配置

场地坐标和比赛数据优先通过 /ccb GUI 管理，避免手工编辑 matches 导致世界、坐标或区域不一致。

默认结构

language: zh

player-identity:
  mode: name

maxMatchPerPlayer: 3
debug: false
lobbySpawn: null
exitSpawn: null

waitingLobby:
  residence: zqc

bossbar:
  redteam: 红队
  blueteam: 蓝队

ball:
  glow: true
  roll:
    enabled: true
    speed: 1.0

visuals:
  enabled: true
  menu-sounds: true
  setup-feedback: true
  lobby-feedback: true
  match-feedback: true
  ball-impact: true
  goal-burst: true
  ball-trail:
    enabled: true
    interval-ticks: 4

matches: []

通用设置

键	默认	说明
`language`	`zh`	`zh` 或 `en`
`player-identity.mode`	`name`	`name` 适合离线服；UUID 稳定的正版服建议 `uuid`
`maxMatchPerPlayer`	`3`	非管理员最多创建场地数
`debug`	`false`	只在排障时启用，避免长期产生大量日志
`lobbySpawn`	`null`	`/ccb spawn` 或 GUI 保存
`exitSpawn`	`null`	`/ccb exitspawn` 或 GUI 保存

切换识别模式前评估现有玩家备份和场地所有者数据。不要在有未恢复备份时随意从 name 改成 uuid。

大厅与 BossBar

waitingLobby.residence：等待大厅 Residence 名称；空字符串关闭检查。
bossbar.redteam：红队显示名。
bossbar.blueteam：蓝队显示名。

命令 /ccb redteam 和 /ccb blueteam 可以修改队名。

足球与视觉

ball.glow：发光。
ball.roll.enabled：自定义物品足球滚动。
ball.roll.speed：速度倍率，建议 0.2–3.0。
visuals.enabled：总开关。
visuals.menu-sounds：菜单音效。
visuals.setup-feedback：场地设置反馈。
visuals.lobby-feedback：大厅反馈。
visuals.match-feedback：比赛反馈。
visuals.ball-impact：碰撞反馈。
visuals.goal-burst：进球粒子。
visuals.ball-trail.enabled：尾迹。
visuals.ball-trail.interval-ticks：粒子生成间隔，默认 4。

`matches`

matches 保存场地数据。通过 GUI 修改位置、规则和外观；手工编辑前必须停服并完整备份，且所有坐标需属于正确世界。

`/ccb reload`

热加载流程异步读取配置和语言，再在全局调度上下文应用通用设置。可更新语言、创建上限、BossBar 名称、大厅/退出位置和视觉开关；不会替换正在进行的比赛或当前 matches 运行状态。

默认结构​

通用设置​

大厅与 BossBar​

足球与视觉​

matches​

/ccb reload​