Configurare CXG-GTFAT

Modificare config.lua e riavviare CXG_GTFAT. I valori di peso sono espressi in chilogrammi e devono rispettare la griglia dell’incremento configurato.

Lingua e peso

Codice

Config.Locale = 'it'

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

Lingue disponibili: en, es, pt-BR, fr, de, it, pl, ru, tr, th, ar, sv e br. br conserva i vecchi testi in portoghese brasiliano; per la selezione normale si consiglia pt-BR.

L’intervallo iniziale va da 50 a 180 kg, il valore predefinito è 75 kg e Fat si attiva da 100 kg inclusi. minKg deve essere almeno zero, stepKg deve essere positivo e minKg <= defaultKg <= maxKg. La soglia deve essere superiore al minimo e non oltrepassare il massimo. Valore predefinito, soglia e massimo devono rientrare nella griglia che parte da minKg; per esempio, con minimo 50 kg e incremento 0,5 kg, 75 e 100 kg sono validi. Una configurazione non valida disattiva le operazioni sul peso.

LB converte solo il valore mostrato. Il server memorizza e convalida i valori in kg.

Comandi e permessi

Codice

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

Se attivati, i comandi configurati vengono registrati. Il comando predefinito di apertura è /fatweight, quello di controllo è /fatdecal. Il controllo accetta on, off, status o ui. on imposta il peso almeno alla soglia Fat; off lo porta al massimo un incremento sotto. Non sono interruttori visivi separati.

access	Comportamento
ace	Richiede il permesso `ACE` indicato da ace. È il valore predefinito.
everyone	Consente l’uso a qualsiasi giocatore che superi i controlli del server.
jobs, groups, custom	Richiede l’implementazione della policy in `bridge/server.lua`; non si collega automaticamente al framework.

Per concedere agli amministratori l’accesso ACE:

Codice

add_ace group.admin cxg_gtfat.use allow

Un menu o un target può richiedere l’apertura dell’interfaccia, ma il server verifica comunque l’autorizzazione. Disabilitare la registrazione dei comandi non impedisce a un’altra risorsa server di chiamare l’export OpenWeightUI.

Stazioni

Dopo l’installazione non è attivata alcuna bilancia fisica. Aggiungere una voce di stazione a Config.Stations, usare una chiave univoca, inserire le coordinate effettive e attivarla.

Codice

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,
    },
}

Sostituire le coordinate di esempio. La distanza supporta fino a 5 metri. bucket deve corrispondere al routing bucket della stazione; di solito è 0. Ogni stazione ha una propria policy access.

Modalità	Impostazioni	Risultato
Punto senza oggetto	model = false, `spawnProp` = false	Interazione invisibile alle coordinate configurate.
Oggetto esistente	model = 'nome_modello', `spawnProp` = false	Il modello deve trovarsi entro 1 metro dalle coordinate. La risorsa non lo rimuove.
Oggetto creato localmente	model = 'nome_modello', `spawnProp` = true	Crea un oggetto locale congelato quando si è vicini e lo rimuove all’allontanamento o all’arresto della risorsa.

Il punto d’interazione non posiziona automaticamente l’oggetto a terra. Impostare coords sull’origine effettiva dell’oggetto e heading sul suo orientamento. L’avviso usa E per impostazione predefinita; il giocatore può riassegnare “Usa bilancia” in Impostazioni FiveM > Associazione tasti.

L’adattatore predefinito consente ace ed everyone. Le altre modalità richiedono un’implementazione server. Un avviso o un prop non concede l’accesso: il server verifica di nuovo autorizzazione e prossimità.

Persistenza per personaggio

Codice

Config.Persistence = { framework = 'none' }

Modalità	Uso
none	Predefinita. Solo sessione; alla riconnessione o al riavvio viene usato `defaultKg`.
qb	Risolve il personaggio tramite qb-core e il relativo citizenid.
esx	Risolve il personaggio tramite es_extended e il relativo identificatore.
custom	Usa `GTFatCustomCharacterId(source)` in `identity.lua`.

La risorsa non rileva Qbox automaticamente. Per server multicharacter, configurare un identificatore stabile e univoco per ogni personaggio con un’opzione compatibile o un adattatore proprio. Non condividere l’identificatore tra personaggi e non accettare un’identità inviata dal client. In modalità custom, restituire nil finché il personaggio non è caricato.

Il peso persistente viene memorizzato separatamente da abiti e outfit. Mantenere il nome risorsa CXG_GTFAT e includere il salvataggio KVP del server nei backup degli altri dati persistenti.