Installazione

Quindici minuti. Due cartelle, qualche impostazione e gli oggetti. Non viene salvato nulla nel database, quindi non c’è niente da importare per la risorsa in sé.

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox, in esecuzione	Oggetti, proprietari e lavori passano attraverso di esso
ox_target o qb-target, in esecuzione	Ogni interazione con un narghilè o una sedia posizionata
Entrambe le cartelle del tuo acquisto: `mic_hookah` e `mic_hookah_prop`	Lo script e i modelli dei narghilè
Accesso alla lista oggetti e alla cartella immagini del tuo inventario	Narghilè, mobili, rifornimenti e aromi sono oggetti

1. Posiziona entrambe le cartelle

Inserisci mic_hookah e mic_hookah_prop nelle tue risorse, ad esempio dentro resources/[mic]/.

mic_hookah_prop contiene i dieci modelli di narghilè (mic_hookah_black … mic_hookah_yellow) e il relativo mic_hookah.ytyp. Non contiene codice; effettua solo lo streaming. I tavoli e le sedie sono modelli del gioco base e non richiedono nient’altro.

2. Ordine di avvio

Nel server.cfg, sotto il tuo framework, il tuo inventario e la tua risorsa di target, aggiungi ensure mic_hookah_prop e poi ensure mic_hookah.

Ha funzionato quando entrambi si avviano senza righe rosse sotto di essi.

3. Framework e target

Apri config.lua:

Opzione	Impostalo su	Predefinito
`Config.Framework`	`esx`, `qbcore` o `qbox`	`esx`
`Config.Target`	`ox_target` o `qb-target`	`ox_target`
`Config.ESXResourceName`	Il nome della cartella di ESX, se l’hai rinominata	`es_extended`
`Config.QBResourceName`	Il nome della cartella di QBCore, se l’hai rinominata	`qb-core`
`Config.QBoxResourceName`	Il nome della cartella di QBox, se l’hai rinominata	`qbx_core`
`Config.QBTargetResourceName`	Il nome della cartella di qb-target, se rinominata	`qb-target`

Qui nulla viene rilevato automaticamente: questi valori decidono quale framework e quale target vengono utilizzati.

4. Il database

Nulla per la risorsa: i narghilè e i mobili posizionati risiedono nella memoria del server, non in una tabella. Su ESX con l’inventario predefinito, gli oggetti vanno nella tabella items — passo successivo.

5. Aggiungi gli oggetti

La lista completa si trova in 🎒 Oggetti. In breve:

Oggetto	Cosa fa
`hookah_black`, `hookah_blue`, `hookah_green`, `hookah_grey`, `hookah_orange`, `hookah_pink`, `hookah_purple`, `hookah_red`, `hookah_skyblue`, `hookah_yellow`	Usalo per portare e posizionare quel narghilè
`hookah_table` … `hookah_table5`	Usalo per posizionare un tavolo
`hookah_chair` … `hookah_chair6`	Usalo per posizionare una sedia su cui ci si può sedere
`hookah_coal`	Riempie il carbone dal menu di configurazione
`hookah_water`	Riempie l’acqua dal menu di configurazione
`hookah_<flavour>_flavor`	Sessanta aromi, scelti dal menu di configurazione

Dove si trovano le definizioni pronte, in inventory_items/ dentro mic_hookah:

File	Per	Cosa fare
`esx_items.sql`	ESX con inventario predefinito	Importalo una volta nel tuo database
`ox_items.md`	ox_inventory	Incolla le sue righe in `ox_inventory/data/items.lua`
`qb_items.md`	QBCore / QBox con qb-inventory	Incolla le sue righe in `qb-core/shared/items.lua`

Immagini: le icone si trovano in inventory_images/, un file PNG per ogni oggetto con lo stesso nome. Copiale nella cartella immagini del tuo inventario — ox_inventory/web/images/ oppure qb-inventory/html/images/.

Poi fai puntare Config.InventoryImagePath a quella stessa cartella, così le icone degli aromi appariranno nel menu di configurazione. Di base è impostato su nui://ox_inventory/web/images/; per qb-inventory usa nui://qb-inventory/html/images/.

Ha funzionato quando puoi darti hookah_red ed esso compare nel tuo inventario con la sua immagine.

6. Primo test

Datti hookah_red, hookah_coal, hookah_water e hookah_mint_flavor.

Usa hookah_red. Il tuo personaggio lo tiene su un vassoio. Premi E.
Un’anteprima segue la tua visuale. Ruotala con la rotellina del mouse, alzala o abbassala con le frecce direzionali e premi E per appoggiarla.
Punta il narghilè con il target e scegli Open Setup Menu. Aggiungi carbone, aggiungi acqua, scegli Mint, poi Light Hookah.
Chiudi il menu, punta di nuovo il narghilè con il target e scegli Grab Hose. Premi E.

Ha funzionato quando un tubo collega il narghilè al tuo personaggio e, premendo E, fai un tiro ed esce del fumo verde chiaro. Il carbone e l’acqua nel menu scendono leggermente a ogni tiro.

Prima di aprire la città

Decidi chi può gestire i narghilè. Config.AdminGroups è impostato di base su false, il che permette a ogni giocatore di aprire il menu e raccogliere qualsiasi narghilè o mobile. Impostalo con i tuoi gruppi admin per limitare questa azione al proprietario e allo staff. Vedi Personalizzazione.
Config.InventoryImagePath punta alla cartella delle immagini che usi effettivamente.
Stress: Config.Stress è attivo, ma ReduceStress in server_functions.lua è vuoto finché non ci inserisci la tua chiamata.
Informa i tuoi giocatori che i narghilè e i mobili non vengono salvati: vengono rimossi quando la risorsa o il server si riavvia.