Risoluzione dei Problemi

I problemi che si incontrano davvero, più o meno nell’ordine in cui si presentano.

Una modifica alla risorsa non ha avuto effetto

restart non rilegge fxmanifest.lua. Se hai aggiunto un file — ad esempio una nuova lingua — digita prima refresh nella console, poi riavvia. Inoltre, tutto ciò che riguarda i capi di abbigliamento richiede un riavvio completo del server, non solo della risorsa: GTA registra i vestiti solo all’avvio del server.

`/clothdesigner` dice che non ho il permesso

Ti manca il permesso ACE indicato in Config.OpenPermission (mic_clothdesigner). Concedilo nel server.cfg al tuo gruppo o al tuo identificatore. Per escludere problemi di permessi durante i test, imposta Config.OpenPermission = false.

“mic_cloth_addons no accesible aún” nella console

Lo studio non riesce a scrivere in mic_cloth_addons. Le cause possono essere:

manca il permesso di scrittura sul filesystem da mic_cloth_designer a mic_cloth_addons;
è presente, ma si trova sotto le righe ensure — deve trovarsi prima dell’avvio delle risorse;
mic_cloth_addons non è avviato, oppure si avvia dopo il designer;
una cartella è stata rinominata, o la riga author è stata modificata in uno dei due file fxmanifest.lua.

Correggi il problema, poi riavvia l’intero server. Vedi il passaggio 3 di 🪛 Installazione.

Lo studio si apre ma la Libreria è vuota, oppure le miniature non si caricano mai

Nella maggior parte dei casi la causa è la stessa indicata sopra: mic_cloth_addons non è in esecuzione, oppure il designer non riesce a leggerlo. Verifica che venga avviato prima di mic_cloth_designer. La prima volta che si apre la Libreria, le miniature vengono renderizzate e salvate nella cache in html/previews/, quindi il primo caricamento è più lento dei successivi.

Ho premuto Replace ma il mio personaggio mostra ancora il vecchio design

È normale. Il gioco mantiene in cache sul client la texture di un capo indossato; un Replace diventa visibile dopo che ti riconnetti. Save (una nuova texture) si vede invece immediatamente.

“Slot limit reached for this garment”

Ogni capo ha un numero limitato di slot per le texture. Riavvia la risorsa affinché possa compattarli, elimina i design che non ti servono più oppure lavora su un capo diverso.

Un capo importato non compare nella Libreria

Richiede un riavvio del server dopo l’importazione — a volte due: il primo avvio lo importa, quello successivo lo registra.
Il nome del file deve iniziare con un prefisso di componente (jbib, lowr, feet, …) e trovarsi in import/male/ o import/female/, a meno che il nome non inizi già con mp_m_ o mp_f_.
Esegui importaddons nella console del server: le righe che iniziano con ! indicano i capi rifiutati, con il relativo motivo.

Un capo importato è invisibile o fa andare in crash il gioco

Quasi sempre dipende dalla variante sbagliata: _r per la maggior parte dei pantaloni, _u per quasi tutto il resto. Scambiala e importa di nuovo. Un capo troppo pesante — oltre 6 MB decompresso o con una texture incorporata superiore a circa 3 MB — viene rifiutato durante l’importazione proprio per questo motivo. Se uno è già in streaming e fa crashare i client, rimuovilo da mic_cloth_addons/stream/.

L’IA non genera nulla

Lo studio indica il motivo; la console del server mostra la risposta del provider accanto a un codice:

Codice	Cosa significa
`AI_NO_KEY`	Nessuna `GeminiAPIKey` in `shared/keys.lua`, oppure la chiave è stata rifiutata
`AI_DISABLED`	`Config.AI.Enabled` è disattivato in `shared/keys.lua`
`AI_QUOTA`	Il tuo account Google AI ha esaurito la quota o richiede l’attivazione della fatturazione
`AI_RATELIMIT`	Troppe richieste — attendi qualche secondo
`AI_BUSY`	Hai già una generazione in corso
`AI_EMPTY_PROMPT`	Non è stato scritto nulla
`AI_BAD_RESPONSE`, `AI_PROVIDER_FAILED`	Il provider ha risposto con dati non utilizzabili; la riga nella console spiega cosa

Se il risultato lascia delle chiazze bianche, Fill white gaps le riempie con il colore principale del design.

Mancano le foto, oppure il database cresce rapidamente

Senza un FivemanageToken in shared/keys.lua, ogni foto dei design viene salvata dentro il database e gli oggetti di ox_inventory non possono mostrare il design come immagine. Aggiungi un token Fivemanage.

Usare l’oggetto non fa nulla

cloth_design è presente nel file degli oggetti del tuo inventario, con lo stesso nome impostato in Config.Items.Name?
Il server utilizza ESX, QBCore o QBox? Gli oggetti vengono registrati tramite il framework; senza un framework gli oggetti non sono supportati. Su QBox, qbx_core deve avviarsi prima di mic_cloth_designer affinché il bridge lo rilevi tramite la compatibilità QBCore.
Per un oggetto da negozio: hai premuto Save name e il nome nel file degli oggetti corrisponde esattamente?
Hai riavviato l’inventario dopo aver aggiunto l’oggetto?

Un design indossato scompare dopo la riconnessione

È normale. Indossare un oggetto dura per la sessione; non viene salvato nell’aspetto permanente del personaggio. Usa di nuovo l’oggetto.

Un design scaricato dalla rete non viene applicato

I design che richiedono un modello di capo non ancora presente sul tuo server scaricano prima il modello. Riavvia il server, poi importa nuovamente il design per completare.

È tutto in inglese

Config.Locale in shared/config.lua seleziona la lingua (en, es, fr, de, it, pt, pl, ru, tr, nl, cs). Riavvia dopo averla modificata.

La console è piena di righe `[ClothDesigner]`

Config.Debug viene fornito attivo. Impostalo su false in shared/config.lua.