使用方法 · 快速上手教學

三步驟開始使用
MJP-Claude-Skills

透過 Claude Code Agent Skills,只需輸入一句自然語言,即可自動生成完整的 NMS Paper 插件程式碼。以下教學將引導你完成安裝、觸發與使用流程。

快速上手

安裝與使用步驟

01

安裝 Skills 到專案

將 MJP-Claude-Skills 的 .claude/skills/ 目錄複製到你的插件專案根目錄,或直接在 Claude Code 中開啟專案以使用 Agent Skills。

Terminal
git clone https://github.com/MrPippi/MJP-Claude-Skills.git
cp -r MJP-Claude-Skills/.claude/skills .claude/skills

也可以直接 Fork 本專案,以 .claude/skills/ 作為你 Paper 插件專案的 Claude Code Skills 來源。

02

在 Claude Code 觸發 Skill

在 Claude Code 終端機中,用自然語言描述需求,Agent 會自動選擇最匹配的 Skill 並開始生成。

"幫我發送封包"
nms-packet-sender
"攔截玩家封包"
nms-packet-interceptor
"建立自定義實體"
nms-custom-entity
"反射式 NMS 存取"
nms-reflection-bridge
"多版本 NMS 相容"
nms-version-adapter
"讀寫 NBT 資料"
nms-nbt-manipulation

觸發詞不需要完全相同,Claude Code Agent 會理解語意並自動套用最匹配的 Skill。

03

取得生成結果

Skill 執行後會根據你的需求自動生成 Java 類別、build.gradle 依賴設定等完整程式碼,可直接讓 Claude Code 寫入檔案,或複製後手動貼上。

  • Java 類別(封包發送器、實體 AI、反射橋接等)
  • build.gradle Paperweight 依賴設定
  • paper-plugin.yml 宣告片段
  • Netty ChannelHandler 管線設定
  • 執行緒安全的 Main thread dispatch 範例

生成的程式碼已包含完整的執行緒安全處理與 Mojang mappings 最佳實踐,可直接作為生產程式碼的基礎。

FAQ

常見問題

找不到答案?歡迎到 GitHub 開 Issue 詢問。

Claude Code 需要什麼版本?

MJP-Claude-Skills 設計用於 Claude Code 的 Agent Skills 系統。請確保已透過 npm install -g @anthropic-ai/claude-code 安裝 Claude Code。Skills 存放於 .claude/skills/,在 Claude Code REPL 或終端機中輸入自然語言即可觸發。

Skills 支援哪些 Minecraft 版本?

所有 Skills 預設以 Paper 1.21.x 為目標,透過 Paperweight userdev 與 Mojang mappings 存取 NMS。大多數非 NMS 工具類 Skill 同樣相容 Paper 1.20+。

Skills 會自動修改我的檔案嗎?

預設情況下,Claude Code 會提出修改建議並等待確認後才寫入檔案。你可以選擇接受或拒絕生成的程式碼。在非互動式 session 中可設定自動套用。

如何貢獻新的 Skill?

Fork 本專案後,在 Skills/nms/ 目錄下新增一個資料夾,依照現有 SKILL.md 格式撰寫你的 Skill,同步至 .claude/skills/nms/ 並更新兩邊的 skills-registry.yml。若希望新 Skill 顯示在網站上,需在 web/data/skills/ 建立對應的 .md 資料檔。最後送出 Pull Request 即可。

準備好開始了嗎?

立即瀏覽所有可用的 Skills,找到最適合你當前開發需求的工具。