可选联动

plugin.yml 将 CraftEngine、Residence、emotecraft 和 BodySize 声明为软依赖。缺失某个插件时，核心比赛仍应加载，只禁用对应能力。

CraftEngine

用途：把自定义物品作为足球外观。

/ccb setballce <场地> <命名空间:id|clear>

也可用 /ccb setballhand <场地> 保存主手物品快照。ID 无法解析或 CraftEngine 缺失时回退原版足球外观。

Residence

用途：

• 等待大厅领地检查。
• 场地位置校验。
• 领地内比分 BossBar。

通过 waitingLobby.residence 指定大厅领地，留空关闭。升级 Residence 后重新验证事件和调度契约。

Emotecraft

插件清单名称为 emotecraft，文档使用 Emotecraft 指代该联动。比赛流程可限制或协调表情行为，避免动作影响比赛状态。未安装时不影响核心足球逻辑。

BodySize

比赛开始前保存玩家体型相关状态，比赛期间限制会改变参赛者体型的操作，离场时与其他玩家状态一同恢复。

排障顺序

1. 确认软依赖先于 CubeCubeBall 加载。
2. 检查版本是否支持 Minecraft 26.2 与 Java 25。
3. 检查命名空间 ID、Residence 名称或玩家状态是否真实存在。
4. 暂时移除单个软依赖并完整重启，确认核心比赛是否正常。
5. 不在运行中热替换依赖 JAR。