# 横版 3D 格斗小游戏开发设计文档

**2.5D · 1v1 · 帧数据驱动 · 单机原型基线**

| **版本**     | v1.0                               |
|--------------|------------------------------------|
| **日期**     | 2026-08-10                         |
| **技术基线** | 引擎无关；示例采用 Unity / C# 命名 |

> 目标：用最小但正确的战斗架构，实现行走、跳跃、格挡、拳脚、必杀技、超必杀技、命中反馈与完整回合流程；同时为后续角色扩展、训练模式和回滚联机保留清晰边界。

| **核心战斗** | **数据驱动** | **可验证** |
| --- | --- | --- |
| 输入缓冲 · 状态机 · 命中结算 | 招式帧表 · 判定轨迹 · 资源规则 | 帧步进 · Hitbox 调试 · 验收用例 |

**DOCUMENT CONTROL**

# 文档控制与阅读说明

本文档是面向小型团队或个人开发者的可执行设计基线。它同时覆盖玩法规则、核心战斗技术方案、数据结构、调试工具、开发计划与验收标准。所有数值均为首轮灰盒原型建议值，应通过手感测试迭代。

| **字段**         | **内容**                                           |
|------------------|----------------------------------------------------|
| **项目类型**     | 横版 3D（2.5D）1v1 对战格斗小游戏                  |
| **首发平台**     | PC；键盘与手柄；本地双人或玩家对 AI                |
| **画面实现**     | 3D 角色与场景，战斗逻辑约束在水平轴与垂直轴        |
| **战斗基线**     | 固定 60 Tick；帧数据驱动；运动学角色控制器         |
| **参考代码风格** | Unity / C# 命名；可映射至 Unreal、Godot 或自研引擎 |
| **目标读者**     | 程序、策划、动画、特效、测试与制作人               |

> **关键边界**
>
> MVP 不做联网、投技、复杂防御资源、角色养成与剧情。先确保“输入可靠、状态可控、命中可解释、帧数据可调”，再增加内容。

## 术语约定

| **术语**                       | **定义**                                                                      |
|--------------------------------|-------------------------------------------------------------------------------|
| **战斗 Tick**                  | 战斗逻辑更新单位；固定为每秒 60 次，与渲染帧率解耦。                          |
| **起手 / 持续 / 收招**         | Startup / Active / Recovery；攻击从输入到判定生效，再到恢复可行动的三个阶段。 |
| **HitStop**                    | 命中瞬间双方短暂停顿，用于强化重量感；不等同于受击硬直。                      |
| **HitStun / BlockStun**        | 命中硬直 / 格挡硬直；期间角色不能自由行动，但可受特定规则影响。               |
| **HitBox / HurtBox / PushBox** | 攻击判定 / 可受击判定 / 角色实体推挤判定。                                    |
| **取消窗口**                   | 允许当前动作提前转入指定动作的帧区间。                                        |
| **指令宽容**                   | 方向输入允许的总时间、相邻输入最大间隔、斜方向替代等容错规则。                |

## 目录

| **01 项目定位与设计目标**   | **11 动画、特效、音效与镜头** |
|-----------------------------|-------------------------------|
| 02 MVP 范围与内容规格       | 12 技术架构与更新顺序         |
| 03 比赛规则与战斗空间       | 13 数据配置与资源规范         |
| 04 输入、缓冲与指令识别     | 14 UI、回合流程与设置         |
| 05 角色状态机与转移优先级   | 15 AI 与训练木桩              |
| **06 行走、跳跃与角色运动** | **16 性能、回放与联机预留**   |
| 07 拳脚攻击与招式时间轴     | 17 调试工具与可观测性         |
| 08 格挡、防御与受击规则     | 18 开发里程碑与任务拆分       |
| 09 HitBox 与命中结算管线    | 19 测试方案与验收标准         |
| 10 必杀技、超必杀技与能量   | 20 风险、原创边界与附录       |

**PRODUCT VISION**

# 01 项目定位与设计目标

本项目是一款使用 3D 角色和场景、但将对战规则限制在二维战斗平面的 1v1 格斗小游戏。玩家通过走位、跳跃、格挡、拳脚、必杀技与超必杀技争夺回合胜利。重点不是堆叠招式数量，而是建立清晰、稳定、可调试的战斗内核。

## 1.1 玩家体验目标

- 输入响应明确：按键、方向与指令不会因为渲染帧率或动画事件而随机失效。

- 攻防结果可理解：为什么命中、为什么被格挡、为什么发生交易命中，都能通过调试数据解释。

- 打击有重量：命中停顿、受击动作、音效、火花、震屏与击退在同一事件上同步。

- 学习成本可控：MVP 只提供少量高辨识度招式，先形成“近身、对空、飞行道具、爆发技”的完整循环。

- 内容可扩展：新增角色主要通过配置数据、动画和判定轨迹完成，避免复制并修改大量角色逻辑。

## 1.2 核心循环

| **阶段**        | **玩家行为**                 | **系统反馈**                   |
|-----------------|------------------------------|--------------------------------|
| **中立博弈**    | 前后移动、试探、跳跃、预判   | 距离、站位、能量与时间形成压力 |
| **进攻确认**    | 拳脚命中或迫使对手格挡       | HitStop、硬直、推远、命中特效  |
| **连段 / 取消** | 用轻攻击确认，再取消到必杀技 | 连击数、伤害缩放、资源增长     |
| **防守反击**    | 格挡、后退、等待收招空隙     | 格挡硬直、削血、反击提示       |
| **资源爆发**    | 积满能量后使用超必杀技       | 屏幕冻结、镜头强化、多段命中   |
| **回合结算**    | KO 或时间结束                | 慢镜、胜负 UI、重开或下一回合  |

## 1.3 设计原则

> **1.** 战斗逻辑先于表现：战斗结果由数据与状态决定，动画、特效和镜头只消费结果。
>
> **2.** 整数帧优先：所有招式时序、无敌、取消与硬直均用战斗 Tick 表达。
>
> **3.** 单一结算入口：所有近战、飞行道具和超必杀命中都进入同一 HitResolver。
>
> **4.** 配置优先于分支：角色差异放入 CharacterData、MoveData 与 HitboxTrack，而不是散落在代码中的 if/else。
>
> **5.** 调试能力属于产品功能：从第一周就提供帧步进、输入历史和判定框显示。

> **成功标准**
>
> 两个相同灰盒角色也能玩出完整回合：走位可控、跳跃轨迹稳定、拳脚可命中/格挡、必杀与超杀可识别、KO 能结算；全流程无随机漏判和状态卡死。

**SCOPE**

# 02 MVP 范围与内容规格

## 2.1 首个可玩版本

| **优先级**   | **功能** | **MVP 规格**                                             |
|--------------|----------|----------------------------------------------------------|
| **P0 必须**  | 角色移动 | 前走、后走、转身、蹲下、前跳、后跳、垂直跳、落地硬直     |
| **P0 必须**  | 基础攻击 | 站立轻拳/重拳/轻脚/重脚，蹲轻脚，跳攻击；至少 6 个普通技 |
| **P0 必须**  | 防御     | 按住背向方向格挡；站防、蹲防；格挡硬直、推远与削血规则   |
| **P0 必须**  | 命中     | HitBox/HurtBox、HitStop、HitStun、击退、浮空、击倒、KO   |
| **P0 必须**  | 特殊招式 | 每角色 3 个必杀技：飞行道具、对空技、突进技              |
| **P0 必须**  | 爆发资源 | 0–100 超必杀能量；每角色 1 个超必杀技                    |
| **P0 必须**  | 比赛流程 | 倒计时、生命、能量、局数、KO、时间结束、重开             |
| **P1 建议**  | 对战对象 | 本地双人 + 简单 AI；训练木桩                             |
| **P1 建议**  | 调试     | 输入历史、帧计数、判定框、命中日志、帧步进               |
| **暂不实现** | 复杂系统 | 投技、拆投、空防、弹反、防御槽、角色养成、联网匹配       |

## 2.2 内容量建议

| **内容项**   | **原型下限**     | **首个完整 Demo**         |
|--------------|------------------|---------------------------|
| **角色**     | 1 个角色镜像对战 | 2 个原创角色              |
| **场景**     | 1 个灰盒场景     | 1 个完整场景 + 1 个训练场 |
| **普通技**   | 每角色 6 个      | 每角色 10–12 个           |
| **必杀技**   | 每角色 2 个      | 每角色 3 个               |
| **超必杀技** | 每角色 1 个      | 每角色 1 个               |
| **AI 难度**  | 1 档             | 3 档                      |
| **回合规则** | 一局定胜负       | 三局两胜、99 秒           |

> **范围控制建议**
>
> 先用胶囊体、基础动作和纯色特效完成“第一可玩”；在手感通过前，不投入角色建模、复杂镜头和大量动作。任何新增功能都必须说明它改善了哪一种攻防决策。

