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

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

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

常見模組錯誤
缺少依賴項
模組需要另一個未安裝的模組。伺服器日誌將列出缺少的模組 ID。
版本不匹配
模組是為不同的 Minecraft 版本或模組載入器版本構建的。
模組衝突
兩個模組以不相容的方式修改相同的遊戲行為。
客戶端-伺服器不同步
模組存在於伺服器上但不在客戶端上(或反之亦然)。
診斷步驟
檢查伺服器日誌中標記為 [FATAL] 或 [ERROR] 的錯誤。
識別提到 ModLoadingException 或 ModResolutionException 的錯誤。
查詢缺少的依賴項 — 日誌會指定 requires modid。
驗證所有模組匹配 Minecraft 版本和載入器版本。
分批移除模組以隔離衝突。
使用像 Modrinth 這樣內建依賴檢查的平臺。
預防
- 在新增之前檢查模組相容性
- 記錄所有已安裝的模組及版本
- 一次只新增一個模組,然後進行測試
- 保持定期備份
- 使用已知相容的模組包
混合使用來自不同 Minecraft 版本的模組幾乎總是會導致崩潰。認真檢查版本!
