故障排查

/cg validate 报资源缺失

1. 确认 CraftEngine 已启用。
2. 确认 resources/chess 位于 plugins/CraftEngine/resources/chess。
3. 检查是否混入旧版或重复资源目录。
4. 完整重启 CraftEngine 和服务器后再次验证。

棋盘无法创建

• 管理员必须看向 8 格内的地面。
• 目标点周围需留出对应棋盘尺寸、至少两格高的完整空间。
• 检查名称是否重复、类型拼写和五子棋尺寸是否在 9～19。

全息没有出现

确认棋盘所在区块已加载，检查 config.yml 的 holograms 开关、可视距离和高度。执行 /cg reload 可安全重建全息。

房间或规则异常

• 用 /cg status [房间] 确认双方和当前回合。
• 围棋与飞行棋暂不支持自动房间。
• 象棋或军棋补摆被拒绝时，棋子层已有方块，必须先确认并清空。
• 重启后未恢复时检查 rooms.yml YAML 与保存错误。

提交问题时附完整启动日志、Paper/CraftEngine/插件版本、/cg validate 输出及棋盘类型。