Cómo instalar un inventario en FiveM (paso a paso)
Scripts y recursos

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.

Antes de empezar: ten un servidor funcionando con un framework instalado. ¿Nuevo en esto? Sigue primero nuestra guía para montar un servidor de FiveM.

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-core o qbx_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

  1. Copia la carpeta del inventario en tu directorio resources/ (mantén el nombre exacto que envió el desarrollador).
  2. 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.

  1. Haz copia de tu base de datos primero. Innegociable.
  2. Importa el .sql con HeidiSQL, phpMyAdmin o la CLI.
  3. 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).
Regla de oro: lee la consola de arriba abajo y corrige el primer error. El resto suelen ser consecuencias que desaparecen al resolver la causa raíz.

¿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íntomaCausa probableSolución
”attempt to index nil” al arrancarDependencia sin iniciarSube oxmysql/ox_lib por encima del inventario
Los objetos no se guardanSQL no importadoImporta el .sql, reinicia
Se abren dos inventariosEl de serie sin desactivarComenta el ensure del inventario antiguo
Interfaz en blancoVersión de ox_lib incompatibleActualiza 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.