MixinBooter

模组

· 作者 Cleanroom

适用于 1.8 - 1.12.2 的 Mixin 库。

8 本站下载 0 关注 更新于 1 天前

最新 12.4 · 1.12.2 · Forge

一键开服(送7天)

MixinBooter

让任何适用于模组的 mixins 在 1.8 - 1.12.2 版本中轻松运行

伪更新日志:

  • 从 4.2 版本开始,MixinBooter 的 API 发生了变化,所有使用 mixins 的模组都建议依赖 MixinBooter,即使那些 mixin 到 vanilla/forge/library 类中的模组也是如此。以避免因模组版本不匹配而导致尝试实现模组化 mixins 时崩溃(说的就是你,VanillaFix)。感谢 @embeddedt 推荐并帮助我引入此更改!

  • 从 5.0 版本开始,MixinExtras by @LlamaLad7 已被 shaded。可供开发者使用。

  • 从 8.0 版本开始,MixinBooter 现在将在 1.8 - 1.12.2 范围内工作。一个单一的构建即可兼容所有这些版本!(待办事项:支持 LiteLoader?)

  • 从 8.4 版本开始,MixinBooter 积极尝试与 SpongeForge 兼容

  • 从 9.2 版本开始,MixinBooter 重新引入了用于 1.8.x 版本的旧版 MixinLoader 注解。

  • 从 10.0 版本开始,MixinBooter 遵循 Mixin 0.8.7

  • 从 11.0 版本开始,MixinBooter 基于 CleanMix 构建。旨在与 Cleanroom 创建统一的后端。

    • 您不再需要自行声明注解处理器的依赖项。
    • 还添加了配置文件 (config/mixinbooter.cfg) 以黑名单混入配置并切换调试选项
    • 专用的 logs/mixinbooter.log 混入日志。具备追踪类加载功能以实现精确调试。
    • 允许传统的 MixinConfig + MixinConnector manifest 属性条目完全融入生态系统
    • 混入所有者的模组发现功能,更好的 isModLoaded 检查
    • 抑制 Forge 的 corrupt zip 警告
    • 淘汰混入 "phases"

面向开发者 ~ 入门指南:

  1. 添加 CleanroomMC 的仓库并依赖 MixinBooter 的 maven 条目:
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)
}
  1. 选择如何注册您的混入配置。MixinBooter 支持多种方法:

(从 11.0 版本开始,早期/晚期划分已不存在,因此 IEarly/ILateMixinLoaders 已被弃用)

  • MixinConfigs manifest 属性:无需加载器类。在 jar 的清单中添加空格分隔的混入配置名称列表。MixinBooter 直接从 jar 的清单中读取并注册它们。
  • MixinConnector manifest 属性:以编程方式注册配置。指向实现 org.spongepowered.asm.mixin.connect.IMixinConnector 的类,其 connect() 方法在启动期间被调用,您可以在其中自行调用 Mixins.addConfiguration(...)。

这两个 manifest 属性均在您的 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");
    }
    
}

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源