# GameConfig/ — 游戏数值配置

策划 Agent 维护的游戏数值配置目录。程序 Agent 读取后导入 UE5 DataTable/DataAsset。

> **注意**：此目录与 UE5 引擎的 `Config/` 无关。`Config/` 存放引擎 ini 配置，`GameConfig/` 存放游戏设计数据。

## 格式约定

### CSV 文件

- 逗号分隔，首行为表头
- 文件名使用小写英文 + 连字符：`marble-params.csv`
- 示例：

```csv
name,displayName,radius,powerMin,powerMax,scoreValue
marble_small,小弹珠,1.0,10,50,10
marble_large,大弹珠,2.5,20,80,25
```

### JSON 文件

- 扁平键值结构为主，避免深层嵌套
- 文件名使用小写英文 + 连字符：`economy.json`
- 示例：

```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 重新导入