Troubleshooting

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

Home · BASIC · UO API · A–Z · Examples · Languages

Навигация по разделу

Тема	Подробнее
Client Startup	Требования и первый запуск
Login	Адрес сервера и настройки
Network	Состояние соединения и задержка
Proxy	Ограничения API
BASIC Runtime	Ошибки языка · Контракт вызова
BASIC IDE	Панели и отладка
AutoLoad	Файл, процедура и макрос
Scripts	Возврат команды · Остановка процедур
Build Errors	SDK, зависимости и логи

API Manual пустой

1. Убедитесь, что используется папка client полной редакции, а не client-without-yoko.
2. Не запускайте ClassicUO.exe отдельно от остальных файлов клиента.
3. Проверьте наличие payload Basic IDE/API рядом с клиентом.
4. Закройте IDE и клиент, затем запустите полный клиент снова.
5. Не копируйте поверх текущей сборки каталоги IDE из старых архивов.
6. Проверьте Output/Logs на ошибку загрузки Runtime metadata или локального Theia host.

Manual получает данные из текущего Runtime. Пустая левая навигация обычно означает, что frontend открылся, но Runtime-каталог не был загружен.

Run открывает launch.json

Используйте команды Basic из встроенного меню Run: Run Script, Run Without Debugging или Start Debugging. Обычная команда Theia/VS Code для неизвестной конфигурации может открыть launch.json; Basic-команды должны быть привязаны к расширению текущей сборки.

Already running: Main

Runtime уже считает выбранный экземпляр Main активным. Выберите нужный скрипт в Explorer и нажмите Stop. Если в UI состояние устарело, закройте и снова откройте IDE: она должна перечитать состояние из работающего Runtime. Не запускайте второй экземпляр той же точки входа, пока первый не остановлен.

F10/F11 ничего не делают

Пошаговые команды работают только в остановленном debug-состоянии:

1. запустите Start Debugging;
2. поставьте breakpoint F9 или дождитесь первой остановки;
3. используйте F10, F11 или Shift+F11.

Если скрипт уже остановлен окончательно, сообщение «selected script is not running» является ожидаемым.

Скрипт виден только после прокрутки

Такое поведение относится к старой ошибке. В актуальной сборке документ индексируется полностью. Убедитесь, что библиотеки IDE/extension не взяты из предыдущего архива.

Нет зелёного или жёлтого индикатора

• выберите скрипт в Explorer;
• проверьте Output на успешный запуск;
• нажмите Reload/Refresh состояния;
• убедитесь, что IDE подключена к тому же экземпляру ClassicUO;
• не запускайте две разные папки клиента одновременно с общей IDE-папкой.

Клиент подвисает при Basic-команде

• добавьте UO.Wait(...) в циклы;
• исключите активные бесконечные циклы;
• не выполняйте большой синхронный поиск на каждой итерации;
• используйте актуальные файлы Runtime из одного комплекта сборки;
• разделите тяжёлую операцию на небольшие шаги.

Шрифт становится чёрным

Включите Use original game/source color, нажмите Apply и убедитесь, что файлы клиента не смешаны со старой сборкой. Подробнее: Шрифты и цвета.

Индикатор NPC/монстра не появляется

Проверьте отдельный флажок NPC/Monster, длину больше нуля, цвет/положение и дальность видимости. Некоторые серверы не передают достаточно речи, action-кодов или анимаций для надёжного определения удалённого каста.

Texture not found for sprite

Сообщение означает отсутствие конкретного изображения в загруженных игровых данных. Клиент кэширует отрицательный результат и использует fallback. Если объект важен визуально, проверьте совместимость client data с сервером.

FPS снова 60

Проверьте, что значение применено, клиент имеет право записывать настройки и не смешаны профили разных версий. FPS относится к глобальным настройкам установки.

Auto Open Doors не работает

Проверьте флажок, доступность двери, расстояние и серверные ограничения. Клиент отправляет действие по конкретному serial перед шагом и ограничивает повторение примерно 500 мс для одной двери.