Transformers-Forged-To-Fight-Offline-Version

Таким образом, ситуация чётко разделена на две части. Арт и звук сохранились, потому что они поставляются внутри приложения (см. re_notes/ASSET_INVENTORY.txt). Каждый персонаж — это полноценный пакет ресурсов Unity, содержащий модель, текстуры, скелет, клипы анимации, контроллеры аниматора, эффекты и аудио. Окружение, здания, интерфейс, портреты, кат-сцены и диалоги — всё это тоже есть. Что не сохранилось — это данные, которые сообщали игре, какие из этих ресурсов использовать, как собрать их в бой или миссию и каковы на самом деле были числовые параметры каждого бота. Все части на месте. Просто больше не осталось ничего, что знало бы, как их собрать. Воссоздать это — вся работа, что осталась.

Как работает офлайн-загрузка

Здесь четыре движущиеся части. Вместе они заставляют немодифицированную игру думать, что она общается с Kabam.

1. Нативные бинарные патчи. Игра использует Unity IL2CPP, поэтому логика находится в скомпилированной ARM библиотеке libil2cpp.so, а не в редактируемых скриптовых файлах. patches/patch_il2cpp.py переписывает шесть функций в этой библиотеке, чтобы обойти проверки мёртвых серверов: он обходит два пути закрепления сертификатов, чтобы наш собственный сертификат TLS был принят, заставляет блок регистрации менеджера выполняться, даже если живая конфигурация равна null, позволяет входу в систему завершиться с нашей локальной сессией устройства и подавляет фатальные ошибки подсистем, которые иначе вызывали бы диалог «не удалось войти». Он также повторно внедряет одну запись зависимостей (см. раздел «Подводные камни»), чтобы хук времени выполнения действительно загрузился. На выходе — libil2cpp.patched.so.

2. Поддельный сервер Sparx. server/fakeserver.py заменяет бэкенд Kabam. Он слушает на TLS 443 и обычном HTTP 80 и отвечает на API-вызовы игры. Заранее подготовленные ответы находятся в server/responses/, по одному файлу на точку входа, названные по методу и пути, например GET__account_data.json. Некоторые точки входа обрабатываются динамически в коде, а не из файла, поскольку игра ожидает, что они будут повторять значения из запроса (точки входа обучения и точка входа деталей героя). Формат ответа — {"error":null,"result": ...}. Обратите внимание, что внутри полезной нагрузки ошибки Sparx поле пишется как err, а не error. Эта деталь важна и её легко пропустить.

3. Нативный хук времени выполнения. tools/nativehook/ собирает libdothook.so — небольшую библиотеку, которая загружается в игру при запуске и регистрирует каждый ключ данных, которые игра читает, плюс пару целевых корректировок поведения. Это была обратная связь, сделавшая всё остальное возможным: она сообщает вам точно, что игра запрашивает, чтобы вы могли синтезировать ответ и проверить его. Это чистый хук с перезаписью байтов, установленный до выполнения, потому что обычный инструмент для этого (Frida) вылетает под эмулятором из-за слоя трансляции ARM.

4. Настройка устройства. Эмулятор должен направлять домены Kabam на ПК и доверять поддельному сертификату. tools/provision_ldplayer.sh делает это одной командой: он помещает заплаченную библиотеку и хук, перенаправляет имена хостов Kabam на LAN-адрес ПК через файл hosts, монтирует поддельный CA в системное хранилище доверия и ослабляет SELinux. Запускайте его после каждого перезапуска эмулятора, потому что эти монтирования не переживают перезагрузку.

Поток данных во время выполнения: игра делает HTTPS-вызов к домену Kabam, файл hosts отправляет его на ПК, поддельный сервер отвечает ответом из server/responses/, заплаченная библиотека принимает сертификат и ответ, а хук регистрирует, что было прочитано. Этот цикл — как был создан каждый экран в этой сборке.

Что входит в этот пакет

