指南

如何製作 Minecraft 插件

更新於 2026年10月7日

Minecraft 插件是一個 Java 程式，由 Spigot 或 Paper 伺服器載入，用來新增指令、規則或整個小遊戲。你可以自己手寫，也可以描述它，讓 AI 撰寫、編譯和測試。以下兩種方式都會介紹。

用你自己的話描述，或從這個範例開始。

用 Codexe 產生這個

逐步說明

  1. 1.選擇伺服器軟體和版本

    插件在以 Bukkit 為基礎的伺服器上執行：Spigot、Paper 或 Folia（代理伺服器則是 BungeeCord 和 Velocity）。選擇你伺服器執行的 Minecraft 版本，從 1.8 到 26.x。

  2. 2.描述插件要做什麼

    寫下指令、權限、遊戲裡會發生什麼，以及哪些要能設定。範例：「/sethome、/home 和 /delhome，每位玩家最多 3 個家，3 秒等待，訊息放在 config.yml」。

  3. 3.讓 Codexe 撰寫並編譯

    Codexe 會寫好 Java 類別、plugin.yml、config.yml 和 pom.xml，實際執行建置，並在把專案標示為完成之前修正編譯錯誤。

  4. 4.在真正的伺服器上測試

    按下「立即試用」，加入裝好插件的私人 Minecraft 伺服器。Codexe 的測試玩家會執行每個指令，並檢查你要求的內容。

  5. 5.下載並安裝 .jar

    下載建置好的 .jar，放進你伺服器的 plugins/ 資料夾，再重新啟動伺服器。設定檔會出現在 plugins/<PluginName>/ 裡。

什麼是 Minecraft 插件

插件是一個 .jar 檔案，由 Minecraft 伺服器從它的 plugins/ 資料夾載入。它只在伺服器端新增指令、遊戲規則、經濟系統、小遊戲或任何東西：玩家用一般的遊戲加入，不需要模組。

插件是用 Java（或 Kotlin）針對伺服器 API 撰寫的：遊戲伺服器用 Spigot 和 Paper，代理伺服器用 BungeeCord 或 Velocity。插件還需要一個 plugin.yml，告訴伺服器它的名稱、主類別、指令和權限。

手動方式：Java、Maven，以及 Spigot 或 Paper API

學起來比較花時間，但能完全掌控。Codexe 產出的是同一種專案，所以你可以從產生的插件開始，再自己手動繼續。

  1. 安裝 JDK（1.20.5 到 1.21.x 用 Java 21，26.x 用 Java 25）和 IntelliJ IDEA 這類 IDE。
  2. 建立 Maven 或 Gradle 專案，加入你版本的 paper-api 或 spigot-api 相依套件，範圍設為 provided。
  3. 撰寫繼承 JavaPlugin 的主類別，包含 onEnable() 和 onDisable()。
  4. 在 src/main/resources 裡加入 plugin.yml，寫上 name、version、main、api-version 和你的指令。
  5. 用 getCommand("name").setExecutor(...) 註冊指令，用 getServer().getPluginManager().registerEvents(...) 註冊監聽器。
  6. 用 mvn package 建置，把 target/ 裡的 .jar 複製到測試伺服器的 plugins/ 資料夾，再重新啟動。

常見問題

我需要會 Java 嗎？

用 AI 產生器就不需要：你負責描述插件並測試。如果你想自己修改程式碼，會 Java 會有幫助。

免費嗎？

在免費方案上，用 Codexe 建立、編譯和測試都免費（每 24 小時補充 50,000 個 token）；下載 .jar 需要方案或下載包。

做出你的第一個插件

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

“一個有 /sethome、/home 和 /delhome 的 Paper 1.21.4 插件：每位玩家最多 3 個家，3 秒等待、移動就取消，所有訊息都在 config.yml。”

用 Codexe 產生這個
如何製作 Minecraft 插件：寫程式或不寫程式 | Codexe