From ef65cba162ce7aefa074bf5f04207d0406345d8b Mon Sep 17 00:00:00 2001 From: Joywayer Date: Wed, 22 Jul 2026 15:52:52 +0800 Subject: [PATCH] =?UTF-8?q?docs(handbook):=2007=20=E6=B8=B8=E6=88=8F?= =?UTF-8?q?=E8=AE=BE=E8=AE=A1=E5=99=A8=E5=90=8C=E6=AD=A5=E5=AD=97=E6=AE=B5?= =?UTF-8?q?=E5=8C=96=E8=A1=A8=E5=8D=95/=E5=8F=8C=E8=AF=AD/=E8=A1=8C?= =?UTF-8?q?=E7=BC=96=E8=BE=91=E5=99=A8=E7=8E=B0=E7=8A=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/handbook/07_game_designer.md | 35 ++++++++++++++++++------------- 1 file changed, 21 insertions(+), 14 deletions(-) diff --git a/docs/handbook/07_game_designer.md b/docs/handbook/07_game_designer.md index 6fd642c..e6b220a 100644 --- a/docs/handbook/07_game_designer.md +++ b/docs/handbook/07_game_designer.md @@ -26,14 +26,18 @@ --- -## 3. 五个分页详解 +## 3. 七个分页详解 + +> 所有分页均为**字段化表单**（输入框/下拉/复选框/行编辑器），选项显示为「中文 English」双语，**无需手写 JSON**。 ### ✨ 法术（spells.json） -新增/编辑/删除法术，最丰富的玩法配置。详见 [06 法术编辑器](06_spell_editor.md)（meta 字段速查表）。 +新增/编辑/删除法术，最丰富的玩法配置。**字段化表单**，详见 [06 法术编辑器](06_spell_editor.md)。 - 列表 → 选中编辑；➕新增 / ⧉复制 / 🗑删除 -- 字段：ID / 类型(ACTION/MODIFIER/TRIGGER/LOGIC) / 显示名 / 描述 / 元素标签 / meta(JSON) -- 「插入该类型 meta 模板」一键填入起始参数（模板已含 `mana_cost` 蓝耗、`shop_cost` 售价） -- 💧 **蓝耗**：每个法术的 `meta.mana_cost` 决定施放消耗的魔力（0=免蓝）；权威数值见 `numerical_design §2` +- 固定字段：ID / 类型(动作/修饰/触发/逻辑) / 显示名 / 描述 +- **元素标签**：火/冰/雷/水/毒 复选框（可多选）+ 自定义标签框（非元素 tag） +- **通用 meta**：蓝耗 mana_cost / 商店价 shop_cost / 解锁价 unlock_cost +- **动态字段**：随类型（及 ACTION 动作种类 弹道/毒池/召唤、LOGIC logic_op）自动切换；伤害类型/施加状态等为下拉；schema 之外的键落入「其它(JSON)」框保留不丢 +- 💧 **蓝耗**：`meta.mana_cost` 决定施放消耗的魔力（0=免蓝）；权威数值见 `numerical_design §2` ### 👾 敌人（enemies.json） 6 种敌人原型的数值表格，**直接拖动数字框**调整： @@ -54,10 +58,10 @@ |:---|:---| | 怪数 | 本波杂兵数量 | | 血量 | 杂兵基础血量 | -| 类型 | 杂兵原型（Basic/Fast/Armored…）| +| 类型 | 杂兵原型（杂兵/快速/护甲…）下拉 | | 精英 | 带寻路的精英数（W15+）| | 金币 / XP | 波次结算奖励 | -| Boss | 无 / MiniBoss(4) / Boss(5) | +| Boss | 无 None / 首领 MiniBoss / 终焉 Boss | - 「➕末尾加一波」扩展关卡长度 - 改完点「💾保存 waves.json」 @@ -68,19 +72,19 @@ | 字段 | 含义 | |:---|:---| | 槽位数 | 可装法术数 | -| 拓扑 | LINEAR(线性) / MATRIX(矩阵邻接) / CIRCUIT(电路分叉) | +| 拓扑 | 线性 LINEAR / 矩阵 MATRIX / 电路 CIRCUIT | | CPU 上限 | 单次施法最大执行步数 | | 施法间隔 | 自动施法冷却(s) | | 蓝上限(Mana Max) | 法杖蓝池上限（基础 100） | | 回蓝/秒(Mana Regen) | 每秒回复的魔力（基础 5） | -| 特性 | 无 / PERSISTENT_MEMORY(寄存器跨帧) / … | +| 特性 | 无 None / 记忆 PERSISTENT_MEMORY / 双流 / 末位施法 / 洗牌 / 无限法术 | | 矩阵行·列 | MATRIX 专用网格尺寸 | -| 电路边 | CIRCUIT 专用，JSON 有向边 `[{"from":0,"to":1}]` | +| 电路边 | CIRCUIT 专用，`from → to` 行编辑器（可 ➕加/🗑删边）| ### 🔮 共鸣（resonance.json） 元素组合自动合成配方（隐藏玩法）： -- **元素 A + 元素 B**（相邻放置）→ 合成**产物法术** -- 匹配方式：adjacent(相邻) / anywhere_in_deck(任意位置) +- **元素 A + 元素 B**（元素下拉，相邻放置）→ 合成**产物法术** +- 匹配方式：相邻 adjacent / 卡组内任意 anywhere_in_deck - 消耗输入：合成后是否移除原两张法术 - 例：`tag:water` + `tag:lightning` → `action_plasma_storm` @@ -91,7 +95,7 @@ DoT/控制/叠层效果： |:---|:---| | 状态 ID | 整数（1=燃烧 2=冻结 3=中毒…），与法术 meta 的 `apply_status_id` 对应 | | 持续时间 / 跳字间隔 | DoT 周期 | -| 叠层模式 | REFRESH(刷新) / INTENSITY(叠层) / INDEPENDENT(独立) | +| 叠层模式 | 刷新 REFRESH / 叠层 INTENSITY / 独立 INDEPENDENT | | 最大层数 | 0=无限 | | 每跳伤害 | DoT 每次伤害 | | VFX ID | 触发的特效 | @@ -100,6 +104,7 @@ DoT/控制/叠层效果： 全局数值微调： - **难度乘子表格**：4 行(敌人血量×/玩家受伤×/波次怪数×/Boss血量×) × 3 档(初学者/标准/挑战) - **Boss 基础血量**：MiniBoss(W8) / Final Boss(W20) +- **碎片奖励阈值**：波次 → 碎片 行编辑器（可 ➕加/🗑删行），元进度奖励表 调一格数字即可改变整体难度曲线。 @@ -144,7 +149,7 @@ DoT/控制/叠层效果： 波次分页 → 第 10 行 Boss 列选 `MiniBoss(4)` → 保存 → F5。 ### 例 3：新增一个"冰锥"法术（策划） -法术分页 → ➕新增 → ID 填 `action_ice_spike`，类型 ACTION，「插入模板」后改 `base_damage` 为 8、加 `"apply_status_id": 2`（冻结）→ ✓应用 → 💾保存 → F5。新法术自动进商店。 +法术分页 → ➕新增 → ID 填 `action_ice_spike`，类型选「动作 ACTION」→ 动态字段里改 base_damage 为 8、施加状态选「冻结 Freeze」→ ✓应用 → 💾保存 → F5。新法术自动进商店。 ### 例 4：精英敌人改成紫色更大（美术） 敌人分页 → 精英行 → 尺寸改 `30`，颜色点开选紫色 → 保存 → F5。 @@ -158,4 +163,6 @@ DoT/控制/叠层效果： 2. 在 `designer_panel.gd` 的 `_init()` 里 `_add_tab(...)` 注册 3. 对应 Manager 加 `_load_json_xxx()`，在 `_ready()` 调用 +> **开发规范见 [`CLAUDE.md`](../../CLAUDE.md) 「编辑器插件 / 游戏设计器开发规范」**：字段化（禁止手写 JSON，可变长整数元组用 `tuple_list_editor.gd`）、输入框 `SIZE_EXPAND_FILL` 撑满、标签「中文 English」双语、显示与存储解耦、改动后 `validate_script` + 回读往返验证。 + > **Godot 编辑器扩展 = Unity 平替**：`EditorPlugin`(面板/工具栏/底部面板) ↔ EditorWindow；`@tool` ↔ ExecuteInEditMode；`EditorInspectorPlugin` ↔ CustomEditor；自定义 `Resource` ↔ ScriptableObject。