如何安裝 Minecraft 插件

逐步說明

1. 1.確認你的伺服器能執行插件

   插件需要以 Bukkit 為基礎的伺服器軟體：遊戲伺服器用 Paper、Spigot、Purpur 或 Folia，代理伺服器用 BungeeCord 或 Velocity。原版伺服器，以及 Fabric 或 Forge 伺服器，都不會載入插件。

2. 2.檢查插件的版本

   插件頁面或檔案會寫明它支援哪些 Minecraft 版本。為比你伺服器還新的版本建置的插件，通常會拒絕載入。

3. 3.停止伺服器並複製 .jar

   把 .jar 檔案放進伺服器 .jar 旁邊的 plugins/ 資料夾。如果用的是主機商的控制面板，就用檔案管理員或 SFTP 上傳。不要解壓縮它。

4. 4.安裝它的相依插件

   如果插件需要其他插件（Vault、PlaceholderAPI、ProtocolLib、LuckPerms），也把它們的 .jar 檔案放進 plugins/。

5. 5.啟動伺服器並查看主控台

   在啟動日誌中找插件的名字。出現「Enabling <Plugin>」而且後面沒有錯誤，就代表載入成功了。

6. 6.在遊戲中確認並設定

   執行 /plugins：已載入的插件顯示為綠色，啟用失敗的插件顯示為紅色。它的設定在 plugins/<PluginName>/config.yml；修改後重新啟動。

檔案放在哪裡

裝了插件並第一次啟動後，一般的伺服器資料夾長這樣：

• paper.jar（或 spigot.jar）：伺服器本身。
• plugins/MyPlugin.jar：你加入的插件。
• plugins/MyPlugin/：插件建立的資料夾，裡面有 config.yml、訊息和它保存的資料。
• logs/latest.log：這次執行的日誌，載入錯誤會寫在這裡。

要重新啟動，不要用 /reload

/reload 會在不重新啟動伺服器的情況下，卸載並重新載入所有插件。很多插件不支援這樣做：監聽器會註冊兩次、資料遺失，或發生記憶體洩漏。新增、移除或更新插件後，一定要重新啟動伺服器。有些插件有自己的重新載入指令（例如 /myplugin reload），只會重新載入它自己的設定：這種可以放心使用。

在正式伺服器上安裝之前

• 備份伺服器資料夾，至少要備份 plugins/ 和世界。
• 先在副本上試：使用和正式伺服器相同的軟體、版本和其他插件。請看如何測試插件。
• 一次只裝一個插件：出問題時，你就知道是哪一個造成的。
• 從作者的頁面下載（SpigotMC、Hangar、Modrinth、GitHub），不要用別人轉載的版本。

用 Codexe 製作的插件

在 Codexe 上做的插件，會以專案命名、已建置好的 .jar 交付，而且你拿到之前已經過檢查：它必須包含編譯好的類別和 plugin.yml。在安裝到任何地方之前，你都可以在私人測試伺服器上試用，所有方案都免費；測試伺服器會幫你安裝列為相依的插件。要把 .jar 下載到你自己的伺服器，需要方案或下載包。

常見問題