refactor(config): 游戏配置目录从 config/ 迁移到 GameConfig/

2026-06-01 17:55:16 +08:00
parent a43bc5cc1d
commit 8889a5a369
7 changed files with 196 additions and 25 deletions
@@ -0,0 +1,44 @@
+# 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
+  }
+}
+```
+
+## 工作流
+
+1. 策划 Agent 创建/更新配置文件
+2. 程序 Agent 读取配置文件，在 UE5 中创建对应的 DataTable 或 DataAsset
+3. 调参时只需修改此目录下的文件，再由程序 Agent 重新导入