ClassicUO — Українське керівництво

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

Докладні розділи українською

• Встановлення
• Налаштування Bad Newbie
• Огляд Age of Power
• Консольні команди сервера
• Квести
• Крафт
• Ресурси
• Basic IDE Runtime та IDE
• AutoLoad та макроси
• API Manual та Inspector
• Складання й тестування
• Усунення проблем

Про збірку

ClassicUO - Bad Newbie & Basic IDE Edition — неофіційна збірка для Windows x64. Вона поєднує ClassicUO, розширені налаштування Bad Newbie, Basic IDE Runtime, окреме вікно IDE на Eclipse Theia та API Manual, що створюється з фактичної реєстрації Runtime.

Ігрові дані Ultima Online до пакета не входять. Проєкт не є офіційним продуктом Electronic Arts, Broadsword, Ultima Online або команди ClassicUO.

Склад пакета

• client — готовий повний клієнт із Basic;
• project — вихідний код повної редакції;
• client-without-yoko — готовий клієнт лише з Bad Newbie;
• project-without-yoko — вихідний код без Basic;
• open-font-pack — необов’язкові шрифти з відкритими ліцензіями;
• verification — звіти складання та тестів.

Встановлення

1. Розпакуйте архів збірки в окрему папку з правом запису.
2. Виберіть client або client-without-yoko.
3. Запустіть ClassicUO.exe.
4. Вкажіть каталог легально отриманих даних Ultima Online.
5. Налаштуйте сервер та обліковий запис.

Порівняйте SHA-256 архіву зі значенням у сусідньому файлі .sha256.txt.

Bad Newbie

Відкрийте Options → Bad Newbie. Доступні:

• дальність видимості та лінія території;
• обхід перешкод із запасом до п’яти додаткових клітин;
• окремі індикатори касту для свого персонажа, інших гравців і NPC/монстрів;
• довжина індикатора 0–200 пікселів, де 0 приховує його;
• незалежні шрифт, розмір і колір для інтерфейсу, журналу, чату, overhead, імен, шкоди, tooltip, hover-карток і підписів касту;
• власні .ttf та .otf із папки Fonts;
• картки наведення для персонажів, предметів, backpack, вкладених контейнерів, екіпірування та тайлів;
• Info Bar, AutoLoot, AutoBuy і AutoSell.

Якщо ввімкнено Use original game/source color, зміна шрифту зберігає початковий динамічний UO hue та не робить текст чорним.

Hover-картка показує лише доступні клієнтові дані: серверну назву, локальний підпис, serial, graphic/body/tile ID, hue, кількість, координати, контейнер, layer та отримані властивості. Приховані серверні значення не вигадуються.

Basic Runtime

Точка входу Basic:

SUB Main()
    UO.Print('Basic запущено')
END SUB

Після відкриття або зміни одразу індексується весь файл. Прокручувати документ донизу не потрібно. Кілька скриптів можуть працювати паралельно та мають незалежні стани.

У довгих циклах використовуйте UO.Wait(...), щоб інтерфейс клієнта залишався чутливим.

Basic IDE

Використовується Eclipse Theia з Monaco. Є Explorer, Editor, Outline, Problems, Output, Debug Console, API Inspector, Variables, Watch, Call Stack і API Manual.

Кольори стану: зелений — працює, жовтий — пауза, чорний/звичайний колір теми — вибраний зупинений скрипт.

Дія	Клавіша
Запуск поточного скрипта	F5
Запуск SUB Main без налагодження	Ctrl+F5
Почати налагодження	F4
Перевірити синтаксис	F6
Пауза/продовження	F7
Continue	F8
Breakpoint	F9
Step Over	F10
Step Into	F11
Step Out	Shift+F11
Stop	Shift+F5
Restart Debugging	Ctrl+Shift+F5
Документація символу	Ctrl+F1

Поточний рядок підсвічується. Покрокові команди доступні, коли налагоджувач зупинився на інструкції.

AutoLoad і макроси

AutoLoad-файли лежать у корені Autoload, звичайні скрипти — у Autoload\Scripts. Підтримуються .sc, .inj, .bas і .txt.

Активний файл вибирається в Options → Basic IDE та зберігається окремо для кожного персонажа. Під час входу запускається лише SUB Main() вибраного AutoLoad.

У Options → Macros → Classic:

• Basic Auto Load показує процедури вибраного AutoLoad та прив’язує їх до клавіш;
• Basic Example зберігає повний скрипт SUB Main() ... END SUB у звичайному профілі макросів.

Новий безіменний файл IDE зберігається в Autoload\Scripts, а відкритий файл — за початковим шляхом.

API Manual

Єдиним джерелом істини є реєстрація Runtime. Manual містить реальні сигнатури, параметри, значення за замовчуванням, return/effect, допустимі значення, маршрут даних і приклади Basic. Користувацькі SUB та FUNCTION залишаються в Outline.

Аудит API: відсутніх, незареєстрованих, дубльованих або помилкових записів і прикладів — 0.

Типові проблеми

• Порожній API Manual: перевірте повний client і не змішуйте його зі старими файлами IDE.
• Already running: Main: зупиніть активний екземпляр перед новим запуском.
• F10/F11 неактивні: запустіть Debug і зупиніться на breakpoint.
• Клієнт зависає: додайте UO.Wait(...) у цикли.
• Немає індикатора NPC: перевірте окремий флажок, довжину, видимість і серверні події.

Перед автоматизацією перевірте правила свого сервера. Не публікуйте логіни, паролі, особисті профілі, журнали та ігрові дані.