CXG-GTFAT konfigurieren

Bearbeite config.lua und starte CXG_GTFAT neu. Gewichtsangaben erfolgen in Kilogramm und müssen auf das konfigurierte Schritt-Raster passen.

Sprache und Gewicht

Code

Config.Locale = 'de'

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

Verfügbare Sprachen: en, es, pt-BR, fr, de, it, pl, ru, tr, th, ar, sv und br. br enthält ältere brasilianisch-portugiesische Texte; für die reguläre Auswahl wird pt-BR empfohlen.

Der anfängliche Gewichtsbereich beträgt 50–180 kg, der Standardwert 75 kg und Fat wird ab einschließlich 100 kg aktiviert. minKg muss mindestens null sein, stepKg muss positiv sein und minKg <= defaultKg <= maxKg gelten. Der Grenzwert muss über dem Minimum liegen und darf das Maximum nicht überschreiten. Standardwert, Grenzwert und Maximum müssen auf dem bei minKg beginnenden Raster liegen. Bei einem Minimum von 50 kg und einem Schritt von 0,5 kg sind zum Beispiel 75 und 100 kg gültig. Eine ungültige Konfiguration deaktiviert die Gewichtsoperationen.

LB rechnet nur die Anzeige um. Der Server speichert und prüft Werte in kg.

Befehle und Berechtigungen

Code

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

Bei aktivierter Einstellung werden die konfigurierten Befehle registriert. Der Standardbefehl zum Öffnen ist /fatweight, der Steuerbefehl lautet /fatdecal. Der Steuerbefehl akzeptiert on, off, status oder ui. on setzt das Gewicht mindestens auf den Fat-Grenzwert; off setzt es höchstens einen Schritt darunter. Dies sind keine getrennten visuellen Schalter.

access	Verhalten
ace	Erfordert die unter ace angegebene `ACE`-Berechtigung. Dies ist der Standard.
everyone	Erlaubt allen Spielern, welche die Serverprüfungen bestehen, die Nutzung.
jobs, groups, custom	Erfordert eine Richtlinienimplementierung in `bridge/server.lua`; es gibt keine automatische Framework-Anbindung.

So erteilst du Administratoren ACE-Zugriff:

Code

add_ace group.admin cxg_gtfat.use allow

Ein Menü oder Target kann das Öffnen der Oberfläche anfordern, der Server prüft die Berechtigung trotzdem. Eine deaktivierte Befehlsregistrierung hindert andere Server-Ressourcen nicht daran, den Export OpenWeightUI aufzurufen.

Stationen

Nach der Installation ist keine physische Waage aktiviert. Füge einen Stationseintrag in Config.Stations, verwende einen eindeutigen Schlüssel, trage die echten Koordinaten ein und aktiviere ihn.

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

Ersetze die Beispielkoordinaten. distance unterstützt bis zu 5 Meter. bucket muss dem Routing-Bucket der Station entsprechen, normalerweise 0. Jede Station hat eine eigene access-Richtlinie.

Modus	Einstellungen	Ergebnis
Punkt ohne Objekt	model = false, `spawnProp` = false	Unsichtbare Interaktion an den konfigurierten Koordinaten.
Vorhandenes Objekt	model = 'Modellname', `spawnProp` = false	Das Modell muss sich innerhalb eines Meters der Koordinaten befinden. Die Ressource entfernt es nicht.
Lokal erzeugtes Objekt	model = 'Modellname', `spawnProp` = true	Erstellt in der Nähe ein eingefrorenes lokales Objekt und entfernt es beim Weggehen oder beim Stoppen der Ressource.

Der Interaktionspunkt setzt das Objekt nicht automatisch auf den Boden. Lege coords auf den tatsächlichen Ursprung des Objekts und heading auf seine Ausrichtung. Die Eingabeaufforderung verwendet standardmäßig E; Spieler können „Waage benutzen“ in den FiveM-Einstellungen unter Tastenbelegung ändern.

Der Standardadapter erlaubt ace und everyone. Andere Modi benötigen eine Serverimplementierung. Eine Eingabeaufforderung oder ein Objekt erteilt keine Berechtigung; der Server prüft Zugriff und Nähe erneut.

Speicherung pro Charakter

Code

Config.Persistence = { framework = 'none' }

Modus	Verwendung
none	Standard. Nur sitzungsbezogen; nach erneutem Verbinden oder Neustart gilt `defaultKg`.
qb	Ermittelt den Charakter über qb-core und dessen citizenid.
esx	Ermittelt den Charakter über es_extended und dessen Kennung.
custom	Verwendet `GTFatCustomCharacterId(source)` in `identity.lua`.

Die Ressource erkennt Qbox nicht automatisch. Richte bei mehreren Charakteren über eine kompatible Option oder einen eigenen Adapter für jeden eine stabile, eindeutige Kennung ein. Verwende Kennungen nicht für mehrere Charaktere und akzeptiere keine vom Client gesendete Identität. Gib im custom-Modus nil zurück, bis der Charakter geladen wurde.

Das gespeicherte Gewicht wird getrennt von Kleidung und Outfits abgelegt. Behalte den Ressourcennamen CXG_GTFAT bei und sichere den KVP-Speicher des Servers zusammen mit den übrigen persistenten Daten.