Mixin Helper

Mixin Helper

掌控整合包中的 Mixin 冲突。Mixin Helper 让你只需编辑一个 JSON 配置文件，就能屏蔽、调整优先级，并精准修改任何已加载模组中的 Mixin。无需编写代码、重新编译或移除模组。

文档

完整文档、指南和示例请见 https://tysontheember.dev/mixin-helper/intro/

⚠️ 使用风险自负 ⚠️

这是一个高级工具。如果你不了解 Mixin 及其工作原理，就不适合使用这个模组。

虽然 Mixin Helper 设有防护措施，但它会直接干预其他模组对游戏的修改。使用不当会导致问题，包括但不限于：

• 游戏崩溃，并伴随难以诊断的堆栈跟踪
• 模组功能损坏，且问题可能不会立即显现
• 世界损坏，进行更改前请备份世界
• 存档不兼容，如果被禁用的 Mixin 会影响世界数据

使用此工具修改其他模组的 Mixin 后，请勿向模组作者报告相关错误。由 Mixin Helper 引起的任何问题均由你自行负责。

功能

• 屏蔽 Mixin：禁用单个 Mixin、整个 Mixin 配置，或阻止所有以特定类为目标的 Mixin
• 优先级控制：调整 Mixin 的执行顺序，解决模组间的加载顺序冲突
• 移除方法：停用或移除特定注入方法，而无需禁用整个 Mixin
• 审计报告：生成详细的 JSON 报告，列出每个已加载的 Mixin 配置及其注解，快速诊断冲突

工作原理

1. 安装 Mixin Helper，并将 jar 文件放入你的mods 文件夹
2. 启动游戏，默认配置文件会生成在config/mixinhelper.json
3. 查看config/mixinhelper-report.json中的审计报告，了解游戏加载的所有 Mixin
4. 按需编辑配置，以屏蔽、调整优先级或移除方法
5. 重启游戏即可

快速示例

两个模组都修改了同一个类，导致游戏崩溃？屏蔽有问题的 Mixin：

{
  "enabled": true,
  "blacklist": {
    "mixins": ["com.conflictingmod.mixin.MixinLevelRenderer"],
    "mixinConfigs": [],
    "targetClasses": []
  }
}

需要更精细的控制？只停用单个注入方法，而非整个 Mixin：

{
  "methodRemovals": {
    "rules": [
      {
        "targetClass": "net.minecraft.world.level.Level",
        "method": "brokenMethod",
        "action": "nop"
      }
    ]
  }
}

适用场景

• 整合包开发者：无需等待模组作者修复，即可解决模组冲突
• 服务器管理员：禁用导致不稳定的特定模组行为
• 故障排查：找出导致崩溃或异常行为的 Mixin
• 精细调整：通过控制执行顺序来调整模组交互

注意事项

• 更改配置后必须完整重启游戏，因为 Mixin 会在启动早期加载
• Mixin Helper 本身不包含任何 Mixin，而是利用 Mixin 插件系统拦截其他模组
• 对运行时性能没有影响，所有工作都在启动期间完成