Installazione

Dieci minuti, la maggior parte dei quali passati a incollare le definizioni degli oggetti. La risorsa non ha tabelle proprie né risorse secondarie: i modelli delle vape vengono caricati in streaming dalla propria cartella stream/.

Prima di iniziare

Ti serve	Perché
ESX (`es_extended`), QBCore (`qb-core`) o QBox (`qbx_core`), in esecuzione	Rilevato automaticamente; non c’è alcuna impostazione di framework
Accesso all’elenco oggetti del tuo inventario	Le vape sono oggetti
Accesso alla cartella immagini del tuo inventario	Così ogni vape ha la propria icona

1. Posiziona la cartella

Inserisci mic_vape nelle tue risorse, ad esempio dentro resources/[mic]/. Mantieni il nome della cartella: la barra di progresso comunica con la risorsa usando il suo nome.

I dieci modelli di vape e il relativo def_props.ytyp si trovano in stream/ e vengono caricati dal manifest; non devi spostarli.

2. Avviala dopo il tuo framework

In server.cfg, inserisci ensure mic_vape sotto es_extended, qb-core o qbx_core, e sotto il tuo inventario. QBox viene rilevato tramite la sua compatibilità QBCore — qbx_core fornisce qb-core — quindi non c’è nulla da impostare.

Questo passaggio è più importante del solito: mic_vape cerca un framework avviato nel momento esatto in cui parte. Se parte per primo, non trova nulla, non registra alcun oggetto e non stampa alcun avviso.

Ha funzionato quando mic_vape si avvia senza righe rosse sotto di sé.

3. Il database

Nulla per la risorsa in sé. Su ESX con l’inventario predefinito, gli oggetti vape vanno nella tabella items — questo è il passaggio successivo.

4. Aggiungi gli oggetti

Ogni chiave in Config.Vapes (in config.lua) è il nome di un oggetto, e ognuna viene registrata come utilizzabile. L’elenco completo con ciò che fa ciascuna si trova in 🎒 Oggetti. In breve:

Gruppo	Oggetti
Normale	`vape`
Vape con poteri	`invisibility_vape`, `speed_vape`, `superjump_vape`, `teleport_vape`, `invincibility_vape`, `health_vape`, `armor_vape`, `carspeed_vape`, `random_vape`
Gusti	`vape_watermelon`, `vape_mango`, `vape_blueberry` … quaranta in tutto, ciascuno chiamato `vape_<flavour>`

Dove si trovano le definizioni già pronte, nella cartella inventory_items/ della risorsa:

File	Per	Cosa fare
`esx_sql_items.sql`	ESX con il suo inventario base	Importalo una volta nel tuo database
`ox_inventory_items.md`	ox_inventory	Incolla le sue righe dentro `ox_inventory/data/items.lua`
`qb_items.md`	QBCore	Incolla le sue righe dentro `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/ o qb-inventory/html/images/. Tre oggetti degli elenchi sopra non hanno icona (transform_vape, freeze_vape, gravity_vape) e nemmeno vape_grape; assegnagliene una tua se decidi di usarlo.

Ha funzionato quando puoi darti vape_watermelon e compare nel tuo inventario con la sua immagine.

5. Primo test

Datti vape e usala dall’inventario.

Ha funzionato quando una vape nera appare nella mano del tuo personaggio. Premi E: il tuo personaggio la solleva e un istante dopo esce del fumo bianco. Usa di nuovo l’oggetto, oppure digita /vape, e viene riposta.

Poi prova speed_vape: dopo un tiro scatti sensibilmente più veloce per quindici secondi.

Prima di aprire la tua città

mic_vape si avvia dopo il tuo framework in server.cfg.
Stress: Config.Stress è attivo e, di base, stampa solo una riga nella console del server a ogni tiro. Inserisci la tua logica dello stress in bridge/server_bridge.lua oppure imposta Config.Stress = false. Vedi Personalizzazione.
Le notifiche sono disattivate per impostazione predefinita (Config.ShowNotifications = false). Attivale se vuoi che i giocatori vedano i messaggi “in recupero”, “vape scarica” e quelli dei poteri.
Decidi cosa fare con le vape con poteri. Invisibilità, invincibilità e teletrasporto sono potenti. Assegna loro un prezzo, un negozio o un lavoro prima che finiscano nelle tasche di qualcuno.