使用方法 · 快速上手教學

三步驟開始使用
MPS Skills

透過 Cursor Agent Skills,只需輸入一句自然語言,即可自動生成完整的 Spigot / Paper 插件程式碼。 以下教學將引導你完成安裝、觸發與使用流程。本網站主要展示 Paper/Bukkit Skills;更多 Skills(含 Velocity、Waterfall、Purpur)請見 GitHub 專案

快速上手

安裝與使用步驟

01

安裝 Skills 到 Cursor

將 MPS 專案的 .cursor/skills/ 目錄複製到你的插件專案根目錄,或在 Cursor 設定中將 MPS 的 skills-registry.yml 加入 Agent Skills 來源路徑。

Terminal
git clone https://github.com/MrPippi/MPS.git
cp -r MPS/.cursor/skills .cursor/skills

也可以直接 Fork 本專案,以 .cursor/skills/ 作為你插件專案的子目錄。

02

在 Cursor Chat 觸發 Skill

開啟 Cursor 的 AI Chat(Ctrl+L / ⌘L),直接用自然語言輸入觸發關鍵字,Agent 會自動選擇對應的 Skill 並開始生成。

「幫我建立指令」
generate-command-handler
「幫我產生 config.yml」
generate-config-yml
「幫我建立資料庫管理器」
generate-database-manager
「監聽事件」
generate-event-listener
「Vault 整合」
integrate-vault
「幫我建立 CI/CD」
generate-cicd-workflow

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

03

取得生成結果

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

  • Java 類別(CommandExecutor、EventListener、DatabaseManager 等)
  • plugin.yml 指令/權限宣告片段
  • pom.xml Maven 依賴設定
  • config.yml 設定檔與 ConfigManager
  • GitHub Actions CI/CD workflow YAML

生成的程式碼已包含完整的繁體中文註解與最佳實踐範例,可直接作為生產程式碼的基礎。

FAQ

常見問題

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

需要什麼版本的 Cursor?

建議使用 Cursor 0.40 以上版本,以確保 Agent Skills(.cursor/skills/ 目錄)功能正常運作。請確認 Cursor 設定中已啟用 Agent 模式。

Skills 支援哪些 Minecraft 版本?

所有 Skills 預設以 Paper 1.20+ 為目標,生成的程式碼同時相容 Spigot 1.19+。部分 Skill(如 generate-database-manager)使用 HikariCP,需在 pom.xml 加入對應依賴,生成結果已自動包含。

Skills 會直接修改我的程式碼嗎?

預設情況下,Cursor Agent 在執行 Skill 後會提出修改建議,你可以選擇接受(Apply)或拒絕(Reject)。若你希望 Agent 自動套用,可在 Cursor 設定中開啟 Auto-apply 功能。

如何貢獻新的 Skill?

Fork 本專案後,在 .cursor/skills/ 目錄下新增一個資料夾,依照現有 SKILL.md 格式撰寫你的 Skill,並更新 .cursor/skills/skills-registry.yml。若希望新 Skill 顯示在網站上,需同步在 web/data/skills/ 建立對應的 .md 資料檔(可透過「同步 Skill 到網站」觸發 sync-website-skill 協助)。最後送出 Pull Request 即可,詳細說明請參考 GitHub 上的貢獻指南。

可以在非 Minecraft 項目中使用這些 Skills 嗎?

這套 Skills 專門針對 Bukkit/Spigot/Paper Minecraft 插件開發設計,部分 Skills(如 generate-database-manager、generate-cicd-workflow)的概念可通用,但生成的程式碼結構仍以 Maven + Java 插件專案為前提。

生成的程式碼需要手動調整嗎?

Skills 生成的程式碼為高品質骨架,通常只需根據你的具體需求填入業務邏輯(如資料庫欄位名稱、指令參數數量等)。細節說明已包含在生成的程式碼註解中。

準備好開始了嗎?

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