diff --git a/assets/script/game/map/gdd/reviews/rogue-spawning-review-log.md b/assets/script/game/map/gdd/reviews/rogue-spawning-review-log.md new file mode 100644 index 00000000..f75b56ac --- /dev/null +++ b/assets/script/game/map/gdd/reviews/rogue-spawning-review-log.md @@ -0,0 +1,29 @@ +# Review Log: rogue-spawning.md + +## Review — 2026-05-15 — Verdict: MAJOR REVISION NEEDED +Scope signal: XL +Specialists: game-designer, systems-designer, qa-lead, level-designer, creative-director +Blocking items: 10 | Recommended: 9 | Nice-to-have: 7 +Summary: 首次评审发现 10 个阻塞项,核心问题包括自适应因子双重叠加(已修复为仅作用于属性)、玩家幻想与自动战斗架构矛盾(已重写为阵容搭配)、蓝图模板池为空(已添加 15 个示例)、填充算法未定义(已添加伪代码)、词缀概率超标(已 clamp)、怪物引入时间线过于后置(已重构 Assassin→T3/Summoner→T5/Splitter→T6)。所有阻塞项已在本次会话中修复。 +Prior verdict resolved: First review + +### Blocking Items Resolved +1. AF 双重叠加 → F2 移除 AF,仅 F3 保留 +2. 玩家幻想矛盾 → 重写为阵容搭配幻想 +3. 填充算法未定义 → 添加规则 5a 伪代码 +4. 蓝图模板为空 → 添加规则 5b 共 15 个示例模板 +5. 词缀概率 >100% → 添加 min(, 1.0) clamp +6. Summoner 互斥 → 互斥组增加 Summoner 词缀×Summoner 类型 +7. BOSS 槽位不强制 → 添加 mandatory_slots 规则 +8. 不可测试 AC → AC4/5/10/11 重写为统计可验证 +9. 缺失 AC → 添加 15 条新 AC +10. 怪物时间线 → Assassin→T3, Summoner→T5, Splitter→T6 + +### Outstanding Recommended Items (未在本次修复) +- ELITE 模板 0.8× 悖论性更简单 +- Bomber 爆炸随 AP 词缀缩放 +- REST 波密度 33% 偏高 +- W12→W15 MajorBoss 跳跃缺乏铺垫 +- W16-W21 六波无 Boss +- 后期预算产生 30-50+ 怪物 +- 英雄战力曲线未验证 diff --git a/assets/script/game/map/gdd/rogue-spawning.md b/assets/script/game/map/gdd/rogue-spawning.md new file mode 100644 index 00000000..b25e9e77 --- /dev/null +++ b/assets/script/game/map/gdd/rogue-spawning.md @@ -0,0 +1,551 @@ +# Rogue Spawning System (肉鸽刷怪系统) + +> **Status**: Designed (pending review) +> **Author**: walkpan + agents +> **Last Updated**: 2026-05-15 +> **Implements Pillar**: Roguelike replayability & strategic depth + +## Overview + +肉鸽刷怪系统是控制每局游戏怪物生成的核心引擎。它从固定 30 波硬编码配置演进为**蓝图模板 + 权重填充 + 自适应微调**的三层程序化生成架构。主线 30 波分为 10 个难度阶梯(每档 3 波),每档内遵循"恢复→攀升→高潮"的心流节奏。10 种怪物类型配合 8 种词缀修饰,使同一基础怪物产生多种变体。通关后玩家可选进入无限模式,以分层推进方式无限挑战。自适应难度引擎追踪玩家表现,在 ±15% 范围内微调强度,确保始终处于心流通道内。 + +## Player Fantasy + +本系统是玩家**间接体验**的基础设施——玩家不直接操作刷怪系统,而是通过英雄阵容选择和升级策略来应对它创造的变化。英雄根据类型和站位自动攻击,玩家的核心操控权在于**战前构建**而非**战中目标选择**。 + +**核心幻想:每次开局都是全新的挑战** + +- "我的阵容能应对任何组合"——每波的怪物构成和词缀变体都不同,玩家的阵容选择、站位配置和升级路线决定了能否通关 +- "不确定性带来的是刺激而非焦虑"——自适应难度确保不会出现过难或过易的无聊区间 +- "通关后的无限挑战才是真正的考验"——无限模式是高手的舞台,每次突破极限都有成就感 +- 心流节奏让玩家在紧张和放松之间交替,避免疲劳 + +**锚定时刻**:波间准备阶段,看到下一波怪物预览的瞬间,快速判断威胁构成(有自爆怪吗?有辅助治疗吗?有刺客突后排吗?),据此调整英雄站位、技能升级优先级和装备选择。决策发生在**构建层面**而非战斗层面。 + +## Detailed Design + +### Core Rules + +**规则 1:三层生成架构** + +每一波的怪物配置由三层依次决定: + +1. **蓝图模板层**:从模板池中抽取一个蓝图,确定该波的类型(REST/NORMAL/MIXED/ELITE/BOSS)和怪物槽位骨架 +2. **权重填充层**:根据蓝图中的槽位定义,从怪物池中按权重随机抽取具体怪物,填充数量 +3. **自适应微调层**:根据玩家历史表现,对难度预算进行 ±15% 浮动调整 + +**规则 2:10 阶梯 × 3 波结构** + +主线 30 波分为 10 个阶梯(Tier),每个 Tier 3 波: + +| Tier | 波次 | 主题 | 新引入元素 | Boss | +|------|------|------|-----------|------| +| 1 | W1-3 | 入门教程 | Melee | - | +| 2 | W4-6 | 远程登场 | Long, Heavy | W6 MiniBoss | +| 3 | W7-9 | 刺客登场 | Assassin(突后排威胁) | - | +| 4 | W10-12 | 辅助登场 | Support + 近远程刺协同 | W12 MiniBoss | +| 5 | W13-15 | 中期 Boss | Bomber, Summoner + 词缀系统首次出现 | **W15 MajorBoss** | +| 6 | W16-18 | 分裂时代 | Splitter(死亡触发型) | - | +| 7 | W19-21 | 精英时代 | 词缀大量出现(全种类) | W21 MiniBoss | +| 8 | W22-24 | 全兵种混合 | 所有类型协同 | - | +| 9 | W25-27 | 终极压力 | 极限数量 | W27 MiniBoss | +| 10 | W28-30 | 最终 Boss | 全词缀组合 | **W30 FinalBoss** | + +**规则 3:档内三拍节奏** + +每个 Tier 内 3 波遵循固定节奏模式: + +- **Wave 1(恢复)**:从 REST 类模板池抽取,低难度预算,少量弱怪 +- **Wave 2(攀升)**:从 NORMAL/MIXED/ELITE 类模板池抽取,中等难度预算 +- **Wave 3(高潮)**:Boss 档位从 BOSS 类模板抽取;非 Boss 档位从 MIXED 类模板抽取 + +例外:Tier 1 Wave 1 为教程波,固定使用特殊教程模板(1 个 Melee 怪)。 + +**规则 4:难度预算制** + +每波有一个难度预算值,每只怪物"花费"一定预算: + +``` +wave_budget = base_budget[tier] × template_modifier × adaptive_factor +``` + +怪物成本: + +| 类型 | 预算成本 | +|------|---------| +| Melee | 30 | +| Heavy | 50 | +| Long | 40 | +| Support | 50 | +| Bomber | 35 | +| Summoner | 60 | +| Assassin | 45 | +| Splitter | 55 | +| Boss (Melee/Long) | 200 | + +词缀额外成本: + +| 词缀 | 额外成本 | +|------|---------| +| Elite | +20 | +| Berserk | +15 | +| Shield | +25 | +| Regen | +20 | +| Swift | +10 | +| Giant | +30 | +| Chain | +20 | +| Summoner | +25 | + +**规则 5:蓝图模板池** + +模板按类型分类,每个模板定义: +- `id`:唯一标识 +- `type`:REST / NORMAL / MIXED / ELITE / BOSS +- `tier_min`:首次可出现的最低档位 +- `slots`:怪物槽位列表(类型池、数量范围、权重) +- `allow_affix`:是否允许词缀修饰 +- `mandatory_slots`:必须填充的槽位(BOSS 类型必须包含至少 1 个 Boss 类型槽位) + +**Boss 槽位强制规则**:BOSS 类型模板的 `mandatory_slots` 必须包含至少 1 个 Boss 类型怪物(MeleeBoss 或 LongBoss)。填充算法必须优先放置强制槽位,确保 Boss 波次始终包含 Boss 怪物。 + +**规则 5a:权重填充算法** + +``` +function fill_wave(template, budget, tier, adaptive_factor): + monsters = [] + + // Step 1: 放置强制槽位(Boss 等) + for slot in template.mandatory_slots: + monster_type = weighted_random(slot.type_pool, slot.weights) + monster_cost = base_cost[monster_type] + max_affix_cost(tier, slot) + if monster_cost <= budget: + monsters.append(create_monster(monster_type, tier)) + budget -= monster_cost + + // Step 2: 填充可选槽位,从高权重到低权重 + remaining_slots = shuffle_by_weight(template.slots - mandatory_slots) + for slot in remaining_slots: + monster_type = weighted_random(slot.type_pool, slot.weights) + monster_cost = base_cost[monster_type] + estimated_affix_cost(tier) + while budget >= monster_cost and count(monster_type) < slot.max_count: + monsters.append(create_monster(monster_type, tier)) + budget -= monster_cost + + // Step 3: 预算不足时保底 + if len(monsters) == 0: + monsters.append(create_monster(Melee, tier)) // 忽略预算 + + // Step 4: 预算利用率检查 + utilization = total_cost(monsters) / original_budget + if utilization < 0.5: // 利用了不到一半预算,尝试补充 + fill_remaining(budget, monsters, tier) + + return monsters +``` + +填充策略说明: +- 强制槽位优先放置,不参与预算竞争 +- 可选槽位按权重随机,每个槽位尽量填满 max_count +- 预算利用率目标 ≥ 70%(不足时触发补充) +- 保底规则:即使预算耗尽也至少生成 1 个 Melee + +**规则 5b:示例模板** + +每种类型至少定义 3 个模板以验证预算系统可行性: + +**REST 类型(tier_min=1):** +| ID | 槽位配置 | 说明 | +|----|---------|------| +| REST_01 | 1-2 × Melee(权重10) | 纯近战休息波 | +| REST_02 | 1 × Melee(8) + 1 × Long(4) | 轻混合休息波 | +| REST_03 | 2 × 随机(权重均分) | 随机轻波 | + +**NORMAL 类型(tier_min=1):** +| ID | 槽位配置 | 说明 | +|----|---------|------| +| NORM_01 | 3-4 × Melee(10) | 近战群 | +| NORM_02 | 2 × Melee(6) + 2 × Long(6) | 标准混合 | +| NORM_03 | 2 × Melee(4) + 1 × Long(6) + 1 × Heavy(4) | 重型混合 | + +**MIXED 类型(tier_min=3):** +| ID | 槽位配置 | 说明 | +|----|---------|------| +| MIX_01 | 2 × Melee(4) + 2 × Long(4) + 1 × Assassin(4) | 刺客突袭 | +| MIX_02 | 1 × Heavy(6) + 2 × Long(6) + 1 × Support(3) | 远程压制 | +| MIX_03 | 2 × Melee(4) + 1 × Long(4) + 1 × Assassin(4) + 1 × Bomber(3) | 多线威胁 | + +**ELITE 类型(tier_min=5, allow_affix=true):** +| ID | 槽位配置 | 说明 | +|----|---------|------| +| ELIT_01 | 2-3 × 随机(权重均分, 必带词缀) | 精英小队 | +| ELIT_02 | 1 × Heavy(必带词缀) + 1 × Support(必带词缀) | 重装精英 | +| ELIT_03 | 2 × Assassin(必带词缀) + 1 × Long(必带词缀) | 精锐突袭 | + +**BOSS 类型(tier_min=2, mandatory_slots 包含 Boss):** +| ID | 槽位配置 | 说明 | +|----|---------|------| +| BOSS_01 | 1 × MeleeBoss(强制) + 2-3 × Melee | 近战 Boss + 小怪 | +| BOSS_02 | 1 × LongBoss(强制) + 1-2 × Support | 远程 Boss + 治疗 | +| BOSS_03 | 1 × MeleeBoss 或 LongBoss(强制) + 1 × Assassin + 1 × Bomber | Boss + 精锐护卫 | + +**规则 6:词缀系统** + +词缀是附着在基础怪物上的属性修饰,提供变体丰富度: + +| 词缀 | 效果 | 首次出现 Tier | +|------|------|-------------| +| Elite | +50% HP, +30% AP | T5 | +| Berserk | 攻速 ×1.5 | T5 | +| Shield | 开局带伤害吸收盾(20% HP) | T6 | +| Regen | 每秒回复 2% HP | T7 | +| Swift | 移速 ×2 | T7 | +| Giant | ×2 体型, +100% HP, +50% AP | T8 | +| Chain | 攻击附带 50% 溅射伤害 | T9 | +| Summoner | 每 8 秒召唤 1 个小怪(Melee,1 级属性) | T10 | + +词缀触发概率: + +``` +affix_chance = min(base_affix_chance[tier] × role_multiplier, 1.0) + +base_affix_chance: + T1-T4: 0% + T5: 10%, T6: 15%, T7: 25%, T8: 30%, T9: 40%, T10: 50% + +role_multiplier: + 普通怪: 1.0x + MiniBoss: 2.0x + MajorBoss/FinalBoss: 3.0x +``` + +> **注**:概率上限为 1.0(100%)。例如 T10 FinalBoss 的原始概率为 50%×3.0=150%,经 clamp 后为 100%(必出词缀)。每个词缀槽位独立判定概率,不超过角色类型的叠加上限。 + +词缀叠加上限: +- 普通怪:最多 1 个 +- MiniBoss:最多 2 个 +- MajorBoss/FinalBoss:最多 3 个 + +互斥组: +- Giant × Swift(体型矛盾) +- Regen × Shield(防止过肉) +- Summoner(词缀)× Summoner(类型)(防止双倍召唤叠加) + +词缀属性加成采用**加法叠加**: +``` +affix_hp_multiplier = 1.0 + Σ(各词缀 HP 加成百分比) +affix_ap_multiplier = 1.0 + Σ(各词缀 AP 加成百分比) + +示例:Elite(+50% HP, +30% AP) + Giant(+100% HP, +50% AP) +→ affix_hp_multiplier = 1.0 + 0.5 + 1.0 = 2.5 +→ affix_ap_multiplier = 1.0 + 0.3 + 0.5 = 1.8 +``` +词缀乘数范围:1.0(无词缀)到 2.5(Elite+Giant HP 加满,加法叠加最大值)。 + +**规则 7:怪物类型定义** + +| 类型 | 基础 HP | 基础 AP | 行为特征 | +|------|---------|---------|---------| +| Melee | 120 | 12 | 标准近战攻击,中速移动 | +| Heavy | 350 | 30 | 极慢移动,高血量肉盾 | +| Long | 80 | 45 | 远程攻击,低血量 | +| Support | 80 | 20 | 治疗/增益其他怪,优先击杀目标 | +| Bomber | 60 | 80 | 低血量,死亡时对周围造成 AP×200% 的 AOE 伤害 | +| Summoner | 100 | 15 | 每 8 秒召唤 1 个小怪(Melee 1 级属性) | +| Assassin | 90 | 55 | 快速突进到后排攻击英雄 | +| Splitter | 150 | 20 | 死亡时分裂为 2 个小体(50% HP/AP) | +| MeleeBoss | 1500 | 20 | Boss 级近战,带特殊技能 | +| LongBoss | 350 | 30 | Boss 级远程,带特殊技能 | + +### States and Transitions + +**波次生成状态机:** + +``` +INIT → SELECT_TEMPLATE → FILL_MONSTERS → APPLY_AFFIXES → APPLY_GROWTH → APPLY_ADAPTIVE → SPAWN_WAVE → EVALUATE_PERFORMANCE → (下一波) +``` + +| 状态 | 输入 | 输出 | 转换条件 | +|------|------|------|---------| +| INIT | 当前 wave_number, tier | tier, wave_position_in_tier | 自动 | +| SELECT_TEMPLATE | tier, wave_position, is_boss_wave | blueprint_template | 根据 REST/NORMAL/BOSS 规则选模板 | +| FILL_MONSTERS | template, difficulty_budget | monster_list (types + counts) | 权重随机,总成本 ≤ budget | +| APPLY_AFFIXES | monster_list, tier | affixed_monster_list | 按概率和规则添加词缀 | +| APPLY_GROWTH | affixed_monster_list, tier | scaled_monsters | 属性 × tier_multiplier | +| APPLY_ADAPTIVE | scaled_monsters, adaptive_factor | final_monsters | 属性 × adaptive_factor | +| SPAWN_WAVE | final_monsters | (游戏内生成) | 按顺序排列怪物 | +| EVALUATE_PERFORMANCE | 战斗结果 | updated adaptive_factor | 计算新自适应系数 | + +### Interactions with Other Systems + +| 系统 | 数据流方向 | 接口 | +|------|-----------|------| +| 英雄系统 | ← 接收 | 英雄存活率、队伍 DPS、通关时间 | +| 战斗系统 | → 发送 | 最终怪物列表(类型、属性、词缀、位置) | +| 怪物配置 | ← 接收 | 怪物基础属性、行为定义 | +| 成长/升级系统 | ← 接收 | 玩家当前英雄等级和装备强度(自适应难度参考) | +| UI 系统 | → 发送 | 当前波次、档位、怪物预览信息 | +| 分数系统 | → 发送 | 击杀统计、Boss 击杀数据 | +| 无限模式入口 | ← 接收 | 玩家选择是否进入无限模式 | + +## Formulas + +### F1: 阶梯属性倍率 + +``` +tier_multiplier = tier_multiplier_table[tier] +``` + +| Variable | Symbol | Type | Range | Description | +|----------|--------|------|-------|-------------| +| tier | T | int | 1-10 (主线), 11+ (无限) | 当前难度阶梯 | +| tier_multiplier | TM | float | 1.0-5.5 | 属性倍率 | + +**Tier Multiplier 表:** + +| Tier | Multiplier | Tier | Multiplier | +|------|-----------|------|-----------| +| T1 | 1.0x | T6 | 2.8x | +| T2 | 1.3x | T7 | 3.3x | +| T3 | 1.6x | T8 | 3.9x | +| T4 | 1.9x | T9 | 4.6x | +| T5 | 2.3x | T10 | 5.5x | + +**无限模式扩展:** T(n) = T(n-1) × 1.2(T11=6.6x, T12=7.9x, ...) + +**Output Range:** 1.0x (T1) to 5.5x (T10 主线), 无限模式无限递增 +**Example:** 基础 Melee 怪在 T5 的属性 = 120×2.3=276 HP, 12×2.3=27.6 AP + +### F2: 难度预算 + +``` +wave_budget = base_budget[tier] × template_modifier[type] +``` + +| Variable | Symbol | Type | Range | Description | +|----------|--------|------|-------|-------------| +| base_budget | BB | int | 100-1050 | 档位基础预算 | +| template_modifier | TMOD | float | 0.5-1.5 | 模板类型修正 | + +**Base Budget 表:** + +| Tier | Budget | Tier | Budget | +|------|--------|------|--------| +| T1 | 100 | T6 | 440 | +| T2 | 150 | T7 | 560 | +| T3 | 200 | T8 | 700 | +| T4 | 260 | T9 | 860 | +| T5 | 340 | T10 | 1050 | + +**Template Modifier:** +- REST: 0.5x +- NORMAL: 1.0x +- MIXED: 1.2x +- ELITE: 0.8x +- BOSS: 1.5x + +**Output Range:** 50 (T1 REST) to 1575 (T10 BOSS) +**Example:** T5 NORMAL 波 → budget = 340 × 1.0 = 340 → 可生成约 8 个 Melee 或 4 个 Melee + 2 个 Long + 1 个 Support + +### F3: 怪物最终属性 + +``` +final_hp = base_hp × tier_multiplier × affix_hp_multiplier × adaptive_factor +final_ap = base_ap × tier_multiplier × affix_ap_multiplier × adaptive_factor +``` + +| Variable | Symbol | Type | Range | Description | +|----------|--------|------|-------|-------------| +| base_hp/base_ap | BH/BA | int | 60-1500 | 怪物基础属性 | +| affix_hp/ap_multiplier | AHM/AAM | float | 1.0-2.5 | 词缀属性倍率(加法叠加,Elite+Giant 最大 2.5) | +| adaptive_factor | AF | float | 0.85-1.15 | 自适应系数 | + +**Output Range:** HP 51 (Bomber, T1, no affix, AF=0.85) to 19,031+ (MeleeBoss, T15 无限, Elite+Giant, AF=1.15) +**Example:** Melee 怪在 T7, 带 Elite 词缀, AF=1.0 → HP=120×3.3×1.5×1.0=594, AP=12×3.3×1.3×1.0=51.5 + +### F4: 自适应难度系数 + +> **设计说明**:自适应系数 (AF) 仅作用于怪物属性(F3),不作用于波次预算(F2)。这意味着自适应难度调整的是"每只怪物的强弱"而非"怪物的数量",实际效果接近 ±15%,而非双重叠加。 + +``` +adaptive_factor = clamp(adaptive_factor + delta, 0.85, 1.15) + +delta calculation per wave: + if heroes_alive_ratio >= 0.8 AND clear_time < target_time: + delta = +0.03 // 玩家太强,提高怪物属性 + elif heroes_alive_ratio <= 0.3: + delta = -0.03 // 快团灭,降低怪物属性 + else: + delta = 0 // 维持 +``` + +| Variable | Symbol | Type | Range | Description | +|----------|--------|------|-------|-------------| +| heroes_alive_ratio | HAR | float | 0.0-1.0 | 存活英雄比例 | +| clear_time | CT | float | 3.0-60.0 | 通关时间(秒) | +| target_time | TT | float | 15.0 | 目标通关时间 | +| delta | D | float | -0.03 to +0.03 | 每波调整量 | +| adaptive_factor | AF | float | 0.85-1.15 | 最终自适应系数 | + +**Output Range:** 0.85-1.15 (硬限制) +**Example:** 连续 3 波全英雄存活且 5 秒内通关 → AF = 1.0 + 0.03×3 = 1.09 + +## Edge Cases + +- **If 难度预算不足以生成任何怪物**:保底生成 1 个 Melee 怪(忽略预算限制),确保每波至少有内容。 +- **If 权重填充结果为空(所有怪物类型被 tier_min 过滤)**:回退到该 Tier 最低限制的类型池(Melee 总是可用)。 +- **If 两个互斥词缀同时被选中**:按词缀优先级(Shield > Regen > Giant > Swift)保留优先级更高的,丢弃另一个。 +- **If 怪物最终 HP 或 AP 低于 1**:clamp 到最小值 1。怪物不能是 0 血或 0 攻击。 +- **If 自适应系数连续 5 波向同一方向调整(持续加难或降难)**:强制一次反向 +0.01 微调,防止极端漂移。 +- **If 无限模式中 tier_multiplier 导致怪物 HP > 100,000**:启用对数压缩公式 `display_hp = log10(actual_hp) × scaling_factor`,避免 UI 数字溢出。实际伤害计算仍用真实值。 +- **If Bomber 怪被 AOE 同时击杀多个**:爆炸伤害不叠加,每个爆炸独立计算但不会叠加超过总伤害的 300%。 +- **If Splitter 分裂出的子体再次被击杀**:子体不再分裂(分裂深度限制为 1 级)。 +- **If Summoner 召唤的小怪存活超过 30 秒**:小怪自动消散,防止场上怪物无限积累。 +- **If 玩家在 Boss 波前有 0 个存活英雄(理论上不应发生)**:不生成该波怪物,触发游戏结束结算。 +- **If 同一模板被连续抽取 3 次**:强制下一次从不同类型模板池中抽取,避免体验单调。 + +## Dependencies + +| 依赖系统 | 方向 | 性质 | 数据接口 | +|----------|------|------|---------| +| **英雄系统** (heroSet.ts) | 上游(硬依赖) | 读取英雄属性、存活状态 | `heroes_alive_ratio`, `team_dps`, `clear_time` | +| **战斗系统** | 下游(硬依赖) | 发送怪物列表 | `final_monster_list[]` 含 type, hp, ap, affixes, position | +| **怪物配置** (HeroAttrs.ts 怪物部分) | 上游(硬依赖) | 读取怪物基础属性 | `base_hp`, `base_ap`, `speed`, `skills` | +| **成长/升级系统** | 上游(软依赖) | 了解玩家当前强度 | `hero_levels[]`, `equipment_power` | +| **UI 系统** | 下游(软依赖) | 发送波次信息 | `wave_number`, `tier`, `monster_preview[]` | +| **分数系统** | 下游(软依赖) | 发送击杀统计 | `boss_kills`, `elite_kills`, `total_kills` | +| **无限模式入口** | 上游(软依赖) | 接收玩家选择 | `enter_infinite: boolean` | + +**硬依赖说明**:英雄系统、战斗系统、怪物配置缺失时刷怪系统无法运行。 +**软依赖说明**:成长系统和 UI 系统缺失时刷怪系统可工作,但自适应难度和波次预览功能降级。 + +## Tuning Knobs + +所有设计者可在不修改代码的情况下调整的配置值: + +| 旋钮 | 当前值 | 安全范围 | 超出后果 | +|------|--------|---------|---------| +| `tier_multiplier_table[T1-T10]` | 1.0-5.5 | 0.5-10.0 | 过低→后期无挑战;过高→后期不可打 | +| `base_budget[T1-T10]` | 100-1050 | 50-2000 | 过低→怪物太少无聊;过高→怪物太多卡顿 | +| `template_modifier[REST]` | 0.5x | 0.3-0.8 | 过低→恢复波太弱无意义;过高→节奏混乱 | +| `template_modifier[BOSS]` | 1.5x | 1.0-2.5 | 过低→Boss 无感;过高→Boss 波必团灭 | +| `adaptive_factor_min` | 0.85 | 0.7-0.95 | 过低→自适应降难太明显 | +| `adaptive_factor_max` | 1.15 | 1.05-1.3 | 过高→自适应加难太明显 | +| `adaptive_delta_per_wave` | 0.03 | 0.01-0.08 | 过低→反应迟钝;过高→体验不稳定 | +| `target_clear_time` | 15.0s | 5.0-30.0 | 影响自适应判断阈值 | +| `base_affix_chance[T5-T10]` | 10%-50% | 0%-80% | 过低→词缀系统无意义;过高→全是精英怪 | +| `bomber_explosion_multiplier` | 200% | 100%-400% | 爆炸伤害占 AP 的比例 | +| `splitter_child_hp_ratio` | 50% | 25%-75% | 分裂子体 HP 占母体比例 | +| `splitter_child_ap_ratio` | 50% | 25%-75% | 分裂子体 AP 占母体比例 | +| `summoner_spawn_interval` | 8s | 4-15s | 召唤间隔 | +| `summoner_max_minions` | 3 | 1-5 | 场上最多同时存在的小怪数 | +| `minion_lifetime` | 30s | 10-60s | 小怪存活上限 | +| `infinite_tier_growth_rate` | 1.2x | 1.1-1.5 | 无限模式每档递增率 | +| `monster_types_available[T1-T10]` | 见规则2 | - | 每档可用怪物类型集合 | +| `affix_mutual_exclusion` | Giant×Swift, Regen×Shield | - | 互斥词缀对 | + +## Acceptance Criteria + +### 核心波次生成 + +- **GIVEN** 游戏开始(adaptive_factor=1.0),**WHEN** 进入 W1,**THEN** 生成 1 个 Melee 怪(T1, 无词缀),HP=120, AP=12。 +- **GIVEN** 当前 Tier 2 W2(攀升波),**WHEN** 模板选取完成,**THEN** 模板类型为 NORMAL 或 MIXED,且模板的怪物槽位池中包含 Long 类型(cost=40)。运行 100 次抽取,Long 类型出现在槽位池中的比例为 100%。 +- **GIVEN** W6(Boss 波),**WHEN** 模板选取完成,**THEN** 模板类型为 BOSS,mandatory_slots 包含 Boss 类型,至少生成 1 个 MeleeBoss + 0-3 个普通怪。 +- **GIVEN** Tier 3 W1(REST 波),**WHEN** 模板选取完成,**THEN** 模板类型为 REST,template_modifier=0.5x。 +- **GIVEN** Tier 4 W3(非 Boss 高潮波),**WHEN** 模板选取完成,**THEN** 模板类型为 MIXED,template_modifier=1.2x。 + +### 预算系统 + +- **GIVEN** Tier 5 NORMAL 波(budget=340, AF 不影响预算),**WHEN** 填充怪物完成,**THEN** 所有怪物成本总和在 340 × 0.7 到 340 × 1.0 之间(即 238-340),且至少生成 3 只怪物。 +- **GIVEN** 预算不足以生成任何怪物,**WHEN** 填充阶段,**THEN** 保底生成 1 个 Melee 怪(忽略预算限制)。 + +### 词缀系统 + +- **GIVEN** Tier 5 正常波(10+ 只怪),**WHEN** 运行 1000 次统计测试,**THEN** 词缀触发率落在 8%-12% 区间(90% 置信度),且所有触发的词缀类型均为 Elite 或 Berserk。单次运行中无词缀怪物比例在 20%-50% 区间内。 +- **GIVEN** Tier 10 FinalBoss(W30),**WHEN** 词缀应用完成,**THEN** FinalBoss 拥有 2-3 个词缀,且任意两个词缀的组合不属于互斥组(Giant+Swift, Regen+Shield, Summoner类型+Summoner词缀)。运行 100 次模拟,0 次出现互斥词缀同时生效。 +- **GIVEN** Tier 7 正常波,**WHEN** 词缀应用完成,**THEN** 每只普通怪最多拥有 1 个词缀。运行 1000 次模拟,0 次出现普通怪拥有 >1 个词缀的情况。 +- **GIVEN** Tier 7 W21 MiniBoss,**WHEN** 词缀应用完成,**THEN** MiniBoss 拥有 0-2 个词缀,0 次超过 2 个词缀。 +- **GIVEN** 两个互斥词缀(Giant + Swift)同时被选中,**WHEN** 词缀应用阶段,**THEN** 保留优先级更高的词缀(Giant),丢弃 Swift。 +- **GIVEN** 两个互斥词缀(Regen + Shield)同时被选中,**WHEN** 词缀应用阶段,**THEN** 保留优先级更高的词缀(Shield),丢弃 Regen。 + +### 自适应难度 + +- **GIVEN** adaptive_factor 初始值为 1.0,且连续 3 波全英雄存活(heroes_alive_ratio ≥ 0.8)且通关时间 < 15s,**WHEN** 自适应计算完成,**THEN** adaptive_factor = 1.0 + 0.03 × 3 = 1.09。 +- **GIVEN** adaptive_factor 初始值为 1.0,且连续 2 波仅 1 英雄存活(heroes_alive_ratio ≤ 0.3),**WHEN** 自适应计算完成,**THEN** adaptive_factor = 1.0 - 0.03 × 2 = 0.94。 +- **GIVEN** adaptive_factor 连续 5 波递减(每次 delta=-0.03),当前值为 0.85(clamp 下限),**WHEN** 第 6 波计算 delta 仍为 -0.03,**THEN** 实际施加的 delta 被覆盖为 +0.01(反向微调),adaptive_factor 变为 0.86。 + +### 怪物行为 + +- **GIVEN** Bomber 怪(final_ap=X)被击杀,**WHEN** 死亡触发,**THEN** 以 Bomber 死亡位置为中心,对 AOE_RADIUS 范围内的所有英雄造成 X × 200% 的伤害。 +- **GIVEN** 3 个 Bomber 怪(final_ap=80)在 AOE 范围内被同时击杀,**WHEN** 爆炸触发,**THEN** 单个英雄受到的总伤害 ≤ 80 × 200% × 300% = 480。 +- **GIVEN** Splitter 怪(HP=150, AP=20)被击杀,**WHEN** 死亡触发,**THEN** 生成 2 个小体,每个小体 HP=75, AP=10。 +- **GIVEN** Splitter 小体被击杀,**WHEN** 死亡触发,**THEN** 不生成任何子体(分裂深度限制为 1 级)。 +- **GIVEN** Summoner 怪存活且场上 0 个小怪,**WHEN** 经过 8 秒,**THEN** 召唤 1 个 Melee 小怪(T1 属性)。 +- **GIVEN** Summoner 怪存活且场上已有 3 个小怪,**WHEN** 经过 8 秒,**THEN** 不召唤新的小怪。 +- **GIVEN** Summoner 召唤的小怪存活 30 秒,**WHEN** 计时器触发,**THEN** 小怪自动消散(从场上移除)。 + +### 属性计算 + +- **GIVEN** Tier 7 Melee 怪,带 Elite 词缀(+50% HP, +30% AP),AF=1.0,**WHEN** 属性计算完成,**THEN** HP = 120 × 3.3 × 1.5 × 1.0 = 594,AP = 12 × 3.3 × 1.3 × 1.0 = 51.48。 +- **GIVEN** 任何怪物,**WHEN** 最终属性计算完成(base × tier_multiplier × affix_multiplier × adaptive_factor),**THEN** final_hp ≥ 1 且 final_ap ≥ 1。 + +### 无限模式与模板多样性 + +- **GIVEN** 主线 W30 通关,**WHEN** 玩家选择进入无限模式,**THEN** 从 T11 开始,每层 4 波(REST→NORMAL→MIXED→BOSS),属性倍率 = tier_multiplier_table[T10] × infinite_tier_growth_rate = 5.5 × 1.2 = 6.6x。 +- **GIVEN** 无限模式 T12,**WHEN** 属性倍率计算,**THEN** tier_multiplier = 6.6 × 1.2 = 7.92x。 +- **GIVEN** 同一模板(id 相同)被连续抽取 3 次,**WHEN** 第 4 波模板选取,**THEN** 选出的模板类型与连续 3 次的类型不同(如连续 3 次 NORMAL 则强制从 REST/MIXED/ELITE/BOSS 池中抽取)。 + +### 游戏结束条件 + +- **GIVEN** 当前波次为 Boss 波且 heroes_alive_count = 0,**WHEN** 波次生成流程启动,**THEN** 不生成任何怪物,触发游戏结束结算流程。 + +## Visual/Audio Requirements + +### 词缀视觉差异化 + +每种词缀需要对应的视觉标识,让玩家一眼识别威胁类型: + +| 词缀 | 视觉效果 | 颜色/标识 | +|------|---------|----------| +| Elite | 怪物周围光圈 | 金色光环 | +| Berserk | 怪物身体发红,攻击动画加速 | 红色脉动 | +| Shield | 怪物面前半透明护盾 | 蓝色半透明盾 | +| Regen | 怪物脚下绿色光环,回复时绿色数字飘出 | 绿色粒子 | +| Swift | 怪物移动时带残影拖尾 | 白色拖尾 | +| Giant | 怪物体型 ×2 | - | +| Chain | 攻击时连电弧特效 | 紫色电弧 | +| Summoner | 召唤时脚下法阵特效 | 紫色法阵 | + +### Boss 视觉需求 + +- Boss 生成时全屏闪白 + 震屏效果 +- Boss 血条 UI 单独显示在屏幕顶部 +- MajorBoss/FinalBoss 有独特的出场动画(2 秒) + +### 新怪物类型视觉 + +- **Bomber**:怪物身上带红色炸弹标识,死亡时爆炸粒子特效(橙色+火焰) +- **Summoner**:带法杖的怪物,召唤时法杖发光 +- **Assassin**:瘦长体型,移动时带残影,突进时有速度线特效 +- **Splitter**:体型略大于普通怪,死亡时分裂动画(绿色分裂粒子) +- **Heavy**:体型 ×1.5,移动缓慢,脚步有灰尘特效 + +### Audio 需求 + +- Boss 出场:低频鼓声 + 金属碰撞音效 +- Bomber 爆炸:爆炸音效(带屏幕震动) +- 自爆怪预警音:Bomber 血量低于 30% 时发出嘀嗒声 +- 词缀怪物:Elite 怪发出低沉吼叫,Swift 怪有疾风声 + +## Open Questions + +| # | 问题 | 负责人 | 目标解决日期 | 备注 | +|---|------|--------|-------------|------| +| 1 | 无限模式 Mega Boss 的特殊机制是什么? | 策划 | 待定 | 每 3 层出现的 Mega Boss 需要独特玩法,不能只是数值翻倍 | +| 2 | Summoner 召唤的小怪是否影响分数统计? | 策划 | 待定 | 如果计入击杀数可能刷分,需确认规则 | +| 3 | 自适应难度是否对玩家可见? | 策划+UI | 待定 | 部分 Roguelike 游戏会显示难度等级作为反馈 | +| 4 | 蓝图模板池具体需要多少个模板? | 策划 | 待定 | 目前每类定义了 3 个示例模板,正式版每类需要 5-8 个 | +| 5 | 新怪物类型(Bomber/Summoner/Assassin/Splitter/Heavy)的 UUID 编号段? | 开发 | 待定 | 需与 HeroAttrs.ts 中的编号体系对齐,需独立怪物定义文档(UUID、AI 行为树、资源规范) | +| 6 | 飞行怪移除后,现有 Fly/FlyBoss 的 UUID 是否回收? | 开发 | 待定 | 影响资源管理 | +| 7 | **英雄战力曲线验证** — 怪物缩放(5.5×)需对照玩家 DPS 曲线校准 | 策划 | 待定 | 缺少英雄成长 GDD,所有平衡数值未验证。需定义:T1/T5/T10 预期团队 DPS、每波怪物预期存活时间 | +| 8 | **Bomber 爆炸 AOE 半径** — AC 引用了 AOE_RADIUS 但未在调参旋钮中定义 | 策划 | 待定 | 需添加到 Tuning Knobs 表 | +| 9 | **MajorBoss vs MiniBoss 机械区别** — 当前仅数值差异,是否有特殊技能/阶段转换? | 策划 | 待定 | W15 MajorBoss 需要与非 MajorBoss 的体验差异 | diff --git a/assets/script/game/map/gdd/systems-index.md b/assets/script/game/map/gdd/systems-index.md new file mode 100644 index 00000000..41e46be8 --- /dev/null +++ b/assets/script/game/map/gdd/systems-index.md @@ -0,0 +1,7 @@ +# Systems Index + +Design order: Foundation → Core → Feature → Presentation → Polish + +| System | Design Order | GDD File | Status | Dependencies | +|--------|-------------|----------|--------|-------------| +| Rogue Spawning (肉鸽刷怪) | Core | [rogue-spawning.md](rogue-spawning.md) | Revised (pending re-review) | 英雄系统, 战斗系统, 怪物配置 (硬) |