ox_lib, ox_inventory y oxmysql: la base moderna de FiveM
Las tres piezas que hoy usan casi todos los scripts nuevos, funcionen sobre ESX o sobre QBCore.
9 min de lectura · 10 pasos
Por qué acabaste necesitándolas
El ecosistema de Overextended se volvió el terreno común de FiveM: da igual que corras ESX o QBCore, los scripts publicados en los últimos años dan por hecho que tienes estas piezas. No son un framework, son la infraestructura debajo.
Recurso Qué resuelve oxmysql Hablar con MySQL sin bloquear el servidor ox_lib Menús, notificaciones, barras de progreso, callbacks, zonas ox_inventory Inventario con peso, cajas, tiendas y objetos con metadatos ox_target Interactuar mirando a algo, en vez de por proximidad ox_doorlock Puertas con cerradura por trabajo oxmysql va antes que todo
Sustituye al viejo mysql-async y es lo primero que arranca. Su ventaja real: las consultas no congelan el hilo principal del servidor, que es la causa más común de tirones en servidores con muchos scripts.
server.cfg
set mysql_connection_string "mysql://usuario:contraseña@localhost/tu_bd?charset=utf8mb4" ensure oxmysqlCómo se consulta con oxmysql
Si vienes de mysql-async, la traducción es directa. La versión await es la que se usa hoy porque el código queda legible.
server/main.lua
-- Consultar local filas = MySQL.query.await( 'SELECT * FROM users WHERE identifier = ?', { identificador }) -- Un solo valor local dinero = MySQL.scalar.await( 'SELECT money FROM users WHERE identifier = ?', { identificador }) -- Insertar MySQL.insert('INSERT INTO logs (accion, jugador) VALUES (?, ?)', { 'compra', identificador })Los signos de interrogación no son decorativos: son lo que impide una inyección SQL. Nunca pegues el valor directo dentro de la consulta con concatenación.
ox_lib: lo que sustituye a media docena de recursos
Un solo recurso que trae menús, cajas de diálogo, notificaciones, barras de progreso, zonas y callbacks. Se declara en el fxmanifest de quien lo use con una @ delante.
fxmanifest.lua de tu recurso
shared_scripts { '@ox_lib/init.lua' }Ejemplos de ox_lib que vas a copiar mil veces
Estas cuatro llamadas cubren casi todo lo que un script necesita mostrar al jugador:
client/main.lua
-- Notificación lib.notify({ title = 'Listo', description = 'Pieza entregada', type = 'success' }) -- Barra de progreso con animación if lib.progressBar({ duration = 5000, label = 'Reparando…', useWhileDead = false, canCancel = true, disable = { move = true, car = true }, }) then print('terminó') end -- Menú de contexto lib.registerContext({ id = 'menu_taller', title = 'Taller', options = { { title = 'Reparar', description = '$500', event = 'taller:reparar' }, } }) lib.showContext('menu_taller')ox_inventory funciona con ESX y con QBCore
Es su mayor virtud y la razón de que sea el estándar: trae puentes para los dos frameworks, así que las llamadas de tus scripts son las mismas vengas de donde vengas. Además pesa objetos, permite metadatos —una identificación con nombre, un arma con su número de serie— y trae tiendas y cajas.
server/main.lua
-- Igual en ESX y en QBCore exports.ox_inventory:AddItem(source, 'pan', 1) exports.ox_inventory:RemoveItem(source, 'pan', 1) local cuantos = exports.ox_inventory:GetItemCount(source, 'pan') -- Con metadatos exports.ox_inventory:AddItem(source, 'identificacion', 1, { nombre = 'Juan Pérez', nacimiento = '1990-04-12' })Declarar objetos en ox_inventory
Los objetos se declaran en su propio archivo de datos, y la imagen va en su carpeta web. Si migras desde qb-inventory, hay scripts de conversión que traen el propio repositorio.
resources/ox_inventory/data/items.lua
['radio'] = { label = 'Radio', weight = 1000, stack = false, close = true, description = 'Para hablar con tu equipo', client = { export = 'mi-radio.usar' } },ox_target: interactuar mirando
Sustituye a los avisos de «pulsa E» por proximidad, que obligan a un bucle constante en cada script. Con ox_target el jugador apunta con el cursor y ve las opciones. Consume menos y se siente mejor.
client/main.lua
exports.ox_target:addBoxZone({ coords = vec3(-1193.0, -899.0, 14.0), size = vec3(2, 2, 3), rotation = 35, options = { { name = 'taller_reparar', icon = 'fa-solid fa-wrench', label = 'Reparar vehículo', groups = { mecanico = 0 }, onSelect = function() TriggerEvent('taller:reparar') end } } })Orden de arranque con el ecosistema completo
Para que nada se adelante a su dependencia:
server.cfg
ensure oxmysql ensure ox_lib ensure qb-core # o es_extended ensure ox_inventory ensure ox_target ensure ox_doorlock ensure [mis-scripts]Migrar a ox_inventory sin perder los inventarios
Se puede, y el repositorio trae la conversión desde qb-inventory y desde los de ESX. Pero se hace con el servidor cerrado, con respaldo de la base de datos y probando en un servidor de pruebas primero. Es de las pocas operaciones donde un fallo significa que todos tus jugadores pierden lo que llevaban encima.
Respaldo de la base de datos antes de convertir. No el del servidor: el de la base de datos, exportado y descargado a tu computadora.
¿Se te atoró algo?
Escríbenos y lo vemos contigo. Si la duda se repite, la agregamos a esta guía.
Pedir ayudaGuías relacionadas
AvanzadoFiveMConvierte un script de ESX a QBCore (y al revés)
La tabla de equivalencias completa. Con esto, casi cualquier script del otro framework se adapta en media hora.
12 min11 pasos
AvanzadoFiveMBaja el hitch: optimizar un servidor de FiveM
resmon, tiempo de tick, base de datos y streaming. Dónde se va de verdad el rendimiento de un RP.
10 min9 pasos
BásicoFiveMInstala cualquier recurso en FiveM sin romper el arranque
resources, fxmanifest, orden de carga en server.cfg y cómo leer los errores de la consola.
9 min9 pasos

