星断肃昭

这篇指南帮你做什么？

汇总AI辅助模组开发中最常见的8个坑，每个坑都给出现象、原因和修复方法。提前了解，少走弯路。

前置要求

建议先完成 千问AI接入指南 和 第一个AI模组Prompt，在实际开发中对照查阅效果最佳。

坑 1：AI生成的代码直接报错

现象 粘贴AI代码后IDE标红，编译不通过

原因 AI使用了旧版API或错误的import

修复 Prompt中明确指定版本号，把报错信息完整给AI

坑 2：Mixin注入不生效或崩溃

现象 Mixin写了但运行没效果，或游戏崩溃

原因 mixin.json未注册、注入点方法名不匹配

修复 先用@Inject(at=HEAD)验证，再尝试复杂注入

坑 3：注册项找不到 / NullPointer

现象 运行时NullPointerException

原因 DeferredRegister注册时机不对

修复 确保register()在模组构造函数中调用，用Supplier延迟获取

坑 4：AI对Minecraft API的"幻觉"

现象 AI写出看似合理但实际不存在的API

原因 AI训练数据过时，混淆了不同版本API

修复 Prompt中提供已有import列表，要求AI标注不确定的API

坑 5：Gradle构建失败

现象 gradlew build 或 runClient 报错

原因 build.gradle配置错误、Java版本不匹配

修复 确认Java 21，用官方MDK模板，把完整日志给AI

坑 6：资源文件路径写错

现象 物品显示紫黑色方块或键名

原因 模型/语言/材质文件路径不正确

修复 让AI每次给出文件内容时附上完整路径

坑 7：AI上下文丢失

现象 AI后续代码和之前不兼容

原因 对话太长，AI"忘记"之前代码

修复 每5~6轮开新对话，重新提供项目上下文

坑 8：版本混淆（Forge vs NeoForge vs Fabric）

现象 AI生成了错误加载器的代码

原因 AI默认生成Forge代码，NeoForge/Fabric API差异大

修复 每个Prompt开头写明："NeoForge 1.21（非Forge非Fabric）"

总结：3条核心原则

1

Prompt要精确

每次都带上版本号、加载器类型、已有代码结构

2

报错直接给AI

完整报错信息是AI最好的修复线索

3

小步验证

每写一个功能就运行测试，不要攒一堆再跑

下一步

🟣

第一个AI模组 Prompt

用完整Prompt跑出你的第一个可运行模组

→ 🧰

效率工具包

完整AI开发工作流方法论

→

想要更系统的工作流？

避坑指南帮你解决常见问题。想要完整的AI开发方法论？效率工具包给你标准化流程。