故障排除
插件錯誤
排查並修復 Cafora Minecraft 伺服器上的插件錯誤。
圖文操作步驟
截圖使用目前應用程式介面與示範資料。請按自己的服務資料操作,點擊圖片可檢視原圖。
檢查控制檯
開啟 Essentials → Console / 常用 → 控制檯,先檢視狀態、啟動輸出和錯誤。連線遊戲前等待 Done 或對應軟體的就緒提示。

找到檔案日誌
在檔案中雙擊 logs 並找到 latest.log,核對修改時間。在重啟覆蓋或輪換日誌前儲存相關檔案。

閱讀完整錯誤上下文
在編輯器開啟日誌,檢視最早的相關錯誤及前後文。分享前移除令牌、密碼及私人玩家資料,不要只憑最後一行判斷根因。

把報錯插件與實際檔案對應起來
先閱讀完整錯誤,找到插件名稱和版本,再進入 文件(檔案)→ plugins,核對 JAR 與目標版本及依賴要求。截圖是測試服範例,不代表每個插件都需要裝到自己的伺服器。
保留錯誤日誌並備份插件設定,停服後再替換或暫時移出可疑 JAR,每次只改一項,啟動後重現檢查。注意依賴關係,後續錯誤可能只是原始故障的結果。不要為消除錯誤就清空插件資料庫或重設全部設定。另見日誌和安裝插件。
插件錯誤範圍從小問題到導致伺服器崩潰的嚴重問題。本指南涵蓋常見插件問題及解決方案。
插件錯誤型別
啟動錯誤
插件在伺服器啟動時載入失敗:
- 缺少依賴項(需要其他插件)
- 錯誤的伺服器軟體版本(Bukkit vs Spigot vs Paper)
- 不相容的 Minecraft 版本
- 損壞的插件 JAR 檔案
執行時錯誤
插件載入後但在遊戲過程中丟擲錯誤:
- NullPointerException(訪問不存在的物件)
- 與其他插件衝突
- 配置錯誤
- 達到資料儲存限制
效能問題
插件消耗過多資源:
- 高 CPU 使用率
- 記憶體洩漏
- 磁碟 I/O 過載
診斷步驟
檢查 控制檯 中的完整錯誤訊息。
識別導致錯誤的插件名稱。
檢查 logs/latest.log 中的時間線。
暫時禁用可疑插件以確認是哪個插件。
更新插件到最新版本。
如果問題持續,聯絡插件開發者。
常見修復
- 缺少依賴項 — 安裝所需的庫插件(Vault、ProtocolLib 等)
- 版本不匹配 — 使用與您的 Minecraft/伺服器軟體版本匹配的插件版本
- 配置錯誤 — 將配置重置為預設值並重新配置
始終從 SpigotMC 或 PaperMC Hangar 等官方來源下載插件。修改過的或盜版的插件是崩潰和安全問題的常見來源。
