SashegDev
9f43d35f44
Вендорный updater.exe перекачивает app.jar, и патч лаунчера после этого стирался. Теперь патчится и сам апдейтер: в его payload (jar, пришитый к PE-заглушке Launch4j после offset 65024) вставляются два хука. - UpdaterGui.runLauncher -> beforeLauncher: перепатчить app.jar перед стартом лаунчера, если апдейтер достал его из своего кэша. - DownloadEngine.findFilesToDownload -> filterUpdates: убрать app.jar из скачивания, но только если хеш манифеста равен baseSha256 из .rsx-patched. Другой хеш означает настоящее обновление, и файл качается как обычно. Хук сделан обёрткой вокруг findFilesToDownload, а не правкой call site: у invokespecial получатель лежит под аргументами, и замена вызова ломала стек. Ещё лаунчер при старте чинит свой updater.exe (jb -> l качает "updater.exe"), из-за чего хук жил ровно один запуск. Этот путь закрыт третьим guard. Ещё: - .rsx-patched теперь пишет сам патчер: baseSha256 нужен фильтру, чтобы отличать наш патч от настоящего обновления. - patchupdater идемпотентен и берёт pristine-копию из updater.exe.orig. - Перед записью payload проверяется загрузкой классов. - Установщик патчит апдейтер, а uninstall откатывает и его. - Маркер и log больше не прибиты к %APPDATA%\kjstudio: папки выводятся из расположения апдейтера. Проверено на живой установке два запуска подряд: хук выживает, app.jar остаётся пропатченным, updater качает 0 файлов.
154 lines
9.5 KiB
Markdown
154 lines
9.5 KiB
Markdown
# rsx-modloader
|
||
|
||
Модлоадер для RustexRemake: Java-моды в папке `mods`, подключаются через
|
||
`-javaagent`, `game.jar` не патчится. Один раз поставил — моды переживают
|
||
обновление игры.
|
||
|
||
В лаунчере появляется выбор режима прямо на кнопке «Играть»: **с модами** или
|
||
**ванилла**.
|
||
|
||
```
|
||
mod-template\ пример мода, собирается один раз
|
||
bridge\ агент (-javaagent) и его исходники
|
||
launcher-patch\ патч лаунчера: окно выбора и защита от автоапдейта
|
||
testserver\ локальный сервер, принимает любой ник и токен
|
||
scripts\ сборка, установка, запуск, удаление
|
||
third_party\asm\ ASM (BSD-3), зашит внутрь rsx-launcher-patch.jar
|
||
```
|
||
|
||
## Установка
|
||
|
||
build.cmd собрать dist\ (нужен только JDK)
|
||
install.cmd поставить модлоадер
|
||
start-launcher.cmd запускать лаунчер
|
||
uninstall.cmd вернуть всё как было
|
||
|
||
`install.cmd` копирует рантайм в `%LOCALAPPDATA%\rsx-mod`, патчит `app.jar`
|
||
лаунчера и прописывает `-javaagent` в его конфиг. Пути можно переопределить:
|
||
|
||
install.cmd --home D:\rsx-mod --game D:\RustexRemake
|
||
|
||
**Лаунчер должен быть закрыт.** Если он запущен с правами администратора,
|
||
`app.jar` не перезаписать — установщик об этом скажет.
|
||
|
||
Запускай лаунчер через `start-launcher.cmd`, а не ярлыком: `updater.exe`
|
||
сверяет хеш `app.jar` с манифестом и при патченом jar заново скачивает
|
||
официальный, стирая патч.
|
||
|
||
## Как это работает
|
||
|
||
* **Агент** (`rsx-bridge.jar`) подключается через `-javaagent` и в `premain`
|
||
читает профиль сборки игры (`profiles/latest.rsxp`): хеш jar, обфусцированные
|
||
имена нужных классов и полей. Ничего не хардкодится под конкретную сборку.
|
||
* **Патчи клиента** — A2 ставит `joml.fastmath` до загрузки JOML, A6
|
||
подменяет таймер телеметрии на «глухой». Оба сделаны на живом клиенте:
|
||
первые версии A6 роняли игру с `NullPointerException` и
|
||
`Timer already cancelled`.
|
||
* **Моды** грузятся родным загрузчиком игры (`ilxq` → `special.Main`) — так же,
|
||
как моды с сервера, и выполняются в игровом потоке.
|
||
* **Переносимость модов.** Мод собирается один раз против стабильного API.
|
||
Мост сам переводит логические имена в имена текущей сборки, поэтому
|
||
ре-обфускация вендора не ломает уже собранные моды.
|
||
|
||
## Патч лаунчера
|
||
|
||
Лаунчер — сторонний продукт, и у него три особенности, которые мешают:
|
||
|
||
* **Гонка за состоянием кнопки.** `xa.run()` вызывает `ha.y()` (ставит `PLAY`),
|
||
а `fa.loadedWeb()` позже ставит `ERROR`. Состояния — это индексы кнопок в
|
||
`web/launcher/main.html`, их шесть, поэтому `ERROR=6` скрывает все кнопки.
|
||
При медленной загрузке страницы `loadedWeb` затирает `PLAY` — кнопки просто
|
||
нет. Патч восстанавливает состояние после `loadedWeb`.
|
||
* **Автоапдейтер.** Патченый `app.jar` отличается от манифеста, и лаунчер
|
||
считает себя устаревшим в двух местах: `sb.q()` (размер и хеш файла) и
|
||
`ha` (хеш рабочего jar, отсюда «обновление найдено, перезапустите лаунчер»).
|
||
Оба закрыты через `rsx.Patch`, который действует только на файл с именем
|
||
`app.jar` и только при наличии маркера `.rsx-patched`.
|
||
* **Ремонт своего апдейтера.** При старте лаунчер проверяет хеш `updater.exe`
|
||
и, не найдя вендорскую сборку, скачивает чистую копию поверх
|
||
(`jb` → `l.ALLATORIxDEMO()` → «updater.exe»). Метод `jb` заменён на
|
||
`rsx.Patch.skipUpdaterRepair()`.
|
||
|
||
Возврат к обычному поведению: удалить `.rsx-patched` или запустить лаунчер с
|
||
`-Drsx.allowLauncherUpdate=true`.
|
||
|
||
## Патч апдейтера
|
||
|
||
`updater.exe` — это PE-заглушка Launch4j, к которой обычным zip просто пришит
|
||
jar (payload начинается с offset 65024 и идёт до EOF). Заглушка запускает jar из
|
||
себя, поэтому патчить надо именно хвост, а PE-заголовок не трогаем.
|
||
|
||
В payload вставляются два хука:
|
||
|
||
* `UpdaterGui.runLauncher(Z)V` → `rsx.UpdaterHook.beforeLauncher(...)` —
|
||
перед запуском лаунчера `app.jar` патчится заново, если он оказался
|
||
вендорским (апдейтер достаёт его из своего локального кэша даже когда скачивать
|
||
нечего).
|
||
* `DownloadEngine.findFilesToDownload` → `rsx.UpdaterHook.filterUpdates(...)` —
|
||
`app.jar` убирается из списка на скачивание, **только** если хеш в манифесте
|
||
совпадает с `baseSha256` из `.rsx-patched`. Хеш другой — значит настоящее
|
||
обновление, и файл скачивается как обычно.
|
||
|
||
`baseSha256` — это хеш нетронутого `app.jar`; патчер пишет его в `.rsx-patched`
|
||
сам, до того как перезаписать файл. При настоящем обновлении маркер
|
||
перезаписывается новым значением.
|
||
|
||
Хук идемпотентен: повторный `patchupdater` берёт pristine-копию из
|
||
`updater.exe.orig`, а если `updater.exe` заменил вендор — обновляет бэкап.
|
||
Перед записью собранный jar проверяется загрузкой классов, так что битый патч
|
||
никогда не попадёт на диск.
|
||
|
||
Лог: `%APPDATA%\kjstudio\rsx-launcher\updater-patch.log`.
|
||
|
||
## Конфиг лаунчера — осторожно
|
||
|
||
`launcher_config.properties` — это properties-файл: слэш экранирует следующий
|
||
символ, а `\r` читается как перевод строки. Значение `gamePath1=G:\rustexremake`
|
||
без экранирования превращается в `G:` + перевод строки + `ustexremake`, и
|
||
лаунчер перестаёт находить игру. Все правки идут через
|
||
`java.util.Properties` — в патчере есть команды `getprop` и `setprop`.
|
||
|
||
## Тест-сервер
|
||
|
||
testserver\start.cmd
|
||
|
||
Локальный сервер: принимает любой ник и токен, отвечает на `/server-ping`,
|
||
слушает порты 25566–25573 и закидывает в пустой мир. Проверка без игры:
|
||
|
||
python testserver\selftest.py
|
||
|
||
Адрес сервера зашит в коде клиента, поэтому для полного захода в мир нужен
|
||
редирект (PowerShell **от администратора**):
|
||
|
||
scripts\install-hosts.ps1 прописать 127.0.0.1 для адреса клиента
|
||
scripts\uninstall-hosts.ps1 откатить
|
||
|
||
## Сборка
|
||
|
||
build.cmd
|
||
|
||
Нужен только JDK. ASM лежит в `third_party\asm` и зашивается внутрь
|
||
`rsx-launcher-patch.jar`, поэтому устанавливать модлоадер можно без Gradle и
|
||
без сети.
|
||
|
||
Готовые файлы кладутся в `dist\`:
|
||
|
||
| файл | что это |
|
||
|---|---|
|
||
| `rsx-bridge.jar` | агент, Java 8 |
|
||
| `rsx-api.jar` | API, против которого собирается мод |
|
||
| `rsx-launcher-patch.jar` | патчер лаунчера, всё внутри |
|
||
| `mod-template\` | заготовка мода |
|
||
|
||
## Тесты
|
||
|
||
python bridge\src\test\python\run_test.py
|
||
|
||
Поднимает фейковый клиент, проверяет профиль, A2, A6, загрузку мода и то, что
|
||
мод выполняется в игровом потоке, а телеметрия не срабатывает.
|
||
|
||
---
|
||
|
||
RustexRemake и KJST Launcher — сторонние продукты, они не входят в этот проект.
|
||
Инструмент работает только на машине пользователя. ASM распространяется по
|
||
лицензии BSD-3, см. `LICENSE`. |