Installazione

Cinque minuti. Nessun file SQL, nessuna impostazione per il framework — solo un permesso e un riavvio.

Prima di iniziare

Ti serve	Perché
ESX, QBCore o QBox	Oggetti utilizzabili, lavori, notifiche e status provengono dal framework
oxmysql	Le configurazioni degli oggetti vengono salvate in una tabella chiamata `mic_itemcreator`
Un inventario che gestisca gli oggetti utilizzabili del framework	È così che l’utilizzo dell’oggetto raggiunge questa risorsa
ox_lib, ox_target / qb-target, screenshot-basic	Opzionali; vedi Personalizzazione

1. Posiziona la cartella

Scarica mic_itemcreator dai tuoi asset concessi su Cfx.re e inserisci la cartella nelle tue risorse, ad esempio resources/[mic]/mic_itemcreator.

2. Avvialo dopo le risorse da cui dipende

Nel server.cfg, ensure mic_itemcreator va messo sotto oxmysql, il tuo framework (es_extended, qb-core o qbx_core) e il tuo inventario.

Il framework viene individuato cercando una risorsa es_extended o qb-core già avviata, quindi l’ordine è importante: se lo avvii troppo presto non ne troverà nessuno. QBox viene rilevato tramite la sua compatibilità QBCore — qbx_core fornisce qb-core — quindi non c’è nulla da impostare.

3. Il database — nulla da fare

Al primo avvio la risorsa crea la tabella mic_itemcreator (una riga per ogni oggetto configurato) e aggiunge eventuali colonne mancanti dalle versioni precedenti. Non c’è alcun file SQL da importare.

Ha funzionato quando la tabella mic_itemcreator è presente nel tuo database dopo il primo avvio.

4. Oggetti

Item Creator non aggiunge oggetti al tuo inventario — dà qualcosa da fare agli oggetti che hai già. Ogni oggetto che configuri deve prima esistere nel tuo inventario.

Non vengono forniti file di definizioni oggetti o immagini. Per i nuovi oggetti, il Registry Tool del menu scrive la definizione per te: scegli OX, QBCORE o ESX SQL, compila i campi e copia il risultato in ox_inventory/data/items.lua, qb-core/shared/items.lua o nella tua tabella items di ESX. Le immagini vanno nella cartella immagini del tuo inventario, nominate come l’oggetto.

Il menu è protetto dal permesso ACE mic_itemcreator.open. Concedilo nel server.cfg con una riga add_ace — a una singola persona, ad esempio add_ace identifier.discord:YOUR_DISCORD_ID mic_itemcreator.open allow, oppure a un gruppo, ad esempio add_ace group.admin mic_itemcreator.open allow.

Il permesso viene controllato quando entri nel server. L’hai aggiunto mentre eri già connesso? Riconnettiti.

Ha funzionato quando /itemcreator apre il menu sulla dashboard. Senza il permesso riceverai la notifica di “nessun permesso”.

6. Primo test

/itemcreator → Usable Items, e scegli un oggetto esistente nel tuo inventario, ad esempio water.
Aggiungi una funzionalità Notification con un messaggio e una funzionalità Food/Thirst con un po’ di sete.
Apri le impostazioni dell’oggetto, attiva Remove on Use con 1 e salva.
Datti l’oggetto (il menu ha un pulsante apposito, uno alla volta) e usalo dal tuo inventario.

Ha funzionato quando compare la notifica, la tua sete sale e un’unità dell’oggetto viene rimossa.

Prima di aprire la città

Solo le persone giuste hanno mic_itemcreator.open. Questo permesso consente di far fare qualsiasi cosa a qualsiasi oggetto, incluso generare auto, eseguire comandi e dare superpoteri.
Ogni oggetto configurato esiste nel tuo inventario, con lo stesso identico nome.
Controlla che Config.ImageInventoryPath punti alla cartella immagini del tuo inventario, altrimenti il menu non mostrerà le icone.
Informa i tuoi giocatori del tasto di annullamento — X di base — che interrompe animazioni, scenari, stili di camminata, velocità, superpoteri e prop avviati da un oggetto.