Куда смотреть#
| Задача | Каталог |
|---|---|
| Подписаться на именованное Lua-событие X4FO | События Lua X4FO |
| Найти screen/control, отправителя, поля payload и MD-получателя | UI → MD |
| Узнать параметры собственной функции адаптера | Функции X4FO |
| Разобраться с native.send, native.receive и другими функциями DLL | Нативный мост |
| Найти обёртку или имя, вычисляемое из входных данных | Вычисляемые обращения |
В боковом дереве вызовы разделены по типу API и подсистемам: имена объектов, торговля, приказы, экипаж и другие. Каждая запись открывается на отдельной странице с параметрами, примерами и источниками. Поиск тоже ведёт на страницу записи; с этой страницы он по умолчанию относится к X4FO. В правилах каталога объяснены типы параметров, полнота и обновление.
Пример: подписаться на исход переименования#
Фрагмент Lua предполагает, что основной адаптер X4FO уже загружен. Он показывает форму подписки, а не полный декодер всех разновидностей сообщения.
if not X4FO then return end
local app = X4FO
app.registerEvent("X4FO.ObjectNameWire", function(_, wire)
if type(wire) ~= "string" then return end
-- Далее: разобрать конкретный OBJECT_NAME_*, проверить epoch и поля.
-- Не считать произвольную строку подтверждением операции.
end)Полезная нагрузка wire может иметь несколько форм. В каталоге событий перечислены выражения отправителей и источник каждого варианта; в разборе переименования показана полная цепочка.
Пример: найти обе стороны UI-события#
Для X4FO_ObjectNames / rename указаны 11 позиций списка: epoch, ключ и digest операции, actor, request_id, объект, организация, ревизия, имя, hex и область изменения.
Отправителем является хостовый адаптер после допуска запроса. Подписчик MD ищет настоящий объект и проверяет права ещё раз рядом с эффектом. Само имя события не является публичным разрешением гостю менять объект.
Для остальных механик действует тот же способ чтения: начать с имени → проверить отправителя → прочитать получателя → посмотреть фактическую операцию → проверить ответ и сохранение. Контракт, которого нет в источнике, не заменяется догадкой.
Что значит полный реестр в этой редакции#
Реестр включает исходники runtime, opt-in лабораторию, нативные источники и явные API-ссылки в исследованиях проекта. В отчёте покрытия есть точный список файлов с хешами, количество записей по группам, вычисляемые выражения и события без найденной второй стороны.
Лабораторная запись помечена отдельно. Найденный код и найденный обработчик не означают, что функция уже принята в двух X4. Игровая приёмка открытых этапов от наполнения справочника не меняется.
Встроенные функции самой игры и стандартные библиотеки смотрите в общем справочнике API. Для последовательного обучения — старт в коде X4Online.