Installazione

Circa cinque minuti e un riavvio completo del server alla fine. L’unico passaggio che spesso si sbaglia è l’ordine delle righe nel server.cfg — leggi due volte il passaggio 3.

Prima di iniziare

Ti serve	Perché
oxmysql, in esecuzione	Design, oggetti e completi vengono salvati nel database
ox_lib	Callback e notifiche dello studio
ESX, QBCore o QBox (opzionale)	Solo per gli oggetti indossabili. Senza, lo studio funziona in modalità standalone
ox_inventory (opzionale)	Preferito per gli oggetti quando è attivo
Una chiave API Gemini (opzionale)	Solo per il generatore IA — gratuita su aistudio.google.com/apikey
Un token Fivemanage (opzionale)	Ospita le foto dei design e degli oggetti — gratuito su fivemanage.com

1. Posiziona entrambe le cartelle

Il pacchetto contiene due risorse. Inseriscile entrambe, una accanto all’altra, nella tua cartella resources — ad esempio resources/[mic]/mic_cloth_designer e resources/[mic]/mic_cloth_addons.

2. Il database — nulla da fare

Le tabelle si creano automaticamente al primo avvio: mic_cloth_designs e mic_cloth_imported per i design, mic_cloth_items per oggetti e completi.

mic_cloth_designs.sql è incluso nella radice di mic_cloth_designer per chi preferisce creare le prime due manualmente. Non ne hai bisogno.

3. server.cfg — l’ordine è importante

Due gruppi separati di righe, in due posizioni diverse.

Verso l’inizio del server.cfg, sopra ogni ensure:

assegna alla risorsa mic_cloth_designer i permessi ACE command.refresh, command.ensure, command.start e command.stop (quattro righe add_ace resource.mic_cloth_designer … allow) — lo studio riavvia autonomamente mic_cloth_addons dopo l’esportazione di un capo;
aggiungi il permesso del filesystem che consente a mic_cloth_designer di scrivere in mic_cloth_addons (add_filesystem_permission mic_cloth_designer write mic_cloth_addons);
assegna a chi dovrà usare lo studio il permesso ACE mic_clothdesigner — ad esempio a group.admin, o all’identifier.discord:… di una singola persona.

Più in basso, insieme alle altre risorse: ensure oxmysql, poi ox_lib, poi mic_cloth_addons, poi mic_cloth_designer. Anche un ensure [mic] che le comprenda entrambe funziona, purché si trovi dopo il blocco sopra indicato.

Vuoi solo provarlo? Imposta Config.OpenPermission = false in shared/config.lua e chiunque potrà aprire lo studio — il permesso di scrittura resta comunque necessario.

4. Le tue chiavi

Apri mic_cloth_designer/shared/keys.lua. È un file solo lato server: nulla al suo interno viene mai inviato ai giocatori. Compila ciò che usi e lascia il resto come virgolette vuote.

Chiave	Cosa fa	Necessaria
`GeminiAPIKey`	Il generatore di texture IA	Solo per l’IA. Vuoto = lo strumento IA è disattivato
`FivemanageToken`	Ospita le foto dei design e degli oggetti	Consigliato. Vuoto = le foto vengono salvate nel database
`DiscordWebhook`	Registra ogni generazione IA con il relativo costo stimato	Opzionale
`ClothNetworkKey`	Lascia vuoto. La Cloth Network funziona anche senza	No

5. Oggetti

Un unico oggetto generico trasporta qualsiasi design: cloth_design (il nome è Config.Items.Name in shared/config.lua).

Oggetto	Cosa fa
`cloth_design`	Fa indossare il design salvato al suo interno; usalo di nuovo per rimettere ciò che indossavi

Le definizioni si trovano in mic_cloth_designer/items/:

File	Per
`items/ox.lua`	ox_inventory — va in `ox_inventory/data/items.lua`
`items/qb.lua`	QBCore — va in `qb-core/shared/items.lua`

Non è inclusa alcuna immagine: ogni oggetto mostra il render del proprio design su ox_inventory. Su QBCore, inserisci un file cloth_design.png in qb-inventory/html/images/ se desideri un’icona predefinita. Su ESX senza ox_inventory, aggiungi un oggetto chiamato cloth_design ai tuoi oggetti come faresti per qualsiasi altro.

I design che vendi nei negozi ricevono un nome oggetto dedicato in seguito — vedi 🎒 Oggetti.

6. Framework

Non c’è nulla da cambiare manualmente. Il bridge degli oggetti rileva da solo qb-core o es_extended e utilizza ox_inventory quando è attivo. Imposta Config.Framework in shared/config.lua su 'qb' o 'esx' in base al tuo server.

Su QBox, il bridge lo rileva tramite la compatibilità QBCore — qbx_core fornisce qb-core — e Config.Framework rimane su 'qb': QBox esegue le risorse QBCore attraverso il suo livello di compatibilità.

Funziona anche in modalità standalone. Senza framework, lo studio, l’anteprima 3D, il generatore IA e la Cloth Network funzionano regolarmente; serve solo il permesso ACE per aprirlo. Lascia Config.Framework su 'qb'. Gli oggetti indossabili sono l’unica parte che richiede ESX, QBCore o QBox.

7. Riavvio completo, poi il primo design

Riavvia l’intero server, non solo la risorsa: GTA legge i dati dei vestiti all’avvio del server.

In gioco, digita /clothdesigner.
Scegli un capo dalla Libreria, dipingi qualcosa e premi Save.

Ha funzionato quando lo studio si apre con la Libreria, l’anteprima 3D e l’editor affiancati, Save risponde Saved, e il tuo personaggio indossa il capo con il tuo design.

Per indossarlo di nuovo in seguito, trasformalo in un oggetto — vedi 🎒 Oggetti.

Prima di aprire la tua città

Disattiva Config.Debug in shared/config.lua. Viene fornito attivo e stampa ogni passaggio nella console.
Decidi per Config.GlobalContent. Se attivo (predefinito), chiunque abbia accesso allo studio vede e modifica tutti i design, gli oggetti e i completi.
Mantieni privato shared/keys.lua. Contiene la tua chiave Gemini, il tuo token Fivemanage e il tuo webhook. Svuotalo prima di passare i file a chiunque.
Controlla chi possiede mic_clothdesigner. Con una chiave Gemini impostata, ogni generazione IA viene addebitata a te.