mc-dev - Minecraft 模组/插件开发工具链

基于 Claude Code 的 Minecraft 开发 Agent + Skill 体系：分析 → 项目搭建 → 内容填充 → 代码审查。

组成

组件	类型	作用
mc-expert	subagent	分析需求、判定平台/版本、拆解任务、给出下一步命令
mc-framework	subagent	搭建项目骨架（Gradle/元数据/目录）
mc-content	subagent	在已有框架里填充游戏内容
mc-review	skill	静态代码审查
CLAUDE.md	知识库	版本边界 + API 速查（放到每个 MC 项目根目录）

安装

Claude Code 的发现规则要求：agent 放在 ~/.claude/agents/，skill 放在 ~/.claude/skills/<name>/。 直接 clone 到 ~/.claude/skills/mc-dev 是不会生效的，请用下面的安装脚本。

git clone https://github.com/sikadi233-hub/mc-dev.git
cd mc-dev
# macOS / Linux
bash install.sh
# Windows (PowerShell)
pwsh -File install.ps1   # 或右键 install.ps1 -> Run with PowerShell

脚本会把 agents/*.md 复制到 ~/.claude/agents/，把 skills/mc-review 复制到 ~/.claude/skills/。安装后重启 Claude Code。

怎么用

直接说需求（先分析）

@mc-expert 我想做一个 NeoForge 1.21.4 模组，功能是雷电法杖

mc-expert 会分析需求、判定 API 组、给出计划，并告诉你接下来该运行哪条命令。 （注意：subagent 之间不能互相调用，所以实际的搭建/填充由你按 mc-expert 给出的命令依次触发。）

手动控制

@mc-framework 建一个 Fabric 1.21.1 项目，modid=thunderstaff
@mc-content 给我的模组加一把会发射闪电的剑
/mc-review

支持平台

平台	版本	用途
NeoForge	1.20.1+	大型模组
Forge	1.16-1.20.4	旧版模组
Fabric	1.14+	轻量/客户端模组
Paper / Spigot	1.16+	服务端插件

版本感知

自动识别三个 API 断裂带（详见 CLAUDE.md）：

版本	API 特征
<= 1.20.4	旧 NBT (stack.getTag())、Item.Properties 链式
1.20.5-1.21.3	Data Components 替代 NBT
>= 1.21.4	custom_model_data list 结构、Item Model 新系统

要求

• Claude Code CLI 已安装
• JDK 21+
• 每个 Minecraft 项目根目录放一份知识库：

# macOS / Linux
cp CLAUDE.md /path/to/your/project/CLAUDE.md

# Windows (PowerShell)
Copy-Item CLAUDE.md \path\to\your\project\CLAUDE.md

许可

MIT，见 LICENSE。

---

🤖 Generated with Claude Code