Instalar ox_inventory en FiveM

El problema

Quieres sustituir el inventario por defecto de tu servidor por ox_inventory, pero no sabes qué dependencias necesita, en qué orden cargarlo ni cómo hacerlo compatible con ESX o QBCore. Tras copiar el recurso, el inventario no abre, los items no existen o la consola lanza errores de oxmysql/ox_lib.

La causa

ox_inventory no funciona en solitario: necesita oxmysql para guardar el stash/inventario en la base de datos y ox_lib para su UI, callbacks y utilidades. Si el orden de ensure es incorrecto (oxmysql u ox_lib cargan después de ox_inventory), o si no le indicas tu framework (ESX/QBCore), el recurso arranca a medias o no encuentra al jugador.

La solución

Instala las dependencias en orden, importa el SQL de ox_inventory y declara el framework. El orden de ensure es lo que más fallos provoca: oxmysql → ox_lib → ox_inventory → tu framework/bridge.

## server.cfg — orden de carga (ensure) crítico
## 1) Base de datos primero: ox_inventory persiste todo vía oxmysql
ensure oxmysql
## 2) Librería de utilidades/UI que usa ox_inventory
ensure ox_lib
## 3) El inventario, ya con sus dependencias listas
ensure ox_inventory
## 4) Tu framework / bridge (ESX o QBCore)
ensure es_extended      ## o: ensure qb-core

## Configura el framework en ox_inventory:
##   ox_inventory/data/  +  setr inventory:framework en tu cfg, p.ej:
setr inventory:framework "esx"   ## valores típicos: "esx" | "qb"
## Tras editar SQL o items, reinicia el SERVIDOR COMPLETO, no solo el recurso.

Paso a paso

1. 1.Instala las dependencias: descarga oxmysql y ox_lib (ambos de overextended) y colócalos en resources/. ox_inventory no arranca sin ellos.
2. 2.Descarga ox_inventory desde el repositorio oficial de overextended (github.com/overextended/ox_inventory). Usa una release estable, no el código de la rama main si tu build de FXServer es antiguo.
3. 3.Importa el SQL: ejecuta el archivo .sql incluido en ox_inventory (crea las tablas ox_inventory, stashes, etc.) en tu base de datos antes de arrancar.
4. 4.Coloca los recursos en el orden de ensure correcto en server.cfg: oxmysql → ox_lib → ox_inventory → tu framework (es_extended o qb-core).
5. 5.Indica tu framework: ox_inventory detecta ESX o QBCore, pero confírmalo en su configuración (data/ o convar inventory:framework) para que resuelva al jugador correctamente.
6. 6.Define tus items en ox_inventory/data/items.lua (name, label, weight, stack, close, description). ox_inventory usa SU propia lista de items, no la de tu framework.
7. 7.Añade las imágenes de cada item en ox_inventory/web/images con el mismo nombre que el item (p.ej. water.png para el item "water"), si no aparecerán en blanco.
8. 8.Usa los exports del servidor para manipular inventarios: exports.ox_inventory:AddItem(source, 'water', 1), :Search(source, 'count', 'water') y :GetItem(source, 'water', nil, true).
9. 9.Reinicia el servidor completo (no solo el recurso) y abre el inventario en juego para verificar que carga, mueve items y persiste tras reconectar.

Guías relacionadas