Esta página cubre las dos formas en que los servidores llegan a qs-inventory 4.1: actualizar desde qs-inventory 4.0, donde cada ajuste estaba en archivos de configuración, y pasar desde otro inventario — ox_inventory, qb-inventory, el inventario predeterminado de ESX o tgiann-inventory — con el importador integrado que trae tus ítems, inventarios de jugadores, stashes y maleteros.
No pueden funcionar dos inventarios a la vez: ambos responden a los mismos exports, se abren con la misma tecla y guardan la misma columna del jugador. Quita el antiguo de server.cfg antes de que se inicie qs-inventory.
Actualizar desde qs-inventory 4.0#
La versión 4.1 trasladó cada ajuste al juego. Todo lo que 4.0 guardaba en config/, y dónde está ahora:
En 4.0 | En 4.1 |
|---|---|
|
|
| /inventorycreator → Crafting. Los bancos de ejemplo incluidos se añaden ahí en el primer arranque. |
| /inventorycreator → Shops, como Buyer. Los puntos de venta de ejemplo incluidos se añaden ahí en el primer arranque. |
| /inventoryconfig → Vehicles. |
| /inventoryconfig → Vending machines, Garbage, Item rules y Weapons. Sus valores de fábrica se trasladaron a |
| /inventorycreator → Give. |
El panel Customization | El estudio de estilos, que se abre con el botón Settings del inventario: 12 estilos, un modo libre, diseño compacto y la rueda rápida. |
Copia de seguridad
Exporta la base de datos y copia tu carpeta
qs-inventoryantigua en algún lugar fuera deresources.Sustituye el recurso
Sustituye todos los archivos. Luego vuelve a poner lo que habías editado:
shared/items.lua,shared/weapons.lua,server/custom/webhook/webhook.luay cualquier cambio enclient/custom/oserver/custom/.No vuelvas a ejecutar el SQL
Los archivos SQL eliminan las tablas de stashes, maleteros, guanteras y ropa. Las nuevas tablas que necesita 4.1 las crea el recurso por sí solo.
Da acceso a los paneles
bash add_ace group.admin command.inventoryconfig allow add_ace group.admin command.inventorycreator allowLos administradores del framework ya tienen acceso.
Vuelve a configurar tus valores
Ejecuta
refreshy reinicia, abre/inventoryconfigy copia lo que habías cambiado en la configuración antigua: pesos y ranuras, teclas, vehículos, armas, reglas de robo. Usa el buscador (Ctrl+F) para encontrar cada uno. Los ajustes marcados con Restart necesitan un reinicio más del inventario.Vuelve a crear tus propios bancos y puntos de venta
Solo se añaden automáticamente los ejemplos incluidos. Los bancos y puntos de venta que habías escrito tú se vuelven a colocar en
/inventorycreator, de pie en el lugar y pulsando Here.
Los archivos de configuración antiguos ya no se leen. Dejarlos en la carpeta no hace nada; elimínalos para evitar confusiones.
Desde las tablas muy antiguas de qs-inventory#
Los servidores que aún tienen las tablas antiguas qs_stash, qs_trunk y qs_glovebox pueden copiarlas: /inventoryconfig → General, activa Show advanced settings, luego Import data from the old qs-inventory, guarda y reinicia. En ese arranque las filas se copian en inventory_stash, inventory_trunk y inventory_glovebox, los ítems que ya no existen se listan en server/custom/backward/missing_items.json, y la opción se desactiva sola.
Venir desde otro inventario#
El importador, en /inventorycreator → Import, lee lo que tu inventario anterior guardó en la base de datos y lo trae a qs-inventory. Las listas de ítems guardadas en un archivo Lua se pegan en el panel.
Inventario | Ítems | Inventarios de jugadores | Stashes | Maleteros y guanteras |
|---|---|---|---|---|
|
| Sí | Compartidos y personales | Sí |
|
| No es necesario: los jugadores de QBCore ya usan el mismo formato | Sí, incluido qb-inventory 2.x | Sí, incluido qb-inventory 2.x |
ESX predeterminado | La tabla | Sí, con el loadout de armas | esx_addoninventory, y armas desde datastores | Maleteros y guanteras de esx_inventoryhud |
|
| Sí | Compartidos y personales | Sí |
Haz una copia de seguridad de la base de datos
El importador nunca borra los datos antiguos, pero escribe los inventarios de los jugadores, así que guarda una copia.
Detén el inventario antiguo
Quítalo de
server.cfgy reinicia. Puedes dejar su carpeta enresources, sin iniciar: así el importador lee de ahí sus ítems e imágenes. Mientras el inventario antiguo esté en marcha, la importación se rechaza.Vacía el servidor
Los jugadores conectados se omiten, así que ejecuta la importación sin nadie más conectado. El indicador de la cabecera dice cuántos hay conectados.
Analiza
Abre /inventorycreator → Import. El análisis se ejecuta solo, sin escribir nada: cada inventario recibe una tarjeta que indica lo que encontró — ítems, inventarios de jugadores, stashes, maleteros — y si su carpeta está ahí.
Pega tu lista de ítems
Para ox_inventory, qb-inventory y tgiann-inventory, abre el archivo de ítems, cópialo entero, pégalo en Item list y pulsa Read list. Sirven el archivo completo, solo sus entradas o una lista JSON, hasta 4 MB.
Importa
Marca lo que quieres traer — Items and images, Player inventories, Stashes, Trunks and gloveboxes — y pulsa Import. La línea de resultado indica cuántos ítems se crearon, cuántas imágenes se copiaron y cuántos inventarios se convirtieron.
Qué hace el importador con cada elemento:
Elemento | Qué ocurre |
|---|---|
Ítems nuevos | Se crean como ítems del creador: aparecen en la pestaña Items y se aplican al instante, con su imagen copiada en |
Ítems que qs-inventory ya tiene | Se omiten. Nunca se sobrescribe nada de qs-inventory. |
Armas en la lista de ítems | Se dejan fuera y se cuentan — añádelas en la pestaña Weapons. Las armas dentro de los inventarios guardados se convierten cuando qs-inventory conoce el arma. |
| No se importa: el dinero está en las cuentas del framework. |
Munición de ox_inventory | Se asigna a |
Stashes, maleteros y guanteras | Solo se añaden donde qs-inventory no tiene nada con ese id; los existentes no se tocan y se cuentan como conflictos. |
Inventarios de jugadores | El valor anterior de cada jugador se guarda en |
Chezza y core_inventory no están en la lista: no publican cómo guardan los inventarios. Sus ítems pueden entrar igualmente desde la tarjeta de ESX (usan la tabla
itemsde ESX) o pegando su lista en la tarjeta de ox_inventory o de qb-inventory.
Tus otros scripts siguen funcionando: qs-inventory responde a las llamadas exports['qb-inventory'] y exports.ox_inventory que ya hacen. Consulta Integraciones.
Qué cambia para tu staff y tus jugadores#
Antes | En qs-inventory 4.1 |
|---|---|
Editar un archivo de configuración y reiniciar |
|
Tiendas, stashes y bancos escritos en Lua |
|
Ítems y armas add-on añadidos en archivos | Las pestañas Items y Weapons del creador, aplicadas sin reiniciar. Los archivos siguen funcionando. |
Dar ítems por comando | La pestaña Give, a varios jugadores a la vez. |
Un mismo aspecto para todos | Cada jugador elige un estilo en el estudio de estilos; el servidor establece el predeterminado. |
Adivinar de dónde vienen los ítems duplicados | La pestaña Stats: cada ítem creado, qué script lo dio, quién tiene qué y alertas antiduplicación. |
Comprobar que ha funcionado#
Inicia el servidor. La consola muestra
loaded N creator recordsy ningún error del inventario antiguo./inventorycreator → Items lista los ítems importados con sus imágenes.
/inventorycreator → Stats → Who has what, luego Scan: los ítems importados aparecen en los jugadores y en stashes, maleteros y guanteras.
Abre un stash y un maletero que sepas que tenían ítems, y abre el inventario de un jugador que se haya importado.