re_notes/dump.cs — самый ценный файл для оставшейся работы. Это полная модель типов игры: каждый класс, каждый метод и, что критически важно, каждое поле данных, которое клиент читает с сервера. Это ваша карта всего бэкендного API. Когда вам нужно узнать, какой формы должен быть ответ, ответ находится там.

Чего нет в этом пакете и где это взять

Следующее было намеренно исключено, потому что это большое, или защищено авторскими правами, или секретно, или вы должны сгенерировать своё собственное.

• Сам APK (com.kabam.bigrobot, версия 9.2.0). Он около 800 МБ. Найдите свою собственную копию. Имя пакета и версия указаны в TECHNICAL_NOTES.md.
• Оригинальный libil2cpp.so и игровые ассеты. Оба извлекаются напрямую из APK. Распакуйте APK, библиотека находится в lib/arm64-v8a/, ассеты — в assets/.
• Сертификат TLS и CA. Не распространяйте закрытые ключи. Запустите server/gen_certs.sh, чтобы создать свою собственную пару, затем укажите хранилищу доверия устройства на новый CA.
• Заплаченная библиотека. Перегенерируйте её: запустите patches/patch_il2cpp.py против оригинального libil2cpp.so из APK.
• Сервер Frida и Il2CppDumper. Оба — общедоступные инструменты. Il2CppDumper создал re_notes/dump.cs из библиотеки APK и глобальных метаданных.
• Android NDK (использовалась r26) и JDK 21, необходимые для сборки хука и запуска безголового декомпилятора Ghidra.

Как запустить то, что существует сегодня

Вам нужен APK, установленный на эмуляторе с поддержкой трансляции ARM (использовался LDPlayer 9, с root и перезаписываемой системой), Python на ПК и элементы из раздела выше.

1. Сгенерируйте сертификаты один раз: bash server/gen_certs.sh.
2. Соберите заплаченную библиотеку один раз: python patches/patch_il2cpp.py path/to/original/libil2cpp.so --apply.
3. Соберите хук один раз, если хотите пересобрать его, иначе используйте предварительно собранный. См. tools/nativehook/deploy.sh.
4. Запустите поддельный сервер на ПК: python server/fakeserver.py. Он должен быть доступен на портах 443 и 80 с эмулятора.
5. Настройте устройство: bash tools/provision_ldplayer.sh <ваш-LAN-IP-ПК>. Повторяйте это после каждой перезагрузки эмулятора.
6. Подождите около 45 секунд, затем нажмите на титульный экран, чтобы войти. Вы должны попасть на главный экран.

Если он зависает при входе, сначала проверьте первый пункт в разделе «Подводные камни», прежде чем что-либо делать.

Подводные камни, которые съедят ваше время

Это те, которые стоили мне часов. Они записаны, чтобы не стоили того же вам.

• Хук времени выполнения загружается только через запись зависимости, которой нет в чистой библиотеке. Скрипт патча собирает из чистой библиотеки, поэтому без повторного добавления этой записи хук молча никогда не загрузится, и вход просто зависает. Скрипт патча теперь повторно внедряет её при каждой сборке. Если хук кажется мёртвым, первое, что нужно проверить — ссылается ли заплаченная библиотека на libdothook.so. Точные байты и смещения документированы в скрипте патча и в TECHNICAL_NOTES.md.
• Frida не работает, если вы используете LDPlayer9 или Bluestacks для тестирования. Эмулятор транслирует ARM в x86, и Frida вылетает при такой трансляции. Вся причина, по которой проект использует чистый хук с перезаписью байтов, в том, что он работает там, где Frida нет. Не тратьте время на попытки заставить Frida работать.
• Сетевые монтирования устройства не переживают перезагрузку эмулятора. Перенаправление hosts и доверие CA являются bind-монтированиями. После любого перезапуска эмулятора вы должны снова запустить provision_ldplayer.sh, иначе ничего не подключится.
• Внутри полезной нагрузки ошибки Sparx поле — err, а не error. Использование неправильного приводит к ответам, которые клиент молча игнорирует или обрабатывает неправильно.
• Интерактивные состояния подсказок обучения зацикливаются в офлайне. Не пытайтесь ответить на запрос обучения, чтобы удовлетворить его. Вместо этого удалите условие, которое запускает обучение в первую очередь. Заморозка обучения щита была исправлена таким образом: игроку дали ресурс, отсутствие которого вызвало обучение, а не ответили на само обучение.
• Рендеринг живого 3D-контента под эмулятором хрупок. Модели рендерятся, но это самая нестабильная область, и она чувствительна к графическому бэкенду эмулятора и настройкам текстур. Это проблема графики эмулятора, а не данных.

