Minecraft Paper 插件怎麼安裝?下載、上傳與錯誤排查

本文目錄

Minecraft Java 插件要由支援它的伺服器核心載入;原版 Vanilla 伺服器不能直接讀取 Bukkit/Paper 插件。以下以 Paper 核心為例,說明從確認相容版本到檢查是否載入成功的流程。

如果還沒決定要用插件還是模組,先看Vanilla、Paper、Fabric 與 Forge 核心比較及插件服和模組服差異,再依朋友想玩的內容選核心。

安裝前核對插件需求

  1. 確認伺服器正在使用 Paper 或插件作者指定的相容核心。
  2. 在插件作者或可信任的插件平台確認支援的 Minecraft/Paper 版本、必要依賴和 Java 版本。
  3. 確認下載的是伺服器插件檔案,通常是 .jar,而不是客戶端模組、原始碼或安裝器。
  4. 先停止伺服器,保留目前世界、plugins 資料夾和設定檔副本。

插件通常能以伺服器程序的權限存取檔案和執行程式碼。Paper 官方提醒,安裝前要信任插件來源;不要為了測試隨便執行來路不明的 JAR。Paper 插件安裝文件列出 Hangar、Modrinth 和 BukkitDev 等來源,下載前仍應檢查實際作者與版本。

把插件安裝到 Paper

  1. 停止伺服器並進入伺服器根目錄。
  2. 將插件 JAR 放到 plugins 資料夾的最上層,不要再多放一層子資料夾。
  3. 若插件要求 Vault、ProtocolLib 或其他相依插件,也一併安裝符合版本的依賴。
  4. 啟動伺服器,等核心完成載入;不要在伺服器運作中直接覆蓋正在使用的插件檔案。
  5. 從遊戲或主控台執行 plugins,並查看 logs/latest.log 確認插件是否成功載入。
  6. 首次啟動後可依插件文件編輯它產生的設定檔,再正常重啟伺服器。

若使用託管面板,在檔案管理進入伺服器根目錄,再把 JAR 上傳到 plugins 資料夾;面板流程可搭配Pterodactyl 教學查看。不同面板的按鈕名稱可能不同,但檔案仍須放在核心會讀取的目錄。

插件沒有出現在 /plugins 怎麼辦?

  • 顯示紅色或沒有載入: 查看 logs/latest.log 中插件載入附近的第一個錯誤。
  • 找不到依賴: 安裝插件要求的相依套件,並再次核對版本。
  • 檔案沒有被掃描: 確認 JAR 在 plugins/ 最上層、檔名副檔名正確,且已重新啟動。
  • 啟動時出現 API 或 Java 錯誤: 查看插件頁標示的伺服器版本、核心及執行環境要求。
  • 問題從安裝後才發生: 停服後先移出最近新增的插件,再用副本測試;不要刪除世界檔來碰運氣。

避免使用 /reload 代替正常重啟來安裝新插件。若插件造成世界或設定異常,先停止伺服器,保留日誌和副本,再按插件作者的排錯方式處理。

Vanilla 可以安裝 Paper 插件嗎?

不行。先選擇插件作者支援的伺服器核心,例如 Paper;模組載入器的 Mod 也不能當成 Paper 插件直接放進 plugins。

插件安裝後要讓玩家下載嗎?

多數伺服器端插件不需玩家安裝,但部分插件會要求額外客戶端資源或相容工具。以插件作者說明為準,並讓玩家使用支援的遊戲版本。

參考資料