MixinBooter

Мод MixinBooter для Minecraft — библиотека для внедрения миксинов в моды

MixinBooter — это библиотека, обеспечивающая работу миксинов в модах для Minecraft на загрузчике Forge в версиях от 1.8 до 1.12.2. Проект предоставляет унифицированный бэкенд на основе CleanMix (форк Fabric Mixin), позволяя разработчикам использовать современные инструменты модификации кода в старых версиях игры без необходимости поддерживать множество версий. Библиотека также включает улучшенную систему обнаружения модов, логирование и настройки.

Техническая основа и совместимость

MixinBooter — это библиотека для загрузчика Forge, позволяющая использовать миксины в модах для Minecraft в версиях от 1.8 до 1.12.2. Проект построен на базе CleanMix 0.2.9 от CleanroomMC, который является форком Fabric Mixin (версия 0.8.7). Это решение объединяет все версии игры в одну сборку, устраняя необходимость поддерживать отдельные бинарники для каждой даты релиза. Библиотека работает как на стороне клиента, так и на сервере, обеспечивая единую точку входа для инструментов модификации кода в устаревшей экосистеме Forge.

Эволюция архитектуры и ключевые обновления

История разработки показывает переход от экспериментов к унифицированной архитектуре. С версии 8.0 библиотека начала поддерживать весь диапазон версий одной сборкой. Версия 9.2 восстановила поддержку старого аннотационного маркера MixinLoader для специфических задач 1.8.x. С версии 10.0 проект синхронизировался с Mixin 0.8.7, а с выходом версии 11.0 произошла полная миграция на CleanMix. Это обновление принесло ряд критических улучшений: упрощение настройки аннотационного процессора, добавление файла конфигурации config/mixinbooter.cfg для блокировки конфликтов и отладки, а также создание отдельного лога logs/mixinbooter.log для детального отслеживания загрузки классов. Кроме того, библиотека теперь активно пытается быть совместимой с SpongeForge и подавляет предупреждения Forge о повреждённых ZIP-архивах.

Способы регистрации конфигураций миксинов

Для разработчиков MixinBooter предлагает два основных подхода к регистрации конфигураций миксинов, оба из которых интегрированы в экосистему на уровне 11.0. Первый метод использует атрибут манифеста MixinConfigs, где в поле списка указываются названия файлов конфигураций (например, mixins.mymod.json). Этот подход не требует создания дополнительного класса-загрузчика и позволяет MixinBooter читать настройки прямо из манифеста JAR-файла. Второй метод опирается на атрибут MixinConnector, который позволяет программно регистрировать конфигурации через класс, реализующий интерфейс org.spongepowered.asm.mixin.connect.IMixinConnector. Метод connect() вызывается при запуске, предоставляя возможность добавлять конфигурации вручную с помощью Mixins.addConfiguration(...), что полезно для динамической логики инициализации.

Интеграция в проект: пример конфигурации Gradle

Чтобы начать использование библиотеки, необходимо добавить репозиторий CleanroomMC в файл `build.gradle` и включить зависимость MixinBooter. Важно отметить, что зависимость должна быть добавлена как `annotationProcessor`, а не просто как `implementation`, чтобы компилятор мог обработать аннотации. Ниже приведен пример конфигурации Gradle для интеграции библиотеки и генерации refmap.

Реализация класса-коннектора

При использовании метода `MixinConnector` требуется создать класс, реализующий интерфейс `IMixinConnector`. В методе `connect()` можно выполнить проверку наличия других модов с помощью `ModDiscoverer.isModPresent(String modId)` перед добавлением конфигурации. Пример реализации класса для добавления конфигурации `mixins.mymod.json` показан ниже.

Настройка манифеста JAR

Оба подхода к регистрации конфигураций настраиваются через задачу сборки `jar` в манифесте проекта. Ниже приведен пример того, как добавить атрибуты `MixinConfigs` и `MixinConnector` в манифест, чтобы библиотека могла корректно инициализировать миксины при запуске игры.

Связанные материалы

• YetAnotherConfigLib (YACL) — похожий мод

Автор: Rongmario · Автор: Cleanroom · Лицензия: LGPL-2.1-only