cmr-mini/doc/games/积分赛/游戏配置项.md

积分赛游戏配置项

文档版本：v1.0 最后更新：2026-04-02 08:28:05

本文档用于汇总当前系统对 score-o 的已支持可配置项，重点只看和积分赛玩法直接相关的字段。

说明：

• 跨玩法公共字段请继续参考 配置选项字典
• 本文只补积分赛视角下最常用、最关键的字段

1. 顶层与样例入口

字段	作用	默认逻辑
game.mode	指定玩法模式	固定为 score-o
event/score-o.json	当前联调样例	可直接运行

2. 点位与分值

字段	作用	可选项 / 取值	默认逻辑
playfield.controlOverrides.<key>.score	单个积分点分值	number	未配置时回退到 game.scoring.defaultControlScore，再回退到玩法默认 10
playfield.controlOverrides.<key>.title	打点后内容卡标题	string	未配置时走系统默认文案
playfield.controlOverrides.<key>.body	打点后内容卡正文	string	未配置时走系统默认文案
playfield.controlOverrides.<key>.autoPopup	打点后是否先弹内容卡	true / false	默认 true；即使关闭，普通点默认题卡仍会自动进入

3. 选点与打点

字段	作用	可选项 / 取值	默认逻辑
game.punch.policy	打点方式	enter / enter-confirm	默认 enter-confirm
game.punch.radiusMeters	打点半径	number	默认 5
game.punch.requiresFocusSelection	是否必须先选目标点	true / false	默认 true
game.guidance.allowFocusSelection	是否允许点击地图切换目标点	true / false	默认 true

4. 结束与结算

字段	作用	可选项 / 取值	默认逻辑
game.finish.finishControlAlwaysSelectable	终点是否始终可打	true / false	默认 true
game.session.autoFinishOnLastControl	最后一个积分点后是否自动结束	true / false	默认 false
game.session.requiresFinishPunch	是否要求打终点才结束	true / false	当前默认 false

5. 默认答题逻辑

当前普通积分点会自动进入默认题卡流程，默认口径如下：

• 倒计时 10 秒
• 默认随机数学题
• 答对加该点同分奖励
• 答错或超时不得奖励分

详细规则请看：

• 规则说明文档