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

59 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 积分赛游戏配置项
> 文档版本v1.0
> 最后更新2026-04-02
本文档用于汇总当前系统对 `score-o` 的已支持可配置项,重点只看和积分赛玩法直接相关的字段。
说明:
- 跨玩法公共字段请继续参考 [配置选项字典](D:/dev/cmr-mini/doc/config/配置选项字典.md)
- 本文只补积分赛视角下最常用、最关键的字段
## 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`
- 默认随机数学题
- 答对加该点同分奖励
- 答错或超时不得奖励分
详细规则请看:
- [规则说明文档](D:/dev/cmr-mini/doc/games/积分赛/规则说明文档.md)