# 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

1. Copiare la cartella della risorsa tra le risorse del server con il nome `CXG_GTFAT`.
2. Rimuovere le vecchie risorse CXG Fat/Luxe e non avviare due selettori o pacchetti alternativi per gli stessi abiti.
3. Verificare che `OneSync` sia attivo nella configurazione del server.
4. Aggiungere a `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Avviare o riavviare il server. Se si modificano file di configurazione, riavviare la risorsa:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. Con l’accesso predefinito, concedere il permesso `ACE` `cxg_gtfat.use` al gruppo o principal interessato. Per esempio:

   ```cfg
   add_ace group.admin `cxg_gtfat.use` allow
   ```

   Per un gruppo personalizzato, associare identificatori reali:

   ```cfg
   add_ace group.fat_scale `cxg_gtfat.use` allow
   add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
   ```

7. 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](https://docs.cxgstudios.com/docs/it/02-cxg-gtfat/06-interfaz.md).

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. |