# CXG-GTFAT installieren

Installiere die Ressource unter dem exakten Namen `CXG_GTFAT`, aktiviere `OneSync` und nimm sie in die Startreihenfolge des Servers auf. Ein Framework ist nur erforderlich, wenn die gewählte Speicheroption davon abhängt.

## Voraussetzungen

- FiveM mit aktiviertem `OneSync`.
- Ordner- und Ressourcenname: `CXG_GTFAT`.
- Kein älterer CXG Fat/Luxe-Selektor oder alternatives Metadatenpaket darf dieselbe Kleidung verwalten.

Im Standardmodus werden weder QB noch ESX oder eine externe Oberflächen- oder Sprachbibliothek benötigt. Für qb- oder esx-Speicherung installiere und starte das gewählte Framework. Bei custom-Speicherung implementiere die Identitätsermittlung; der integrierte `KVP`-Speicher funktioniert weiterhin. Bei Bedarf kannst du einen eigenen Speicheranbieter einsetzen.

## Installationsschritte

1. Kopiere den Ressourcenordner als `CXG_GTFAT` in die Server-Ressourcen.
2. Entferne ältere CXG Fat/Luxe-Ressourcen. Starte nicht zwei Selektoren oder alternative Pakete für dieselbe Kleidung.
3. Prüfe, ob `OneSync` in der Serverkonfiguration aktiviert ist.
4. Füge Folgendes in `server.cfg` ein:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Starte den Server oder starte ihn neu. Nach Änderungen an Konfigurationsdateien muss die Ressource neu gestartet werden:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. Erteile bei der standardmäßigen Zugriffsmethode der betreffenden Gruppe oder dem Principal die `ACE`-Berechtigung `cxg_gtfat.use`. Beispiel:

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

   Für eine eigene Gruppe kannst du echte Kennungen zuordnen:

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

7. Verbinde einen autorisierten Freemode-Spieler und verwende `/fatweight`. Teste einen Wert unterhalb und anschließend einen Wert am oder über dem eingestellten Grenzwert, um den Wechsel zwischen Normal und Fat zu prüfen.

Ersetze TU_IDENTIFICADOR_REAL durch eine gültige Kennung deines Servers. Die Ressource erstellt Berechtigungen und Principals nicht automatisch.

## Erste Verwendung

Mit den Standardwerten öffnet `/fatweight` die Waage, über die ein Gewicht zwischen 50 und 180 kg eingestellt werden kann. Der Fat-Grenzwert liegt einschließlich bei 100 kg. `/fatdecal ui` öffnet dieselbe Oberfläche; `/fatdecal status` fragt den Status ab, während on und off das Gewicht über den Grenzwert bewegen. Siehe [Oberfläche](https://docs.cxgstudios.com/docs/de/02-cxg-gtfat/06-interfaz.md).

Schließe die Waage mit Esc oder über die X-Schaltfläche. Das Schließen des Fensters setzt das angewendete Gewicht nicht zurück und deaktiviert Fat nicht.

## Häufige Probleme

| Symptom | Prüfen |
| --- | --- |
| Die Ressource startet nicht | Prüfe den exakten Namen `CXG_GTFAT`, die Aktivierung von `OneSync` und Lua-Fehler beim Laden der Konfiguration. |
| Der Befehl meldet fehlenden Zugriff | Erteile bei standardmäßigem `ACE`-Zugriff `cxg_gtfat.use`. Bei jobs, groups oder custom muss die Richtlinie in `bridge/server.lua` implementiert werden. |
| Keine Station wird angezeigt | Stationen sind anfangs deaktiviert. Aktiviere und konfiguriere einen Eintrag in `Config.Stations` oder verwende `/fatweight`. |
| Das Gewicht wird nach erneutem Verbinden zurückgesetzt | Das ist bei framework = 'none' erwartungsgemäß; gespeichert wird nur für die Sitzung. Richte bei Bedarf eine Speicherung pro Charakter ein. |
| Kleidung ändert sich nicht | Prüfe, ob der Charakter eines der beiden Freemode-Modelle verwendet, das Kleidungsstück abgedeckt ist und keine zweite Ressource dasselbe Decal gleichzeitig verwaltet. |
| Ein Menü speichert ein technisches Decal | Wende den Patch für die verwendete Menüversion manuell an oder integriere `SanitizeAppearance` am Speicherpunkt. |
| Effekte bleiben nach einer Metadatenänderung oder dem Entfernen der Ressource bestehen | Beende doppelte Selektoren, entferne das nicht mehr benötigte alternative Metadatenpaket und starte Server und Client vollständig neu, damit die aktuellen Metadaten geladen werden. |