# Instalacja CXG-GTFAT

Zainstaluj zasób pod dokładną nazwą `CXG_GTFAT`, włącz `OneSync` i dodaj zasób do kolejności uruchamiania serwera. Framework jest wymagany tylko wtedy, gdy wybrany tryb trwałości od niego zależy.

## Wymagania

- FiveM z włączonym `OneSync`.
- Nazwa folderu i zasobu: `CXG_GTFAT`.
- Żaden starszy selektor CXG Fat/Luxe ani alternatywny pakiet metadanych nie może równolegle obsługiwać tych samych ubrań.

Tryb domyślny nie wymaga QB, ESX ani zewnętrznej biblioteki interfejsu lub języków. Jeśli konfigurujesz trwałość qb lub esx, zainstaluj i uruchom wybrany framework. Dla trybu custom zaimplementuj ustalanie tożsamości; wbudowany zapis `KVP` nadal działa. Możesz zastąpić go własnym dostawcą zapisu.

## Kroki instalacji

1. Skopiuj folder zasobu do zasobów serwera pod nazwą `CXG_GTFAT`.
2. Usuń starsze zasoby CXG Fat/Luxe. Nie uruchamiaj dwóch selektorów ani alternatywnych pakietów dla tych samych ubrań.
3. Sprawdź, czy `OneSync` jest włączony w konfiguracji serwera.
4. Dodaj do `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Uruchom lub zrestartuj serwer. Po zmianie plików konfiguracji zrestartuj zasób:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. Przy domyślnym dostępie przyznaj odpowiedniej grupie lub principalowi uprawnienie `ACE` `cxg_gtfat.use`. Na przykład:

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

   Aby użyć własnej grupy, przypisz prawdziwe identyfikatory:

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

7. Połącz się jako uprawniony gracz freemode i użyj `/fatweight`. Sprawdź wartość poniżej, a następnie równą lub wyższą od skonfigurowanego progu, aby potwierdzić zmianę Normal/Fat.

Zastąp TU_IDENTIFICADOR_REAL prawidłowym identyfikatorem ze swojego serwera. Zasób nie tworzy automatycznie uprawnień ani principalów.

## Pierwsze użycie

Przy wartościach domyślnych `/fatweight` otwiera wagę, która pozwala ustawić wartość od 50 do 180 kg. Próg Fat wynosi 100 kg włącznie. `/fatdecal ui` otwiera ten sam interfejs, `/fatdecal status` sprawdza stan, a on i off zmieniają wagę tak, by przekroczyć próg. Zobacz [Interfejs](https://docs.cxgstudios.com/docs/pl/02-cxg-gtfat/06-interfaz.md).

Zamknij wagę klawiszem Esc lub przyciskiem X. Zamknięcie okna nie cofa zastosowanej wagi ani nie wyłącza Fat.

## Typowe problemy

| Objaw | Co sprawdzić |
| --- | --- |
| Zasób nie uruchamia się | Sprawdź dokładną nazwę `CXG_GTFAT`, włączone `OneSync` i błędy Lua podczas wczytywania konfiguracji. |
| Komenda zgłasza brak dostępu | Przy domyślnym dostępie `ACE` przyznaj `cxg_gtfat.use`. Dla jobs, groups lub custom zaimplementuj politykę w `bridge/server.lua`. |
| Nie widać stanowiska | Stanowiska są domyślnie wyłączone. Włącz i skonfiguruj wpis w `Config.Stations` albo użyj `/fatweight`. |
| Waga resetuje się po ponownym połączeniu | To normalne przy framework = 'none', który zapisuje tylko w czasie sesji. W razie potrzeby skonfiguruj trwałość dla postaci. |
| Ubrania się nie zmieniają | Sprawdź, czy postać używa jednego z dwóch modeli freemode, czy ubranie jest obsługiwane i czy inny zasób nie zarządza tym samym decalem. |
| Menu zapisuje techniczny decal | Ręcznie zastosuj poprawkę dla wersji menu albo zintegruj `SanitizeAppearance` w miejscu zapisu. |
| Efekty pozostają po zmianie metadanych lub usunięciu zasobu | Zatrzymaj duplikujące się selektory, usuń nieaktualny alternatywny pakiet metadanych i całkowicie uruchom ponownie serwer oraz klienta, aby wczytać bieżące metadane. |