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

Copiez le dossier de la ressource dans les ressources du serveur sous le nom CXG_GTFAT.
Supprimez les anciennes ressources CXG Fat/Luxe et ne démarrez pas deux sélecteurs ou paquets alternatifs pour les mêmes vêtements.
Vérifiez que OneSync est activé dans la configuration du serveur.
Ajoutez ceci à server.cfg :
Code
```
ensure `CXG_GTFAT`
```
Démarrez ou redémarrez le serveur. Si vous modifiez les fichiers de configuration, redémarrez la ressource :
Code
```
restart `CXG_GTFAT`
```
Avec le mode d’accès par défaut, accordez l’autorisation ACE cxg_gtfat.use au groupe ou principal concerné. Par exemple :
Code
```
add_ace group.admin `cxg_gtfat.use` allow
```
Pour utiliser un groupe personnalisé, associez des identifiants réels :
Code
```
add_ace group.fat_scale `cxg_gtfat.use` allow
add_principal identifier.license:TU_IDENTIFICADOR_REAL group.fat_scale
```
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.

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.