# Installer CXG-GTFAT

Installez la ressource sous le nom exact `CXG_GTFAT`, activez `OneSync` et ajoutez-la à l’ordre de démarrage du serveur. Un framework est requis uniquement si vous choisissez une option de persistance qui en dépend.

## Prérequis

- FiveM avec `OneSync` activé.
- Nom du dossier et de la ressource : `CXG_GTFAT`.
- Aucun ancien sélecteur CXG Fat/Luxe ni autre paquet de métadonnées alternatif ne doit gérer les mêmes vêtements.

Le mode par défaut ne nécessite ni QB, ni ESX, ni bibliothèque externe d’interface ou de langue. Si vous configurez la persistance qb ou esx, installez et démarrez le framework choisi. Pour une persistance custom, implémentez la résolution de l’identité ; le stockage `KVP` intégré continue de fonctionner. Vous pouvez le remplacer par votre propre fournisseur de stockage.

## Étapes d’installation

1. Copiez le dossier de la ressource dans les ressources du serveur sous le nom `CXG_GTFAT`.
2. Supprimez les anciennes ressources CXG Fat/Luxe et ne démarrez pas deux sélecteurs ou paquets alternatifs pour les mêmes vêtements.
3. Vérifiez que `OneSync` est activé dans la configuration du serveur.
4. Ajoutez ceci à `server.cfg` :

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Démarrez ou redémarrez le serveur. Si vous modifiez les fichiers de configuration, redémarrez la ressource :

   ```cfg
   restart `CXG_GTFAT`
   ```

6. Avec le mode d’accès par défaut, accordez l’autorisation `ACE` `cxg_gtfat.use` au groupe ou principal concerné. Par exemple :

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

   Pour utiliser un groupe personnalisé, associez des identifiants réels :

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

7. Connectez un joueur freemode autorisé et utilisez `/fatweight`. Essayez une valeur inférieure puis une valeur égale ou supérieure au seuil configuré pour vérifier le passage de Normal à Fat.

Remplacez TU_IDENTIFICADOR_REAL par un identifiant valide de votre serveur. La ressource ne crée automatiquement ni permissions ni principals.

## Première utilisation

Avec les valeurs par défaut, `/fatweight` ouvre la balance pour définir un poids de 50 à 180 kg. Le seuil Fat est de 100 kg inclus. `/fatdecal ui` ouvre la même interface ; `/fatdecal status` consulte l’état, tandis que on et off modifient le poids pour franchir le seuil. Consultez [Interface](https://docs.cxgstudios.com/docs/fr/02-cxg-gtfat/06-interfaz.md).

Fermez la balance avec Échap ou le bouton X. Fermer la fenêtre n’annule pas le poids appliqué et ne désactive pas Fat.

## Problèmes courants

| Symptôme | Vérifications |
| --- | --- |
| La ressource ne démarre pas | Vérifiez le nom exact `CXG_GTFAT`, l’activation de `OneSync` et l’absence d’erreurs Lua lors du chargement de la configuration. |
| La commande indique un accès refusé | Avec l’accès `ACE` par défaut, accordez `cxg_gtfat.use`. Si vous avez choisi jobs, groups ou custom, implémentez la politique dans `bridge/server.lua`. |
| Aucune station n’apparaît | Les stations sont désactivées par défaut. Activez et configurez une entrée de `Config.Stations`, ou utilisez `/fatweight`. |
| Le poids est réinitialisé après reconnexion | C’est normal avec framework = 'none', qui ne sauvegarde que pendant la session. Configurez la persistance par personnage si nécessaire. |
| Les vêtements ne changent pas | Vérifiez que le personnage utilise l’un des deux modèles freemode, que le vêtement est pris en charge et qu’aucune autre ressource ne gère le même decal simultanément. |
| Un menu sauvegarde un decal technique | Appliquez manuellement le correctif correspondant à la version du menu ou intégrez `SanitizeAppearance` à son point de sauvegarde. |
| Les effets persistent après un changement de métadonnées ou la suppression de la ressource | Arrêtez les sélecteurs en double, retirez le paquet de métadonnées alternatif devenu inutile, puis redémarrez complètement serveur et client pour charger les métadonnées actuelles. |