前言¶

在 DeepSeek Harness（DSH）里处理 Minecraft 服务端插件或模组任务时，常见难点不是单一文件生成，而是版本、平台和构建链路同时变化：Paper、Spigot、Fabric、Forge、NeoForge 的写法不同，MC 1.7.10 到 26.x 的依赖与 JDK 要求也不同。

下面介绍 sikadi233-hub/minecraft-dev。它是 DSH 的 Minecraft 开发插件，提供相关技能、工具、子代理和 Agent 预设，用于让 agent 更擅长写 Minecraft 服务端插件与模组。

这是什么¶

• 插件名：sikadi233-hub/minecraft-dev
• 维护方：sikadi233-hub
• 许可：MIT
• npm 包名：minecraft-dev
• 官方安装命令：dsh plugin --profile web add minecraft-dev

该插件覆盖 MC 1.7.10 ~ 26.x 的 Paper/Spigot 插件与 Fabric/Forge/NeoForge 模组开发知识，提供以下组成：

• 7 个按需加载技能
• 2 个工具：mc_scaffold、mc_gradle
• 4 个内置子代理
• 1 个 minecraft Agent 预设

目录页：
https://www.skillhub.cn/plugins/sikadi233-hub/minecraft-dev

源码：
https://github.com/sikadi233-hub/minecraft-dev

核心功能¶

按需加载技能¶

插件提供 7 个技能：

• minecraft-java-build
• minecraft-paper-plugin
• minecraft-fabric-mod
• minecraft-forge-mod
• minecraft-neoforge-mod
• minecraft-spigot-legacy
• minecraft-major-mods

发 Minecraft 相关任务时，模型会自动调 skill 工具加载对应技能。也可以手动注入，例如在输入框直接发送：

/minecraft-paper-plugin

其他技能名也可以按同样方式手动发送。

工具¶

插件提供 2 个工具。

mc_scaffold 用于创建 Paper/Fabric/Forge/NeoForge/Spigot 可构建项目。根据插件披露，mc_scaffold 仅在用户指定 targetDir 下写文件。

mc_gradle 用于在项目里运行 gradlew <task>。根据插件披露，mc_gradle 在用户指定项目目录执行 gradlew。mc_gradle 依赖目标机存在 taskkill（win32），输出截断为头尾内联标记，不做 spill 文件。

内置子代理¶

插件提供 4 个内置子代理：

• subagent_mc_plan
• subagent_mc_skeleton
• subagent_mc_content
• subagent_mc_verify

示例对话：

用四子代理团队帮我做一个 Paper 插件 my-plugin，包名 com.example.myplugin，MC 1.21.8

Minecraft 专家预设¶

插件提供 1 个 Agent 预设：minecraft。

从 v0.6.0 起，装完插件并重启 dsh 后，会自动安装到：

$DSH_HOME/.agent-presets/minecraft/

该自动安装只写入，不覆盖已有 preset。若关闭自动安装，可配置：

autoInstallPreset: false

安装与启用¶

npm 安装¶

推荐方式：

dsh plugin --profile web add minecraft-dev

国内 npm 镜像可能未同步。若报：

ERR_PNPM_FETCH_404

可加官方源：

dsh plugin --profile web add minecraft-dev --registry=https://registry.npmjs.org

本地 tarball 与源码直连¶

插件支持 npm 安装、本地 tarball 离线/内网安装、源码直连安装。

从 dsh 源码运行时¶

若从 dsh 源码运行，命令应使用：

pnpm dsh

而不是：

dsh

安装后重启¶

安装后必须重启 dsh 服务。正在运行的 dsh 不会自动加载新装的插件。

典型用法¶

常见示例如下：

创建一个 Paper 插件 my-plugin，包名 com.example.myplugin，MC 1.21.8
创建一个 Forge 1.12.2 模组 mymod，包名 com.example.mymod
写一个植物魔法 1.12.2 附属，注册一种新的花
用 mc_gradle 跑一下当前项目的 build

也可以让 agent 使用四子代理团队：

用四子代理团队帮我做一个 Paper 插件 my-plugin，包名 com.example.myplugin，MC 1.21.8

经过上面的步骤，插件会按当前任务加载技能，并使用 mc_scaffold 或 mc_gradle 处理项目创建与构建任务。

适用场景与注意¶

适合这类使用场景：

• 在 DSH 会话中写 Paper/Spigot 插件
• 在 DSH 会话中写 Fabric/Forge/NeoForge 模组
• 处理 MC 1.7.10、1.12.2、1.16.5 等老线项目
• 用子代理拆分 Minecraft 开发任务
• 需要 minecraft 专家预设的 DSH 会话

使用注意：

• 插件以当前 dsh 进程权限运行。安装前应检查源码、许可证和披露信息。
• 插件许可为 MIT。
• package.json 披露：cloud=false、network=[]、offlineMode=true、apiKeys=[]、retention=none。
• 老线 1.7.10、1.12.2、1.16.5 需手动安装 JDK 8 并设置 JAVA_HOME。
• spigot 1.7.10 模板构建前，需按项目内 libs/README.txt 放置 spigot-api jar。
• 用户本地同名技能会覆盖本包 bundled 技能，属预期行为。冲突时需删除本地同名目录。
• API 参考为精选高频签名，而非全量 Javadoc。
• npm run check-links 会校验链接与 curse.maven projectId，UNVERIFIABLE 项需人工复核。

结尾¶

minecraft-dev 的价值在于把 Minecraft 开发所需的技能、工具、子代理和 Agent 预设装进 DSH 会话里，让 agent 在处理 Paper/Spigot 插件与 Fabric/Forge/NeoForge 模组时有明确可加载的知识与工具。

目录页：
https://www.skillhub.cn/plugins/sikadi233-hub/minecraft-dev

GitHub：
https://github.com/sikadi233-hub/minecraft-dev