UA API Manual - LIHACHTETAN/ClassicUO-BadNewbie-BasicIDE GitHub Wiki
API Manual та Inspector
Home · BASIC · UO API · A–Z · Examples · Languages
API Manual
Актуальний довідник містить 1103 символи та всі 1037 назв команд із кількома прикладами для кожної команди. Клієнт читає редаговані файли із зовнішньої папки API Manual; у Theia повторно відкрийте довідку після змін. Докладні картки спільні: російською та частково англійською. Мова інтерфейсу не змінює ідентифікатори команд.
Джерело істини
Каталог створюється за одним правилом:
Runtime registration → API Manual
Старий довідковий текст не доводить існування команди. Символ входить до Runtime Manual лише тоді, коли його зареєстровано поточним Basic Runtime. Зареєстровані символи, яких немає у старих даних, додаються з Runtime metadata; старі незареєстровані символи відкидаються.
Вміст запису API
Кожен елемент може містити:
- точну назву й тип елемента;
- усі зареєстровані overload і реальні сигнатури;
- обов’язкові та необов’язкові параметри;
- значення за замовчуванням і допустимі значення, якщо вони визначені;
- return або побічний ефект;
- джерело даних і маршрут виклику до ClassicUO;
- ігноровані або сумісні параметри, якщо вони є;
- пов’язані властивості та елементи;
- правильний приклад у синтаксисі Basic Script.
Назви команд, параметрів і синтаксис коду не перекладаються.
Користувацький код окремо
Користувацькі SUB і FUNCTION з AutoLoad або Autoload\Scripts не є Runtime API. Вони відображаються в Outline, навігації символів і статичному аналізі вибраного документа, але не додаються до Runtime-каталогу.
Режими картки команди
Після вибору команди спочатку показується компактна картка: точна назва, тип, короткий синтаксис і return (або ефект).
Розширена інформація відкриває всі overload, вимоги до параметрів, значення за замовчуванням, допустимі значення, обмеження, залежності, маршрут Runtime, пов’язані елементи та робочий приклад Basic Script. Синтаксис і return залишаються видимими в обох режимах.
Inspector, debugger і Output
API Inspector відповідає на запитання «що означає ця команда?»: показує зареєстрований синтаксис, параметри, return/effect, приклад і технічний маршрут. Він не запускає безперервно кожну команду API.
Щоб побачити результат конкретного виклику:
- запишіть його у змінну;
- зупиніться breakpoint на наступному рядку;
- перегляньте Variables або Watch;
- або виведіть значення через
UO.Print.
SUB Main()
VAR hp = UO.GetHP()
UO.Print('HP: ' + CStr(hp))
END SUB
Locals, globals, watches і call frames належать панелям налагоджувача. Output і Debug Console містять хронологічні повідомлення Runtime.
Мови
Пояснення Manual підтримують коди EU, RU, UA, FR, DE, IT, ES, ZH, JA і KO. Назви Runtime-символів та Basic-синтаксис лишаються незмінними, щоб код не залежав від мови інтерфейсу.
Аудит відповідності
Повна перевірка має показати:
Missing from Manual: 0
Not registered in Runtime: 0
Invalid signatures: 0
Duplicate entries: 0
Invalid Basic Script examples: 0
Це підтверджує відповідність каталогу, але не замінює ігровий тест на сервері. Якщо навігація порожня, відкрийте усунення проблем.