minecraft-dev

Minecraft 开发插件 for DeepSeek Harness (dsh)：让 agent 更擅长写 Minecraft 服务端插件与模组，覆盖 MC 1.7.10 ~ 26.x 全时代。

已发布 npm：minecraft-dev（MIT）｜ 源码：GitHub

功能一览

7 个技能（模型按需加载，不占常驻上下文）

技能	内容
minecraft-java-build	全时代 Java/Gradle 构建知识：JDK 配对表、wrapper、foojay toolchain、依赖仓库、常见坑
minecraft-paper-plugin	Paper/Spigot 现代线插件（1.20.x / 1.21.x / 26.x）+ 5 份 API 参考
minecraft-fabric-mod	Fabric 模组（loom/loader/fabric-api/yarn 配合）+ 4 份 API 参考
minecraft-forge-mod	传统 Forge 四时代（1.7.10 FG2 / 1.12.2 FG3 / 1.16.5 FG5 / 1.20.1 FG6）+ 3 份时代 API 参考
minecraft-neoforge-mod	NeoForge（1.20.1 legacyforge / 1.21.x / 26.2 beta）+ 3 份 API 参考
minecraft-spigot-legacy	1.7.10 / 1.12.2 老线 Bukkit 插件 + Cauldron/Thermos/Mohist 混合服说明 + 2 份老线 API 参考
minecraft-major-mods	大型模组附属开发：28 个模组条目（1.7.10×10 / 1.12.2×8 / 现代×10，含拔刀剑、神秘时代、匠魂、植物魔法、Create、Botania、AE2、Mekanism、Curios、JEI/REI 等），每条含核实过的 curse.maven 坐标与扩展点

2 个工具

工具	用途
mc_scaffold	一句话创建完整可构建项目：paper / fabric / forge / neoforge / spigot 五平台，自动配好构建脚本、主类、元数据、时代对应的 Gradle wrapper
mc_gradle	在项目里跑 gradlew <task>：终端卡片显示、超时自动杀进程树、输出头尾截断、非零退出码不报错而是可读呈现

4 个内置子代理（v0.5.0，四子代理团队）

子代理（toolName）	环节与产出
subagent_mc_plan	A 方案：勘察项目 + web_search 联网查证 → 写 <项目>/PLAN.md + 5 行摘要
subagent_mc_skeleton	B 框架：按 PLAN.md 用 mc_scaffold 搭骨架 + 资源模板 + 测试桩 → 变更清单
subagent_mc_content	C 内容：按 PLAN.md 与骨架填充功能代码 → 变更清单 + 不确定点
subagent_mc_verify	D 编译审查：mc_gradle 编译/测试、修小错 → 验证报告

（注：4 个子代理为宿主层工具，任何 preset 会话可见；使用说明见 Minecraft 专家 preset persona。）

1 个 Agent 预设

预设	内容
minecraft（Minecraft 专家）	一键切换的专精 agent：standard 全工具集（shell / 文件 / 检索 / 技能 / 计划 / 目标 / 子代理 / 工作流）+ 中文专家人设 + 全局可见的 7 个技能与 4 个内置子代理 subagent_mc_plan/skeleton/content/verify（v0.6.0 起装完插件重启 dsh 后自动安装到 $DSH_HOME/.agent-presets/minecraft/，见下方「Minecraft 专家 agent 的安装」）

安装

方式一：npm 安装（推荐）

dsh plugin --profile web add minecraft-dev

国内用户注意：npm 默认源 npmmirror 会在发布后几分钟内同步；若报 ERR_PNPM_FETCH_404 说明镜像还没同步，加官方源即可： dsh plugin --profile web add minecraft-dev --registry=https://registry.npmjs.org

方式二：本地 tarball（离线/内网）

cd minecraft-dev && pnpm pack        # 产出 minecraft-dev-x.y.z.tgz
dsh plugin --profile web add ./minecraft-dev-0.5.0.tgz

方式三：源码直连（开发迭代，改完即生效）

dsh plugin --profile web add /path/to/minecraft-dev

⚠️ 如果你从源码运行 dsh：命令是 pnpm dsh 不是 dsh

只有通过 npm 安装的 dsh（npx @deepseek-ai/dsh 或 npm i -g）才有 dsh 命令。 如果你是从仓库源码跑的（比如 C:\Users\...\deepseek-harness-master），必须：

1. 先 cd 到 dsh 仓库根目录
2. 用 pnpm dsh 代替 dsh：

cd C:\Users\YX-ASUS\Desktop\deepseek-harness-master
pnpm dsh plugin --profile web add minecraft-dev --registry=https://registry.npmjs.org

⚠️ 安装后必须重启 dsh 服务

正在运行的 dsh 不会自动加载新装的插件。装完后：

1. 在跑 pnpm dsh web 的窗口按 Ctrl+C 停掉
2. 重新启动 pnpm dsh web
3. 新会话里插件生效

验证安装

pnpm dsh --profile web --dump-config     # 应出现 "# == minecraft-dev" 层与七行插件（skills/tools/preset + 4 个 subagent 实例）

卸载

dsh plugin --profile web remove minecraft-dev

安装 Minecraft 专家 agent（v0.6.0 起自动）

装完插件重启 dsh 后自动安装，无需手动复制：插件每次启动（挂载）时把自带的 preset/minecraft/ 复制到 preset 扫描根：

…