## 2.3 非功能目标

- 标准 PC 在 1080p 下稳定 60 FPS；战斗 Tick 永远保持 60 Hz。

- 单次对战可从输入流重放，重放结果在同版本、同平台上保持一致。

- 角色招式数据修改后无需改核心代码即可生效。

- 战斗关键路径不产生持续 GC；飞行道具、命中特效和飘字使用对象池。

- 控制支持手柄与键盘重绑定，并提供震屏、闪光强度与输入显示开关。

**RULES & SPACE**

# 03 比赛规则与战斗空间

## 3.1 默认比赛规则

| **参数**       | **默认值**       | **说明**                           |
|----------------|------------------|------------------------------------|
| **局制**       | 三局两胜         | 原型阶段可切换为一局定胜负         |
| **回合时间**   | 99 秒            | 使用战斗时间；暂停与回合演出不计时 |
| **最大生命**   | 1000             | 便于用整数表达伤害与缩放           |
| **超必杀能量** | 0–100            | 命中、格挡与受击均可按招式配置增长 |
| **时间结束**   | 生命百分比高者胜 | 相同则判平局并重开该回合           |
| **KO 判定**    | 生命值 ≤ 0       | 本 Tick 结算完成后进入 KO 状态     |

## 3.2 坐标系与战斗平面

建议将 X 轴定义为左右移动，Y 轴定义为高度，Z 轴为场景深度。角色逻辑位置始终投影到固定的战斗平面 Z = 0；3D 模型可在表现层有轻微深度偏移，但 PushBox、HurtBox 与 HitBox 均在同一逻辑平面计算。

- 舞台边界：X ∈ \[−StageHalfWidth, +StageHalfWidth\]，角色中心不可越界。

- PushBox：两个角色不可穿透；先求期望位移，再按质量和边界分摊重叠量。

- 面对方向：每个 Tick 末根据双方 X 位置决定；攻击不可转身的帧区间保持原朝向。

- 交叉攻击：双方交换位置后，下一 Tick 更新面对方向；当前 Tick 的方向输入按 Tick 开始时朝向解释。

- 镜头：始终看向两人中点，并用距离和舞台边界控制缩放与平移。

## 3.3 战斗时间模型

> **固定战斗 Tick**
>
> 渲染可以是 60、120 或更高 FPS，但输入采样、状态推进、移动、碰撞与命中结算都以固定 1/60 秒为单位。动画播放速度由当前招式帧映射，不反过来驱动战斗结果。

| **时间域**           | **是否受 HitStop 影响** | **典型内容**                          |
|----------------------|-------------------------|---------------------------------------|
| **BattleTime**       | 是                      | 招式帧、移动、飞行道具、受击/格挡硬直 |
| **PresentationTime** | 可选                    | 粒子、镜头震动、音效尾音、UI 动画     |
| **RealTime**         | 否                      | 暂停菜单、设备重连、加载与调试界面    |

**INPUT**

# 04 输入、缓冲与指令识别

## 4.1 默认操作映射

| **动作**    | **键盘示例**  | **手柄示例**    | **规则**                           |
|-------------|---------------|-----------------|------------------------------------|
| **方向**    | WASD / 方向键 | 十字键 / 左摇杆 | 8 方向归一化；按角色朝向转换为前后 |
| **轻拳 LP** | J             | X / □           | 快速、短距离、低伤害               |
| **重拳 HP** | K             | Y / △           | 较慢、高伤害、可对空               |
| **轻脚 LK** | U             | A / ×           | 中短距离、可做低段                 |
| **重脚 HK** | I             | B / ○           | 长距离、较大收招                   |
| **暂停**    | Esc           | Menu / Options  | 仅比赛允许时打开                   |

*格挡默认不占独立按键：按住“远离对手”的方向进入格挡意图。可在辅助模式中增加 Guard 键。*

## 4.2 输入帧结构

每个渲染帧读取设备输入，将结果写入 InputBuffer；每个战斗 Tick 消费一个归一化输入快照。缓冲区建议保存最近 30–45 Tick，用于指令识别、输入显示、回放与问题复现。

| **字段**           | **类型**     | **用途**                                 |
|--------------------|--------------|------------------------------------------|
| **Tick**           | int          | 输入发生的战斗 Tick                      |
| **Direction**      | enum 1–9     | 数字小键盘方向；5 为中立                 |
| **PressedMask**    | bitmask      | 本 Tick 新按下的攻击键                   |
| **HeldMask**       | bitmask      | 本 Tick 持续按住的攻击键                 |
| **ReleasedMask**   | bitmask      | 本 Tick 释放的攻击键；可用于负边输入扩展 |
| **FacingSnapshot** | Left / Right | 用于将世界方向转换为相对方向             |
| **ConsumedFlags**  | bitmask      | 避免同一次按键被多个动作重复消费         |

## 4.3 指令识别规则

- 方向按“相对朝向”解释：6 始终代表前，4 始终代表后。

- 从攻击键按下 Tick 向前回溯方向序列，而不是从最早输入向后搜索。

- 每条指令配置总窗口、相邻步骤最大间隔、是否允许斜方向替代、是否允许跳过中立。

- 同 Tick 多条指令成立时，按“超必杀 \> 必杀技 \> 特殊普通技 \> 普通技”排序。

- 动作进入后消费相关按键与方向片段，避免一个输入同时触发两个动作。

- 推荐首版宽容：必杀总窗口 12–16 Tick，超必杀 20–24 Tick，按键缓冲 4–6 Tick。

| **招式类型** | **输入示例**    | **匹配序列** | **宽容建议**                        |
|--------------|-----------------|--------------|-------------------------------------|
| **飞行道具** | ↓ ↘ → + P       | 2, 3, 6 + P  | 允许 2,6 或 2,3,6；总窗口 14 Tick   |
| **对空技**   | → ↓ ↘ + P       | 6, 2, 3 + P  | 允许首个 6 来自前走；总窗口 12 Tick |
| **突进技**   | ↓ ↙ ← + K       | 2, 1, 4 + K  | 斜方向必须出现；总窗口 14 Tick      |
| **超必杀**   | ↓ ↘ → ↓ ↘ → + P | 236236 + P   | 总窗口 24 Tick；能量必须为 100      |

**指令识别伪代码（方向相对角色朝向）**

```csharp
bool TryMatch(Command cmd, InputBuffer buffer, int nowTick, Facing facing) {
    int cursor = nowTick;
    for (int i = cmd.steps.Count - 1; i >= 0; --i) {
        cursor = buffer.FindPreviousMatch(
        cmd.steps[i], cursor, cmd.maxGapTicks, facing);
        if (cursor < 0) return false;
    }
    return nowTick - cursor <= cmd.totalWindowTicks
        && buffer.HasButtonPress(cmd.buttonMask, nowTick, cmd.buttonBufferTicks);
}
```

> **输入可靠性验收**
>
> 在固定录制的 1000 组输入序列中，识别结果必须完全一致；切换渲染帧率、开启慢动作或发生 HitStop 时，不得改变指令成立结果。

**STATE MACHINE**

# 05 角色状态机与转移优先级

角色使用分层状态机：顶层区分 Ground、Air、Attack、Reaction、Down 与 KO，子状态负责行走、跳跃、攻击阶段和受击类型。状态机只处理“角色当前允许做什么”，招式帧表负责“某个动作在第几帧发生什么”。

```mermaid
flowchart LR
  subgraph A["自然动作链"]
    G["Ground<br/>Idle / Walk / Crouch / Turn"] -->|跳跃输入| JS["JumpStart"]
    JS -->|起跳完成| AIR["Air<br/>Jump / Fall"]
    AIR -->|接地| LAND["Landing"]
    LAND -->|落地硬直结束| G
  end

  subgraph B["主动与防御分支"]
    READY["Ground / Air<br/>当前可行动"] -->|攻击输入| ATK["Attack<br/>普通技 / 空中攻击"]
    READY -->|指令成立| SP["Special / Super<br/>指令技 / 资源技"]
    READY -->|有效格挡姿态| BLK["Block / BlockStun<br/>格挡意图 / 格挡硬直"]
    ATK -->|动作结束| BACK["返回 Ground / Air"]
    SP -->|动作结束| BACK
    BLK -->|硬直结束| BACK
  end

  subgraph C["强制中断链（优先级高于普通输入）"]
    NONKO["任意非 KO 状态"] -->|合法命中| HIT["HitStun / Launch<br/>站立受击 / 浮空"]
    HIT -->|击倒| DOWN["Knockdown / Wakeup<br/>倒地 / 起身"]
    DOWN -->|站立恢复或起身完成| GROUND["Ground"]
    NONKO -->|生命归零| KO["KO / RoundEnd"]
    HIT -->|受击阶段生命归零| KO
  end
```

图 1 角色核心状态与主要转移

## 5.1 状态清单

