# Установка CXG-GTFAT

Установите ресурс под точным именем `CXG_GTFAT`, включите `OneSync` и добавьте ресурс в порядок запуска сервера. Фреймворк нужен только при выборе зависящего от него режима сохранения.

## Требования

- FiveM с включённым `OneSync`.
- Имя папки и ресурса: `CXG_GTFAT`.
- Не используйте старый селектор CXG Fat/Luxe или другой альтернативный пакет метаданных, который управляет той же одеждой.

Стандартному режиму не требуются QB, ESX или внешняя библиотека интерфейса либо языков. Для сохранения через qb или esx установите и запустите выбранный фреймворк. Для режима custom реализуйте определение идентификатора; встроенное хранилище `KVP` продолжит работать. При необходимости его можно заменить собственным хранилищем.

## Этапы установки

1. Скопируйте папку ресурса в папку ресурсов сервера под именем `CXG_GTFAT`.
2. Удалите старые ресурсы CXG Fat/Luxe. Не запускайте два селектора или альтернативных пакета для одной и той же одежды.
3. Убедитесь, что `OneSync` включён в конфигурации сервера.
4. Добавьте в `server.cfg`:

   ```cfg
   ensure `CXG_GTFAT`
   ```

5. Запустите или перезапустите сервер. После изменения файлов конфигурации перезапустите ресурс:

   ```cfg
   restart `CXG_GTFAT`
   ```

6. При стандартном режиме доступа выдайте нужной группе или principal разрешение `ACE` `cxg_gtfat.use`. Например:

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

   Чтобы использовать собственную группу, привяжите реальные идентификаторы:

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

7. Подключитесь персонажем freemode с разрешённым доступом и выполните `/fatweight`. Проверьте значение ниже порога, а затем равное ему или превышающее его, чтобы проверить переход Normal/Fat.

Замените TU_IDENTIFICADOR_REAL действительным идентификатором сервера. Ресурс не создаёт разрешения или principals автоматически.

## Первый запуск

При стандартных значениях команда `/fatweight` открывает весы для выбора веса от 50 до 180 кг. Порог Fat равен 100 кг включительно. `/fatdecal ui` открывает тот же интерфейс; `/fatdecal status` проверяет состояние, а on и off изменяют вес, чтобы пересечь порог. См. [Интерфейс](https://docs.cxgstudios.com/docs/ru/02-cxg-gtfat/06-interfaz.md).

Закройте весы клавишей Esc или кнопкой X. Закрытие окна не отменяет применённый вес и не отключает Fat.

## Частые проблемы

| Симптом | Что проверить |
| --- | --- |
| Ресурс не запускается | Проверьте точное имя `CXG_GTFAT`, включён ли `OneSync`, и нет ли ошибок Lua при загрузке конфигурации. |
| Команда сообщает об отсутствии доступа | При стандартном доступе `ACE` выдайте `cxg_gtfat.use`. Для jobs, groups или custom реализуйте политику в `bridge/server.lua`. |
| Станция не отображается | Станции изначально отключены. Включите и настройте запись в `Config.Stations` либо используйте `/fatweight`. |
| Вес сбрасывается после повторного подключения | Это ожидаемо при framework = 'none', который хранит вес только в течение сессии. При необходимости настройте сохранение по персонажу. |
| Одежда не меняется | Убедитесь, что используется одна из двух моделей freemode, одежда входит в покрытие и другой ресурс не управляет тем же decal. |
| Меню сохраняет технический decal | Вручную примените патч для используемой версии меню или подключите `SanitizeAppearance` в точке сохранения. |
| Эффекты остаются после изменения метаданных или удаления ресурса | Остановите дублирующие селекторы, удалите ненужный альтернативный пакет метаданных и полностью перезапустите сервер и клиент, чтобы загрузить актуальные метаданные. |