Agent Skills
返回列表
Minecraft NeoForge 模组开发

Minecraft NeoForge 模组开发

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_da52f27b/minecraft-modder-neoforge。

技能介绍

要解决的问题

Minecraft NeoForge 模组开发里,很多错误并不来自逻辑,而来自工程约束:DeferredRegister 的 id 设置、datagen 入口、Mixin 声明、Access Transformer 与 @Accessor 的取舍、AnvilLib 模块引入,都会影响一次构建是否能通过。对小型物品、合成表或实体需求,过度抽象和手写 JSON 也会让代码很快变得难维护。这个技能把任务限制在可验证范围内:先澄清需求,再查文档,最后产出符合 NeoForge 工作流的代码。

核心能力与关键步骤

该技能默认围绕 NeoForge 和 ModDevGradle 展开,优先使用官方注册系统和 datagen。添加物品或方块时,它会把注册、模型、语言、纹理位置一次列出;添加配方时,使用 RecipeProvider 生成到 src/generated/resources 而不是手写 JSON;需要访问私有成员时,优先 Access Transformer,只有在更复杂的注入场景才建议 Mixin。如果引入 AnvilLib,它会根据需求选择 Config、Network、Registrum、Util 等模块,而不是默认引入 Main 聚合包。

适用边界与注意点

它适合单人或小团队的 Minecraft 模组开发,尤其适合需要中文注释、中文交流和明确完成标准的场景。它不是版本查询器:涉及最新 Minecraft 或 NeoForge 版本时,应要求文档确认而不是依赖记忆。参考开源代码时必须标注来源并遵守许可证;GPL 项目不能直接并入 MIT 或闭源项目。生成代码后,仍需通过构建、客户端运行、datagen 或测试验证。

使用场景

  • 在 NeoForge 模板中新建物品、方块和配方,并生成模型与语言文件。
  • 为已有模组添加合成表,用 RecipeProvider 生成 JSON 并验证工作台可用。
  • 调试注册失败或 Mixin 加载错误,定位 neoforge.mods.toml 与 AT 配置问题。
  • 引入 AnvilLib 的 Config 或 Network 模块,实现配置项和客户端数据包。

适合人员

  • 用 Java 做 Minecraft 模组的独立开发者,希望按 NeoForge 最佳实践写注册与 datagen。
  • 接手旧 NeoForge 项目的小队成员,需要只改必要代码并避免破坏 Mixin 或配置。
  • 做教学或示例的模组作者,要给出可构建、可运行、注释清晰的物品与实体代码。
  • 希望减少手写 JSON 的玩法开发者,想用 datagen 生成配方、模型和语言。