| **状态组**   | **子状态**                                    | **关键职责**                                       |
|--------------|-----------------------------------------------|----------------------------------------------------|
| **Ground**   | Idle / Walk / Crouch / Turn                   | 读取移动与攻击输入；处理面对方向与地面摩擦         |
| **Air**      | JumpStart / Jump / Fall / AirAttack / Landing | 处理起跳锁定、空中速度、接地与落地硬直             |
| **Attack**   | Startup / Active / Recovery                   | 推进 MoveTimeline；开放 HitBox、取消窗口与位移曲线 |
| **Special**  | Special / Super / Cinematic                   | 资源校验、无敌、飞行道具、屏幕冻结和多段命中       |
| **Defense**  | Block / BlockStun                             | 格挡姿态、高低段校验、格挡硬直与推远               |
| **Reaction** | HitStun / Launch / WallBounce                 | 受击、浮空、击退、连段计数与恢复                   |
| **Down**     | Knockdown / Wakeup                            | 倒地时间、起身无敌与恢复站立                       |
| **Terminal** | KO / RoundEnd                                 | 禁用输入，播放结算动作与回合流程                   |

## 5.2 转移优先级

同一 Tick 可能同时出现 KO、受击、落地、取消与新输入。为避免结果依赖代码调用顺序，所有转移先生成 TransitionRequest，再由统一优先级选择。建议顺序如下：

> **1.** KO / RoundEnd：生命归零或回合结束，覆盖所有普通转移。
>
> **2.** 强制受击：命中、击倒、浮空；无敌或装甲可在 HitResolver 阶段拦截。
>
> **3.** 脚本强制状态：超必杀演出、抓取演出（未来）、出生与回合开场。
>
> **4.** 取消转移：命中取消、格挡取消、特殊取消、超必杀取消。
>
> **5.** 接地 / 离地：落地、起跳帧结束、被击飞离地。
>
> **6.** 自然结束：收招、硬直、起身、转身结束。
>
> **7.** 玩家输入：走、蹲、跳、普通攻击、必杀技。

## 5.3 状态接口

**状态机接口建议**

```csharp
interface IFighterState {
    void Enter(FighterContext ctx, StateEnterArgs args);
    void PreTick(FighterContext ctx, in InputFrame input);
    void Tick(FighterContext ctx); // 推进逻辑帧，不直接播放特效
    void PostTick(FighterContext ctx); // 生成转移请求与表现事件
    void Exit(FighterContext ctx);
}

struct TransitionRequest {
    FighterStateId target;
    int priority;
    TransitionReason reason;
    object payload;
}
```

> **避免的实现**
>
> 不要让 Animator StateMachineBehaviour 直接修改生命、开启判定或决定状态转移。动画事件可能因过渡、掉帧、速度变化或跳帧而漏发；它们最多用于非关键音效与装饰。

**MOVEMENT**

# 06 行走、跳跃与角色运动

## 6.1 运动学角色控制器

角色移动使用自定义 Kinematic FighterMotor，而不是依赖动态刚体。每个 Tick 计算期望速度与位移，执行舞台边界、地面检测和 PushBox 修正，再写回逻辑位置。这样能获得稳定、可重放且便于联网预留的结果。

| **参数**         | **原型建议值** | **说明**                               |
|------------------|----------------|----------------------------------------|
| **前走速度**     | 4.2 m/s        | 接近对手时略快，鼓励主动走位           |
| **后走速度**     | 3.4 m/s        | 后退不应成为无成本脱离手段             |
| **蹲姿移动**     | 0 m/s          | MVP 中蹲下固定；后续可增加缓慢移动     |
| **跳跃初速度**   | 8.5 m/s        | 通过重力与初速度共同调整弧线           |
| **重力**         | −28 m/s²       | 建议自定义重力，不使用项目全局物理重力 |
| **空中水平速度** | 3.2 m/s        | 起跳时锁定方向，允许少量空中修正可配置 |
| **落地硬直**     | 4 Tick         | 普通跳落地；空中攻击可配置更长硬直     |
| **PushBox 宽度** | 0.75 m         | 站立基线；蹲姿可略小                   |

*上述数值只用于灰盒验证；最终手感应以画面比例、角色身高和攻击距离统一调整。*

## 6.2 行走规则

- 方向输入为 6 时使用前走速度，4 时使用后走速度；“前/后”按角色面对方向解释。

- 攻击、格挡硬直、受击、倒地和大多数必杀技期间不读取普通行走输入。

- 进入 Turn 状态时可锁定 1–2 Tick，防止模型瞬间镜像造成脚步穿帮；逻辑朝向仍在规则允许时更新。

- 两个 PushBox 重叠时，先尝试各自退让一半；一方贴舞台边界时由另一方承担剩余位移。

- 不得用 CharacterController 的自动 StepOffset 造成 Z 轴或高度漂移；地面只允许设计好的坡度或平面。

## 6.3 跳跃规则

- 跳跃分为 JumpStart、Airborne、Landing。JumpStart 建议 3–4 Tick，期间可被命中。

- 起跳方向在 JumpStart 结束时锁定；垂直跳 X 速度为 0，前后跳使用各自速度。

- 空中不允许再次跳跃；是否允许空中格挡、空中必杀应由角色与招式数据显式配置。

- 接地判定使用脚底 Probe 与上一 Tick 高度，避免高速下落穿透地面。

- 被击飞时使用 ReactionVelocity，不复用普通跳跃状态，以便独立控制重力、弹地和受身。

**角色运动 Tick 伪代码**

```csharp
void SimulateMotor(Fighter f) {
    Vec2 desired = f.State.BuildVelocity();
    Vec2 delta = desired * BattleClock.FixedDelta;
    delta = Stage.ClampToBounds(f.Position, delta, f.PushBox);
    f.Position += delta;
    PushSolver.ResolvePair(f, f.Opponent);
    GroundProbe.ResolveLanding(f);
}
```

> **手感调试顺序**
>
> 先固定角色身高与舞台比例，再调走速和跳跃弧线；随后调攻击距离；最后才调镜头。镜头不能掩盖角色运动本身的问题。

**MOVE SYSTEM**

# 07 拳脚攻击与招式时间轴

## 7.1 普通攻击规格

每个普通技由 MoveData 描述，并由 MoveController 按 Tick 推进。MoveData 不仅记录起手/持续/收招，还包含位移、HitBox 轨迹、伤害、命中效果、取消窗口、资源变化和表现事件。

| **招式**        | **定位**      | **建议特征**                                     |
|-----------------|---------------|--------------------------------------------------|
| **站轻拳 LP**   | 近距离确认    | 4 Tick 起手；短收招；命中可连自身或取消必杀      |
| **站重拳 HP**   | 高伤害 / 对空 | 8–10 Tick 起手；大 HitStop；可设置上半身对空判定 |
| **站轻脚 LK**   | 中距离牵制    | 5 Tick 起手；较长脚部 HitBox；低伤害             |
| **站重脚 HK**   | 远距离重击    | 10–12 Tick 起手；长收招；可造成击退或击倒        |
| **蹲轻脚 2LK**  | 低段确认      | 低段；伤害低；命中后可接轻拳或必杀               |
| **跳重脚 j.HK** | 跳入攻击      | 空中可用；落地有硬直；根据落点决定正反向         |

## 7.2 招式阶段

| **阶段**     | **逻辑**                 | **可发生事件**                           |
|--------------|--------------------------|------------------------------------------|
| **Startup**  | 输入已接受，尚无攻击判定 | 前摇位移、无敌/装甲、取消来源检查        |
| **Active**   | 一个或多个 HitBox 有效   | 命中、格挡、交易命中、多段间隔           |
| **Recovery** | HitBox 关闭，等待恢复    | 可被反击；部分招式开放命中取消           |
| **End**      | 招式完成                 | 返回 Idle / Air / Landing 或链入后续动作 |

## 7.3 取消规则

- Whiff Cancel：挥空时允许取消；MVP 默认关闭，避免无限安全试探。

- Hit Cancel：命中后允许普通技取消到指定必杀技。

- Block Cancel：被格挡时也可取消；通常比命中取消列表更严格。

- Chain Cancel：轻攻击可在命中后连到另一轻攻击或指定中攻击。

- Super Cancel：特定必杀技在命中/格挡时可取消为超必杀技。

- 取消只在 MoveData 的帧区间内有效，并且来源、目标、命中状态和资源条件全部满足。

## 7.4 连段与伤害缩放

| **规则**         | **MVP 建议**                                              |
|------------------|-----------------------------------------------------------|
| **连击成立**     | 上一击造成的 HitStun 尚未结束，下一击在恢复前命中         |
| **伤害缩放**     | 第 1 击 100%，第 2 击 90%，之后每击 −10%，最低 50%        |
| **最低伤害**     | 超必杀最后一击可设 20% 最低保障，避免长连段完全失去终结感 |
| **HitStun 衰减** | 连击达到 5 段后每段额外减少 1 Tick，避免无限连            |
| **重复招式限制** | 同一浮空连段中关键弹墙/浮空属性只触发一次                 |
| **连击重置**     | 受击者回到可行动状态、倒地结束或回合结算时重置            |

