RetroConvert

RetroConvert

Бросьте свои Babric-моды в инстанс Ornithe — RetroConvert автоматически конвертирует их при запуске. Babric и Ornithe оба запускают Fabric Loader на Minecraft Beta 1.7.3, но используют разные промежуточные маппинги, поэтому их моды несовместимы друг с другом. RetroConvert это исправляет: при запуске он переписывает байт-код Babric-модов на месте под маппинги Calamus gen2 от Ornithe — токен за токеном, без перекомпиляции, без исходников и без интернета.

Возможности

• Полностью автоматически — просто положите Babric-.jar файлы в папку mods рядом с RetroConvert и запустите игру. Сконвертированные моды появятся как `-ornithe.jar; оригиналы надёжно архивируются в config/retroconvert/originals/`.
• Глубокая конвертация — переписывает байт-код классов, аннотации миксинов (включая строковые цели без refmap), refmap JSON-файлы, access wideners, fabric.mod.json, строковые константы, используемые для рефлексии, и вложенные jar-in-jar моды — рекурсивно.
• Без видимого перезапуска — после конвертации Fabric Loader перезапускается внутри той же JVM поверх папки со сконвертированными модами. Игра просто запускается.
• Умное определение — уже портированные Ornithe-моды остаются нетронутыми, а зонтичные моды с вложенными jar (например, StationAPI) обрабатываются по каждому jar отдельно.
• Замена на официальные сборки — несколько модов (StationAPI, GlassConfigAPI) изменились слишком сильно для перезаписи байт-кода; для них скачивается официальная сборка Ornithe, а конвертация байт-кода используется как офлайн-запасной вариант.
• Кэширование — jar-файлы индексируются по SHA-256, поэтому при последующих запусках сканируются только новые файлы.

Использование

1. Установите RetroConvert в папку mods инстанса Ornithe b1.7.3.
2. Добавьте свои Babric-моды в ту же папку.
3. Запустите игру. Вот и всё.

Опционально: режим Java-агента (без перезапуска, даже при первом запуске)

Добавьте это в аргументы JVM (Prism Launcher: инстанс → Настройки → Java → Аргументы JVM):

-javaagent:mods/retroconvert-1.0.1+mcb1.7.3.jar

Это конвертирует моды до того, как Fabric Loader просканирует папку — логика перезапуска вообще не нужна. Та же строка работает для любого инстанса в Prism, MultiMC и ванильном лаунчере.

Использование без запуска игры

Конвертируйте любую папку с модами без запуска игры:

./gradlew runConverter --args="/path/to/.minecraft/mods"

Ограничения

• Поддерживается только b1.7.3 — так задумано, поскольку Babric нацелен только на b1.7.3.
• Babric-мод, у которого не разрешаются зависимости, падает до того, как RetroConvert успевает запуститься; удалите этот jar вручную.
• Не восстанавливайте архивный оригинал рядом с его сконвертированным результатом — загрузчик увидит два мода с одинаковым id.

Лицензия и исходники

Исходный код, трекер задач и полные технические подробности доступны на GitHub.