來源：https://diamondhost.tw/blog/minecraft-paper-plugin-install-guide/

[網站首頁](https://diamondhost.tw/)/[知識文章](https://diamondhost.tw/blog/)/Minecraft 開服

FIELD NOTES / Minecraft 開服

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

![](/images/optimized/logo-48.webp?v=20260722-1) 鑽石託管技術團隊 · 約 3 分鐘閱讀

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

如果還沒決定要用插件還是模組，先看[Vanilla、Paper、Fabric 與 Forge 核心比較](https://diamondhost.tw/blog/minecraft-server-core-comparison/)及[插件服和模組服差異](https://diamondhost.tw/blog/plugins-vs-mods/)，再依朋友想玩的內容選核心。

## 安裝前核對插件需求

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

插件通常能以伺服器程序的權限存取檔案和執行程式碼。Paper 官方提醒，安裝前要信任插件來源；不要為了測試隨便執行來路不明的 JAR。[Paper 插件安裝文件](https://docs.papermc.io/paper/adding-plugins/)列出 Hangar、Modrinth 和 BukkitDev 等來源，下載前仍應檢查實際作者與版本。

## 把插件安裝到 Paper

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

若使用託管面板，在檔案管理進入伺服器根目錄，再把 JAR 上傳到 `plugins` 資料夾；面板流程可搭配[Pterodactyl 教學](https://diamondhost.tw/blog/pterodactyl-guide/)查看。不同面板的按鈕名稱可能不同，但檔案仍須放在核心會讀取的目錄。

## 插件沒有出現在 `/plugins` 怎麼辦？

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

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

### Vanilla 可以安裝 Paper 插件嗎？

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

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

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

### 參考資料

*   [PaperMC：安裝插件](https://docs.papermc.io/paper/adding-plugins/)
*   [PaperMC：插件設定文件格式](https://docs.papermc.io/paper/dev/plugin-configurations/)
*   [Pterodactyl 面板教學](https://diamondhost.tw/blog/pterodactyl-guide/)

希望這篇文章對你有幫助。

[需要主機？查看鑽石託管方案](https://store.diamondhost.tw)

KEEP READING

## 接著閱讀

Minecraft 開服

### [Minecraft 手機版怎麼加入伺服器？基岩版 IP 與連接埠設定](https://diamondhost.tw/blog/minecraft-bedrock-join-server-mobile/)

Minecraft 開服

### [Minecraft 自架開服遇到 CGNAT？檢查公網 IP 與連線替代方案](https://diamondhost.tw/blog/minecraft-cgnat-port-forwarding/)

Minecraft 開服

### [Minecraft Forge／Fabric 模組伺服器怎麼裝？核心、模組與版本同步](https://diamondhost.tw/blog/minecraft-forge-fabric-mod-server-install/)

[回到所有文章](https://diamondhost.tw/blog/)