MixinBooter

Библиотека миксинов для Minecraft 1.8 - 1.12.2

MixinBooter - это мод-библиотека для Майнкрафт, которая решает одну из главных проблем старых версий (1.8 - 1.12.2) - совместимость миксинов между разными модами. Если ты когда-нибудь сталкивался с крашами из-за конфликта версий Mixin (например, тот же VanillaFix), то знаешь, как это бесит. MixinBooter как раз это и чинит.

Что это и зачем нужно

В Minecraft Forge для старых версий (особенно 1.7.10, 1.8, 1.12.2) многие моды используют миксины - штуку, которая позволяет менять код игры на лету, без переписывания ядра. Проблема в том, что разные моды могут тянуть разные версии библиотеки Mixin, и начинается ад: краши, несовместимость, вылеты. MixinBooter унифицирует этот процесс - под капотом у него UniMix 0.15.3 (форк от CleanroomMC, основанный на ветке 0.8.7 от LegacyModdingMC), и он работает на всех версиях от 1.8 до 1.12.2 одним билдом.

Кстати, версия MixinExtra в комплекте - 0.5.0, так что разработчикам не придется подключать её отдельно.

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

Если ты собираешь мод под старые версии Майнкрафт и хочешь использовать миксины без головной боли - MixinBooter твой выбор. Вот как подключить его через Gradle:

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

dependencies {
    // Common:
    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')
api (mixinBooter) {
    transitive = false
}
annotationProcessor (mixinBooter) {
    transitive = false
}

}

## Что изменилось по версиям

- **С версии 4.2** - API MixinBooter изменился, и теперь все моды, использующие миксины, рекомендуют зависеть от него (даже те, что миксанят ванильные/фордж/библиотечные классы). Это чтобы избежать рассогласования версий Mixin - спасибо embeddedt за идею.
- **С версии 5.0** - MixinExtras от LlamaLad7 встроен прямо в библиотеку, доступен разработчикам.
- **С версии 8.0** - один билд работает на всех версиях от 1.8 до 1.12.2 (LiteLoader пока в планах).
- **С версии 8.4** - активная совместимость с SpongeForge.
- **С версии 9.2** - вернули старую аннотацию MixinLoader для версий 1.8.x.
- **С версии 10.0** - MixinBooter следует за Mixin 0.8.7.

## Важно знать

- **IEarlyMixinLoader** - для миксинов, которые влияют на ванильные классы, Forge или любые классы, загружаемые очень рано (например, Guava).
- **ILateMixinLoader** - для миксинов, которые влияют на моды.
- Аннотация `@MixinLoader` по функционалу похожа на `ILateMixinLoader`. Обе можно использовать одновременно, особенно для версий 1.8.x, где это необходимо.

По факту, если ты собираешь сервер или модпак на старых версиях Minecraft и хочешь избежать крашей из-за миксинов - MixinBooter must-have. На слабом железе он не скажется на производительности, но стабильность поднимет знатно.