Instalación

Cinco minutos. Sin archivo SQL, sin ajuste de framework: un permiso y un reinicio.

Antes de empezar

Necesitas	Por qué
ESX, QBCore o QBox	Los ítems usables, los trabajos, las notificaciones y el estado vienen del framework
oxmysql	Las configuraciones de los ítems se guardan en una tabla llamada `mic_itemcreator`
Un inventario que ejecute los ítems usables del framework	Así es como el uso del ítem llega a este recurso
ox_lib, ox_target / qb-target, screenshot-basic	Opcionales; consulta Personalización

1. Coloca la carpeta

Descarga mic_itemcreator desde tus granted assets de Cfx.re y mete la carpeta en tus resources, por ejemplo resources/[mic]/mic_itemcreator.

2. Arráncalo después de aquello de lo que depende

En server.cfg, ensure mic_itemcreator va debajo de oxmysql, tu framework (es_extended, qb-core o qbx_core) y tu inventario.

El framework se detecta buscando un es_extended o un qb-core ya arrancado, así que el orden importa: si lo arrancas demasiado pronto, no encuentra ninguno. QBox se detecta gracias a su compatibilidad con QBCore (qbx_core proporciona qb-core), así que no hay nada que configurar.

3. La base de datos: nada que hacer

En su primer arranque, el recurso crea la tabla mic_itemcreator (una fila por ítem configurado) y añade cualquier columna que una versión anterior no tuviera. No hay ningún archivo SQL que importar.

Ha funcionado si la tabla mic_itemcreator está en tu base de datos después del primer arranque.

4. Ítems

El Item Creator no añade ítems a tu inventario: da algo que hacer a los ítems que ya tienes. Cada ítem que configures tiene que existir antes en tu inventario.

No incluye definiciones de ítems ni imágenes. Para ítems nuevos, la Registry Tool del menú te escribe la definición: elige OX, QBCORE o ESX SQL, rellena los campos y copia el resultado en ox_inventory/data/items.lua, qb-core/shared/items.lua o tu tabla items de ESX. Las imágenes van en la propia carpeta de imágenes de tu inventario, con el nombre del ítem.

5. Date acceso al menú

El menú está bloqueado tras el permiso ACE mic_itemcreator.open. Concédelo en server.cfg con una línea add_ace: a una persona, por ejemplo add_ace identifier.discord:YOUR_DISCORD_ID mic_itemcreator.open allow, o a un grupo, por ejemplo add_ace group.admin mic_itemcreator.open allow.

El permiso se comprueba al entrar. ¿Te lo han concedido estando ya conectado? Reconéctate.

Ha funcionado si /itemcreator abre el menú en el panel principal. Sin el permiso te sale la notificación de “sin permiso”.

6. Primera prueba

/itemcreator → Usable Items, y elige un ítem que exista en tu inventario, por ejemplo water.
Añade una función Notification con un mensaje y una función Food/Thirst con algo de sed.
Abre los ajustes del ítem, activa Remove on Use con 1 y guarda.
Date el ítem (el menú tiene un botón para ello, de uno en uno) y úsalo desde tu inventario.

Ha funcionado si aparece la notificación, tu sed sube y desaparece una unidad del ítem.

Antes de abrir tu ciudad

Solo las personas adecuadas tienen mic_itemcreator.open. Puede hacer que cualquier ítem haga cualquier cosa, incluido sacar coches, ejecutar comandos y dar superpoderes.
Cada ítem configurado existe en tu inventario, con el mismo nombre.
Comprueba que Config.ImageInventoryPath apunta a la carpeta de imágenes de tu inventario, o el menú no mostrará imágenes.
Cuéntales a tus jugadores lo de la tecla de cancelar (X por defecto), que detiene las animaciones, escenarios, estilos de andar, velocidad, superpoderes y props que haya iniciado un ítem.