chore: initial commit

Docs/Design/23_GameFeelTuningGuide.md

@@ -0,0 +1,333 @@
+# 23 · 游戏手感调优指南（Game Feel Tuning Guide）
+
+> **所属文档集** [← 返回索引](./README.md) · [总览](./00_Overview.md)  
+> **适用人员** 策划 / 程序员 / 动画师  
+> **相关系统** `BaseGames.Combat` · `BaseGames.Feedback` · `BaseGames.Player` · Feel/MMFeedbacks
+
+---
+
+## 目录
+
+1. [设计理念](#1-设计理念)
+2. [玩家移动参数](#2-玩家移动参数)
+3. [跳跃手感参数](#3-跳跃手感参数)
+4. [输入缓冲时长](#4-输入缓冲时长)
+5. [战斗打击感参数](#5-战斗打击感参数)
+6. [弹反系统参数](#6-弹反系统参数)
+7. [受伤 / 死亡反馈](#7-受伤--死亡反馈)
+8. [BOSS 战手感规范](#8-boss-战手感规范)
+9. [镜头与屏幕震动配置表](#9-镜头与屏幕震动配置表)
+10. [音效音量平衡](#10-音效音量平衡)
+11. [Feel MMF_Player 预设速查表](#11-feel-mmf_player-预设速查表)
+12. [调优工作流 SOP](#12-调优工作流-sop)
+
+---
+
+## 1. 设计理念
+
+**参考标准**：以《丝之歌》（Silksong）公开 Demo 的手感为目标基准。核心原则：
+
+- **每个动作都有清晰的起手/作用/收手**（三段式）：玩家永远知道自己处于哪个阶段
+- **惩罚感知而非惩罚玩家**：错误不是数值惩罚，而是视觉/音效让玩家自我意识到失误
+- **快节奏但有分量**：帧数越少越爽，但每一击都要有重量感（Hitstop + 音效 + 震动三合一）
+- **可预测的反馈**：同一输入在不同场景产生相同手感，避免奇怪的边界情况
+
+**手感调优顺序**：
+```
+1. 移动 & 跳跃（地基，最先确定）
+2. 攻击手感（Hitstop、音效、VFX）
+3. 受伤反馈（无敌帧、击退）
+4. 弹反（窗口、回报感）
+5. BOSS 战（电报/前摇/节奏）
+```
+
+---
+
+## 2. 玩家移动参数
+
+### 2.1 推荐基准值
+
+| 参数 | 推荐值 | 说明 |
+|------|--------|------|
+| 最大地面移速 | **8.5 units/s** | 匀速跑动，适合横向扫图 |
+| 最大空中移速 | **7.5 units/s** | 略低于地面，保留空中操控感 |
+| 地面加速度 | **80 units/s²** | 约 0.1s 达到最大速度，起步不能太滑 |
+| 地面减速度 | **120 units/s²** | 松开方向键时比加速更快停下（紧实感）|
+| 空中水平加速 | **60 units/s²** | 慢于地面，有飘逸感 |
+| 空中水平减速 | **50 units/s²** | 空气阻力模拟 |
+| 重力倍率（下降） | **3.5** | 跌落要快，避免漂浮感 |
+| 重力倍率（上升） | **2.5** | 起跳要有力量感，上升弧线陡峭 |
+
+### 2.2 PlayerMovement 速查参数名
+
+```
+PlayerMovementConfigSO:
+  moveSpeed          = 8.5
+  airMoveSpeed       = 7.5
+  groundAcceleration = 80
+  groundDeceleration = 120
+  airAcceleration    = 60
+  airDeceleration    = 50
+  gravityScaleUp     = 2.5   （上升时 Rigidbody2D.gravityScale）
+  gravityScaleDown   = 3.5   （下降时）
+  maxFallSpeed       = -28    （最大下落速度，防止穿地）
+```
+
+---
+
+## 3. 跳跃手感参数
+
+| 参数 | 推荐值 | 说明 |
+|------|--------|------|
+| 跳跃初速度 | **18 units/s** | 跳起来有力量感 |
+| 二段跳初速度 | **16 units/s** | 略低，体现"空气中借力"感 |
+| 土狼时间（Coyote Time） | **0.15 s** | 走过平台边缘后仍可起跳 |
+| 跳跃缓冲（Jump Buffer） | **0.12 s** | 落地前提前按跳跃仍然有效 |
+| 短跳切断时间（Jump Cut） | 长按 = 全跳；松开后 0.05s 内速度削减至 60% | 短按跳低，长按跳高 |
+| 壁跳速度（水平） | **12 units/s**（反向） | 离墙跳出，不粘墙 |
+| 壁跳速度（垂直） | **14 units/s** | 可配合二段跳向上突进 |
+| 蹲下跳（下 + 跳，单向平台） | 忽略平台 0.3s | 按时间，不按速度 |
+
+---
+
+## 4. 输入缓冲时长
+
+输入缓冲允许玩家比实际判定稍早按下按键并依然生效，减少"明明按了但没反应"的挫败感：
+
+| 动作 | 缓冲时长 | 备注 |
+|------|---------|------|
+| 跳跃 | **0.12 s** | 空中/落地前均缓冲 |
+| 攻击 | **0.08 s** | 动画取消窗口内可缓冲下一攻击 |
+| 冲刺 | **0.10 s** | 攻击前摇中可缓冲冲刺（若取消窗口开启）|
+| 弹反 | **0.06 s** | 严格，弹反窗口精确（奖励精确操作）|
+| 法术 | **0.10 s** | 落地后立即施法生效 |
+| 互动 | **0.20 s** | 接近 NPC 时可提前按 |
+
+---
+
+## 5. 战斗打击感参数
+
+### 5.1 Hitstop（定格帧）
+
+Hitstop 是命中瞬间游戏时间短暂冻结，增强打击感：
+
+| 击中类型 | Hitstop 时长 | 时间缩放 |
+|---------|------------|--------|
+| 轻击 | **0.05 s** | TimeScale = 0.05 |
+| 中击 | **0.10 s** | TimeScale = 0.05 |
+| 重击 / 终结技 | **0.15 s** | TimeScale = 0.0 |
+| 弹反成功 | **0.20 s** | TimeScale = 0.0（完全冻结）|
+| 受到伤害（玩家） | **0.07 s** | TimeScale = 0.05 |
+| BOSS 进入新阶段 | **0.35 s** | TimeScale = 0.0 |
+
+> **注意**：Hitstop 期间 Animancer 也应暂停（通过 `animancer.Speed = 0`），否则动画继续播放会破坏效果。
+
+**HitstopSO 配置**（`BaseGames.Feedback.HitstopConfigSO`）：
+
+```csharp
+[CreateAssetMenu(menuName = "Feedback/HitstopConfig")]
+public class HitstopConfigSO : ScriptableObject
+{
+    [Serializable]
+    public struct HitstopEntry
+    {
+        public HitWeight   weight;
+        public float       duration;
+        [Range(0f, 0.1f)]
+        public float       timeScale;
+    }
+    public HitstopEntry[] entries;
+}
+```
+
+### 5.2 击退（Knockback）参数
+
+| 击中类型 | 水平力 | 垂直力 | 说明 |
+|---------|-------|-------|------|
+| 轻击 | **6** | **3** | 敌人小幅后退 |
+| 中击 | **10** | **5** | 敌人明显弹飞 |
+| 重击 | **16** | **8** | 敌人强力弹飞 |
+| 玩家受击（轻） | **5** | **2** | 轻微后退 |
+| 玩家受击（重） | **9** | **5** | 玩家摔跌感 |
+
+击退曲线（`AnimationCurve`）建议：
+
+```
+时间 0.0 → 1.0 的 velocity 衰减曲线:
+  起点: 1.0（最大速度）
+  0.3:  0.7（线性段）
+  0.7:  0.2（开始减速）
+  终点: 0.0（完全停止）
+
+曲线类型: EaseInOutCubic（前段快，后段急停）
+```
+
+---
+
+## 6. 弹反系统参数
+
+| 参数 | 推荐值 | 说明 |
+|------|--------|------|
+| 弹反前摇（Startup） | **0.05 s** | 弹反有输入延迟，需预判 |
+| 弹反判定窗口（Active） | **0.28 s** | 约 17 帧（60fps），宽松但非无限 |
+| 弹反收手（Recovery） | **0.10 s** | 若弹反失败，收手期间可受击 |
+| 成功弹反后无敌帧 | **0.3 s** | 完美弹反后短暂无敌 |
+| 弹反回血 | **+0 HP**（仅 Soul 回复 10）| 弹反奖励为 Soul 而非 HP |
+| 对 BOSS 弹反 | Soul + 15；BOSS 硬直 0.5s | 高风险高回报 |
+| 弹反冲击波范围 | **2 units** | 可打退附近小型敌人 |
+
+> **弹反感知设计**：弹反成功时播放 `Parry_Success_Heavy` 预设（Hitstop 0.2s + 光环闪光 + 振动 + 专属音效），即使面对普通敌人也要有"神级操作"的反馈。
+
+---
+
+## 7. 受伤 / 死亡反馈
+
+### 7.1 玩家受伤
+
+| 参数 | 推荐值 |
+|------|--------|
+| 无敌帧时长（正常受击） | **1.8 s** |
+| 无敌帧时长（蹲下受击） | **1.2 s** |
+| 无敌帧闪烁频率 | **0.1 s 间隔**（10 fps 闪烁）|
+| 受伤时摄像机震动 | Magnitude 0.3 / Frequency 20 / Duration 0.3s |
+| 受伤时屏幕红边 Vignette | 透明度 0.5 → 0 渐出，0.4s |
+| 受伤停手时间（控制锁定） | **0.2 s**（允许无敌帧内仍可移动）|
+
+### 7.2 玩家死亡
+
+| 阶段 | 时长 | 效果 |
+|------|------|------|
+| 死亡 Hitstop | **0.5 s** | TimeScale → 0 |
+| 死亡动画播放 | **1.2 s** | 玩家倒地 / 破碎动画 |
+| 画面淡黑 | **0.8 s** | 从透明 → 全黑 |
+| 复活场景淡入 | **0.5 s** | 在最近存档点淡入 |
+| 冥影生成（Shade 生成） | 死亡 1s 后 | 在死亡位置生成 DeathShade |
+
+---
+
+## 8. BOSS 战手感规范
+
+### 8.1 电报（Telegraph）时序
+
+| 攻击类型 | 电报时长 | 前摇时长 | 作用时长 | 收手时长 |
+|---------|--------|--------|--------|--------|
+| 普通近战 | **0.4 s** | **0.2 s** | **0.3 s** | **0.4 s** |
+| 重型近战 | **0.6 s** | **0.4 s** | **0.5 s** | **0.7 s** |
+| 远程弹射 | **0.5 s** | **0.3 s** | **0.4 s** | **0.4 s** |
+| 范围爆炸 | **1.0 s** | **0.5 s** | **0.2 s**（瞬间） | **0.8 s** |
+| 冲刺攻击 | **0.3 s** | **0.2 s** | （持续至碰墙） | **0.6 s** |
+
+> **原则**：电报时长与攻击伤害成正比。一击必杀类攻击电报 ≥ 0.8s，确保玩家有逃避时间。
+
+### 8.2 BOSS 节奏规范
+
+| 参数 | 推荐值 | 说明 |
+|------|--------|------|
+| 连招最大次数 | **3 连击** | 第三击后强制空档期 |
+| 空档期（Idle Gap） | **0.8 ~ 1.2 s** | 随机化，避免可预测节拍 |
+| 阶段切换无敌时间 | **1.5 s** | 切换阶段时玩家无法伤害 BOSS |
+| 阶段切换冻结时间 | **0.5 s** | TimeScale → 0，营造戏剧感 |
+| 二阶段进入速度加成 | **+15%** | 攻击速度加快，玩家需重新适应节奏 |
+
+---
+
+## 9. 镜头与屏幕震动配置表
+
+使用 Cinemachine 3 的 `CinemachineImpulseSource` + Feel 的 `MMCinemachineImpulse`：
+
+| 事件 | Amplitude | Frequency | Duration | 衰减类型 |
+|------|-----------|-----------|----------|----------|
+| 轻击命中 | **0.1** | 10 | **0.15 s** | 快速衰减 |
+| 中击命中 | **0.2** | 15 | **0.20 s** | 快速衰减 |
+| 重击命中 | **0.4** | 20 | **0.30 s** | 中速衰减 |
+| 弹反成功 | **0.5** | 25 | **0.25 s** | 瞬间峰值 + 快速衰减 |
+| 玩家受击 | **0.3** | 18 | **0.30 s** | 快速衰减 |
+| 玩家死亡 | **0.6** | 12 | **0.50 s** | 慢速衰减 |
+| 落地重击 | **0.25** | 15 | **0.20 s** | 快速衰减 |
+| BOSS 阶段切换 | **0.8** | 8 | **0.60 s** | 慢速衰减 |
+| BOSS 死亡 | **1.0** | 6 | **1.00 s** | 极慢衰减 |
+
+**镜头追踪参数**：
+
+| 参数 | 推荐值 |
+|------|--------|
+| 水平追踪 Damping | **0.15 s** | 快速跟上水平移动 |
+| 垂直追踪 Damping | **0.25 s** | 稍慢，跳跃时镜头延迟跟随 |
+| 垂直偏移（俯冲先见） | 向速度方向偏移 **1.5 units** | 奔跑方向可看到更多前方 |
+| 向下看偏移（下蹲） | **-2.0 units**（ 按住 ↓ 激活）| 可看到脚下平台 |
+| 向上看偏移（上按键） | **+3.0 units** | 可看到头顶区域 |
+
+---
+
+## 10. 音效音量平衡
+
+所有音量值均为 Unity AudioMixer 分组的相对 dB 值（主混音组 = 0 dB）：
+
+| 音效类型 | AudioMixer 分组 | 推荐电平 |
+|---------|----------------|---------|
+| BGM | `BGM` | **-6 dB** |
+| 环境音 | `Ambience` | **-12 dB** |
+| 玩家脚步 | `SFX_Player` | **-8 dB** |
+| 玩家攻击音效 | `SFX_Player` | **-3 dB** |
+| 玩家受击音效 | `SFX_Player` | **-2 dB** |
+| 敌人普通音效 | `SFX_Enemy` | **-6 dB** |
+| BOSS 音效 | `SFX_Enemy` | **-3 dB** |
+| UI 音效 | `SFX_UI` | **-10 dB** |
+| 弹反成功音效 | `SFX_Player` | **0 dB**（最响，高奖励感）|
+
+**动态闪避（Audio Ducking）规则**：
+- BOSS 进入 → BGM 淡出至 -18 dB（0.5s 渐变），BOSS BGM 淡入
+- BOSS 死亡 → BOSS BGM 淡出（1.0s）→ 区域 BGM 淡入（0.8s）
+- 弹反成功音效播放时 → 其他 SFX 临时降至 -6 dB（0.1s）→ 恢复（0.2s）
+
+---
+
+## 11. Feel MMF_Player 预设速查表
+
+所有预设存放于 `Assets/ScriptableObjects/Feedback/Presets/`：
+
+| 预设名 | 包含 Feedback | 主要参数 |
+|--------|--------------|---------|
+| `Hit_Light` | MMF_CameraShake + MMF_AudioPlay | Amplitude 0.1, 0.15s, SFX_击中_轻 |
+| `Hit_Medium` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze | Amplitude 0.2, 0.2s, Freeze 0.1s |
+| `Hit_Heavy` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze + MMF_Flash | Amplitude 0.4, 0.3s, Freeze 0.15s |
+| `Parry_Success` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze + MMF_Flash + MMF_Particles | Amplitude 0.5, 0.25s, Freeze 0.2s, 专属粒子爆发 |
+| `Player_Hurt` | MMF_CameraShake + MMF_AudioPlay + MMF_Vignette | Amplitude 0.3, 0.3s, 红色渐变 |
+| `Player_Death` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze + MMF_ScreenFade | Amplitude 0.6, 0.5s, Freeze 0.5s |
+| `Land_Normal` | MMF_CameraShake + MMF_Particles + MMF_AudioPlay | Amplitude 0.15, 0.2s, 轻尘粒子 |
+| `Land_Heavy` | MMF_CameraShake + MMF_Particles + MMF_AudioPlay | Amplitude 0.3, 0.25s, 重尘粒子 |
+| `Boss_Roar` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze + MMF_Zoom | 全屏震动，Freeze 0.3s |
+| `Boss_Death` | MMF_CameraShake + MMF_AudioPlay + MMF_Freeze + MMF_Particles + MMF_ScreenFade | 史诗级演出，1.0s |
+| `Spell_Cast` | MMF_Particles + MMF_AudioPlay | 灵魂粒子，施法音效 |
+| `Ability_Unlock` | MMF_ScreenFlash + MMF_AudioPlay + MMF_Freeze + MMF_UIAnim | 全屏白色闪光，0.35s Freeze |
+
+---
+
+## 12. 调优工作流 SOP
+
+### 加入新攻击时的手感清单
+
+```
+□ 1. 攻击动画三段清晰（前摇/作用/收手）
+□ 2. AnimationEventConfigSO 中设置 EnableHitBox / DisableHitBox 帧
+□ 3. 设置 EnableCancelWindow 帧（若该攻击可取消）
+□ 4. 为命中创建 MMF_Player 预设（轻/中/重选择）
+□ 5. 添加 HitstopConfigSO 条目（对应击中类型）
+□ 6. 配置击退向量（KnockbackWeight）
+□ 7. 在 Damage Simulator 中测试（见 09_EditorExtensions.md §8）
+□ 8. 实际游玩 15 次以上，感受节奏
+```
+
+### 调优迭代建议
+
+1. **先调 Hitstop**：哪怕 0.01s 的差异都能感知，先到位
+2. **再调音效**：使用 -3dB 和 0dB 对比，选择更有力的
+3. **最后调震动**：震动要配合音效节拍，不要只是随机添加
+4. **对比参考**：在屏幕右侧开一个《丝之歌》Demo 视频，反复对比攻击节奏
+
+### 关键数字不要随意更改的原因
+
+- **Coyote Time 0.15s**：低于 0.1s 玩家感觉不到（失去意义），高于 0.2s 感觉像 Bug
+- **弹反窗口 0.28s**：经过大量玩家测试的最优平衡点（太短 = 无法使用，太长 = 无技术含量）
+- **地面减速 120 > 地面加速 80**：停下要比启动快，避免"冰面感"
+- **Hitstop 用 TimeScale 不用暂停 Time**：配合 `Animancer.Speed` 一起设为 0，物理不受影响