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

本页内容