Instalación

Quince minutos. Dos carpetas, unos pocos ajustes y los ítems. No se guarda nada en la base de datos, así que no hay nada que importar para el recurso en sí.

Antes de empezar

Necesitas	Por qué
ESX, QBCore o QBox, funcionando	Los ítems, los dueños y los trabajos pasan por él
ox_target o qb-target, funcionando	Cada interacción con una cachimba o silla colocada
Las dos carpetas de tu compra: `mic_hookah` y `mic_hookah_prop`	El script y los modelos de cachimba
Acceso a la lista de ítems y a la carpeta de imágenes de tu inventario	Las cachimbas, los muebles, los suministros y los sabores son ítems

1. Coloca las dos carpetas

Mete mic_hookah y mic_hookah_prop en tus resources, por ejemplo dentro de resources/[mic]/.

mic_hookah_prop contiene los diez modelos de cachimba (mic_hookah_black … mic_hookah_yellow) y su mic_hookah.ytyp. No tiene código; solo hace stream. Las mesas y sillas son modelos del juego base y no necesitan nada más.

2. Orden de arranque

En server.cfg, debajo de tu framework, tu inventario y tu recurso de target, añade ensure mic_hookah_prop y después ensure mic_hookah.

Ha funcionado si ambos arrancan sin líneas rojas debajo.

3. Framework y target

Abre config.lua:

Opción	Ponlo en	Por defecto
`Config.Framework`	`esx`, `qbcore` o `qbox`	`esx`
`Config.Target`	`ox_target` o `qb-target`	`ox_target`
`Config.ESXResourceName`	El nombre de la carpeta de ESX, si lo has renombrado	`es_extended`
`Config.QBResourceName`	El nombre de la carpeta de QBCore, si lo has renombrado	`qb-core`
`Config.QBoxResourceName`	El nombre de la carpeta de QBox, si lo has renombrado	`qbx_core`
`Config.QBTargetResourceName`	El nombre de la carpeta de qb-target, si lo has renombrado	`qb-target`

Aquí no se detecta nada solo: estos valores deciden qué framework y qué target se usan.

4. La base de datos

Nada para el recurso: las cachimbas y los muebles colocados viven en la memoria del servidor, no en una tabla. En ESX con el inventario por defecto, los ítems van en la tabla items; lo ves en el siguiente paso.

5. Añade los ítems

La lista completa está en 🎒 Ítems. En resumen:

Ítem	Qué hace
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Úsalo para llevar y colocar esa cachimba
`hookah_table` … `hookah_table5`	Úsalo para colocar una mesa
`hookah_chair` … `hookah_chair6`	Úsalo para colocar una silla en la que sentarte
`hookah_coal`	Rellena el carbón desde el menú de preparación
`hookah_water`	Rellena el agua desde el menú de preparación
`hookah_<flavour>_flavor`	Sesenta sabores, que se eligen desde el menú de preparación

Dónde están las definiciones listas, en inventory_items/ dentro de mic_hookah:

Archivo	Para	Qué hacer
`esx_items.sql`	ESX con su inventario por defecto	Impórtalo una vez en tu base de datos
`ox_items.md`	ox_inventory	Pega sus líneas en `ox_inventory/data/items.lua`
`qb_items.md`	QBCore / QBox con qb-inventory	Pega sus líneas en `qb-core/shared/items.lua`

Imágenes: los iconos están en inventory_images/, un PNG por ítem con su mismo nombre. Cópialos a la carpeta de imágenes de tu inventario: ox_inventory/web/images/ o qb-inventory/html/images/.

Después apunta Config.InventoryImagePath a esa misma carpeta, para que los iconos de los sabores se vean en el menú de preparación. Viene como nui://ox_inventory/web/images/; para qb-inventory usa nui://qb-inventory/html/images/.

Ha funcionado si puedes darte hookah_red y aparece en tu inventario con su imagen.

6. Primera prueba

Date hookah_red, hookah_coal, hookah_water y hookah_mint_flavor.

Usa hookah_red. Tu personaje la sujeta en una bandeja. Pulsa E.
Una vista previa sigue a donde apuntas. Gírala con la rueda del ratón, súbela o bájala con las flechas y pulsa E para dejarla.
Apunta a la cachimba con el target y elige Open Setup Menu. Añade carbón, añade agua, elige Mint y luego Light Hookah.
Cierra el menú, vuelve a apuntar a la cachimba y elige Grab Hose. Pulsa E.

Ha funcionado si sale una manguera desde la cachimba hasta tu personaje y, al pulsar E, das una calada y sale humo verde claro. El carbón y el agua del menú bajan un poco con cada calada.

Antes de abrir tu ciudad

Decide quién puede gestionar las cachimbas. Config.AdminGroups viene como false, lo que permite a cualquier jugador abrir el menú de cualquier cachimba o mueble, y recogerlo. Ponle tus grupos de admin para limitarlo al dueño y al staff. Consulta Personalización.
Config.InventoryImagePath apunta a la carpeta de imágenes que usas de verdad.
Estrés: Config.Stress está activado, pero ReduceStress en server_functions.lua está vacío hasta que pongas tu llamada en él.
Avisa a tus jugadores de que las cachimbas y los muebles no se guardan: se borran cuando se reinicia el recurso o el servidor.