指南

如何製作 Spigot 插件

更新於 2026年10月7日

Spigot 插件使用 Bukkit/Spigot API，所以能在 Spigot 和它的所有分支（包括 Paper）上執行。當你不知道插件會在哪裡執行時，這是適用範圍最廣的選擇。這份指南涵蓋專案、程式碼和建置。

把範例改成適合你伺服器的內容。

用 Codexe 產生這個

逐步說明

  1. 1.設定 Java 和建置工具

    安裝符合你 Minecraft 版本的 JDK（17、21 或 25），並使用 Maven 或 Gradle。

  2. 2.加入 Spigot API

    從 Spigot 儲存庫加入你版本的 spigot-api，範圍設為 provided。它只在編譯時需要；執行時由伺服器提供。

  3. 3.撰寫指令和監聽器

    用 getCommand("name").setExecutor(...) 註冊 CommandExecutor，用 registerEvents 註冊事件監聽器。

  4. 4.撰寫 plugin.yml

    名稱、版本、主類別、api-version（1.13 起）、指令和權限。

  5. 5.建置並安裝

    執行 mvn package，再把 target/ 裡的 .jar 複製到伺服器的 plugins/ 資料夾，然後重新啟動。

舊版本（1.8 到 1.12）

很多小遊戲伺服器還在跑 1.8。它的 API 比較舊（沒有 api-version，材質名稱也不同），所以插件必須針對那個版本撰寫，不能直接照抄 1.21 的教學。Codexe 會詢問版本，並針對那個 API 撰寫程式碼。

用 Codexe

描述插件，並寫明「Spigot」和版本。Codexe 會產生 Maven 專案、編譯、修正錯誤，並讓你在下載前，先在該版本的測試伺服器上測試。

常見問題

我需要 BuildTools 嗎？

只有在要架 Spigot 伺服器或使用 NMS（伺服器內部程式碼）時才需要。要針對一般 API 編譯，有 spigot-api 相依套件就夠了。

Spigot 插件還是 Paper 插件？

如果必須到處都能執行，就選 Spigot；如果你的伺服器跑 Paper，又想用它額外的 API，就選 Paper。請看如何製作 Paper 插件。

製作 Spigot 插件

這則提示詞開啟後即可直接傳送：

“一個叫 Kits 的 Spigot 1.8.8 插件：/kit <name> 發放一組可設定的物品，每個套組各有冷卻時間，套組在 config.yml 定義，每個套組的權限為 kits.<name>，冷卻時間在重新啟動後保留。”

用 Codexe 產生這個
如何製作 Spigot 插件：設定、程式碼、建置 | Codexe