Lo que falla con más frecuencia, qué significa y qué hacer al respecto. La mayoría se debe al orden de carga, a un ítem que falta o a un ajuste, y la consola suele indicar la causa.
Instalación e inicio#
"You have renamed the script!" y el servidor se congela
La carpeta del recurso debe llamarse exactamente qs-inventory. Vuelve a ponerle ese nombre y reinicia.
Errores al iniciar, o el inventario nunca carga
El framework se detecta una sola vez, cuando qs-inventory se inicia. Asegúrate de que oxmysql, ox_lib y tu framework se inicien antes que él en server.cfg y luego reinicia todo el servidor.
En ESX, un error sobre GetUsableItems significa que es_extended no está usando qs-inventory: establece Config.CustomInventory = 'qs' en es_extended/shared/config/main.lua, o usa el es_extended ya editado de Instalación.
"You do not have permission to open the inventory settings" (o el creador)
Añade el ace a server.cfg: la consola del servidor muestra la línea exacta que debes copiar cuando se rechaza a alguien:
add_ace group.admin command.inventoryconfig allow
add_ace group.admin command.inventorycreator allowLos administradores del framework (admin y superadmin en ESX, god y admin en QBCore y Qbox) siempre pueden entrar.
"/inventoryconfig will not save until then"
El recurso no pudo crear sus propias tablas, normalmente porque el usuario de la base de datos no tiene los permisos. Ejecuta a mano los bloques qs_inventory_settings y qs_inventory_creator de sql/esx.sql o sql/qb.sql: solo esos dos bloques, no el archivo completo.
Un ajuste que cambié no hace nada
Los campos con la etiqueta Restart (idioma, teclas, target, manos arriba, lanzar, ropa, crafteo, basura, comandos y algunas tablas) se aplican después de restart qs-inventory. La cabecera del panel cuenta los cambios que esperan un reinicio. Un cambio de tecla solo afecta a los jugadores que nunca han configurado esa tecla ellos mismos.
"Missing webhooks" en la consola
Es informativo. Rellena los canales que quieras en server/custom/webhook/webhook.lua y ejecuta testwebhooks en la consola.
"KickableDrops needs OneSync"
Patear ítems en el suelo requiere OneSync. Activa OneSync o desactiva Kickable items on the ground en Settings → Capacity; así las bolsas se quedan quietas.
Ítems#
Un ítem no existe, o mi cambio en items.lua no hace nada
En QBCore los ítems se leen de qb-core/shared/items.lua, así que qs-inventory/shared/items.lua se ignora allí. En ESX y Qbox es al revés. Los nombres de los ítems deben estar en minúsculas. Crear el ítem en /inventorycreator → Items funciona en todos los frameworks sin reiniciar.
"The following items were removed for player … as they no longer exist"
Un jugador tenía un ítem cuya definición ya no existe: renombrado, eliminado del archivo de ítems o un ítem del creador que se borró. Vuelve a añadir el ítem antes de que cargue el jugador, o acepta que se elimine.
Un ítem muestra NO IMG
La imagen debe ser un PNG en qs-inventory/web/dist/images/ cuyo nombre coincida exactamente con el campo image del ítem, mayúsculas incluidas, o un enlace https:// completo. Reinicia el inventario después de añadir archivos nuevos para que los jugadores los descarguen.
"Inventory is not working, clear the inventory column [sql] to continue"
El inventario guardado del jugador está en un formato que qs-inventory no puede leer, normalmente el antiguo de ESX. Tráelo con el importador (consulta Cambiar a qs-inventory) o restablece la columna inventory de ese jugador a [].
"You can't carry more" con espacio de sobra
Es un límite de transporte, no de peso: Settings → Item rules → Carry limits. Por defecto un jugador lleva una bolsa, y backpack, backpack2, briefcase y paramedicbag cuentan todas como esa única bolsa.
La comida nunca se estropea, o se estropea demasiado rápido
decay es el número de días que tarda el ítem en pasar del 100% al 0%: un número mayor dura más, y 0 nunca se deteriora. El estado se actualiza al abrir un inventario.
"You can't drop this item"
El ítem está en Settings → Item rules → Items that can't be dropped: no se puede dejar en el suelo, lanzar ni colocar. Quítalo de esa lista para permitirlo.
"<item> spoiled and was thrown away"
Throw away spoiled items está activado (Settings → Item rules) y el ítem, marcado como Delete when broken, llegó a 0. Desactívalo para eliminar los ítems estropeados solo cuando alguien intente usarlos.
"You need a free slot to open this container"
La caja está en una pila. Al abrirla primero se separa de la pila, así que el jugador necesita una ranura libre. Haz que los ítems contenedores sean unique en la lista de ítems para que cada caja ocupe su propia ranura.
"You can't put a container inside another container"
Containers inside containers está desactivado (Settings → Item rules → Containers). Actívalo para permitir, por ejemplo, una cajetilla de cigarrillos dentro de una bolsa. Un contenedor nunca puede ir dentro de sí mismo.
Stashes, maleteros y puntos#
"The inventory is being used by another player or you opened it too quickly"
Los stashes, maleteros, guanteras y bolsas se abren para un solo jugador a la vez. Si uno se queda bloqueado tras un crash, libéralo con /resetinv stash <id> (o trunk / glovebox con la matrícula).
"Cannot access a trunk that is not yours"
Anyone can open any trunk está desactivado en Settings → Vehicles: los coches con dueño solo se abren para su dueño y para la policía a partir del rango elegido. Los maleteros de los coches cuya matrícula contiene PLZI son siempre solo para la policía. Un coche cerrado indica que está cerrado.
Los ítems del maletero desaparecen tras un reinicio
Con Only owned cars keep their items activado, los coches que no están en tu tabla de vehículos con dueño no conservan su maletero ni su guantera. Desactívalo para guardar todos los coches.
Un stash, tienda o banco de trabajo del creador no muestra aviso ni blip
Su Access incluye trabajos o bandas: solo esos, a partir del rango mínimo, lo ven y lo abren.
Los bancos de trabajo permanecen ocultos mientras Crafting esté desactivado en Settings.
Con Use target activado, los puntos solo se abren mediante ox_target, qb-target o qtarget; si no hay ninguno en ejecución, no se pueden abrir. El panel muestra cuál ha encontrado.
Usa el botón Teleport de la lista del creador para comprobar dónde está realmente el punto.
Las máquinas expendedoras o los contenedores de basura no se abren
Colócate justo al lado del prop y pulsa TAB, o usa el ojo del target cuando target esté activado. El modelo del prop debe estar en Settings → Vending machines o Garbage, una máquina debe apuntar a una categoría existente, y los modelos nuevos añadidos ahí solo obtienen su opción de target tras un reinicio.
"Vending machines are disabled" o "Selling items is disabled"
El interruptor Vending machines (Settings → Vending machines) o el interruptor Sell points (Settings → Interaction) está desactivado. Vuelve a activarlo.
Ropa#
El botón de ropa no aparece o no hace nada
Comprueba Clothing system (requiere reinicio) y Show the Clothing button en Settings → Clothing. La pantalla de ropa no se abre dentro de un vehículo y solo funciona con los personajes freemode (mp_m_freemode_01, mp_f_freemode_01). Los 14 ítems de ropa deben existir en tu lista de ítems.
La ropa aparece como ítems al probártela en una tienda
El menú de ropa debe pausar el inventario mientras está abierto, con setInClothing(true) y setInClothing(false); consulta Integraciones.
El atuendo no se guarda tras volver a entrar
El script de apariencia debe iniciarse antes que qs-inventory para que se detecte. Las prendas puestas siempre las conserva el inventario.
Armas#
"Your weapons.lua is broken! AMMO_TYPE is not found"
Esa arma no tiene ammotype en tu lista de armas (qs-inventory/shared/weapons.lua en ESX y Qbox, qb-core/shared/weapons.lua en QBCore). Añádelo, o establece el tipo de munición en la pestaña Weapons del creador.
La rueda de armas de GTA y las teclas numéricas dejaron de funcionar
Es intencionado: las armas se llevan en el inventario y se sacan con las teclas 1–5 o la rueda rápida. Un script que necesite recuperar la rueda de GTA puede llamar a exports['qs-inventory']:WeaponWheel(true).
"You can only have one magazine in your weapon"
One magazine at a time está activado (Settings → Weapons): el arma ya está llena. Desactívalo para que las recargas acumulen cargadores.
El arma está rota
Su estado llegó a 0. Usa un kit de reparación con ella en la mano, o un punto de reparación. "This weapon can't be repaired here" significa que su tipo de arma no tiene precio en Settings → Weapons → Repair prices. Para que un arma no se desgaste, pon su desgaste a 0 o añádela a Weapons that never wear out.
"The attachment is not compatible with this weapon"
El arma no tiene ningún componente para ese accesorio. Añádelo en la pestaña Weapons del creador (edita un arma existente) y comprueba el ítem en Settings → Weapons → Attachment items.
Tiendas#
"Config.DisableShopGenerationOnClient is active"
Server-only shops está activado (Settings → General, avanzado), así que se rechaza un script que construye su tienda en el cliente. Crea esa tienda con los exports de servidor CreateShop y OpenShop, o desactiva el ajuste.
OpenShop devuelve false
La tienda nunca se registró con CreateShop, el jugador está a más de 5 m de sus coordenadas, o la tienda tiene grupos de trabajo que el jugador no cumple.
Falta un producto en una tienda
Los productos cuyo ítem no existe se omiten. Comprueba el nombre del ítem, o crea primero el ítem.
El stock se repuso tras un reinicio
Es así por diseño: el stock limitado vuelve a empezar lleno cuando se reinicia el recurso, y se repone solo cada "Restock every" minutos.
"Your job's society doesn't have enough money"
La tienda se paga con Society y la cuenta de la sociedad del trabajo del comprador tiene menos que el precio. Pon dinero en la sociedad, o configura la tienda para efectivo o banco. La cuenta de la sociedad necesita esx_addonaccount en ESX, y qb-banking, Renewed-Banking o qb-management en QBCore y Qbox.
"Only members of this shop's job can buy here with the society account"
Las tiendas de sociedad solo venden a los trabajos de su lista Access, a partir del rango configurado ahí. Añade el trabajo o baja el rango.
"This shop is paid by a society but has no job assigned"
Añade al menos un trabajo a la lista Access de la tienda en /inventorycreator, o dale a la llamada CreateShop un campo society o jobs.
Importador y alertas#
"That inventory is started next to qs-inventory"
Quita el inventario antiguo de server.cfg y reinicia antes de importar. Su carpeta puede quedarse en resources, sin iniciarse.
Algunos jugadores no se importaron
Los jugadores conectados durante la importación se omiten. Vuelve a ejecutarla con el servidor vacío: los jugadores ya convertidos no se importan dos veces.
"That doesn't look like an item list"
Pega el archivo de ítems completo tal cual, o solo sus entradas. El límite es de 4 MB.
Demasiadas alertas anti-dupe
Un trabajo o evento que legítimamente da mucho de un mismo ítem puede activar la alerta de ráfaga. La vista Activity muestra qué script lo dio; sube los límites en Settings → Anti-dupe alerts para ese caso.
¿Sigues atascado? Activa el modo Debug (Settings → General, avanzado), reinicia y abre un ticket con el inicio de la consola de tu servidor y el orden de carga de tu
server.cfg.