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>
59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
# 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 重新导入
|