ChildHood/GameConfig

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/弹珠小游戏-执行案.md v0.2.1。摩擦组合规则：最终摩擦 = 场地摩擦 + 弹珠摩擦加成。

---

工作流

1. 策划 Agent 创建/更新配置文件
2. 程序 Agent 读取配置文件，在 UE5 中创建对应的 DataTable 或 DataAsset
3. 调参时只需修改此目录下的文件，再由程序 Agent 重新导入