如何在IntelliJ开发环境中让Minecraft Mixins正常运行

核心排查步骤 #

• 移除你手动添加的-Dfml.coreMods.loadVM参数，高版本Forge的MixinGradle插件会自动注入所需的启动参数，手动填写错误的核心模组路径反而会阻断Mixin加载
• 检查build.gradle中的Mixin配置是否正确：
  1. 确保依赖声明格式正确：

  dependencies {
      implementation fg.deobf("org.spongepowered:mixin:0.8.3")
  }
  

  2. 确保存在mixin闭包声明你的配置文件：

  mixin {
      config "mixins.你的模组ID.json"
  }
  

• 刷新Gradle项目后重新生成运行配置：点击IDEA右侧Gradle面板的刷新按钮，然后执行Tasks > forgegradle runs > genIntellijRuns任务，不要使用之前旧的运行配置，旧配置不会同步Mixin的启动参数
• 检查资源路径配置：确认mixins.你的模组ID.json文件放在src/main/resources目录下，或者你自定义的资源目录已经在IDEA中被标记为资源根，同时文件中的package字段与你存放Mixin类的包路径完全匹配
• 清理增量编译缓存：执行gradle clean build后再启动运行配置，IDEA的增量编译可能不会将新增的Mixin类同步到运行时输出目录，导致Mixin找不到对应类

额外校验 #

启动前可以打开运行配置的VM选项列表，确认是否存在自动生成的-Dmixin.config=mixins.你的模组ID.json参数，如果没有则说明Gradle的Mixin配置未被正确识别，需要检查MixinGradle插件是否已经正确引入到build.gradle中。

内容的提问来源于stack exchange，提问作者EliteUnity