> **帧优势的基本检查**
>
> 命中优势 ≈ HitStun − 攻击者剩余收招；格挡优势 ≈ BlockStun − 剩余收招。MVP 不要求复杂数值，但每个招式都应能从帧表推导“命中后谁先动、格挡后是否可反击”。

**DEFENSE**

# 08 格挡、防御与受击规则

## 8.1 格挡意图

格挡不是一个可以随时强制进入的普通动作，而是角色在可防御状态下、检测到“远离对手”的方向输入后产生的 GuardIntent。HitResolver 在命中 Tick 使用该意图、姿态和攻击段位决定是否格挡成功。

| **攻击段位**           | **站立格挡** | **蹲下格挡** | **空中格挡** |
|------------------------|--------------|--------------|--------------|
| **High 高段**          | 可           | 不可         | MVP 不支持   |
| **Mid 中段**           | 可           | 可           | MVP 不支持   |
| **Low 低段**           | 不可         | 可           | MVP 不支持   |
| **Unblockable 不可防** | 不可         | 不可         | 不可         |

## 8.2 格挡成立条件

- 受击者当前状态允许格挡：Idle、Walk、Crouch 或可取消到格挡的恢复状态。

- 在命中 Tick 开始时存在有效 GuardIntent；方向按该 Tick 的 FacingSnapshot 解释。

- 攻击段位与受击者姿态匹配；不可防或投技类攻击直接绕过。

- 受击者未处于 GuardBreak、KO、不可防演出或明确禁止格挡的动作中。

- 命中来自身后时，MVP 仍按双方逻辑朝向判定；下一 Tick 才更新转身，避免同 Tick 双重解释。

## 8.3 格挡结果

| **项目**     | **建议规则**                                                        |
|--------------|---------------------------------------------------------------------|
| **格挡硬直** | 由攻击 MoveData 给出；轻攻击 6–9 Tick，重攻击 12–18 Tick            |
| **格挡推远** | 攻击者与防守者按比例分摊；角落时攻击者承担更多反作用位移            |
| **削血**     | 普通技 0；必杀技 5%–15% 基础伤害；削血不能直接 KO（可配置）         |
| **能量增长** | 攻击者命中格挡获得少量能量，防守者也获得更少能量                    |
| **取消规则** | 攻击者可按 MoveData 在格挡后取消；防守者不可在 BlockStun 中普通行动 |
| **连续格挡** | BlockStun 期间若新攻击到达，重新计算段位并刷新硬直                  |

## 8.4 受击类型

| **类型**       | **用途**             | **反应**                         |
|----------------|----------------------|----------------------------------|
| **LightHit**   | 轻拳、轻脚           | 短 HitStop、轻微后仰、短硬直     |
| **HeavyHit**   | 重拳、重脚、必杀     | 较长 HitStop、明显击退与受击动作 |
| **Launch**     | 对空或浮空技         | 写入空中速度，进入 Launch 状态   |
| **Knockdown**  | 扫腿、重击、超杀终结 | 落地后进入倒地与起身流程         |
| **Crumple**    | 可选的重度受击       | 长站立硬直，可用于超杀前置       |
| **CounterHit** | 在对手攻击起手被命中 | 额外伤害或 HitStun，并显示提示   |

> **简化建议**
>
> MVP 先不做完美格挡、弹反、防御槽和受身。防御系统越复杂，越需要额外动画、UI、AI与平衡成本；先把高/中/低段与格挡硬直做正确。

**HIT DETECTION**

# 09 HitBox 与命中结算管线

## 9.1 判定体分类

| **判定体**       | **归属**       | **用途**                 | **实现建议**                         |
|------------------|----------------|--------------------------|--------------------------------------|
| **PushBox**      | 角色           | 角色间实体推挤与角落挤压 | 固定矩形/胶囊；每 Tick 处理一次      |
| **HurtBox**      | 角色骨骼或姿态 | 可被攻击命中的区域       | 头、躯干、腿等多个盒；随姿态轨迹变化 |
| **HitBox**       | 招式或飞行道具 | 主动攻击判定             | 仅 Active 帧开启；携带 HitDefinition |
| **ProximityBox** | 可选           | 靠近时触发近身普通技     | 只用于选招，不直接造成命中           |
| **StageBox**     | 场景           | 地面、边界与特殊区域     | 逻辑用简化体，视觉网格不参与战斗碰撞 |

## 9.2 判定轨迹

HitBox 与 HurtBox 不依赖运行时骨骼物理碰撞，而是由可编辑的 BoxTrack 描述。每个 Tick 根据招式帧或姿态帧读取局部位置、尺寸、旋转与标签，再转换到角色逻辑坐标。这样可以稳定调节判定，并在动画替换后保持规则可控。

- 优先使用矩形或胶囊；避免 MeshCollider 和复杂 Convex 碰撞。

- 每个 HitBox 携带 MoveInstanceId + HitGroupId，用于控制同一招式对同一目标的命中次数。

- 多段招式通过不同 HitGroup 或 RehitInterval 配置，不通过重复开关碰撞器猜测。

- 飞行道具使用独立 OwnerId、TeamId 与 ProjectileInstanceId，仍进入统一 HitResolver。

- 调试模式显示红色 HitBox、绿色 HurtBox、蓝色 PushBox，并标注 Tick 与招式 ID。

```mermaid
flowchart TD
  S1["1. 收集同 Tick 的 HitBox × HurtBox 候选"] -->
  S2["2. 过滤：阵营、自身、重复命中、无敌 / 装甲"] -->
  S3["3. 判定格挡、高低段、交叉攻击与反击命中"] -->
  S4["4. 处理同帧冲突：交易命中 / 显式优先级"] -->
  S5["5. 计算伤害、连段缩放、削血与资源变化"] -->
  S6["6. 写入 HitStop、HitStun / BlockStun、击退与浮空"] -->
  S7["7. 派发视觉事件：特效、音效、震屏、慢镜头"] -->
  S8["8. 记录 CombatLog 与回放输入，进入下一个 Tick"]
```

图 2 单个战斗 Tick 内的命中结算顺序

## 9.3 同帧冲突规则

| **场景**                     | **规则**                                                              |
|------------------------------|-----------------------------------------------------------------------|
| **双方普通攻击同 Tick 命中** | 默认交易命中：两边都应用结果；除非招式显式配置优先级或无敌            |
| **攻击命中飞行道具**         | MVP 默认不相互抵消；后续可给飞行道具增加耐久与碰撞层                  |
| **同一攻击命中多个 HurtBox** | 只生成一个 HitCandidate，使用命中点优先级最高的 HurtBox               |
| **多段攻击同 Tick 重叠**     | 按 HitGroupId 和 RehitInterval 去重；同目标每组最多结算一次           |
| **命中与 KO 同 Tick**        | 先完成该 Tick 全部合法命中，再按结果进入 KO；表现上可选择超杀终结慢镜 |
| **格挡与被绕后同 Tick**      | 按 Tick 开始时 FacingSnapshot 判断；下一 Tick 才转身                  |

## 9.4 HitResult 数据

**统一命中结果对象**

```csharp
struct HitResult {
    EntityId attacker;
    EntityId defender;
    MoveInstanceId moveInstance;
    HitOutcome outcome; // Hit / Block / Armor / Invulnerable
    int damage;
    int chipDamage;
    int hitStopAttacker;
    int hitStopDefender;
    int stunTicks;
    Vec2 pushback;
    Vec2 launchVelocity;
    bool counterHit;
    bool knockdown;
    Vec2 contactPoint;
}
```

> **实现原则**
>
> 碰撞系统只回答“哪些判定体发生重叠”；HitResolver 才回答“这次重叠是否有效、是否格挡、造成多少伤害、进入什么状态”。不要把游戏规则写进 OnTriggerEnter。

**SPECIALS & SUPER**

# 10 必杀技、超必杀技与能量

## 10.1 必杀技组合建议

| **招式类型** | **战术作用**               | **关键实现点**                        |
|--------------|----------------------------|---------------------------------------|
| **能量弹**   | 远距离牵制、迫使跳跃或格挡 | 对象池、速度、寿命、命中组、场外回收  |
| **对空升击** | 惩罚跳跃、近身反击         | 起手无敌窗口、向上 HitBox、落地收招   |
| **突进踢**   | 中距离接近、连段收尾       | 位移曲线、墙边推挤、命中/格挡不同收招 |

## 10.2 能量系统

| **事件**         | **攻击者获得** | **防守者获得** |
|------------------|----------------|----------------|
| **普通技命中**   | 2–5            | 1–3            |
| **普通技被格挡** | 1–3            | 1–2            |
| **必杀技命中**   | 5–10           | 3–5            |
| **必杀技被格挡** | 3–6            | 2–4            |
| **受到重击**     | —              | 5–8            |
| **使用超必杀**   | 消耗 100       | —              |

