Configurer CXG-GTFAT

Modifiez config.lua, puis redémarrez CXG_GTFAT. Les valeurs de poids sont définies en kilogrammes et doivent respecter la grille du pas configuré.

Langue et poids

Code

Config.Locale = 'fr'

Config.Weight = {
    minKg = 50,
    maxKg = 180,
    defaultKg = 75,
    fatThresholdKg = 100,
    stepKg = 0.5,
}

Langues disponibles : en, es, pt-BR, fr, de, it, pl, ru, tr, th, ar, sv et br. br conserve les anciens textes en portugais brésilien ; pt-BR est recommandé pour un usage normal.

La plage initiale va de 50 à 180 kg, la valeur par défaut est 75 kg et Fat s’active à partir de 100 kg inclus. minKg doit être supérieur ou égal à zéro ; stepKg doit être positif ; et minKg <= defaultKg <= maxKg. Le seuil doit dépasser le minimum et ne pas dépasser le maximum. La valeur par défaut, le seuil et le maximum doivent appartenir à la grille commençant à minKg ; par exemple, avec un minimum de 50 kg et un pas de 0,5 kg, 75 et 100 kg sont valides. Une configuration invalide désactive les opérations de poids.

L’unité LB ne convertit que l’affichage. Le serveur stocke et valide les valeurs en kg.

Commandes et permissions

Code

Config.Commands = {
    enabled = true,
    access = 'ace',
    ace = 'cxg_gtfat.use',
    job = nil,
    group = nil,
    custom = nil,
    open = 'fatweight',
    control = 'fatdecal',
}

Lorsque les commandes sont activées, celles définies dans la configuration sont enregistrées. La commande d’ouverture par défaut est /fatweight et la commande de contrôle est /fatdecal. Le contrôle accepte on, off, status ou ui. on règle le poids au moins au seuil Fat ; off le règle au maximum un pas en dessous. Ce ne sont pas des interrupteurs visuels indépendants.

access	Comportement
ace	Exige la permission `ACE` définie par ace. C’est la valeur par défaut.
everyone	Autorise tout joueur qui passe les contrôles du serveur.
jobs, groups, custom	Nécessite l’implémentation d’une politique dans `bridge/server.lua` ; la connexion au framework n’est pas automatique.

Pour accorder l’accès ACE aux administrateurs :

Code

add_ace group.admin cxg_gtfat.use allow

Un menu ou un target peut demander l’ouverture de l’interface, mais le serveur vérifie toujours l’autorisation. Désactiver l’enregistrement des commandes n’empêche pas une autre ressource serveur d’appeler l’export OpenWeightUI.

Stations

Aucune balance physique n’est activée à l’installation. Ajoutez une entrée de station à Config.Stations, utilisez une clé unique, saisissez les coordonnées réelles et activez-la.

Code

Config.Interaction = {
    key = 'E',
    streamDistance = 60.0,
}

Config.Stations = {
    gimnasio = {
        enabled = true,
        coords = { x = 0.0, y = 0.0, z = 0.0 },
        heading = 0.0,
        distance = 1.8,
        bucket = 0,
        access = 'ace',
        ace = 'cxg_gtfat.use',
        job = nil,
        group = nil,
        custom = nil,
        model = false,
        spawnProp = false,
    },
}

Remplacez les coordonnées d’exemple. La distance est limitée à 5 mètres. bucket doit correspondre au routing bucket de la station ; sa valeur est généralement 0. Chaque station a sa propre politique access.

Mode	Paramètres	Résultat
Point sans objet	model = false, `spawnProp` = false	Interaction invisible aux coordonnées configurées.
Objet existant	model = 'nom_du_modèle', `spawnProp` = false	Nécessite un modèle correspondant à moins d’un mètre des coordonnées. La ressource ne le supprime pas.
Objet créé localement	model = 'nom_du_modèle', `spawnProp` = true	Crée un objet local figé à proximité et le retire lorsque vous partez ou arrêtez la ressource.

Le point d’interaction ne pose pas automatiquement l’objet au sol. Définissez coords sur l’origine réelle de l’objet et heading sur son orientation. L’invite utilise E par défaut ; le joueur peut réattribuer « Utiliser la balance » dans Paramètres FiveM > Attributions des touches.

L’adaptateur par défaut autorise ace et everyone. Les autres modes nécessitent une implémentation serveur. Afficher une invite ou un objet ne donne aucun droit ; le serveur revérifie l’accès et la proximité.

Persistance par personnage

Code

Config.Persistence = { framework = 'none' }

Mode	Utilisation
none	Valeur par défaut. Session uniquement ; une reconnexion ou un redémarrage utilise `defaultKg`.
qb	Résout le personnage via qb-core et son citizenid.
esx	Résout le personnage via es_extended et son identifiant.
custom	Utilise `GTFatCustomCharacterId(source)` dans `identity.lua`.

La ressource ne détecte pas Qbox automatiquement. Pour les serveurs à personnages multiples, configurez un identifiant stable et unique pour chaque personnage via une option compatible ou votre propre adaptateur. Ne partagez pas un identifiant entre personnages et n’acceptez pas une identité envoyée par le client. En mode custom, renvoyez nil tant que le personnage n’est pas chargé.

Le poids persistant est stocké séparément des vêtements et des tenues. Conservez le nom de ressource CXG_GTFAT et sauvegardez le stockage KVP du serveur avec ses autres données persistantes.