> ## Documentation Index
> Fetch the complete documentation index at: https://rust-co.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Устранение неполадок

> Типичные проблемы RCO Appearance и способы их решения.

Прежде всего: установите `Config.Debug = true` в `rco-appearance/config/config.lua`, перезапустите ресурс и воспроизведите проблему. Appearance выводит, что делает и почему что-то отклонил. Большинство случаев становятся очевидны из этого вывода.

Если застряли, откройте тикет в [Discord](https://discord.gg/j67u6pbnDs) с выводом консоли, вашим фреймворком и тем, что ожидали увидеть.

## Запуск

<AccordionGroup>
  <Accordion title="'Could not detect a framework. Start rsg-core or vorp_core...'">
    Appearance запускается до ядра фреймворка. Переместите `ensure rsg-core` (или `ensure vorp_core`) выше `rco-appearance` в списке запуска.
  </Accordion>

  <Accordion title="'Both rsg-core and vorp_core are started...'">
    Ваш `server.cfg` запускает оба ядра. Почти всегда это лишний `ensure` — удалите строку фреймворка, который вы **не** используете. RSG: только `rsg-core`; VORP: только `vorp_core`.
  </Accordion>

  <Accordion title="'Config.Framework is rsg but rsg-core is not started' (or the VORP equivalent)">
    Вы принудительно задали фреймворк в конфиге, но ядро не запущено при старте Appearance. Исправьте порядок запуска или установите `Config.Framework = 'auto'`.
  </Accordion>

  <Accordion title="'oxmysql is not started. Persistence requires oxmysql...'">
    `oxmysql` запускается после Appearance. Переместите `ensure oxmysql` в начало списка, выше ядра фреймворка. Без него внешность не сохраняется.
  </Accordion>

  <Accordion title="'Failed to migrate rco_appearance / rco_appearance_outfits'">
    Appearance не смог создать или обновить таблицы. Детали после `Error=db_schema` объясняют причину — обычно у пользователя БД нет прав `CREATE` / `ALTER`. Выдайте права или один раз импортируйте `sql/rco_appearance.sql` вручную и перезапустите.
  </Accordion>

  <Accordion title="'stop the stock vorp_character resource before starting this pack' (VORP)">
    Штатный `vorp_character` всё ещё работает. Уберите `ensure vorp_character` из списка запуска и перезапустите сервер. Папку можно оставить; сообщение вызывает только *работающий* штатный ресурс.
  </Accordion>

  <Accordion title="'stop the stock vorp_barbershop resource before starting this pack' (VORP)">
    Штатный `vorp_barbershop` всё ещё работает. Он **не** часть `vorp_character`. Уберите `ensure vorp_barbershop` из списка запуска и перезапустите сервер. Папку можно оставить.
  </Accordion>

  <Accordion title="'stop the stock vorp_clothingstore resource before starting this pack' (VORP)">
    Штатный `vorp_clothingstore` всё ещё работает. Уберите `ensure vorp_clothingstore` из списка запуска и перезапустите. В текущих пакетах VORP этого ресурса часто нет; сообщение появляется только если эта папка started.
  </Accordion>

  <Accordion title="'stop the stock rsg-barbers resource before starting this pack' (RSG)">
    Штатный `rsg-barbers` всё ещё работает. Уберите `ensure rsg-barbers` из списка запуска и перезапустите сервер. Папку можно оставить.
  </Accordion>
</AccordionGroup>

## Внешность и сохранение

<AccordionGroup>
  <Accordion title="У персонажа пропали волосы или сбросилось лицо">
    Почти всегда другой скрипт записал полный blob внешности поверх персонажа. Частые виновники: всё ещё работающий `rsg-barbers` на RSG или сторонний скрипт одежды/барбера, отправляющий весь skin вместо изменённых полей.

    Остановите штатные ресурсы из [Установки](/ru/rco-appearance/installation) и проверьте [Совместимость](/ru/rco-appearance/compatibility) для требований к сторонним скриптам. Затем пусть игрок исправит внешность в барбершопе или, как админ, откройте редактор через `/rco_creator`.
  </Accordion>

  <Accordion title="Изменил что-то через ApplyAppearance / EquipCategory, но не сохранилось">
    Это ожидаемо. Клиентские экспорты применяют внешность визуально и никогда не сохраняют. Чтобы сохранить изменение из другого ресурса, используйте серверный экспорт `SetAppearanceForCharacter`. См. [Экспорты](/ru/rco-appearance/exports).
  </Accordion>

  <Accordion title="Существующие персонажи показывают ped по умолчанию после установки">
    Миграция выполняется при первом входе каждого персонажа. Если после этого всё ещё внешность по умолчанию — старые данные были пустыми или невалидными и пропущены. При `Config.Debug` консоль укажет персонажа. Внешность можно восстановить в редакторе (`/rco_creator` как админ или в барбершопе и магазине одежды).
  </Accordion>

  <Accordion title="Ped выглядит сломанным после долгой сессии">
    Введите `/reloadskin`. Повторно применяет сохранённую внешность без изменений. Если часто после конкретного действия (езда, смерть) — сообщите, какой скрипт это вызывает.
  </Accordion>
</AccordionGroup>

## Магазины

<AccordionGroup>
  <Accordion title="Два blip'а барбершопа в каждом городе (RSG)">
    `rsg-barbers` всё ещё работает. Уберите его из списка запуска. Его магазины сохраняют в `playerskins`, которую Appearance больше не читает — стрижки там всё равно исчезнут при relogin.
  </Accordion>

  <Accordion title="Два UI барбершопа или два blip'а в одном городе (VORP)">
    `vorp_barbershop` всё ещё работает. Уберите его из списка запуска. Остановить `vorp_character` недостаточно — барбершоп отдельный ресурс в стандартном пакете VORP.
  </Accordion>

  <Accordion title="Подсказка у двери магазина ничего не делает">
    Проверьте, что игрок в пределах `Config.ShopInteractDistance` от координат `prompt` и нажимает клавишу из `Config.ShopInteractControl`. При `Config.Debug` клиентская консоль покажет, зарегистрирована ли подсказка и принял ли сервер запрос на открытие.
  </Accordion>

  <Accordion title="С игроков не списывают оплату">
    `Config.ShopCost` по умолчанию `0`. Установите нужную цену. Списание только при сохранении в магазине одежды или барбершопе — никогда в редакторе или гардеробе.
  </Accordion>

  <Accordion title="Моя пользовательская татуировка не появляется">
    Три проверки: `.ytd` в `rco-appearance/stream/addons/`, `dict` в записи `Config.OverlayAddons` точно совпадает с именем файла (без `.ytd`), `id` уникален. Перезапустите ресурс после изменений. См. [Магазины и оверлеи](/ru/rco-appearance/shops#custom-tattoos-and-makeup).
  </Accordion>

  <Accordion title="Старые команды rsg-wardrobe ничего не делают">
    `rsg-wardrobe` намеренно остановлен. Игроки используют магазины-гардеробы; скрипты — `OpenEditor` с `mode = 'wardrobe'`, `SetUndressed` или `ListOutfits`.
  </Accordion>
</AccordionGroup>