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

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

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

Если застряли, откройте тикет в Discord с выводом консоли, вашим фреймворком и тем, что ожидали увидеть.

​

Запуск

'Could not detect a framework. Start rsg-core or vorp_core...'

Appearance запускается до ядра фреймворка. Переместите ensure rsg-core (или ensure vorp_core) выше rco-appearance в списке запуска.

'Both rsg-core and vorp_core are started...'

Ваш server.cfg запускает оба ядра. Почти всегда это лишний ensure — удалите строку фреймворка, который вы не используете. RSG: только rsg-core; VORP: только vorp_core.

'Config.Framework is rsg but rsg-core is not started' (or the VORP equivalent)

Вы принудительно задали фреймворк в конфиге, но ядро не запущено при старте Appearance. Исправьте порядок запуска или установите Config.Framework = 'auto'.

'oxmysql is not started. Persistence requires oxmysql...'

oxmysql запускается после Appearance. Переместите ensure oxmysql в начало списка, выше ядра фреймворка. Без него внешность не сохраняется.

'Failed to migrate rco_appearance / rco_appearance_outfits'

Appearance не смог создать или обновить таблицы. Детали после Error=db_schema объясняют причину — обычно у пользователя БД нет прав CREATE / ALTER. Выдайте права или один раз импортируйте sql/rco_appearance.sql вручную и перезапустите.

'stop the stock vorp_character resource before starting this pack' (VORP)

Штатный vorp_character всё ещё работает. Уберите ensure vorp_character из списка запуска и перезапустите сервер. Папку можно оставить; сообщение вызывает только работающий штатный ресурс.

'stop the stock vorp_barbershop resource before starting this pack' (VORP)

Штатный vorp_barbershop всё ещё работает. Он не часть vorp_character. Уберите ensure vorp_barbershop из списка запуска и перезапустите сервер. Папку можно оставить.

'stop the stock vorp_clothingstore resource before starting this pack' (VORP)

Штатный vorp_clothingstore всё ещё работает. Уберите ensure vorp_clothingstore из списка запуска и перезапустите. В текущих пакетах VORP этого ресурса часто нет; сообщение появляется только если эта папка started.

'stop the stock rsg-barbers resource before starting this pack' (RSG)

Штатный rsg-barbers всё ещё работает. Уберите ensure rsg-barbers из списка запуска и перезапустите сервер. Папку можно оставить.

​

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

У персонажа пропали волосы или сбросилось лицо

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

Остановите штатные ресурсы из Установки и проверьте Совместимость для требований к сторонним скриптам. Затем пусть игрок исправит внешность в барбершопе или, как админ, откройте редактор через /rco_creator.

Изменил что-то через ApplyAppearance / EquipCategory, но не сохранилось

Это ожидаемо. Клиентские экспорты применяют внешность визуально и никогда не сохраняют. Чтобы сохранить изменение из другого ресурса, используйте серверный экспорт SetAppearanceForCharacter. См. Экспорты.

Существующие персонажи показывают ped по умолчанию после установки

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

Ped выглядит сломанным после долгой сессии

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

​

Магазины

Два blip'а барбершопа в каждом городе (RSG)

rsg-barbers всё ещё работает. Уберите его из списка запуска. Его магазины сохраняют в playerskins, которую Appearance больше не читает — стрижки там всё равно исчезнут при relogin.

Два UI барбершопа или два blip'а в одном городе (VORP)

vorp_barbershop всё ещё работает. Уберите его из списка запуска. Остановить vorp_character недостаточно — барбершоп отдельный ресурс в стандартном пакете VORP.

Подсказка у двери магазина ничего не делает

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

С игроков не списывают оплату

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

Моя пользовательская татуировка не появляется

Три проверки: .ytd в rco-appearance/stream/addons/, dict в записи Config.OverlayAddons точно совпадает с именем файла (без .ytd), id уникален. Перезапустите ресурс после изменений. См. Магазины и оверлеи.

Старые команды rsg-wardrobe ничего не делают

rsg-wardrobe намеренно остановлен. Игроки используют магазины-гардеробы; скрипты — OpenEditor с mode = 'wardrobe', SetUndressed или ListOutfits.