*能量增长应全部来自 MoveData，不写死在攻击类型分支中。*

## 10.3 超必杀执行流程

> **1.** CommandRecognizer 检测到超必杀指令，并确认当前状态允许、能量为 100。
>
> **2.** 立即预占资源并创建 SuperMoveInstance，防止同 Tick 重复触发。
>
> **3.** 进入 8–15 Tick 的 SuperFreeze：对手、普通飞行道具与比赛计时暂停；施放者按配置推进或保持。
>
> **4.** 播放镜头拉近、角色闪光和蓄力音效；逻辑仍由 MoveTimeline 决定无敌与判定开启。
>
> **5.** 按多段 HitGroup 依次命中；每段有独立 HitStop、伤害与击退。
>
> **6.** 终结段应用 Knockdown 或特殊 KO 镜头；超杀结束后恢复正常镜头与 BattleTime。

| **规则项**   | **建议**                                              |
|--------------|-------------------------------------------------------|
| **超杀输入** | 236236 + 任意拳；总窗口 24 Tick，按键缓冲 5 Tick      |
| **资源检查** | 必须在动作开始前满足；资源在 Enter 时扣除             |
| **起手无敌** | 示例 1–8 Tick；只作为招式数据，不由“超杀”类型自动赋予 |
| **画面冻结** | 逻辑冻结与表现冻结分离；UI、音效尾音可继续            |
| **连段缩放** | 遵循通用缩放，但终结段可有最低伤害保障                |
| **失败处理** | 资源不足时回退到普通拳；不可因指令部分匹配吞掉输入    |

> **原创性要求**
>
> 可以借鉴“飞行道具、对空、突进、超杀冻结”等类型设计，但角色造型、动作轮廓、招式名称、特效、音效、UI 与数值组合应原创，避免直接复刻现有作品。

**PRESENTATION**

# 11 动画、特效、音效与镜头

## 11.1 动画驱动策略

| **内容**         | **权威来源**                | **说明**                       |
|------------------|-----------------------------|--------------------------------|
| **当前动作与帧** | FighterState + MoveTimeline | 动画根据逻辑动作与 Tick 采样   |
| **HitBox 开关**  | MoveData / HitboxTrack      | 不依赖 Animation Event         |
| **角色位移**     | FighterMotor / MotionCurve  | 普通战斗禁用自由 Root Motion   |
| **受击与格挡**   | HitResult                   | 结果确定后触发对应表现         |
| **音效与特效**   | PresentationEvent           | 允许丢帧补播，但不影响战斗结果 |
| **镜头**         | CameraDirector              | 消费角色位置与命中事件         |

## 11.2 动画状态建议

- 基础层：Idle、WalkF、WalkB、Crouch、Turn、JumpStart、JumpUp、Fall、Landing。

- 攻击层：每个普通技、必杀技与超必杀独立 Clip；按 MoveId 显式切换。

- 受击层：轻/重受击、上段/下段格挡、浮空、倒地、起身、KO。

- 面部或上半身叠加层仅用于非关键表现，不改变 HurtBox 和战斗姿态。

- 动画过渡时间应很短且可预测；攻击动作通常使用 0 或 1 Tick 的逻辑切换。

## 11.3 打击反馈事件包

| **反馈**    | **轻击**     | **重击 / 必杀**        | **超必杀终结**           |
|-------------|--------------|------------------------|--------------------------|
| **HitStop** | 4–6 Tick     | 7–11 Tick              | 10–16 Tick               |
| **火花**    | 小型、短寿命 | 较大、方向性强         | 多层特效 + 屏幕闪光      |
| **音效**    | 清脆         | 低频冲击 + 武器/元素层 | 专属终结音与低频冲击     |
| **震屏**    | 0–2 px       | 3–7 px                 | 8–14 px；可在设置中减弱  |
| **镜头**    | 通常不变     | 轻微推近或冲击抖动     | 拉近、冻结、跟随终结动作 |
| **飘字**    | 可选         | Counter / Punish 提示  | Super / KO 强调          |

## 11.4 镜头规则

- 基础镜头朝向战斗平面，目标点为两角色中点；距离随角色间距变化。

- 确保两人屏幕边缘留有安全边距，且舞台边界不会暴露未制作区域。

- 跳跃时相机只跟随一定比例的 Y 高度，避免频繁上下晃动。

- HitStop 期间可添加短促 Impulse，但相机位置插值需使用 PresentationTime。

- 超杀镜头必须有超时回退；角色被 KO、演出被中断或对象销毁时强制恢复基础镜头。

> **无障碍与舒适度**
>
> 设置中提供“震屏强度、闪光强度、手柄震动、动态镜头”开关。关闭这些效果不应改变 HitStop、输入、判定和比赛结果。

**ARCHITECTURE**

# 12 技术架构与更新顺序

```mermaid
flowchart TB
  subgraph DATA["输入与数据"]
    CD["Character / Move / Stage Data"]
    IB["InputBuffer"] --> CR["CommandRecognizer"]
  end

  subgraph COMBAT["战斗域"]
    BC["BattleClock<br/>固定 60 Tick"]
    FC["FighterController<br/>StateMachine + Motor"]
    MF["MatchFlow"]
    MC["MoveController<br/>招式时间轴"]
    CW["CollisionWorld<br/>Push / Hurt / Hit Box"]
    HR["HitResolver<br/>统一命中结算"]
    PS["ProjectileSystem"]
  end

  subgraph PRESENT["表现层"]
    VA["VFX / Audio / 动画"]
    CAM["CameraDirector"]
    HUD["HUD / 菜单"]
  end

  CD --> FC
  CD --> MC
  CD --> PS
  CR --> FC
  BC --> FC
  BC --> MF
  FC --> MC
  FC --> CW
  MC --> CW
  CW --> HR
  HR --> FC
  HR --> PS
  PS --> CW

  MF -.-> HUD
  FC -.-> VA
  FC -.-> CAM
  FC -.-> HUD
  HR -.-> VA
  HR -.-> CAM
```

图 3 推荐的战斗域模块划分

## 12.1 核心模块

| **模块**              | **职责**                                 | **禁止事项**                   |
|-----------------------|------------------------------------------|--------------------------------|
| **BattleClock**       | 固定 Tick、暂停、HitStop 域与帧步进      | 不读取玩家输入，不直接控制动画 |
| **InputService**      | 设备采样、重绑定、写入 InputBuffer       | 不决定招式，不改变角色状态     |
| **CommandRecognizer** | 匹配指令并生成动作请求                   | 不扣资源，不直接播放动画       |
| **FighterController** | 聚合状态机、运动、生命、能量与动作实例   | 不直接搜索场景对象             |
| **MoveController**    | 按 Tick 推进招式事件与取消窗口           | 不直接结算伤害                 |
| **CollisionWorld**    | 构建判定体、收集重叠候选                 | 不处理格挡、伤害或 KO          |
| **HitResolver**       | 过滤、格挡、伤害、硬直、击退、资源与日志 | 不依赖特效对象是否存在         |
| **ProjectileSystem**  | 生成、推进、回收飞行道具                 | 不绕过 HitResolver             |
| **MatchFlow**         | 开场、计时、KO、回合与胜负               | 不持有角色招式细节             |
| **Presenter**         | 动画、VFX、音效、镜头、HUD               | 不反向决定战斗逻辑             |

## 12.2 每 Tick 更新顺序

> **1.** InputService 将设备状态汇总为 InputFrame，并写入每个玩家的 InputBuffer。
>
> **2.** BattleClock 判断全局暂停、超杀冻结与各实体 HitStop，确定本 Tick 谁可以推进。
>
> **3.** Fighter PreTick：识别指令、生成转移请求、处理已到期硬直。
>
> **4.** 状态机提交最高优先级转移；MoveController 推进当前招式帧并生成判定轨迹。
>
> **5.** FighterMotor 与 ProjectileSystem 计算位移；Stage/PushSolver 修正边界和角色重叠。
>
> **6.** CollisionWorld 重建本 Tick 的 Push/Hurt/Hit Box 并收集 HitCandidate。
>
> **7.** HitResolver 对全部候选排序和结算，写入生命、能量、硬直、击退与新状态请求。
>
> **8.** MatchFlow 检查 KO、时间结束与回合转换。
>
> **9.** Presenter 消费本 Tick 的只读快照与 PresentationEvent，更新动画、特效、音效、镜头和 HUD。
>
> **10.** CombatLog 记录输入摘要、状态摘要与命中结果，用于回放和问题复现。

**战斗主循环伪代码**

