MixinBooter

Универсальная библиотека Mixin для старых версий Minecraft

MixinBooter предоставляет разработчикам возможность использовать технологию Mixin в Minecraft версий 1.8-1.12.2 без каких-либо сложностей. Эта библиотека решает проблему совместимости и позволяет применять модификации кода к любым модам в указанном диапазоне версий игры.

Технические характеристики

В основе проекта лежат:

• UniMix 0.15.3 от CleanroomMC (основан на ветке 0.8.7 от LegacyModdingMC)
• MixinExtras версии 0.5.0 от LlamaLad7

Для разработчиков

Чтобы интегрировать MixinBooter в свой проект, добавьте репозиторий CleanroomMC и соответствующие зависимости:

repositories {
    maven {
        url 'https://maven.cleanroommc.com'
    }
}

dependencies {

    // Общие зависимости:
    annotationProcessor 'org.ow2.asm:asm-debug-all:5.2'
    annotationProcessor 'com.google.guava:guava:32.1.2-jre'
    annotationProcessor 'com.google.code.gson:gson:2.8.9'

    // Для ForgeGradle:
    implementation ('zone.rong:mixinbooter:10.7') {
        transitive = false
    }
    annotationProcessor ('zone.rong:mixinbooter:10.7') {
        transitive = false
    }

    // Для RetroFuturaGradle:
    String mixinBooter = modUtils.enableMixins('zone.rong:mixinbooter:107')
    // modUtils.enableMixins('zone.rong:mixinbooter:10.7', 'mod_id.mixins.refmap.json') << добавьте имя refmap как второй аргумент (опционально)
    api (mixinBooter) {
        transitive = false
    }
    annotationProcessor (mixinBooter) {
        transitive = false
    }
}

История изменений

Версия 4.2 принесла значительные изменения в API MixinBooter. Теперь все моды, использующие технологию Mixin, настоятельно рекомендуется подключать к MixinBooter, включая те, которые работают с ванильными классами, Forge или библиотеками. Это помогает избежать конфликтов версий Mixin и связанных с ними сбоев.

С версии 5.0 в состав библиотеки включен MixinExtras от LlamaLad7, что расширяет возможности для разработчиков.

Версия 8.0 сделала MixinBooter универсальным решением для Minecraft 1.8-1.12.2 - один билд работает со всеми этими версиями!

Начиная с версии 8.4, MixinBooter активно работает над совместимостью с SpongeForge.

Версия 9.2 вернула поддержку старой аннотации MixinLoader для использования в Minecraft 1.8.x.

Версия 10.0 перешла на использование Mixin 0.8.7.

Полезные советы

Используйте интерфейс IEarlyMixinLoader для миксинов, которые влияют на ванильные классы, Forge или любые классы, загружаемые на очень ранних этапах (например, Guava).

Для миксинов, влияющих на другие моды, применяйте интерфейс ILateMixinLoader.

Аннотация @MixinLoader по функциональности аналогична ILateMixinLoader. Оба подхода можно использовать одновременно, особенно в версиях Minecraft 1.8.x, где это необходимо.