CAFORADocs
故障排除

模組錯誤

排查並修復 Cafora Minecraft 伺服器上的模組錯誤。

圖文操作步驟

截圖使用目前應用程式介面與示範資料。請按自己的服務資料操作,點擊圖片可檢視原圖。

檢查控制檯

開啟 Essentials → Console / 常用 → 控制檯,先檢視狀態、啟動輸出和錯誤。連線遊戲前等待 Done 或對應軟體的就緒提示。

檢查控制檯
檢查控制檯2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

找到檔案日誌

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

找到檔案日誌
找到檔案日誌2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

閱讀完整錯誤上下文

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

閱讀完整錯誤上下文
閱讀完整錯誤上下文2026-11-11 · 目前應用程式介面 · 示範資料 · 開啟原圖檢視

向支援說明請求

開啟支援工單,填寫服務或發票編號及具體請求。連線問題請附時間、錯誤和 MTR 證據,不要傳送密碼、令牌或銀行卡資料。

向支援說明請求
向支援說明請求2026-11-11 · 公開頁面 · 不含私人帳號資料 · 開啟原圖檢視

常見模組錯誤

缺少依賴項

模組需要另一個未安裝的模組。伺服器日誌將列出缺少的模組 ID。

版本不匹配

模組是為不同的 Minecraft 版本或模組載入器版本構建的。

模組衝突

兩個模組以不相容的方式修改相同的遊戲行為。

客戶端-伺服器不同步

模組存在於伺服器上但不在客戶端上(或反之亦然)。

診斷步驟

檢查伺服器日誌中標記為 [FATAL] 或 [ERROR] 的錯誤。

識別提到 ModLoadingException 或 ModResolutionException 的錯誤。

查詢缺少的依賴項 — 日誌會指定 requires modid。

驗證所有模組匹配 Minecraft 版本和載入器版本。

分批移除模組以隔離衝突。

使用像 Modrinth 這樣內建依賴檢查的平臺。

預防

  • 在新增之前檢查模組相容性
  • 記錄所有已安裝的模組及版本
  • 一次只新增一個模組,然後進行測試
  • 保持定期備份
  • 使用已知相容的模組包

混合使用來自不同 Minecraft 版本的模組幾乎總是會導致崩潰。認真檢查版本!


Service information · Backups · Support

本頁內容