Sinytra Connector: совместимость модов Minecraft¶

Sinytra Connector — это программный инструмент (загрузчик совместимости) с открытым исходным кодом, предназначенный для запуска модов, написанных для Fabric API, в среде загрузчика NeoForge (ранее — Forge) в игре Minecraft Java Edition. Он выступает в роли прослойки, транслирующей вызовы Fabric API в эквивалентные вызовы NeoForge API, что позволяет игрокам одновременно использовать моды, созданные для двух исторически несовместимых экосистем модификации.

¶Предпосылки появления

Экосистема модов Minecraft долгое время была разделена на два основных лагеря: Forge (позже NeoForge) и Fabric. Forge, появившийся в 2011 году, долгое время доминировал, но его монолитная архитектура и медленное обновление до новых версий игры вызывали критику. Fabric, созданный в 2018 году, предложил более лёгкую и модульную архитектуру, что привлекло многих разработчиков. Однако пользователи были вынуждены выбирать один из загрузчиков, так как моды для них не были совместимы между собой напрямую. Проект Sinytra Connector возник как ответ на эту проблему, предлагая решение, которое не требует от разработчиков модов переписывать код, а работает на уровне рантайма и трансформации байт-кода.

¶Архитектура и принцип работы

Sinytra Connector работает не как самостоятельный загрузчик, а как расширение (мод) для NeoForge. Его работа основана на нескольких ключевых механизмах.

¶Трансформация байт-кода (Mixin и ASM)

Основная сложность заключается в том, что Fabric API и NeoForge API имеют разные структуры классов, имена методов и события. Connector использует библиотеки для трансформации байт-кода (такие как ASM) и инфраструктуру Mixin, чтобы перехватывать обращения модов Fabric к их API и перенаправлять их на эквивалентные функции NeoForge. Это происходит динамически во время загрузки игры, что позволяет подключать Fabric-моды без изменения их исходных JAR-файлов.

¶Маппинги и переименование

Minecraft использует обфусцированные имена классов и методов. Для разработки модов применяются промежуточные маппинги (например, Yarn для Fabric и Official Mojang mappings для NeoForge). Connector решает проблему несоответствия маппингов, выполняя ремаппинг (переименование) классов и методов Fabric-модов в соответствии с маппингами NeoForge в памяти на лету.

¶Эмуляция Fabric API

Вместо того чтобы пытаться подключить настоящий Fabric API, который зависит от специфичного загрузчика Fabric Loader, Connector включает в себя собственную реализацию-эмуляцию. Эта эмуляция предоставляет Fabric-модам те же интерфейсы и точки входа, которые они ожидают, но внутренне делегирует выполнение NeoForge. По сути, Connector содержит урезанную, но функциональную копию ключевых частей Fabric API, адаптированную под архитектуру NeoForge.

¶Процесс загрузки

При запуске игры с установленным Connector происходят следующие этапы:

NeoForge загружается стандартным образом.
Connector сканирует папку с модами на наличие JAR-файлов, помеченных как Fabric-моды (по наличию файла fabric.mod.json).
Для каждого найденного мода запускается процесс ремаппинга и трансформации.
Создаётся изолированная среда, имитирующая Fabric Loader, в которой моды инициализируются через стандартные для Fabric точки входа (например, onInitialize).
Взаимодействие с игрой осуществляется через преобразованные вызовы NeoForge API.

¶Возможности и ограничения

¶Поддерживаемые функции

Запуск большинства клиентских и серверных модов, использующих стандартные хуки Fabric API (блоки, предметы, рецепты, события).
Работа с библиотеками рендеринга, такими как Indium (для совместимости с Sodium), при условии наличия соответствующих адаптеров.
Использование модов, основанных на Mixin, для изменения кода игры.

¶Известные ограничения

Производительность: Трансформация байт-кода и эмуляция могут приводить к увеличению времени загрузки и незначительному снижению производительности в сравнении с нативным запуском на Fabric.
Несовместимость сложных модов: Моды, глубоко интегрирующиеся в загрузчик Fabric (например, использующие специфичные хуки Fabric Loader для сложных манипуляций с классами), могут работать некорректно или вызывать краши.
Версионность: Connector требует точного соответствия версий Minecraft, NeoForge и Fabric API. Обновление игры или API может потребовать обновления самого Connector.
Конфликты: Одновременное использование модов, которые модифицируют одни и те же игровые механики разными способами (через Forge и Fabric), может приводить к логическим конфликтам.

¶Использование и установка

Для использования Sinytra Connector пользователю необходимо:

Установить Minecraft и NeoForge для целевой версии игры.
Скачать JAR-файл Sinytra Connector, соответствующий версии игры.
Поместить файл Connector в папку mods наравне с другими модами NeoForge.
Поместить Fabric-моды, которые требуется запустить, в ту же папку mods. Connector автоматически определит их по структуре файла.

Важно отметить, что Connector не заменяет необходимость установки Fabric API. Fabric-моды часто требуют его наличия. Connector включает эмуляцию, которая покрывает большинство вызовов, но для некоторых специфических модов может потребоваться установка дополнительного модуля совместимости, который подключает реальный Fabric API в режиме совместимости.

¶Развитие и альтернативы

Проект Sinytra Connector является активным и постоянно развивается. Его разработчики следят за обновлениями Minecraft и экосистем модов. Основная цель — достичь прозрачной совместимости, чтобы игроки не задумывались о том, на каком загрузчике основан тот или иной мод.

На рынке существуют и другие попытки решить проблему совместимости. Например, проект Connector для версий на базе Forge (до появления NeoForge) или архитектурно иные решения, такие как Architectury API, который позволяет разработчикам создавать моды сразу для нескольких платформ с единой кодовой базой, но требует от авторов модов изначально использовать этот инструментарий. Sinytra Connector же ориентирован на конечного пользователя и не требует от разработчиков Fabric-модов каких-либо действий.

¶Значение для сообщества

Появление Sinytra Connector значительно упростило жизнь игрокам, желающим использовать моды из разных экосистем в одном мире. Это расширило пул доступных модификаций для NeoForge за счёт огромного количества существующих Fabric-модов. Несмотря на технические компромиссы и ограничения, проект демонстрирует высокий уровень инженерной мысли в сообществе моддеров Minecraft и способствует консолидации разрозненных сообществ разработчиков вокруг общей цели — улучшения игрового опыта.