1
2
3

Player (MonoBehaviour)
  ├── movementStateMachine   ← 移动 FSM（待机/行走/奔跑/冲刺/闪避/转身…）
  └── comboStateMachine      ← 连招 FSM（Null/ATKIng/Skill）

1
2
3
4
5

输入 → 状态机 → ComboData取值 → CrossFade动画
                    ↓
       动画事件ATK() → 伤害判定 → GameEventManager → 敌人Health → 受击反馈
       动画事件PlayComboFX() → SFX_PoolManager → 音效
       CameraSwitcher + SkillTimelineManager → 相机控制

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

Player Action Map:
  L_AtK       → <Mouse>/leftButton       轻攻击
  R_Atk       → <Mouse>/rightButton      重攻击（代码未接线）
  Movement    → WASD / 左摇杆            移动
  Run         → <Keyboard>/shift         闪避/冲刺
  Execute     → <Keyboard>/e             技能
  FinishSkill → <Keyboard>/q             终极大招

SwitchSkill Action Map:
  L           → <Mouse>/leftButton       QTE选左
  R           → <Mouse>/rightButton      QTE选右

1
2
3
4
5

按下左键 → Input System → L_AtK.started
  → PlayerComboState.OnAttackInput(InputAction.CallbackContext)
    → 当前角色校验 → CanBaseComboInput(检查canInput + 不在Hit/Parry/Skill)
      → 冲刺/闪避中? → DodgeComboInput
      → 普通状态   → LightComboInput

1
2
3
4
5
6
7

