Skip to content
MJP
/ 開始使用

開始使用

三步驟開始使用

用一句自然語言，讓你的 AI 編碼工具產生完整的 Paper 插件程式碼。Skills 採用開放的 Agent Skills（SKILL.md）格式，Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI 等工具都能載入。

安裝與使用

  1. 01

    安裝 Skills 到專案

    用 skills CLI 安裝：它會找出你使用的 AI 工具（Claude Code、Codex、Cursor、Copilot、Gemini CLI…），把 Skills 複製到各工具讀取的目錄。也可以自行複製。

    npx skills add MrPippi/MJP-Paper-Skills                             # 選擇技能與工具
npx skills add MrPippi/MJP-Paper-Skills --skill paper-dialog-ui   # 只裝一個技能

# 自行複製安裝
git clone https://github.com/MrPippi/MJP-Paper-Skills.git
cp -r MJP-Paper-Skills/.claude/skills .agents/skills
    每個技能的 references/ 都已放入建置設定與執行緒規則，只裝單一技能也能用。自行安裝路徑：Claude Code 用 .claude/skills/、Codex 與 Gemini CLI 用 .agents/skills/、Cursor 用 .cursor/skills/、GitHub Copilot 用 .github/skills/，實際路徑以各工具官方文件為準。不支援 Agent Skills 的工具，可在 AGENTS.md 或規則檔中引用需要的 SKILL.md。
  2. 02

    在 AI 工具中觸發 Skill

    用自然語言描述需求，Agent 會依觸發關鍵字選出最合適的 Skill。

    觸發詞不需完全相同，AI 工具會依 Skill 的描述理解語意。
  3. 03

    取得產出

    Skill 會產生 Java 類別、build.gradle、paper-plugin.yml 等，可直接寫入檔案。

    • Java 類別（封包發送器、實體 AI、Repository、指令…）
    • build.gradle（Paperweight 或 paper-api）
    • paper-plugin.yml 宣告片段
    • 執行緒安全的主執行緒切換範例
    • 1.21.11 差異以 // @1.21.11: 行尾標註
    產出遵守平台執行緒規則與 Mojang 官方命名，可直接作為正式程式碼的基礎。

常見問題

找不到答案？到 GitHub 開 Issue。 GitHub Issues ↗

可以搭配哪些 AI 工具？+

任何支援 Agent Skills（SKILL.md 開放格式）的 AI 編碼工具，例如 Claude Code、OpenAI Codex、Cursor、GitHub Copilot、Gemini CLI。不支援的工具也能在 AGENTS.md 或規則檔中引用 SKILL.md，或直接把它們當成 Paper 開發參考文件閱讀。

支援哪些 Minecraft 版本？+

所有範本都對 Paper 1.21.11 與 26.2 實際編譯驗證。NMS 技能透過 Paperweight userdev；Paper API 技能只需 paper-api。兩版寫法不同處以 // @1.21.11: 標註。

NMS 與 Paper API 技能該選哪個？+

能用 Paper API 完成就優先選 Paper API —— 升級成本最低。需要封包、Netty、實體 AI 或假玩家等原版內部功能時才用 NMS 技能。

Skills 會自動改我的檔案嗎？+

Skills 本身只是說明文件，寫不寫入檔案由你的 AI 工具決定；多數工具預設會先提出修改並等你確認。

如何貢獻新的 Skill？+

Fork 後在 Skills/nms/ 或 Skills/paper/ 新增目錄，撰寫 SKILL.md 與 examples.md，同步到 .claude/skills/、更新兩份 skills-registry.yml，並在 web/data/skills/ 新增網站頁面後送出 Pull Request。

準備好了嗎？

瀏覽全部 Skills，找到符合你當前需求的那一個。

瀏覽 Skills →