starmen1265
2c10eedad3
- 弹珠小游戏执行案 v0.2.1（经6维度对抗性审查修订25项问题） - 蹲下系统执行案 v0.2.0（玩家控制器姿态扩展） - v0.2 范围定义（对标 v01-范围） - 弹珠操作手感与系统决策头脑风暴共识 - 弹珠配置表（属性/场地/NPC/参数，4个文件） - 更新设计文档索引与 GameConfig 说明 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.1 KiB
2.1 KiB
GameConfig/ — 游戏数值配置
策划 Agent 维护的游戏数值配置目录。程序 Agent 读取后导入 UE5 DataTable/DataAsset。
注意：此目录与 UE5 引擎的
Config/无关。Config/存放引擎 ini 配置，GameConfig/存放游戏设计数据。
格式约定
CSV 文件
- 逗号分隔，首行为表头
- 文件名使用小写英文 + 连字符：
marble-params.csv - 示例：
name,displayName,radius,powerMin,powerMax,scoreValue
marble_small,小弹珠,1.0,10,50,10
marble_large,大弹珠,2.5,20,80,25
JSON 文件
- 扁平键值结构为主，避免深层嵌套
- 文件名使用小写英文 + 连字符：
economy.json - 示例：
{
"currency": {
"startAmount": 50,
"maxAmount": 9999
},
"shop": {
"marblePrice": 5,
"ropePrice": 3
}
}
弹珠小游戏配置（v0.2）
| 文件 | 格式 | 用途 | 关键单位 |
|---|---|---|---|
marble-types.csv |
CSV | 弹珠属性（玻璃/陶瓷/铁 + 目标弹珠 + 兜底弹珠） | radius_m（米）、mass（相对值）、frictionAdd/restitution（无量纲 0-1） |
marble-venues.csv |
CSV | 场地配置（水泥地/泥土地） | friction（无量纲） |
marble-npc.csv |
CSV | NPC 对手配置（死党B/小霸王） | angleError_deg（度）、powerError/basePower（%）、distComp（%/m） |
marble-config.json |
JSON | 画圈弹规则、操作、物理、库存、时序等键值参数 | 见各字段 unit |
CSV 列名后缀表示单位（
_m米、_deg度、_pct百分比、_pctPerM每米百分比、_mps米/秒、_hz赫兹）。JSON 每个参数为{value, min, max, unit, note}对象，value 为建议值（程序导入用），min/max 为可调范围。 来源：docs/design/弹珠小游戏-执行案.mdv0.2.1。摩擦组合规则：最终摩擦 = 场地摩擦 + 弹珠摩擦加成。
工作流
- 策划 Agent 创建/更新配置文件
- 程序 Agent 读取配置文件，在 UE5 中创建对应的 DataTable 或 DataAsset
- 调参时只需修改此目录下的文件，再由程序 Agent 重新导入