MixinBooter

МиксинБутер

Позволяет любым миксинам, работающим с модами, без проблем работать на версиях 1.8–1.12.2.

• Текущая версия миксина: CleanMix 0.2.9 от CleanroomMC, форк SpongePowered/Fabric Mixin (0.8.7)

• Текущая версия MixinExtra: 0.5.4

Псевдо-Changelog:

• Начиная с версии 4.2, API MixinBooter изменился, и всем модам, использующим миксины, рекомендуется зависеть от MixinBooter, даже тем, которые смешиваются с классами vanilla/forge/library. Чтобы избежать несоответствия версий миксинов и сбоев модов при попытке реализовать модифицированные миксины (смотря на вас, VanillaFix). Спасибо @embeddedt, который рекомендовал и помог мне внедрить это изменение!

• Начиная с версии 5.0, MixinExtras от @LlamaLad7 затенена. Доступно для использования разработчиками.

• Начиная с версии 8.0, MixinBooter теперь будет работать с версиями 1.8–1.12.2. Одна сборка работает со всеми этими версиями! (TODO: поддержка LiteLoader?)

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

• Начиная с версии 9.2, MixinBooter восстанавливает старую аннотацию MixinLoader для использования в версии 1.8.x.

• Начиная с версии 10.0, MixinBooter следует за Mixin 0.8.7.

• Начиная с версии 11.0, MixinBooter построен на основе CleanMix. В целях создания единого бэкэнда с Cleanroom. — Вам больше не нужно будет самостоятельно объявлять зависимости для обработчика аннотаций.

  • Также добавляет файл конфигурации (config/mixinbooter.cfg) в черный список конфигураций миксина и переключает параметры отладки.
  • Выделенный журнал миксинов logs/mixinbooter.log. С возможностью отслеживать загрузку классов для точной отладки.
  • Позволяет традиционным записям атрибутов манифеста MixinConfig + MixinConnector полностью участвовать в экосистеме.
  • Обнаружение модов для владельцев миксинов, лучше isModLoaded проверок
  • Подавляет предупреждения Forge о поврежденном почтовом индексе.
  • Поэтапно исключены миксины "фазы"

Для разработчиков ~ Начало работы:

1. Добавьте репозиторий CleanroomMC и используйте запись maven MixinBooter:

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

dependencies {
    def mixin = 'zone.rong:mixinbooter:11.0'
    
    implementation (mixin) {
        transitive = false
    }
    annotationProcessor mixin

    // RetroFuturaGradle for refmap generation:
    modUtils.enableMixins(mixin)
    // modUtils.enableMixins(mixin, 'mod_id.mixins.refmap.json') << add refmap name as 2nd arg (optional)
}

2. Выберите, как зарегистрировать конфигурации миксина. MixinBooter поддерживает множество подходов:

(Начиная с версии 11.0 разделения на ранние и поздние больше нет, поэтому IEarly/ILateMixinLoaders устарели)

• MixinConfigs атрибут манифеста: класс загрузчика не требуется. Добавьте разделенный пробелами список имен конфигурации вашего миксина в манифест вашего jar. MixinBooter считывает его прямо из манифеста jar и регистрирует.
• MixinConnector атрибут манифеста: программная регистрация конфигураций. Наведите его на класс, реализующий org.spongepowered.asm.mixin.connect.IMixinConnector, его connect() вызывается во время загрузки, где вы сами вызываете Mixins.addConfiguration(...).

Оба атрибута манифеста установлены в вашей задаче jar:

jar {
    manifest {
        attributes(
                'MixinConfigs': 'mixins.mymod.json',
                'MixinConnector': 'com.example.mymod.MyMixinConnector'
        )
    }
}

public class MyMixinConnector implements IMixinConnector {
    
    @Override
    public void connect() {
        // Check if mod is loaded before registering?
        // Possible with zone.rong.mixinbooter.service.ModDiscoverer.isModPresent(String modId)
        Mixins.addConfiguration("mixins.mymod.json");
    }
    
}