Installare CXG-GTFAT

Installare la risorsa con il nome esatto CXG_GTFAT, attivare OneSync e aggiungerla all’ordine di avvio del server. Un framework serve solo se si sceglie un’opzione di persistenza che ne dipende.

Requisiti

FiveM con OneSync attivo.
Nome della cartella e della risorsa: CXG_GTFAT.
Nessun vecchio selettore CXG Fat/Luxe o altro pacchetto alternativo di metadati deve gestire gli stessi abiti.

La modalità predefinita non richiede QB, ESX né librerie esterne per interfaccia o lingue. Per la persistenza qb o esx, installare e avviare il framework scelto. Per la modalità custom, implementare la risoluzione dell’identità; l’archiviazione KVP integrata continuerà a funzionare. È possibile sostituirla con un proprio provider di archiviazione.

Procedura d’installazione

Copiare la cartella della risorsa tra le risorse del server con il nome CXG_GTFAT.
Rimuovere le vecchie risorse CXG Fat/Luxe e non avviare due selettori o pacchetti alternativi per gli stessi abiti.
Verificare che OneSync sia attivo nella configurazione del server.
Aggiungere a server.cfg:
Codice
```
ensure `CXG_GTFAT`
```
Avviare o riavviare il server. Se si modificano file di configurazione, riavviare la risorsa:
Codice
```
restart `CXG_GTFAT`
```
Con l’accesso predefinito, concedere il permesso ACE cxg_gtfat.use al gruppo o principal interessato. Per esempio:
Codice
```
add_ace group.admin `cxg_gtfat.use` allow
```
Per un gruppo personalizzato, associare identificatori reali:
Codice
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
```
Connettere un giocatore freemode autorizzato e usare /fatweight. Provare un valore inferiore e poi uno pari o superiore alla soglia configurata per verificare il passaggio Normal/Fat.

Sostituire TU_IDENTIFICADOR_REAL con un identificatore valido del server. La risorsa non crea automaticamente permessi né principal.

Primo utilizzo

Con i valori predefiniti, /fatweight apre la bilancia per impostare un peso tra 50 e 180 kg. La soglia Fat è 100 kg inclusi. /fatdecal ui apre la stessa interfaccia; /fatdecal status controlla lo stato, mentre on e off modificano il peso per attraversare la soglia. Consultare Interfaccia.

Chiudere la bilancia con Esc o con il pulsante X. Chiudere la finestra non annulla il peso applicato né disattiva Fat.

Problemi comuni

Sintomo	Controlli
La risorsa non si avvia	Controllare il nome esatto `CXG_GTFAT`, che `OneSync` sia attivo e che non ci siano errori Lua durante il caricamento della configurazione.
Il comando segnala accesso negato	Con l’accesso `ACE` predefinito, concedere `cxg_gtfat.use`. Se si è passati a jobs, groups o custom, implementare la policy in `bridge/server.lua`.
Non compare alcuna stazione	Le stazioni sono disattivate per impostazione predefinita. Attivare e configurare una voce in `Config.Stations`, oppure usare `/fatweight`.
Il peso si azzera alla riconnessione	È previsto con framework = 'none', che salva solo per la sessione. Se serve, configurare la persistenza per personaggio.
Gli abiti non cambiano	Verificare che il personaggio usi uno dei due modelli freemode, che l’abito sia coperto e che un’altra risorsa non gestisca contemporaneamente lo stesso decal.
Un menu salva un decal tecnico	Applicare manualmente la patch per la versione del menu oppure integrare `SanitizeAppearance` nel punto di salvataggio.
Gli effetti restano dopo una modifica ai metadati o la rimozione della risorsa	Arrestare i selettori duplicati, rimuovere il pacchetto alternativo di metadati ormai superfluo e riavviare completamente server e client per caricare i metadati aggiornati.