Por qué ox_inventory es el estándar
ox_inventory se ha convertido en el inventario de referencia en FiveM por buenos motivos. Rendimiento excelente, API robusta, integración con QBCore y ESX, UI moderna, soporte para metadatos, durabilidad e ítems contenedor. El ecosistema Overextended sigue mejorándolo activamente, y la mayoría de recursos premium modernos lo soportan nativamente. Adoptarlo asegura compatibilidad a largo plazo.
Instalación y configuración básica
Descarga ox_inventory del repositorio de Overextended en GitHub y colócalo en tu carpeta resources. Configura el puente (bridge) para tu framework editando config.lua y poniendo 'qb' o 'esx' según corresponda. Importa el esquema SQL a tu base de datos para que las tablas necesarias existan. Asegúrate de que oxmysql esté iniciado antes que ox_inventory en tu server.cfg.
Definir ítems personalizados
Los ítems se definen en data/items.lua con propiedades como label, weight, stack, imagen e opciones de uso. Para ítems consumibles, define eventos en server o client que se disparen al usarlos. Los ítems de arma se gestionan automáticamente. Añade ítems en lotes editando el archivo y reiniciando el recurso. Para cambios mayores, usa convar ensure ox_inventory para recargar sin reiniciar todo el servidor.
Stashes y contenedores
ox_inventory brilla con stashes personalizados. Registra stashes con exports.ox_inventory:RegisterStash(id, label, slots, weight, owner, groups). Los dueños y permisos se pueden filtrar por citizenid, trabajo o grupo. Los stashes de propiedad están ligados al dueño de la casa; los de trabajo son compartidos entre empleados. Los contenedores como mochilas funcionan con metadatos que referencian otro inventario virtual.
Exports para otros scripts
La potencia de ox_inventory reside en sus exports: añadir ítems, quitar ítems, comprobar cantidad, listar contenido. Otros recursos de tu servidor deben usar estos exports en vez de manipular datos directamente. Esto asegura consistencia, valida operaciones y dispara eventos adecuados. Documenta qué exports usa cada uno de tus scripts para entender la red de dependencias de tu servidor.