Lo que falla con más frecuencia, lo que significa realmente y qué hacer al respecto. La mayoría de estos casos son de configuración, no fallos — y la consola suele indicar cuál. Léela desde el principio antes de abrir un ticket.
Instalación y acceso#
El recurso no se inicia
Comprueba que ox_lib, oxmysql, MugShotBase64 y qs-inventory-objects estén todos con ensure antes de qs-inventory — FiveM se niega a iniciar un recurso al que le faltan dependencias — y que el artifact de tu servidor sea la build 4752 o posterior.
"You have renamed the script!" y la consola se congela
La carpeta debe llamarse exactamente qs-inventory. Vuelve a ponerle ese nombre — una carpeta de categoría a su alrededor, como [qs], no da problemas. Los complementos de [dlc] siguen la misma regla.
El archivo SQL no se importa
Los archivos usan ADD COLUMN IF NOT EXISTS de MariaDB, que MySQL 8 rechaza. Usa MariaDB, o ejecuta una vez esas líneas ALTER TABLE sin IF NOT EXISTS. Recuerda que ambos archivos eliminan las tablas inventory_*: nunca los vuelvas a importar en una actualización.
Los stashes, maleteros o misiones no se guardan
No se importó el archivo SQL. Las seis tablas inventory_* y las columnas inventory_skill / unlocked_skills solo provienen de [sql]; solo las tablas qs_inventory_* se crean solas. La consola muestra un error "Table doesn't exist" de oxmysql.
"You do not have permission to open the inventory settings" (o creator)
Mira la consola del servidor: imprime la línea add_ace exacta que dejaría entrar a ese jugador. Nueve de cada diez veces el ace está en server.cfg pero no se reinició el servidor, o el jugador no está en el grupo que indica la línea. ESX admin / superadmin y QBCore god / admin siempre tienen acceso.
Los ítems usables de mis otros scripts no hacen nada (ESX)
es_extended no está cediendo su inventario a qs-inventory. Usa el es_extended ya editado de Instalación, o configura Config.CustomInventory = 'qs' en es_extended/shared/config/main.lua y reinicia.
Guardé un ajuste y no cambió nada
Busca la etiqueta Restart: el idioma, el target, las teclas, los nombres de comandos y los interruptores que activan o desactivan funciones completas se aplican tras restart qs-inventory. El panel los muestra en Waiting for a restart. Las teclas tampoco reemplazan nunca una tecla que un jugador ya asignó a esa acción.
Edité un archivo en shared/data y no cambió nada
Es el comportamiento correcto. Esos archivos son los valores de fábrica; en cuanto se guarda un valor en /inventoryconfig o en el creador, manda la base de datos. Cámbialo en el juego, o usa Reset section para volver al valor del archivo.
Abrir el inventario#
TAB no hace nada
Probablemente otro recurso tiene la tecla. Reasigna Open/Close Inventory en GTA, en Settings → Key Bindings → FiveM. Tampoco funciona mientras estás muerto, cayendo, en ragdoll u ocupado (usando un ítem, comerciando), ni después de pulsarla repetidamente ("Stop trying..."). Si un script llamó a setInventoryDisabled(true), sigue bloqueado hasta que ese script lo libere.
ESC abre el inventario en lugar del menú de GTA
Es el menú de pausa del inventario. Desactiva Replace the GTA pause menu en /inventoryconfig → Pause menu (reinicio), o deja que cada jugador mueva la acción a otra tecla en Settings → Keys.
El maletero no se abre
Colócate a menos de 1.5 m de la parte trasera del vehículo — o de la delantera, en coches con motor trasero — y asegúrate de que esté desbloqueado ("Vehicle locked!"). Si Anyone can open any trunk está desactivado, solo pueden el propietario y la policía. Un superdeportivo con el maletero delante que falte en la lista de motor trasero se puede añadir en Vehicles.
"Another player is using the inventory!" pero no hay nadie
Un stash, maletero o guantera quedó marcado como abierto, normalmente por un crash. /resetinv stash <id> (o trunk / glovebox con la matrícula) lo desbloquea sin tocar sus ítems.
Las opciones de target no aparecen
Use target necesita un reinicio después de activarlo, y ox_target o qb-target deben iniciarse antes que el inventario. Show target zones dibuja las zonas para que veas dónde están.
Falta el personaje o el fondo 3D
Las salas de fondo se cargan mediante qs-inventory-objects, que debe estar iniciado. La vista previa también se oculta a propósito en las páginas Settings, Information, Skills y Shop, y los jugadores pueden desactivarla para sí mismos — o activar el fondo transparente — en Settings → Inventory.
Ítems y armas#
Un ítem no muestra imagen o no existe
En QBCore, los ítems vienen de qb-core/shared/items.lua — añádelo ahí, o créalo en la pestaña Items del creador, que funciona en todos los frameworks. Para una imagen propia, usa Link en el campo de imagen del ítem con una dirección directa PNG, JPG o WebP.
La ropa no se quita en QBCore
Faltan los ítems de ropa en qb-core/shared/items.lua. Pégalos desde Instalación y reinicia.
Un ítem no se puede usar desde una ranura rápida o en un coche
Está en Items blocked on keys 1-6 (Item rules → Hotbar), o Use items in vehicles está desactivado. Los ítems también pueden restringirse en su definición a un trabajo, un nivel o una sección del inventario.
"You can't store this item" o "can't take more"
El ítem está en Items that can't be stored (una mochila, por defecto) o tiene un Carry limit (una mochila por jugador). Ambos están en Item rules → Limits and protected items.
La comida se estropea demasiado rápido, o nunca
La tasa de deterioro es el número de días que tarda un ítem en pasar del 100% al 0% — un número mayor dura más. 0.07 es aproximadamente una hora y cuarenta minutos; 0 nunca se deteriora. La calidad se actualiza al abrir el inventario.
Un arma no se saca, o no se recarga
Al 0% de calidad está rota: repárala con un kit o en un punto de reparación. Un cargador lleno rechaza otra recarga mientras One magazine at a time esté activado, y una recarga necesita el ítem de munición correspondiente — o master_ammo. Con Weapons usable inside vehicles desactivado, las armas se quedan guardadas en los coches.
El tinte por URL no se ve en el arma
El arma debe estar en URL tint textures (Weapons, avanzado) y el enlace debe apuntar directamente a una imagen. Usa el ítem de tinte con el arma en la mano — soltarlo en la pantalla de accesorios se rechaza.
Jugadores y mundo#
No se pueden patear las bolsas del suelo
Patear requiere OneSync y Show a prop for bags, y las bolsas se quedan quietas mientras sv_entityLockdown sea strict — la consola indica cuál al iniciar. Patea desarmado, a pie, a menos de 1.6 m.
El botón Steal no aparece
El otro jugador debe tener las manos arriba (o estar muerto, con el robo a muertos activado), estar a menos de 3 m, y tú debes ir armado salvo que Rob without a weapon esté activado. No se puede registrar a un jugador que está en mitad de un intercambio.
Una tienda no me deja comprar
Las compras requieren que estés a menos de 8 m de la tienda, el ítem de licencia que pide, el trabajo o la banda correctos, el dinero en la cuenta que cobra y que quede stock. Un producto que la tienda muestra para un trabajo o una licencia está oculto para todos los demás.
Los bancos de crafteo han desaparecido
El crafteo está desactivado en /inventoryconfig → Crafting, lo que oculta todos los bancos, o el banco está limitado a un trabajo. Una receta también se oculta cuando su resultado o un ingrediente no es un ítem real.
Los outfits se pierden al volver a conectarse
El script de apariencia debe iniciarse antes que el inventario para que se detecte; el outfit se guarda a través de él al cerrar el inventario. Consulta Integraciones.
Herramientas de administración#
El importador se niega a ejecutarse
Running significa que el inventario antiguo está iniciado junto a qs-inventory: quita su ensure y reinicia. Busy significa que la importación de otro administrador sigue en curso. Los jugadores conectados se omiten a propósito — importa con el servidor vacío. Consulta Cambiar a Advanced Inventory.
Demasiadas alertas anti-dupe
Un script de trabajo que reparte legítimamente grandes cantidades activa Burst o Spike. Sube los límites en Anti-dupe alerts; la pestaña Stats muestra qué script dio los ítems, para que distingas un farmeo de un dupeo.
Los logs o avatares de Discord no aparecen
Ejecuta testwebhooks en la consola del servidor: indica qué categorías están vacías y cuáles rechazó Discord. Los avatares del menú de pausa necesitan tu propio token de bot de Discord en webhook.lua.
Los jugadores pueden abrir inventarios de otros jugadores con un comando
El modo debug está activado. Registra comandos de prueba para todos los jugadores. Desactívalo en /inventoryconfig → General (avanzado) y reinicia.
Mensajes de consola#
Mensaje | Significa |
|---|---|
| Esas categorías de log no tienen URL en |
| El servidor funciona sin OneSync, así que los ítems del suelo se quedan quietos. |
| Las bolsas no se pueden patear; los ítems lanzados y colocados sí. |
| Se guardó un ajuste que requiere reinicio, pero faltaba la copia temprana en |
| El usuario de la base de datos no puede crear tablas. Ejecuta a mano el bloque correspondiente del archivo |
| Alguien sin acceso escribió el comando. La línea termina con el |
| El inventario detuvo qb-inventory por ti. Quítalo de |
| Hay una actualización disponible; descárgala desde el CFX Portal. Tu configuración y el contenido del creador están en la base de datos y se conservan. |
| No se pudo contactar con el servidor de versiones. Es inofensivo. |
¿Sigues atascado? Abre un ticket e incluye tu framework y su versión, la salida de la consola desde el inicio del servidor y una captura de la consola F8 para cualquier cosa relacionada con la interfaz.