```csharp
void BattleTick() {
    inputService.CaptureTickInputs();
    battleClock.BeginTick();
    foreach (var fighter in fighters) fighter.PreTick();
    foreach (var fighter in fighters) fighter.CommitTransition();
    foreach (var fighter in fighters) fighter.SimulateMoveAndMotor();
    projectileSystem.Simulate();
    collisionWorld.BuildSnapshot(fighters, projectiles);
    hitResolver.Resolve(collisionWorld.CollectHitCandidates());
    foreach (var fighter in fighters) fighter.PostTick();
    matchFlow.EvaluateRound();
    combatLog.RecordSnapshot();
    presenter.PublishFrame();
}
```

## 12.3 事件分类

| **事件类型**           | **是否可丢失**  | **例子**                               |
|------------------------|-----------------|----------------------------------------|
| **Domain Command**     | 不可            | 开始招式、扣能量、应用 HitResult       |
| **Domain Event**       | 不可            | FighterHit、RoundKO、ProjectileSpawned |
| **Presentation Event** | 可补播 / 可降级 | HitSpark、CameraShake、PlaySfx         |
| **Telemetry Event**    | 可批量          | 输入统计、帧耗时、招式使用率           |

**DATA**

# 13 数据配置与资源规范

## 13.1 CharacterData

| **字段组**   | **示例字段**                                             |
|--------------|----------------------------------------------------------|
| **身份**     | CharacterId、显示名、阵营、默认皮肤                      |
| **体型**     | 身高、PushBox、站立/蹲姿 HurtBox 轨迹                    |
| **移动**     | 前走/后走速度、跳跃初速度、重力、落地硬直                |
| **资源**     | 最大生命、最大能量、初始能量、受击能量倍率               |
| **动作映射** | Idle、Walk、Jump、Block、Hit、KO 与 MoveId 列表          |
| **表现**     | AnimatorProfile、VFXProfile、AudioProfile、CameraProfile |

## 13.2 MoveData 核心字段

| **字段组** | **字段**                              | **说明**                                              |
|------------|---------------------------------------|-------------------------------------------------------|
| **标识**   | MoveId / DisplayName / Tags           | 唯一 ID、编辑器名称与 Normal/Special/Super/Air 等标签 |
| **输入**   | CommandId / Button / AllowedStates    | 指令、攻击键、允许起招状态                            |
| **时序**   | Startup / ActiveSegments / Recovery   | 全部使用整数 Tick                                     |
| **命中**   | Damage / HitLevel / HitStop / HitStun | 伤害、高低段、停顿与硬直                              |
| **位移**   | MotionCurve / Pushback / Launch       | 攻击者位移、受击推远与浮空速度                        |
| **判定**   | HitboxTrack / HurtboxOverride         | 逐 Tick 判定轨迹与姿态覆盖                            |
| **防御**   | BlockStun / Chip / GuardPush          | 被格挡后的效果                                        |
| **资源**   | MeterGain / MeterCost                 | 命中、格挡、挥空与使用成本                            |
| **取消**   | CancelWindows / CancelTargets         | 时间区间、命中条件和目标标签                          |
| **特殊**   | Invuln / Armor / CounterHitBonus      | 无敌、装甲、反击奖励                                  |
| **表现**   | AnimationId / VFX / SFX / CameraCue   | 只读消费的表现事件                                    |

**Unity 风格的数据对象示例**

```csharp
[CreateAssetMenu(menuName = "Fighting/Move Data")]
public sealed class MoveData : ScriptableObject {
    public string moveId;
    public MoveTag tags;
    public CommandData command;
    public int startupTicks;
    public ActiveSegment[] activeSegments;
    public int recoveryTicks;
    public HitDefinition hit;
    public HitboxTrack hitboxTrack;
    public MotionTrack motionTrack;
    public CancelWindow[] cancelWindows;
    public InvulnerabilityWindow[] invulnerability;
    public PresentationCue[] presentation;
}
```

## 13.3 资源目录建议

**建议的目录与归属**

```text
Assets/Game/
├── Battle/
│   ├── Core/                 # Clock、状态机、命中、运动、回放
│   ├── Data/                 # CharacterData、MoveData、StageData
│   ├── Editor/               # 帧表、判定轨迹与预览工具
│   └── Debug/                # Hitbox、输入、日志、帧步进
├── Characters/<CharacterId>/
│   ├── Animations/
│   ├── Moves/
│   ├── HitboxTracks/
│   ├── VFX/
│   ├── Audio/
│   └── Prefabs/
├── Stages/<StageId>/
├── UI/
└── Tests/
    ├── Unit/
    ├── Simulation/
    └── PlayMode/
```

## 13.4 命名与版本

- 稳定 ID 使用小写蛇形：hero_01、st_lp、sp_projectile、su_finisher；显示名可本地化。

- 逻辑数据与表现资源分离：MoveData 不直接引用场景对象，只引用可加载资源 ID。

- 数据增加 schemaVersion；重大字段变更提供迁移脚本，而不是手工逐个修复。

- 所有平衡数值变更进入版本控制，并在提交说明中写明“旧值 → 新值 → 目的”。

- 角色 Prefab 只挂通用组件，不在 Prefab 上复制核心战斗脚本。

> **编辑器工具优先级**
>
> 最值得做的自定义工具是“招式时间轴 + HitBox/HurtBox 轨迹预览”。它应支持拖动 Tick、复制帧、镜像判定、显示动画参考姿态并即时运行单招测试。

**MATCH & UI**

# 14 UI、回合流程与设置

## 14.1 MatchFlow 状态

| **状态**        | **持续 / 退出条件**     | **允许内容**                   |
|-----------------|-------------------------|--------------------------------|
| **Loading**     | 资源准备完成            | 不推进战斗                     |
| **Intro**       | 角色入场动画结束        | 镜头演出、不可操作             |
| **RoundReady**  | “Round / Fight”演出结束 | 角色锁定、计时不动             |
| **Fighting**    | KO 或时间归零           | 完整战斗逻辑                   |
| **KOFreeze**    | 短暂停顿结束            | 命中表现继续，禁止新输入       |
| **RoundResult** | 胜负演出完成            | 更新局数、播放胜利动作         |
| **MatchResult** | 玩家选择重开或退出      | 结果 UI                        |
| **Paused**      | 关闭暂停                | BattleTime 停止，RealTime 继续 |

## 14.2 战斗 HUD

- 双方生命条：显示当前值、延迟损失值（白血）与 KO 状态。

- 双方能量条：0–100；满能量时有明确但不过度闪烁的提示。

- 回合标记：最多 2 个胜利点；当前回合和剩余时间居中。

- 连击与提示：Combo、Counter、Punish、Block；由 Domain Event 驱动。

- 训练/调试叠层：当前状态、MoveId、招式帧、帧优势、输入历史和判定框开关。

## 14.3 设置与可访问性

| **类别** | **设置项**                                        |
|----------|---------------------------------------------------|
| **控制** | 键盘/手柄重绑定、摇杆死区、输入显示、简易指令开关 |
| **画面** | 分辨率、窗口模式、画质、动态模糊关闭、闪光强度    |
| **镜头** | 震屏强度、超杀镜头、镜头跟随强度                  |
| **音频** | 总音量、音乐、音效、语音、手柄震动                |
| **游戏** | 回合数、时间、AI 难度、训练模式生命恢复           |
| **辅助** | 色盲友好 HUD、字幕、慢速训练、按键提示            |

> **UI 数据边界**
>
> HUD 只读取 BattleSnapshot，不直接持有 FighterController。这样暂停、回放、观战与未来联网时都可以复用同一套展示逻辑。

**AI & TRAINING**

# 15 AI 与训练木桩

## 15.1 MVP AI 结构

采用“感知 + 战术状态 + 效用评分”的轻量 AI。AI 不需要直接读取未来输入或命中结果；它只使用当前距离、双方状态、资源、角落位置和近期行为。决策间隔建议 4–8 Tick，并加入反应延迟。

| **战术状态** | **进入条件**            | **候选行为**                         |
|--------------|-------------------------|--------------------------------------|
| **Neutral**  | 双方可行动、距离中远    | 走位、能量弹、试探重脚、等待         |
| **Approach** | 距离过远或时间落后      | 前走、前跳、突进技                   |
| **Pressure** | 对手在 BlockStun / 角落 | 轻攻击、延迟重击、必杀取消、后退诱骗 |
| **Defense**  | 对手起攻或自身低血量    | 格挡、后退、对空、无敌技             |
| **Punish**   | 检测到对手大收招        | 选择起手足够快且距离可达的招式       |
| **Combo**    | 己方攻击命中确认        | 按预设连段脚本执行后续输入           |

## 15.2 难度差异

| **维度**     | **简单**       | **普通**         | **困难**               |
|--------------|----------------|------------------|------------------------|
| **反应延迟** | 18–24 Tick     | 10–16 Tick       | 6–10 Tick              |
| **指令失误** | 较高           | 中等             | 低                     |
| **格挡倾向** | 只格挡明显攻击 | 按距离与动作判断 | 能识别常见高低段       |
| **连段长度** | 1–2 击         | 3–4 击           | 4–6 击并使用资源       |
| **反制知识** | 无             | 有限对空/惩罚    | 基于帧差和距离选择惩罚 |
| **随机性**   | 高             | 中               | 低但仍保留风格权重     |

