常见问题

扫描后无法开始比赛

确认红蓝出生点、双方球门和足球出生点已设置，让玩家站到对应出生点后重新扫描。目标比分 0 表示不限分，不是配置缺失。

玩家离场后背包没有恢复

玩家上线后插件会检查持久化备份。目标在线时，管理员可执行 /ccb check <玩家名或 UUID>。不要直接删除 inv_backup/。

/ccb check 会复制物品吗？

它只在存在备份且目标在线时恢复，并在成功路径清理备份；不会创建第二份背包内容。发现异常时先停止重复操作并保存日志/备份。

暂停后如何继续？

管理员执行 /ccb resume [场地]。恢复会进行 3 秒倒计时；队伍暂停到期也进入同一倒计时。

CraftEngine 足球没有显示

确认 CraftEngine 已加载、命名空间 ID 可解析且客户端资源可用。失败时插件回退原版足球外观。

Residence 大厅检查不需要怎么办？

把 waitingLobby.residence 设为空字符串并执行 /ccb reload。Residence 本身是软依赖。

离线服和正版服如何选择身份模式？

离线服通常使用 player-identity.mode: name，UUID 稳定的正版服建议 uuid。有未恢复玩家备份时不要直接切换。

Luminol build 726 验证过，为什么还有警告？

运行验证表示特定场景在该核心上测试过；静态审查按项目给定规则发现 runRegion/runEntity 的 Rule 7 must_fix。两类证据不能互相替代。

Paper 或其他 Folia 分支能直接使用吗？

项目保留对应路径，但资料中的运行基线只明确到 Luminol 26.2 build 726。其他核心部署前需要真实联机验证。