public enum OnEnterAnimationPlayerState
{
    Idle, Walk, Run, Sprint,
    Dash, DashBack, TurnBack,
    Switch, SwitchOut,
    ATK, Null
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

switch (onEnterAnimationState)
{
    case Dash / DashBack / TurnBack / Switch / SwitchOut
         / Idle / Walk / Run / Sprint:
        player.OnMovementAnimationExitEvent();   // 只调 movement
        break;

    case ATK:
        player.OnMovementAnimationExitEvent();   // 调 movement（恢复移动）
        player.OnComboAnimationExitEvent();      // 调 combo（退出攻击状态）
        break;

    default:  // 含 Null（技能动画）
        player.OnAnimationExitEvent();            // 两者都调（向后兼容）
        break;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

左键 → LightComboInput()
  ├── currentCombo = comboData.lightCombo     ← 设为轻攻击链
  ├── ResetComboDates()                        ← 恢复第一段（防止闪A残留）
  └── ExecuteBaseCombo()
        ├── hasATKCommand = true               ← 攻击指令排队
        └── canInput = false                   ← 锁输入

下一帧 UpdateComboAnimation() 消费指令:
  ├── comboName = currentCombo.GetComboName(comboIndex)
  ├── CrossFade(comboName, 0.111f)            ← 播放动画
  ├── PlayCharacterVoice / PlayWeaponSound     ← 播放音效
  └── comboIndex++, hasATKCommand=false, canATK=false

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

ComboData.asset          → 单段攻击的所有参数
  ├── comboName: "ATK_01"
  ├── comboDamage: 15
  ├── hitName[]: "Hit_Front", "Hit_Back"
  ├── parryName[]: "Parry"
  ├── ATKCount: 2
  └── shakeForceList: [0.3, 0.5]

ComboContainerData.asset → 多段连招链
  └── comboDates[]: [ComboData_01, ComboData_02, ...]
      └── DodgeATKData: 闪A替换第一段

PlayerComboSOData        → 角色的五类攻击
  ├── lightCombo
  ├── heavyCombo
  ├── executeCombo
  ├── skillCombo
  ├── finishSkillCombo
  └── switchSkill

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

按 E → OnSkill()
  → CanSkillInput()         ← 不在Hit/Parry/Skill/ATK中
  → SkillInput()
    → currentSkill = comboData.skillCombo
    → ExecuteSkill()
      → ReSetATKIndex(0)    ← 手动清零伤害判定序号
      → PlayCharacterVoice(currentSkill) / PlayWeaponSound(currentSkill)
      → CrossFadeInFixedTime(comboName, 0.1f)
    → ChangeState(SkillState)

SkillState.Enter:
  → movement → playerMovementNullState    ← 禁止移动
  → CameraSwitcher.ActiveStateCamera      ← 激活技能相机
  → SkillTimelineManager.PlaySkillTimeline ← 播放 Timeline 推近变焦

动画播完 → OnAnimationExitEvent → ChangeState(NullState) → 恢复

1
2
3
4

AttackTrigger():
  if   animTag("ATK")   → AttackDetection(currentCombo)      → 普通攻击
  elif animTag("Skill") → SkillDetection(currentSkill)        → 技能
  else                  → AttackDetection(executeCombo)       → 处决

1
2
3
4
5

stateCameraPool[CharacterNameList][AttackStyle] → CinemachineVirtualCameraBase

ActiveStateCamera(Skikk)   → Priority = 20
UnActiveStateCamera()      → Priority = 0
UnActiveAllStateCameras()  → 遍历该角色全部VCam → Priority=0（切人时用）

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

// SkillTimelineManager.PlaySkillTimeline():
foreach (var track in timeline.GetOutputTracks())
{
    if (track is AnimationTrack && director.GetGenericBinding(track) == null)
    {
        var vcam = playerRoot.GetComponentInChildren<CinemachineVirtualCameraBase>();
        if (vcam != null)
            director.SetGenericBinding(track, vcam.gameObject);
    }
}

1
2

SkillTimelineManager.MainInstance.StopAllForCharacter(旧角色);
CameraSwitcher.MainInstance.UnActiveAllStateCameras(旧角色);

1
2
3
4
5
6

SwitchInput()
  → 旧角色名移入 waitingCharacterList，新角色移出
  → ExecuteSwitchCharacter(新角色, isSwitchATK=false)
    → 新角色在旧角色侧面 spawn → Play("SwitchIn")
    → 旧角色：攻击中? → 等播完 → CrossFade("SwitchOut") → 非攻击 → 立即退场
    → switchOutCharacterTime 后 SetActive(false) 旧角色

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

连招满足条件 → TriggerSwitchSkill()
  → 禁用 Player Input
  → 激活切人相机 CameraSwitcher.ActiveSwitchCamera(true)
  → 0.3s后 Time.timeScale = 0.06（慢动作）
  → 0.2s后 StartSwitchSkill()
    → 3秒倒计时
    → 弹出 SwitchTimeUI（候补角色头像 + 定时）
    → 注册 SwitchSkill.L/R 输入
  → 玩家选人 → SwitchSkill(角色名)
    → CameraSwitcher.ActiveSwitchCamera(false)
    → 恢复时间 → 恢复输入
    → ExecuteSwitchCharacter(新角色, isSwitchATK=true)
      → 新角色从敌人生成位置登场 → 播切人大招动画

1
2
3
4
5
6
7
8

IEnumerator WaitAttackFinishAndExit(SwitchCharacterInfo info, string switchOutAnim)
{
    while (info.animator.AnimationAtTag("ATK") || info.animator.AnimationAtTag("Skill"))
        yield return null;           // 每帧检查，攻击播完再继续

    info.animator.CrossFadeInFixedTime(switchOutAnim, 0.1f);
    StartDeactivateCoroutine();      // 延迟 switchOutCharacterTime 后隐藏
}

1
2
3
4
5
6

// newCharacterName 变化时（BindableProperty.OnValueChanged）
OnSetWaitingCharacterList(newValue):
  waitingCharacterList.Remove(newValue);          // 新上场的角色移出
  waitingCharacterList.Add(currentCharacterName); // 旧角色移入（如果不在列表中）

// 效果：waitingCharacterList 永远只存"不在场"的角色

1
2
3
4

IgnoreAllPlayerCollisions():
  遍历 switchCharacterInfos 所有两两组合
    GetComponentsInChildren<Collider>() × 2
      Physics.IgnoreCollision(ca, cb);    // 一对永久忽略

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

动画关键帧 ATK() 事件触发
  → Player.ATK()
    → PlayerATKIngState.ATK()
      → CharacterComboBase.ATK()
        → AttackTrigger()

AttackTrigger():
  判断 animTag:
    "ATK":
      AttackDetection(距离<comboDistance && 角度<80°)
      → 取得 hitName/parryName（ComboData 数组中随机取一个字符串）
      → GameEventsManager.CallEvent("触发伤害",
          damage, hitName, parryName, attacker, bearer, combo)

GameEventManager → EventHandler<float,string,string,Transform,Transform,ComboBase>.CallBack
  → Action.Invoke(damage, hitName, parryName, attacker, bearer, combo)

CharacterHealthBase.OnCharacterHitEventHandler:
  if (Bearer != this.transform) return;         ← 过滤：只处理被击中的那个敌人
  → CharacterHitAction(Damage, HitName, ParryName)
    → CharacterHeath.CharacterHitAction():
        if (hasStrength)  → animator.CrossFade(parryName)  ← 格挡动画
        else              → animator.CrossFade(hitName)    ← 受击动画
  → OnCharacterDamageAction → TakeDamage/TakeStrength
  → SetHitFVX → VFX_PoolManager.GetVFX(Enemy, "Hit", 命中点)
  → SetHitSFX（被注释）

1
2
3
4
5
6
7

HasStrength = true:
  → TakeStrength(damage)        ← 扣耐力值
  → 播 parryName 格挡动画

HasStrength = false:
  → TakeDamage(damage)          ← 扣血量
  → 播 hitName 受击动画

1
2

// CameraHitFeel.MainInstance.CameraShake(shakeForce[ATKIndex-1]);
// CameraHitFeel.MainInstance.PF(pauseFrameTime);

1
2
3
4

effectPool[CharacterNameList][VFXNameString] → Queue<GameObject>

例: effectPool[Seele]["Slash"]    → Queue(刀光×3)
    effectPool[Enemy]["Hit"]      → Queue(火花×5)

1
2
3
4
5
6
7
8

TryGetVFX → Dequeue(不活跃) → Init(角色,特效名) → SetActive(true)
  → OnEnable → Spawn → StartPlay
    → ParticleSystem.Play()
    → TimerManager.GetOneTimer(playTime, StartReCycle)

playTime到期 → StartReCycle → ReturnVFX(角色,特效名,go)
  → SetActive(false) → OnDisable → ReSycle → ParticleSystem.Stop()
  → Enqueue(回池)

1
2
3
4
5

// 有父级（刀光附着武器骨骼，不改位置）
VFX_PoolManager.TryGetVFX(Seele, "Slash");

// 无父级（世界坐标生成火花）
VFX_PoolManager.GetVFX(Enemy, "Hit", worldPos, rotation);

1
2

Vector3 hitDir = (attacker.position - hitter.position).normalized;
Vector3 targetPos = hitter.position + hitDir * 0.8f + Vector3.up * 1f;

1
2
3
4

if (currentCombo != null)  → 取 currentCombo.GetComboSoundStyle()
else if (currentSkill != null && currentSkill.AppAudioPrefab)
  → 取 currentSkill.universalSound
else → return（静默）

1
2
3
4

GetOneTimer(float time, Action task)       // 受 timeScale 影响
GetTimer(float time, Action task)          // 同上，返回引用供取消
GetRealTimer(float time, Action task)      // 不受 timeScale 影响
UnregisterTimer(GameTimer timer)           // 手动取消

1
2
3
4
5

public class BindableProperty<T>
{
    public T Value { get; set; }
    public event Action<T> OnValueChanged;
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

PlayerSO.asset                    ← 角色总资产
  └── PlayerMovementData
        ├── bufferToIdleTime: 0.15s
        ├── turnBackAngle: 135°
        ├── PlayerDashData:      闪避动画名、冷却0.5s、淡入12帧
        ├── PlayerSprintData:    移动倍率3x
        ├── PlayerRunData / WalkData / IdleData
        ├── PlayerReturnRunData
        └── PlayerCameraRecenteringData: 相机居中角度范围

  └── PlayerComboData
        └── PlayerComboSOData
              ├── lightCombo: ComboContainerData.asset
              ├── heavyCombo: ComboContainerData.asset
              ├── executeCombo: ComboContainerData.asset
              ├── skillCombo: ComboData.asset (Skikk)
              ├── finishSkillCombo: ComboData.asset (FinishiSkill)
              └── switchSkill: ComboData.asset (SwitchSkill)

ComboContainerData.asset:
  comboDates[]: List<ComboData>       按顺序排列的攻击段
  DodgeATKData: ComboData             闪A替换第一段
  BackDodgeATKData: ComboData         后闪A替换第一段

ComboData.asset (每一段):
  动画: _comboName
  伤害: _comboDamage, _attackDistance, _comboOffset
  受击: _hitName[], _parryName[]
  音效: _weaponSound[], _characterVoice[], _universalSound, appAudioPrefab
  打击: _ATKCount, _shakeForceList[], _pauseFrameTime, _pauseFrameTimeList[]
  类型: attackStyle (Skikk/FinishiSkill/SwitchSkill)

1
2

comboIndex  → comboDates[comboIndex] → ComboData → comboName → CrossFade
ATKIndex    → ShakeForceList[ATKIndex-1] / PauseFrameTimeList[ATKIndex-1]

1
2
3
4
5
6
7
8

UIManager.Awake → transform.Find("UIRoot/State Bar") → StateBarUI

BloodPos.LateUpdate → UIManager.stateBarUI.ShowAt(敌人位置)
  → Camera.WorldToScreenPoint → UI 定位 + 距离缩放

CharacterHealthBase.OnUpdatePH → stateBarUI.UpdateBlood(HP/maxHP)
  → GreenBloodBar.fillAmount = percentage
  → Update(): if(Green < Red) Red -= Time.deltaTime * 0.05（红条缓退）

1
2
3
4
5
6
7
8
9

// ActiveImage(List<CharacterNameList>, float time)
// 1人: R_Image 隐藏，只显示 L
// 2人: 双头像显示
// 0人: 直接 return

// MatchImage(CharacterNameList) → 返回 Sprite（Seele/Stick）

// UnActive() → 协程 MoveUI 滑出 → SetActive(false)
// MoveUI(Vector3 src, Vector3 dst, float speed, bool canUnActive)

1
2
3

if   (AnimationAtTag("Movement")) → Move(dir * deltaTime * moveMult)
elif (AnimationAtTag("Dodge"))    → Move(dir * deltaTime * dodgeMult)
// 其他 Tag 不移动

1
2

public static bool AnimationAtTag(this Animator animator, string tagName, int layerIndex = 0)
    => animator.GetCurrentAnimatorStateInfo(layerIndex).IsTag(tagName);

1
2
3

public static readonly int MovementID  = Animator.StringToHash("Movement");
public static readonly int HasInputID  = Animator.StringToHash("HasInput");
public static readonly int TurnBackID  = Animator.StringToHash("TurnBack");

1
2
3
4
5
6
7
8

void CheckStateExit()
{
    if (AnimationAtTag("ATK") || AnimationAtTag("Skill"))
        return;   // 攻击还没播完，不退

    if (PlayerMove != zero) → ChangeState(runningState)
    else                    → ChangeState(idlingState)
}

1
2
3
4

Idle ←→ Walk ←→ Run ←→ Sprint
  ↑                      ↑
  └── Dash退出有方向 ────┘
  └── Dash退出无方向 → Idle

1
2
3

public void PauseVFX()    → 所有粒子 simulationSpeed = 0         ← 顿帧用
public void SetVFXSpeed(f) → 所有粒子 simulationSpeed = f          ← 慢动作用
public void ResetVXF()    → 所有粒子恢复 speedMult                 ← 恢复

1
2
3
4

GetEnemy() == null      → return false
距离 > comboDistance     → return false
角度 > 80°               → return false
全部通过                 → return true