Installazione

Nota

💬 Hai bisogno di aiuto? Supporto, aggiornamenti e changelog sono sul Discord di Mic Scripts. Apri un ticket con il tuo ID transazione Tebex e l’errore della console.

Cinque minuti, per lo più dedicati ad aggiungere gli oggetti al tuo inventario.

---

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox, in esecuzione	I quattro oggetti utilizzabili sono registrati tramite il tuo framework
Un inventario che possa contenere cinque nuovi oggetti	ox_inventory, qb-inventory o l’inventario predefinito di ESX funzionano tutti

---

1. Posiziona la cartella

Inserisci mic_carbomb nelle tue risorse, ad esempio dentro resources/[mic]/. Non c’è alcuna risorsa di prop da abbinare.

---

2. Avvialo dopo il tuo framework

In server.cfg, metti ensure mic_carbomb sotto il tuo framework (es_extended, qb-core o qbx_core) e il tuo inventario.

Ha funzionato quando la console del server non mostra alcuna riga rossa da mic_carbomb all’avvio. Quella che non vuoi vedere è “Invalid framework specified in config.lua. Use ‘esx’ or ‘qbcore’.”

---

3. Il database — nulla di proprio

mic_carbomb mantiene le bombe piazzate nella memoria del server, non nel database. L’unico passaggio relativo al database riguarda le righe degli oggetti ESX al passaggio 4, e solo se usi l’inventario predefinito di ESX.

---

4. Aggiungi gli oggetti

Oggetto	Cosa fa
car_bomb	Usalo per tenere una bomba in mano, poi premi E vicino a un veicolo per piazzarla
phone_detonator	Apre il telefono detonatore: le tue bombe, detona subito o con un timer
bomb_detector	Estrae lo scanner; usalo di nuovo per riporlo
bomb_defuser	Estrae la cassetta degli attrezzi; premi E vicino a un veicolo con bomba per disinnescare
defused_bomb	Non utilizzabile. Restituito dopo un disinnesco quando Config.ReturnDefusedBomb è attivo

Le definizioni pronte all’uso si trovano in inventory_items/, e le icone in inventory_images/:

Inventario	Definizioni (mic_carbomb/inventory_items/)	Dove vanno	Icone
ox_inventory	ox_inventory.md	ox_inventory/data/items.lua	Copia inventory_images/*.png in ox_inventory/web/images/
QBCore / qb-inventory	qb_inventory.md	qb-core/shared/items.lua	Copiale in qb-inventory/html/images/
Inventario ESX predef.	esx_sql_items.md	Esegui l’istruzione SQL una volta sul database	—

Attenzione

QBCore: nelle voci fornite il campo name contiene l’etichetta (Car Bomb, Phone Detonator…). Cambia ogni name con la sua chiave — car_bomb, phone_detonator, bomb_detector, bomb_defuser, defused_bomb. QBCore trova gli oggetti utilizzabili tramite quel nome e, lasciando l’etichetta, gli oggetti non fanno nulla quando vengono usati.

Ha funzionato quando ti dai uno di ciascuno e tutti e cinque compaiono nel tuo inventario con la rispettiva icona.

---

5. Imposta il tuo framework

Apri config.lua e imposta Config.Framework su esx (il predefinito) o qbcore. Non c’è rilevamento automatico. Su QBox, scegli qbcore: QBox esegue le risorse QBCore attraverso il suo livello di compatibilità.

Già che ci sei: Config.WebhookEnabled è attivo di base con un URL segnaposto. Incolla il tuo webhook Discord in Config.WebhookURL, oppure imposta WebhookEnabled su false.

---

6. Primo test

1. Spawna un veicolo e scendi.
2. Usa car_bomb. Una bomba appare nella tua mano. Avvicinati al veicolo (entro 2 m) e premi E. L’animazione di piazzamento dura due secondi e la bomba scompare dalla tua mano.
3. Usa bomb_detector e guarda il veicolo. Emette un bip e un blip rosso appare sul veicolo.
4. Usa di nuovo bomb_detector per riporlo. Allontanati dal veicolo, ma tienilo in vista — il detonatore può far esplodere solo un veicolo caricato intorno a te.
5. Usa phone_detonator. Il telefono elenca il modello e la targa del veicolo. Premi il tasto verde.

Ha funzionato quando il veicolo esplode e scompare dall’elenco del telefono.

Per testare il disinnesco, piazza una seconda bomba, usa bomb_defuser, posizionati accanto al veicolo e premi E. Ha funzionato quando l’animazione di riparazione termina, il bip si ferma e ti viene restituita una car_bomb.

---

Prima di aprire la tua città

• Config.Framework corrisponde al framework che usi effettivamente (qbcore su QBox).
• QBCore: il campo name di ogni oggetto corrisponde alla sua chiave.
• Il webhook contiene un URL reale oppure è disattivato.
• config.lua viene inviato a ogni giocatore (è uno script condiviso). Chiunque frughi nei propri file client può leggere l’URL del webhook. Usa un webhook per un canale in cui non ti importa ricevere spam, oppure lascialo disattivato.
• Decidi il consumo degli oggetti. Di base il piazzamento non consuma la bomba (Config.RemoveItem è disattivato), quindi una sola car_bomb permette al giocatore di piazzare quante bombe vuole.