故障排除
模组错误
排查并修复 Cafora Minecraft 服务器上的模组错误。
图文操作步骤
截图使用当前应用界面与演示数据。请按自己的服务资料操作,点击图片可查看原图。
检查控制台
打开 Essentials → Console / 常用 → 控制台,先查看状态、启动输出和错误。连接游戏前等待 Done 或对应软件的就绪提示。

阅读完整错误上下文
在编辑器打开日志,查看最早的相关错误及前后文。分享前移除令牌、密码及私人玩家资料,不要只凭最后一行判断根因。

常见模组错误
缺少依赖项
模组需要另一个未安装的模组。服务器日志将列出缺少的模组 ID。
版本不匹配
模组是为不同的 Minecraft 版本或模组加载器版本构建的。
模组冲突
两个模组以不兼容的方式修改相同的游戏行为。
客户端-服务器不同步
模组存在于服务器上但不在客户端上(或反之亦然)。
诊断步骤
检查服务器日志中标记为 [FATAL] 或 [ERROR] 的错误。
识别提到 ModLoadingException 或 ModResolutionException 的错误。
查找缺少的依赖项 — 日志会指定 requires modid。
验证所有模组匹配 Minecraft 版本和加载器版本。
分批移除模组以隔离冲突。
使用像 Modrinth 这样内置依赖检查的平台。
预防
- 在添加之前检查模组兼容性
- 记录所有已安装的模组及版本
- 一次只添加一个模组,然后进行测试
- 保持定期备份
- 使用已知兼容的模组包
混合使用来自不同 Minecraft 版本的模组几乎总是会导致崩溃。认真检查版本!

