RexHost — Hosting y VPS
Todas las guías
FiveMIntermedio

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

  1. 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.

    RecursoQué resuelve
    oxmysqlHablar con MySQL sin bloquear el servidor
    ox_libMenús, notificaciones, barras de progreso, callbacks, zonas
    ox_inventoryInventario con peso, cajas, tiendas y objetos con metadatos
    ox_targetInteractuar mirando a algo, en vez de por proximidad
    ox_doorlockPuertas con cerradura por trabajo
  2. 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 oxmysql
  3. Có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.

  4. 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' }
  5. 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')
  6. 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'
    })
  7. 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'
        }
    },
  8. 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
            }
        }
    })
  9. 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]
  10. 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 ayuda

¿Todavía no tienes servidor?

QBCore · ESX · vRP · qbox, desde $547 al mes.

Ver planes de FiveM