前言¶

在 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