Cómo instalar un inventario en FiveM (paso a paso)
Tutorial para principiantes: instala un script de inventario en tu servidor FiveM —dependencias, base de datos, orden en server.cfg y pruebas— para ESX, QBCore y Qbox.
El inventario es uno de los primeros sistemas de pago que instala la mayoría de dueños, y una de las causas más comunes de errores de “no arranca”. Este tutorial te lleva por una instalación limpia que funciona a la primera, ya uses ESX, QBCore o Qbox.
Paso 1 — Comprueba los requisitos
Todo inventario lista dependencias. Las casi universales hoy son:
- oxmysql — la capa de base de datos.
- ox_lib — librería de UI/utilidades que usan casi todos los recursos modernos.
- Tu framework (
es_extended,qb-coreoqbx_core).
Instálalas y confirma que arrancan limpias antes de añadir el inventario. Puedes ver lo comunes que son en nuestra página de métricas de recursos: oxmysql y ox_lib están en lo más alto del ecosistema.
Paso 2 — Añade los archivos del recurso
- Copia la carpeta del inventario en tu directorio
resources/(mantén el nombre exacto que envió el desarrollador). - Si venía en una carpeta con corchetes
[inventory], mantén esa estructura: los corchetes agrupan recursos y afectan al orden de carga.
Paso 3 — Importa la base de datos
La mayoría de inventarios traen un .sql que añade tablas de objetos, alijos o columnas de metadatos.
- Haz copia de tu base de datos primero. Innegociable.
- Importa el
.sqlcon HeidiSQL, phpMyAdmin o la CLI. - Si el script usa una tabla de items, asegúrate de que tus objetos estén cargados (muchos inventarios premium incluyen una lista inicial).
Paso 4 — Ordena la carga en server.cfg
El orden es donde se rompen la mayoría de instalaciones. Las dependencias deben iniciarse antes del inventario:
# Núcleo primero
ensure oxmysql
ensure ox_lib
ensure es_extended # o qb-core / qbx_core
# Luego el inventario
ensure mi-inventario
Si el inventario reemplaza al de serie de tu framework, desactiva el antiguo (comenta su línea ensure) para que no peleen por los mismos eventos.
Paso 5 — Configúralo
Abre el config.lua del recurso (o su carpeta config/) y ajusta lo esencial:
- Framework — algunos autodetectan; otros necesitan
Config.Framework = 'esx'. - Slots / peso — elige un sistema y mantenlo en todo el servidor.
- Tecla para abrir el inventario.
- Alijos, tiendas, maleteros — activa las funciones que uses; desactiva el resto para ahorrar rendimiento.
Paso 6 — Prueba antes de anunciar
Arranca el servidor y vigila la consola de txAdmin en el primer arranque. Luego, en el juego, verifica el bucle principal:
- Abrir/cerrar el inventario.
- Recoger y soltar un objeto.
- Mover objetos entre la barra rápida y la mochila.
- Abrir un alijo / maletero / tienda.
- Reconectar y confirmar que los objetos persisten (la base de datos guarda).
¿Qué inventario instalar?
Si quieres una base gratuita y fiable, ox_inventory es la referencia de la comunidad. Si el inventario es central en la identidad de tu servidor —crafteo, progresión, almacenamiento profundo y una interfaz pulida—, uno de pago compensa. En nuestras pruebas el todoterreno que más destaca es Quasar Inventory, que soporta ESX, QB, QBCore y Qbox desde un único producto y está diseñado para mantener bajo su coste por frame incluso en una ciudad llena. Puedes verlo en la página de Quasar Store, y lo comparamos con el resto en nuestra guía de mejores inventarios de FiveM.
Errores comunes de instalación (y solución)
| Síntoma | Causa probable | Solución |
|---|---|---|
| ”attempt to index nil” al arrancar | Dependencia sin iniciar | Sube oxmysql/ox_lib por encima del inventario |
| Los objetos no se guardan | SQL no importado | Importa el .sql, reinicia |
| Se abren dos inventarios | El de serie sin desactivar | Comenta el ensure del inventario antiguo |
| Interfaz en blanco | Versión de ox_lib incompatible | Actualiza ox_lib a la versión requerida |
Cuando tu inventario sea estable, combínalo con un HUD limpio —mira nuestra guía de personalización de HUD— y asegúrate de que todo siga rápido con nuestra guía de optimización.