Skip to content

Версии документации

Экспорт OED ​

Карточка Engine Atlas объясняет класс человеку. Файл OED передаёт то же знание программе: он говорит сборщику мода, где в игре лежит функция, как её вызвать и когда это безопасно. Из такого файла получается обычный код C++, и мод работает с движком без ручного поиска адресов.

OED (Octane Engine Definition) — текстовый файл с описанием связи между модом и точной версией libasphalt8.so. Одна строка говорит примерно следующее:

text
method MainMenu.classId id=oed.game.class_id module=game result=ptr rva=0x7a32f8 isa=arm thread=any phases=active,stop

Это метод classId типа MainMenu: он возвращает указатель, находится по адресу 0x7a32f8 и вызывается в указанные фазы работы мода.

Как получить файл ​

Откройте класс и нажмите Экспорт OED рядом с кнопкой Показать в списке. Браузер скачает файл с именем класса. Через Engine Atlas MCP тот же файл даёт просьба к модели:

Выгрузи OED для GS_MainMenu.

Кнопка есть у классов, по которым есть что выгрузить: у изученных и у классов с подтверждёнными привязками.

Что внутри файла ​

СтрокаЧто значит
Обычная строкаПодтверждённая привязка. Мод может на неё опираться
Строка с # methodЗаготовка из карточки. Она не работает, пока не подтверждена
thread=?, phases=?, result=?Этого исследование ещё не установило

Заготовки нужны, чтобы не начинать с пустого места: адрес, режим инструкций и известные типы уже подставлены. Чтобы заготовка заработала, установите недостающее по коду игры, замените ? и уберите #. Догадка здесь опаснее пустого места: неверный тип аргумента или поток роняет игру.

Чего файл не делает ​

  • Не меняет игру и не является модом. Это описание, которое использует сборка мода.
  • Не заменяет проверку. Наличие метода в карточке не значит, что его безопасно вызывать.
  • Подходит только к той версии libasphalt8.so, которая указана в нём. Другая библиотека будет отвергнута при запуске.

Правки в режиме редактирования на файл не влияют: он отражает опубликованные данные.