Если вы хотите действительно возродить её: воссоздание бэкенда

Это настоящая работа, и она объёмна. Вот её структура и с чего начать.

Цель — воссоздать вручную серверный контент, который ранее транслировался клиенту: квесты и миссии, карты и составы врагов, полный список ботов с их статистикой и способностями, боевые формулы и экономику. Ничего этого больше не существует, поэтому всё должно быть создано заново, в точных формах, которые ожидает клиент.

Метод, который работает, — это цикл, вокруг которого построен этот проект. Запустите игру с подключённым хуком. Хук регистрирует каждый ключ, который читает клиент. Когда клиент запрашивает что-то, чего вы не предоставили, вы видите именно то, что ему нужно. Затем вы синтезируете ответ в правильной форме, помещаете его в server/responses/ или добавляете в динамический обработчик в fakeserver.py, перезапускаете и проверяете, принимает ли его клиент и продвигается ли он дальше. Повторяйте. Каждый экран в текущей сборке был создан именно таким образом. re_notes/dump.cs подсказывает вам форму каждой структуры ещё до запуска, потому что он перечисляет каждое поле, которое читает клиент.

Разумный порядок атаки:

1. Добейтесь, чтобы один полный бой загрузился и прошёл от начала до конца. Это самая ценная цель, потому что бой — ядро игры и он задействует больше всего серверных данных одновременно. Вам нужны определения участников, их статистика и способности, а также то, что запрашивает путь инициализации боя. Вступительный бой уже начинает загружаться, поэтому это место, куда стоит нажать в первую очередь. Декомпилируйте пути инициализации боя и боевых данных (используйте decompile_targets.py) и прочитайте точные поля.
2. Восстановите полностью модель данных отряда, бот за ботом, включая статистику и способности. Арт для каждого бота уже существует в пакетах, перечисленных в ASSET_INVENTORY.txt, поэтому вы создаёте только числа и определения способностей, а не ассеты.
3. Перестройте структуры квестов и карт, чтобы Сюжет перестал быть пустым. Базовая структура уже частично взломана, см. TECHNICAL_NOTES.md для ключей.
4. Заполните экономику и прогрессию в последнюю очередь, когда бои и миссии уже будут, на что их тратить.

Будьте реалистичны в масштабах. Даже для игр, где фанаты сохранили данные живого сервера до отключения, поднятие приватного сервера — долгий проект. Здесь нет сохранённых данных, с которых можно начать, поэтому каждое число и каждая способность должны быть исследованы или изобретены заново, а затем проверены на клиенте. Это многолетний проект для нескольких человек, если цель — настоящая игра. Тем не менее, путь больше не является загадкой. Загрузка решена, обратная связь существует, модель типов дампнута, а ассеты целы. Осталась лишь очень большая объёмная работа по тщательному восстановлению данных, а не дальнейшая обратная разработка неизвестного.

Начните с TECHNICAL_NOTES.md. Это более глубокий технический справочник с точными патчами, восстановленными формами данных и конкретными находками, более подробно, чем этот README. Затем запустите цикл.

Удачи. Теперь это настоящая машина. Ей просто нужно восстановить свой контент.