积分赛最小配置模板.md 3.6 KB
# 积分赛最小配置模板
本文档提供一份 积分赛（score-o）最小可跑配置模板。
目标：
- 只保留积分赛跑通所需的最少字段
- 适合快速起活动、联调、排查配置链
- 每个字段都带简要说明
1. 最小模板
{
"schemaVersion": "1",
"version": "2026.03.30",
"app": {
"id": "sample-score-o-minimal-001",
"title": "积分赛最小示例"
},
"map": {
"tiles": "../map/lxcb-001/tiles/",
"mapmeta": "../map/lxcb-001/tiles/meta.json"
},
"playfield": {
"kind": "control-set",
"source": {
"type": "kml",
"url": "../kml/lxcb-001/10/c01.kml"
}
},
"game": {
"mode": "score-o",
"punch": {
"policy": "enter-confirm",
"radiusMeters": 5
}
}
}
2. 字段说明
schemaVersion
- 类型：
string - 必填：是
- 说明：配置结构版本
- 当前建议值：
"1"
version
- 类型：
string - 必填：是
- 说明：配置版本号
app.id
- 类型：
string - 必填：是
- 说明：活动配置实例 ID
app.title
- 类型：
string - 必填：是
- 说明：活动标题 / 比赛名称
map.tiles
- 类型：
string - 必填：是
- 说明：地图瓦片根路径
map.mapmeta
- 类型：
string - 必填：是
- 说明：地图 meta 文件路径
playfield.kind
- 类型：
string - 必填：是
- 说明：空间对象类型
- 积分赛固定使用：
control-set
playfield.source.type
- 类型：
string - 必填：是
- 说明：空间底稿来源类型
- 当前推荐值：
kml
playfield.source.url
- 类型：
string - 必填：是
- 说明：KML 文件路径
game.mode
- 类型：
string - 必填：是
- 说明：玩法模式
- 积分赛固定值：
score-o
game.punch.policy
- 类型：
string - 必填：是
- 说明：打点策略
- 当前常用值：
enter-confirmenter
game.punch.radiusMeters
- 类型：
number - 必填：是
- 说明：打点判定半径，单位米
- 建议默认值：
5
3. 当前默认逻辑
如果你不写下面这些字段，积分赛会按当前客户端默认逻辑运行：
map.declination- 默认按
0处理
- 默认按
map.initialView.zoom- 默认由客户端初始视口逻辑接管
playfield.CPRadius- 默认按客户端内置值处理
playfield.controlOverrides.*.score- 没配时走
game.scoring.defaultControlScore或玩法默认值
- 没配时走
game.session.*- 默认手动开始
game.guidance.allowFocusSelection- 默认按积分赛逻辑允许选点
game.finish.finishControlAlwaysSelectable- 默认按积分赛逻辑处理终点可选
resources.*- 默认 profile
debug.*- 默认关闭
4. 推荐补充字段
如果你要让积分赛更接近正式活动，通常很快会补这几项：
{
"playfield": {
"controlOverrides": {
"control-1": {
"score": 10
},
"control-2": {
"score": 20
}
}
},
"game": {
"scoring": {
"type": "score",
"defaultControlScore": 10
},
"guidance": {
"allowFocusSelection": true
},
"finish": {
"finishControlAlwaysSelectable": true
}
}
}
5. 适用场景
这份模板适合：
- 快速验证积分赛主流程
- 联调自由选点、积分累加、终点结束
- 后台先跑通最小积分赛配置
如果要看更完整版本，请继续参考：