Minecraft Java 插件要由支援它的伺服器核心載入;原版 Vanilla 伺服器不能直接讀取 Bukkit/Paper 插件。以下以 Paper 核心為例,說明從確認相容版本到檢查是否載入成功的流程。
如果還沒決定要用插件還是模組,先看Vanilla、Paper、Fabric 與 Forge 核心比較及插件服和模組服差異,再依朋友想玩的內容選核心。
安裝前核對插件需求
- 確認伺服器正在使用 Paper 或插件作者指定的相容核心。
- 在插件作者或可信任的插件平台確認支援的 Minecraft/Paper 版本、必要依賴和 Java 版本。
- 確認下載的是伺服器插件檔案,通常是
.jar,而不是客戶端模組、原始碼或安裝器。 - 先停止伺服器,保留目前世界、
plugins資料夾和設定檔副本。
插件通常能以伺服器程序的權限存取檔案和執行程式碼。Paper 官方提醒,安裝前要信任插件來源;不要為了測試隨便執行來路不明的 JAR。Paper 插件安裝文件列出 Hangar、Modrinth 和 BukkitDev 等來源,下載前仍應檢查實際作者與版本。
把插件安裝到 Paper
- 停止伺服器並進入伺服器根目錄。
- 將插件 JAR 放到
plugins資料夾的最上層,不要再多放一層子資料夾。 - 若插件要求 Vault、ProtocolLib 或其他相依插件,也一併安裝符合版本的依賴。
- 啟動伺服器,等核心完成載入;不要在伺服器運作中直接覆蓋正在使用的插件檔案。
- 從遊戲或主控台執行
plugins,並查看logs/latest.log確認插件是否成功載入。 - 首次啟動後可依插件文件編輯它產生的設定檔,再正常重啟伺服器。
若使用託管面板,在檔案管理進入伺服器根目錄,再把 JAR 上傳到 plugins 資料夾;面板流程可搭配Pterodactyl 教學查看。不同面板的按鈕名稱可能不同,但檔案仍須放在核心會讀取的目錄。
插件沒有出現在 /plugins 怎麼辦?
- 顯示紅色或沒有載入: 查看
logs/latest.log中插件載入附近的第一個錯誤。 - 找不到依賴: 安裝插件要求的相依套件,並再次核對版本。
- 檔案沒有被掃描: 確認 JAR 在
plugins/最上層、檔名副檔名正確,且已重新啟動。 - 啟動時出現 API 或 Java 錯誤: 查看插件頁標示的伺服器版本、核心及執行環境要求。
- 問題從安裝後才發生: 停服後先移出最近新增的插件,再用副本測試;不要刪除世界檔來碰運氣。
避免使用 /reload 代替正常重啟來安裝新插件。若插件造成世界或設定異常,先停止伺服器,保留日誌和副本,再按插件作者的排錯方式處理。
Vanilla 可以安裝 Paper 插件嗎?
不行。先選擇插件作者支援的伺服器核心,例如 Paper;模組載入器的 Mod 也不能當成 Paper 插件直接放進 plugins。
插件安裝後要讓玩家下載嗎?
多數伺服器端插件不需玩家安裝,但部分插件會要求額外客戶端資源或相容工具。以插件作者說明為準,並讓玩家使用支援的遊戲版本。