> ## 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 Creator и способы их решения.

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

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

## Запуск

<AccordionGroup>
  <Accordion title="Creator не запускается: 'rco-appearance' is not started">
    Creator объявляет зависимость от `rco-appearance`. Убедитесь, что Appearance установлен и в списке запуска стоит **выше** Creator:

    ```cfg theme={"dark"}
    ensure rco-appearance
    ensure rco-creator
    ```
  </Accordion>

  <Accordion title="'rsg-core must start before rco-creator' or 'vorp_core must start before rco-creator'">
    Ядро фреймворка запускается после наших ресурсов. Переместите `ensure rsg-core` (или `ensure vorp_core`) выше `rco-appearance` и `rco-creator`.
  </Accordion>

  <Accordion title="'both supported cores are started; set Config.Framework explicitly'">
    Ваш `server.cfg` запускает `rsg-core` и `vorp_core` одновременно. Удалите `ensure` фреймворка, который вы **не** используете. RSG: только `rsg-core`; VORP: только `vorp_core`.
  </Accordion>

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

  <Accordion title="'Discord slots are enabled, but guildId or botToken is empty'">
    Вы включили `CreatorServerConfig.Discord.enabled`, не заполнив guild ID и токен бота в `config/server.lua`. Заполните их или установите `enabled = false`.
  </Accordion>

  <Accordion title="'starter item N in config/server.lua is invalid'">
    Одна из записей в `CreatorServerConfig.Starter.items` без `name` или с `amount`, не являющимся целым числом не меньше 1. Исправьте запись с этим номером.
  </Accordion>
</AccordionGroup>

## Выбор персонажа

<AccordionGroup>
  <Accordion title="Всё ещё вижу старый селектор персонажей">
    Штатный селектор работает параллельно с Creator.

    * **RSG:** уберите `ensure rsg-multicharacter` и `ensure rsg-spawn`.
    * **VORP:** уберите `ensure vorp_character`.

    Перезапустите сервер после изменения списка запуска.
  </Accordion>

  <Accordion title="Выбор открывается дважды или поверх активного персонажа">
    Другой скрипт вызывает поток персонажа, когда игрок уже в мире. Сам Creator не накладывает экраны (`OpenCharacterSelection` возвращает `already_open` / `already_active`) — ищите штатный ресурс или сторонний скрипт, повторно вызывающий события входа фреймворка. В debug-выводе будет причина отказа.
  </Accordion>

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

  <Accordion title="У игрока меньше слотов, чем ожидалось">
    Слоты определяются в фиксированном порядке: своя функция, Discord, переопределение для игрока, лимит фреймворка, значение по умолчанию. При включённом Discord переопределения для отдельных игроков **не** учитываются. Полная логика в [Слотах персонажей](/ru/rco-creator/character-slots). Результат всегда ограничен `Config.MaxCharacters`.
  </Accordion>

  <Accordion title="Создание персонажа отклоняет корректную дату рождения">
    Возраст проверяется относительно `Config.IdentityReferenceDate`, а не реальной даты. При значениях по умолчанию `1899-01-01` и возрасте 18–100 допустимые годы рождения — 1799–1881. Подстройте опорную дату или `BirthYearMin` / `BirthYearMax` под ваш сеттинг. См. [Правила личности](/ru/rco-creator/configuration#identity-rules).
  </Accordion>
</AccordionGroup>

## Спавн

<AccordionGroup>
  <Accordion title="Селектор спавна никогда не появляется">
    Проверьте `Config.Spawn.selectorMode`. При `new_character_only` существующие персонажи пропускают селектор; при `first_login_after_restart` каждый персонаж видит его один раз за цикл сервера. Также проверьте `CreatorServerConfig.ForceLastPosition` — по умолчанию заключённые всегда возвращаются на последнюю позицию.
  </Accordion>

  <Accordion title="Изменил Config.Spawn.locations, но ничего не изменилось">
    Этот список используется только для первоначального заполнения базы. Далее управляйте спавнами в игре через `/rcospawns` или очистите таблицу `rco_creator_spawn_locations` и перезапустите для повторного заполнения. См. [Точки спавна](/ru/rco-creator/spawn-locations).
  </Accordion>

  <Accordion title="/rcospawns сообщает об отсутствии прав">
    Выдайте ACE явно и перезапустите:

    ```cfg theme={"dark"}
    add_ace group.admin rco.creator.spawns allow
    ```

    Или настройте `CanManageSpawns` в `config/server.lua`.
  </Accordion>

  <Accordion title="Новые персонажи не получили стартовый набор">
    Проверьте, что `CreatorServerConfig.Starter.enabled` равен `true` и каждое имя предмета существует в инвентаре фреймворка. Набор выдаётся один раз на персонажа и записывается в базу; при сбое выдачи консоль выводит сообщение, и Creator **намеренно** не повторяет автоматически, чтобы не дублировать предметы. Исправьте причину и выдайте предметы вручную затронутым игрокам.
  </Accordion>

  <Accordion title="Игрок оказывается в неправильном routing bucket">
    Во время выбора персонажа каждый игрок изолирован в своём bucket. При спавне Creator возвращает его в bucket, который был при открытии выбора — bucket 0 не зашит жёстко. Если другой скрипт меняет bucket, пока открыт экран выбора, вероятна именно эта причина.
  </Accordion>
</AccordionGroup>

## Предупреждения version checker

`RCO Identity update available` означает, что установленный пакет старее текущей публичной release.

`Resource version mismatch` означает, что `rco-creator` и `rco-appearance` взяты из разных releases. Установите оба из одного пакета; не меняйте только номер manifest.

Если remote request не удался, version checker работает **fail-open**: RCO продолжает запуск нормально.