Cambiar a AdvancedInventory

Advanced Inventory puede traer los ítems y los inventarios guardados de tu servidor desde el inventario que usas hoy, para que los jugadores conserven lo que tienen. Todo se hace desde una pestaña Import en /inventorycreator, sin scripts de conversión ni SQL a mano, y los datos antiguos nunca se eliminan.

Antes de cambiar#

Dos inventarios no pueden funcionar a la vez: gestionan los mismos ítems, teclas y eventos. El importador se niega a ejecutarse mientras el antiguo está iniciado, pero sí necesita su carpeta: de ahí se leen las listas de ítems guardadas en archivos y las imágenes de los ítems.

1. Detén el inventario antiguo, conserva su carpeta

   Elimina su línea ensure de server.cfg pero deja la carpeta dentro de resources. Elimina también los scripts que venían con él: qb-weapons, qb-shops, esx_inventoryhud y similares.

2. Instala Advanced Inventory

   Sigue Instalación, con una diferencia en ESX: la primera línea de esx.sql vacía la columna de inventario de todos los jugadores, que es justo lo que quieres importar. Elimina esa línea antes de importar el archivo:

   UPDATE `users` SET `inventory` = '[]' WHERE identifier IS NOT NULL; -- remove this line when importing players

   qb.sql nunca toca players.inventory, así que QBCore y Qbox no necesitan cambios.

3. Inicia el servidor sin nadie dentro

   Los jugadores conectados se omiten, porque su inventario está activo en memoria y sobrescribiría la importación al salir. Entra solo como administrador; la pestaña Import dice Server empty, everything can be imported cuando todo está despejado.

El importador#

Abre /inventorycreator → Import. Hay una tarjeta por cada inventario de origen, y cada tarjeta indica de dónde vendrán sus datos: Folder stopped (lo que debería decir), No folder (solo se lee la base de datos) o Running (detenlo primero).

1. Analyse

   Lee cada origen sin escribir nada. Cada tarjeta lista lo que encontró: ítems encontrados, nuevos y ya existentes; filas a importar por parte; almacenamientos que ya existen en qs; jugadores conectados que se omitirán; y los ítems desconocidos que contiene un inventario guardado.

2. Pega la lista de ítems, si la tarjeta la pide

   ox_inventory, qb-inventory y tgiann-inventory guardan sus ítems en un archivo Lua, no en SQL. Abre el archivo indicado en la tarjeta, copia todo y pulsa Paste list (4 MB como máximo). Si no pegas nada, la lista se lee de la carpeta detenida si está ahí.

3. Elige las partes y pulsa Import

   Las partes son Items and images, Player inventories, Stashes y Trunks and gloveboxes. Los ítems se crean al momento como ítems del creador (activos para todos los jugadores y editables en la pestaña Items) y los inventarios guardados se escriben en las tablas de qs-inventory.

Las reglas que sigue#

• Nada en qs se sobrescribe. Un ítem que ya existe se omite, y un stash, maletero o guantera que ya tiene una fila en qs se cuenta como conflicto y se deja como está.

• El dinero nunca se importa. money, cash y black_money se quedan en las cuentas del framework.

• Las armas quedan fuera de la importación de ítems y solo se cuentan. Todas las armas de GTA ya están en el inventario; crea las armas add-on en la pestaña Weapons del creador.

• Los ítems de los jugadores se ajustan a las ranuras que tienes (41 por defecto). Lo que no cabe se cuenta, así que aumenta primero las ranuras en /inventoryconfig → Capacity si la cifra es alta.

• Los ítems que el inventario no conoce se listan como desconocidos. Importa la parte de ítems antes que los inventarios, o crea los que falten en Items.

• Las imágenes solo se copian cuando el inventario no tiene ninguna con ese nombre, y solo desde una carpeta que esté de vuelta en resources. ESX no tiene carpeta de imágenes de la que copiar.

• Los pesos de ESX entre 0 y 100 se leen como kilogramos y se convierten a gramos, que es la unidad que usa el inventario.

• Una importación a la vez. Si un segundo administrador pulsa Import mientras otra está en curso, se le indica que espere.

Cada importación se registra en la consola y en el webhook de Discord de administración. Cuando estés conforme con el resultado, la carpeta y las tablas del inventario antiguo se pueden eliminar: el importador no las vuelve a necesitar.

Desde el antiguo qs-inventory#

Los servidores que usaban el antiguo qs-inventory guardaban los stashes, maleteros y guanteras en qs_stash, qs_trunk y qs_glovebox. Los inventarios de los jugadores ya están en users / players con el mismo formato y no necesitan nada.

1. Actívalo

   /inventoryconfig → General → Show advanced settings → Import data from the old qs-inventory y guarda.

2. Reinicia el inventario

   Cada stash, maletero y guantera no vacío se copia a las tablas nuevas, sobre lo que contengan, con sus ranuras renumeradas desde 1. Los ítems que tu lista de ítems ya no tiene se omiten y se escriben en server/custom/backward/missing_items.json.

3. Lee la consola

   Muestra Backward compatibility has been completed. y desactiva el ajuste por sí solo, así que la copia nunca se ejecuta dos veces. Si no pudo, desactívalo a mano. Después se pueden eliminar las tablas antiguas qs_*.

Scripts escritos para otro inventario#

Tus otros recursos no necesitan reescribirse. Advanced Inventory responde a los exports que los scripts ya llaman en exports.ox_inventory y exports['qb-inventory'], reemplaza los métodos de ítems de jugador de QBCore y lanza los eventos de ítems de ESX y qb-inventory. Integraciones enumera exactamente lo que está cubierto.

¿Prefieres guardar una lista de ítems en un archivo? Pégala en el QS Inventory Item Converter y te la devuelve en el formato de shared/items.lua.