## 15.3 训练木桩

- 站立、蹲下、跳跃、第一击后格挡、随机格挡。

- 受击后恢复生命、能量固定、位置重置。

- 录制 5–10 秒输入并循环播放，用于测试防守与惩罚。

- 显示连击伤害、起始伤害、缩放、帧优势和可行动 Tick。

- 一键重置到舞台中央或角落。

> **禁止“读心”**
>
> 困难 AI 可以更快、更准，但不应读取玩家尚未生效的输入，也不应在 0 Tick 内完美反应。可接受的优势来自更短反应延迟、更好的距离判断与更完整的连段脚本。

**PERFORMANCE & FUTURE**

# 16 性能、回放与联机预留

## 16.1 性能预算

| **项目**       | **目标**                                                 |
|----------------|----------------------------------------------------------|
| **战斗 Tick**  | 平均 \< 1.5 ms，99 分位 \< 3 ms（双角色 + 常规飞行道具） |
| **碰撞判定体** | 每角色 HurtBox 4–8 个；单招 HitBox 1–4 个                |
| **运行时分配** | 战斗关键路径 0 B / Tick；列表和事件缓冲预分配            |
| **飞行道具**   | 常规同时存在 ≤ 16；使用对象池                            |
| **VFX / 飘字** | 对象池 + 最大并发；超限时降级而非阻塞                    |
| **动画**       | 避免每 Tick 字符串查找；缓存哈希与状态 ID                |

## 16.2 回放

首版回放只需保存初始随机种子、角色/场景数据版本与每 Tick 的 InputFrame。回放时重新运行战斗逻辑，并周期性记录状态哈希。若哈希不一致，立即输出首个分歧 Tick、角色状态、位置、生命与当前招式。

- 回放文件不保存动画、特效或音频状态。

- 每 60 Tick 记录一次轻量状态哈希，用于自动检测非确定性。

- 版本不兼容时明确拒绝播放，不尝试静默修复。

- Bug 报告可自动附带最近 10 秒输入与 CombatLog。

## 16.3 回滚联机预留

MVP 不实现联网，但核心域应避免阻断未来回滚：战斗逻辑固定 Tick、输入驱动、状态可序列化、表现层可重建。真正接入网络时，需进一步处理浮点确定性、快照大小、回滚重演性能与输入延迟。

| **现在就做**                          | **以后再做**                 |
|---------------------------------------|------------------------------|
| 固定 Tick、输入帧、战斗快照、状态哈希 | 网络传输、预测输入、回滚窗口 |
| 战斗域不依赖场景查找与动画事件        | 跨平台确定性与浮点策略       |
| 表现事件带唯一 ID，允许回滚撤销/去重  | 观战、断线重连、匹配与反作弊 |
| 对象池和可重建飞行道具                | 网络带宽压缩与同步协议       |

> **现实边界**
>
> 不要为了“以后可能联网”过早引入复杂框架。只要保持固定 Tick、输入驱动、数据可序列化和表现解耦，单机原型就已经保留了最有价值的联机基础。

**DEBUGGING**

# 17 调试工具与可观测性

## 17.1 必做工具

| **工具**          | **功能**                             | **验收标准**                   |
|-------------------|--------------------------------------|--------------------------------|
| **帧步进**        | 暂停后每次推进 1 Tick / 10 Tick      | 状态、动画采样和判定体同步推进 |
| **输入历史**      | 显示最近 30–60 Tick 的方向和按键     | 标出已消费输入与指令匹配区间   |
| **判定框显示**    | Hit/Hurt/Push Box 颜色区分           | 镜像、缩放和移动后仍准确       |
| **招式面板**      | MoveId、当前帧、阶段、取消窗口       | 能看到有效 HitBox 与无敌窗口   |
| **战斗日志**      | 命中候选、过滤原因、HitResult        | 可按角色、招式与 Tick 筛选     |
| **状态快照**      | 位置、速度、状态、生命、能量、Facing | 一键复制为文本用于 Bug 单      |
| **输入录制/回放** | 录制并重复执行短序列                 | 多次播放结果哈希一致           |

## 17.2 CombatLog 示例

**命中日志应能回答“为什么发生这个结果”**

```text
T=1842 P1 move=st_hp frame=8 phase=Active
candidate: hitbox=body_0 target=P2 hurtbox=torso
guardIntent=true stance=Standing hitLevel=Mid => BLOCK
result: blockStun=14 hitStop=8 guardPush=(0.42,0)
meter: P1 +4, P2 +2
transition: P2 -> BlockStun(14), P1 stays st_hp frame=8
```

## 17.3 自动监控断言

- 角色生命、能量与状态枚举始终在合法范围。

- 同一 Fighter 同 Tick 只能提交一个最终状态转移。

- MoveController 帧不得超出总帧数；已结束招式必须释放 MoveInstance。

- 同一 HitGroup 不得在禁止重击间隔内重复命中同一目标。

- KO 后不得接受玩家输入或生成新的攻击 HitBox。

- 角色逻辑位置不得离开舞台边界，Z 逻辑坐标必须为 0。

- 回放状态哈希不一致时自动中止并导出差异。

> **调试不是“开发者模式装饰”**
>
> 格斗游戏的大多数问题都发生在特定 Tick 和特定状态组合。没有输入历史、帧步进和判定框，团队会把时间花在猜测而不是定位。

**DELIVERY PLAN**

# 18 开发里程碑与任务拆分

以下计划以 1 名程序 + 1 名通才美术/动画的原型团队为参考。若是个人开发，可按同一顺序推进，但不要并行制作大量内容。每个阶段必须通过验收门再进入下一阶段。

| **阶段**          | **主要交付**                                    | **验收门**                                       |
|-------------------|-------------------------------------------------|--------------------------------------------------|
| **M0 工程骨架**   | BattleClock、输入帧、基础数据、空场景、调试面板 | 帧步进与输入历史可用；固定 Tick 不受渲染帧率影响 |
| **M1 运动原型**   | 双角色生成、行走、转身、跳跃、PushBox、镜头     | 无穿透、无越界；30/60/120 FPS 手感一致           |
| **M2 命中闭环**   | 普通技、Hit/Hurt Box、HitStop、受击、格挡、KO   | 镜像角色能完成一局；结果可由 CombatLog 解释      |
| **M3 招式系统**   | 指令识别、取消、飞行道具、对空、突进、超杀      | 录制输入可稳定触发；资源和多段命中正确           |
| **M4 比赛产品化** | HUD、回合流程、暂停、设置、本地双人、训练木桩   | 从启动到重开无阻断；关键设置可保存               |
| **M5 AI 与打磨**  | AI、VFX/SFX、镜头、两角色内容、性能优化         | 完整 Demo 可连续游玩 30 分钟无卡死或明显漏判     |
| **M6 发布准备**   | 测试回归、手柄覆盖、打包、日志与崩溃信息        | 验收清单全绿；已知问题有明确说明                 |

## 18.1 工作量粗估

| **模块**                 | **人日范围** | **备注**                                            |
|--------------------------|--------------|-----------------------------------------------------|
| **战斗核心与调试**       | 8–12         | 输入、时钟、状态机、运动、判定、命中与工具          |
| **普通技 / 必杀 / 超杀** | 5–8          | 不含高质量动画制作                                  |
| **比赛流程与 UI**        | 3–5          | 基础 HUD、设置、回合与暂停                          |
| **AI 与训练模式**        | 3–5          | 简单效用 AI + 训练木桩                              |
| **表现整合**             | 5–8          | 动画接入、特效、音效、镜头与反馈                    |
| **测试与优化**           | 4–7          | 自动测试、性能、手柄、打包与回归                    |
| **合计**                 | 28–45        | 占位素材的功能型 Demo；个人开发按技能和素材情况浮动 |

## 18.2 推荐任务拆分

- 每个功能任务都包含：数据、运行时、调试显示、测试场景与验收用例。

- 角色动作与判定由同一 MoveId 串联，避免动画名、招式名和代码枚举不一致。

- 每新增一个招式，必须同时提交帧表、HitboxTrack、命中/格挡结果和训练模式验证步骤。

- 每次调整核心结算顺序，都运行固定回放集并比较状态哈希。

- 表现任务在战斗事件稳定后接入，不直接修改战斗核心以“配合动画”。

> **第一可玩顺序**
>
> Idle → Walk → Jump → 一个普通技 → HitBox/HurtBox → HitStop/HitStun → Block → KO。完成这条链路前，不做超杀镜头、AI 或复杂 UI。

**QA**

# 19 测试方案与验收标准

## 19.1 自动测试层级

