docs(design): v0.2 弹珠小游戏与蹲下系统设计准备

- 弹珠小游戏执行案 v0.2.1(经6维度对抗性审查修订25项问题)
- 蹲下系统执行案 v0.2.0(玩家控制器姿态扩展)
- v0.2 范围定义(对标 v01-范围)
- 弹珠操作手感与系统决策头脑风暴共识
- 弹珠配置表(属性/场地/NPC/参数,4个文件)
- 更新设计文档索引与 GameConfig 说明

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-15 05:07:41 +08:00
parent 893ef1eac2
commit 2c10eedad3
10 changed files with 1143 additions and 2 deletions
+14
View File
@@ -37,6 +37,20 @@ marble_large,大弹珠,2.5,20,80,25
}
```
## 弹珠小游戏配置(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 创建/更新配置文件