| **层级**          | **覆盖内容**    | **示例**                                      |
|-------------------|-----------------|-----------------------------------------------|
| **Unit**          | 纯算法与数据    | 指令匹配、伤害缩放、格挡段位、优先级排序      |
| **Simulation**    | 无渲染战斗 Tick | 固定输入运行 600 Tick，检查状态哈希与最终生命 |
| **PlayMode**      | 场景与组件集成  | 跳跃接地、舞台边界、飞行道具回收、HUD 更新    |
| **Golden Replay** | 回归回放集      | 10–30 条已知战斗录像在每次构建中重放          |
| **Manual**        | 手感与设备      | 键盘/多种手柄、帧率、震屏、视觉可读性         |

## 19.2 核心验收用例

| **ID**     | **场景**                      | **通过标准**                             |
|------------|-------------------------------|------------------------------------------|
| **MOV-01** | 前后行走并互相推挤            | 不穿透、不抖动、不越界；角落分摊正确     |
| **MOV-02** | 30/60/120 FPS 下连续跳跃      | 起跳高度、滞空 Tick 与落点一致           |
| **INP-01** | 快速输入 236+P                | 在宽容窗口内稳定触发，超窗不触发         |
| **INP-02** | 236236+P 且能量不足           | 不吞键；按优先级回退到合法动作           |
| **ATK-01** | 轻拳命中站立对手              | 伤害、HitStop、HitStun、推远与特效一致   |
| **BLK-01** | 站防高/中/低段                | 高/中成功，低段失败并进入受击            |
| **BLK-02** | 蹲防高/中/低段                | 中/低成功，高段失败并进入受击            |
| **HIT-01** | 双方同 Tick 普通攻击          | 按交易规则双方受击，日志顺序稳定         |
| **HIT-02** | 多 HurtBox 与一个 HitBox 重叠 | 只结算一次，命中点选择一致               |
| **SP-01**  | 飞行道具命中/格挡/出界        | 三种路径均正确回收且无重复命中           |
| **SP-02**  | 对空技无敌窗口                | 窗口内忽略指定攻击，窗口外正常受击       |
| **SU-01**  | 满能量超杀                    | 只扣一次资源；冻结、镜头、多段与终结正确 |
| **KO-01**  | 同 Tick 生命归零与多段后续    | 只结算合法段；进入 KO 后无新攻击         |
| **REP-01** | 同输入回放 20 次              | 最终状态与中间哈希完全一致               |

## 19.3 功能完成定义（Definition of Done）

- 设计数据已填写且通过合法性校验，没有魔法数字散落在运行时代码。

- 功能可在 Debug HUD 中观察关键状态与 Tick。

- 至少有 1 个自动测试或固定回放覆盖主要逻辑。

- 键盘与至少一种手柄可用，重绑定后仍正常。

- 30/60/120 FPS 下结果一致；暂停、慢动作与 HitStop 不影响输入匹配。

- 不存在已知的状态卡死、重复命中、越界、资源重复扣除或 KO 后继续行动。

- 表现层缺失时战斗逻辑仍可完整运行；表现对象销毁不会破坏比赛。

> **发布门槛**
>
> 完整对战连续运行 30 分钟，无崩溃、无永久卡死、无明显输入丢失；核心回放集全部通过；关键路径战斗 Tick 在目标机器上满足性能预算。

**RISKS & APPENDIX**

# 20 风险、原创边界与附录

## 20.1 主要风险与缓解

| **风险**         | **表现**                                 | **缓解措施**                             |
|------------------|------------------------------------------|------------------------------------------|
| **动画驱动逻辑** | 判定漏发、过渡不同步、改动画导致规则变化 | 逻辑帧表权威；动画只采样与展示           |
| **范围持续膨胀** | 投技、防反、联网、角色内容同时开工       | 严格按 M0–M6 验收门推进                  |
| **输入手感差**   | 指令过严或误触发，玩家无法稳定出招       | 输入录制、匹配日志、可配置宽容窗口       |
| **判定难调**     | 动画好看但判定不稳定或不可读             | 独立 HitboxTrack 编辑器与帧步进          |
| **碰撞不确定**   | 动态刚体、回调顺序导致同帧结果变化       | 运动学控制 + 收集后统一结算              |
| **表现反向侵入** | 镜头/特效脚本改生命或状态                | Domain / Presentation 事件边界与代码审查 |
| **内容制作成本** | 每个招式需要动作、判定、特效、音效       | 先做少量高辨识度招式，复用事件模板       |
| **知识产权风险** | 造型、动作、招式名和 UI 过度相似         | 建立原创设定与视觉语言；保留素材来源记录 |

## 20.2 原创边界检查

- 不要直接使用现有格斗游戏的角色姓名、服装轮廓、招式名称、语音、UI、标志或特效图样。

- 通用机制如走、跳、格挡、飞行道具、对空、能量槽和超杀冻结可以采用，但表达方式应原创。

- 动作捕捉、音效、字体、模型与特效包需确认商业许可范围，并保存许可证与购买凭证。

- 宣传文案使用“2.5D 对战格斗”描述，不以他人商标作为产品名称或核心卖点。

## 附录 A：首个灰盒角色帧表示例

| **招式**     | **输入** | **起/持/收**     | **伤害** | **硬直 H/B** | **用途**                   |
|--------------|----------|------------------|----------|--------------|----------------------------|
| **站轻拳**   | LP       | 4 / 2 / 8        | 40       | 10 / 7       | 近身确认；命中可取消必杀   |
| **站重拳**   | HP       | 9 / 3 / 18       | 90       | 16 / 12      | 重击；部分帧可对空         |
| **站轻脚**   | LK       | 5 / 3 / 10       | 45       | 11 / 8       | 中距离试探                 |
| **站重脚**   | HK       | 11 / 3 / 22      | 105      | 18 / 14      | 长距离；反击风险高         |
| **蹲轻脚**   | 2+LK     | 5 / 2 / 9        | 35       | 9 / 7        | 低段；可链轻拳             |
| **跳重脚**   | 空中 HK  | 7 / 5 / 着地6    | 80       | 14 / 11      | 跳入攻击                   |
| **能量弹**   | 236+P    | 12 / 投射物 / 22 | 80       | 15 / 12      | 远程牵制；削血 8           |
| **对空升击** | 623+P    | 5 / 6 / 28       | 110      | 击倒 / 15    | 1–6 Tick 上半身无敌        |
| **突进踢**   | 214+K    | 10 / 5 / 20      | 100      | 17 / 13      | 接近与连段收尾             |
| **超必杀**   | 236236+P | 7 / 多段 / 35    | 300      | 击倒 / 20    | 消耗 100；起手冻结 10 Tick |

*H/B = HitStun / BlockStun。所有数值仅为原型起点，不代表最终平衡。*

## 附录 B：首轮实现清单

| **完成** | **任务**                               | **完成** | **任务**                                     |
|----------|----------------------------------------|----------|----------------------------------------------|
| □        | BattleClock 与 60 Tick 主循环          | □        | InputBuffer 与方向相对化                     |
| □        | CommandRecognizer 与输入日志           | □        | FighterStateMachine 与转移优先级             |
| □        | FighterMotor、跳跃、舞台边界与 PushBox | □        | MoveData、MoveTimeline 与取消窗口            |
| □        | HitBox/HurtBox 轨迹与调试显示          | □        | HitResolver、格挡、伤害、HitStop、硬直与击退 |
| □        | 飞行道具、对空技、突进技与超必杀       | □        | MatchFlow、HUD、KO、暂停与重开               |
| □        | 训练木桩、AI、输入回放与状态哈希       | □        | 动画、VFX、SFX、镜头与可访问性设置           |

## 附录 C：项目启动时的 10 个决定

> **1.** 确认战斗是严格 2D 平面，还是允许 Z 轴闪避；本方案默认严格 2D。
>
> **2.** 确认普通技数量与按钮数；本方案默认 4 攻击键。
>
> **3.** 确认格挡采用背向方向，是否提供独立 Guard 辅助键。
>
> **4.** 确认是否支持蹲姿与高低段；本方案建议首版支持。
>
> **5.** 确认每角色必杀技与超杀数量；本方案为 3 + 1。
>
> **6.** 确认是否有动态刚体需求；战斗角色默认不使用动态刚体。
>
> **7.** 确认首版仅单机/本地对战，不在 MVP 中实现联网。
>
> **8.** 确认动画与模型来源、许可和可用动作数量。
>
> **9.** 确认调试工具必须随核心功能同步交付。
>
> **10.** 确认第一可玩验收后再投入完整美术与角色内容。

> **最终建议**
>
> 先做一个角色镜像对战，完整打通“一次输入 → 一个动作 → 一个判定 → 一次命中/格挡 → 一次状态恢复 → 一次 KO”。这条链路稳定后，新增角色与招式才会变成可控的内容生产，而不是继续堆技术债。