fix(enemy): 无受击/僵直动画时不再永久卡死

EnemyHurtState 与 EnemyStaggerState 的 Enter 在对应 Clip 为空时守卫式早退,
**同时丢掉了恢复安排**:_currentState 永远停在该态,IsControllable 恒假,
AiRuntime 的让位门永久挡住条件边求值——敌人被打一次即永久失能。
美术未接入时这影响的是大部分敌人。

TakeDamage 是分发点:霸体被破进 Stagger、否则进 Hurt,两条都可达,
所以这是两个活 bug 而非一个。EnemyKnockUpState 本就有 else 分支走
ScheduleStateRecovery,是正确范式;本次把该分支补给另外两个,并加一条
KnockUp 回归测试守住它。

时长权威没有新造:
- Hurt 接上 DamageSourceSO.HitStunDuration——该字段一路铺到 DamageInfo
  却零消费者,本就是「这一击让对方僵多久」的既有权威;经 PendingHitStun
  传给状态,形状与既有的 PendingLaunchDir 一致。
- Stagger 用 HitTierConfig.staggerDuration——该结构 tooltip 本就写着
  「Stagger / KnockUp 参数」却只有 KnockUp 的字段,属补齐而非发明。

顺带修 ScheduleStateRecovery 不取消前一次安排的问题:两个重叠安排里较短的
会先把状态改回 Controlled,静默缩短调用方想要的时长(ReceiveParry 接线后
就会撞上)。并在 OnSpawn 清掉跨池化周期残留的协程句柄。

注:Knockback 目前零调用者,其中的 PendingHitStun 赋值今天是死代码,
但它是 public virtual 且会进 Hurt 态,不设则将来接线时会用到陈旧时长。

验证:编译 0 错;EditMode 263/263(260 + 新增 3)。
变异验证——移除两个 else 分支后恰好 Hurt/Stagger 两条测试变红、
KnockUp 回归测试保持绿,恢复后复验 263/263。
This commit is contained in:
2026-07-31 09:40:47 +08:00
parent 691b19fd11
commit 9120964be0
6 changed files with 190 additions and 21 deletions
+31 -5
View File
@@ -179,6 +179,8 @@ namespace BaseGames.Enemies
}
else
{
// 存储硬直时长供 EnemyHurtState 在无受击动画时使用
_pendingHitStun = info.HitStunDuration;
nextState = EnemyStateType.Hurt;
reason = InterruptReason.Hurt;
}
@@ -200,17 +202,37 @@ namespace BaseGames.Enemies
private Vector2 _pendingLaunchDir;
/// <summary>
/// 协程兜底:在无对应 Animancer 动画时按时长自动恢复到 Controlled 状态。
/// 仅在 AnimConfig 对应 Clip 为 null 时由状态类调用
/// 本次受击的硬直时长(由 TakeDamage / Knockback 从 <see cref="DamageInfo.HitStunDuration"/> 写入,
/// 供 <see cref="States.EnemyHurtState"/> 在无受击动画时作为恢复时长)
/// 权威在攻击方:同一敌人挨重击比挨轻击僵得久。有受击动画时以动画长度为准。
/// </summary>
public void ScheduleStateRecovery(EnemyStateType fromState, float delay)
internal float PendingHitStun => _pendingHitStun;
private float _pendingHitStun;
/// <summary>
/// 在无对应 Animancer 动画时按时长自动恢复到 Controlled 状态。
/// 由受击类状态(Hurt / Stagger / KnockUp)在其 Clip 为 null 时调用——
/// 缺了它,敌人会永久停在该态,<c>IsControllable</c> 恒假、决策层永久停摆。
///
/// 同一时刻只保留一个待恢复安排:后一次调用取消前一次。
/// 否则两次重叠安排里较短的那个会先把状态改回 Controlled,
/// 静默缩短调用方本想要的时长(如弹反惩罚窗口)。
///
/// virtual:供 EditMode 测试替换掉协程,直接断言"是否安排了恢复"。
/// </summary>
public virtual void ScheduleStateRecovery(EnemyStateType fromState, float delay)
{
StartCoroutine(StateRecoveryRoutine(fromState, delay));
if (_stateRecovery != null) StopCoroutine(_stateRecovery);
_stateRecovery = StartCoroutine(StateRecoveryRoutine(fromState, delay));
}
private Coroutine _stateRecovery;
private System.Collections.IEnumerator StateRecoveryRoutine(EnemyStateType fromState, float delay)
{
yield return new WaitForSeconds(delay);
if (delay > 0f) yield return new WaitForSeconds(delay);
else yield return null; // 时长为 0 = 不硬直,下一帧即恢复
_stateRecovery = null;
if (_currentState == fromState)
ForceState(EnemyStateType.Controlled);
}
@@ -385,6 +407,7 @@ namespace BaseGames.Enemies
if (info.Flags.HasFlag(DamageFlags.NoKnockback)) return;
_movement?.ApplyKnockback(info.KnockbackDirection, info.KnockbackForce);
// 统一路径:击退必须经过状态机,确保能力被中断且动画一致。
_pendingHitStun = info.HitStunDuration; // 无受击动画时的恢复时长
ForceState(EnemyStateType.Hurt);
_abilities.InterruptAll(InterruptReason.Hurt);
}
@@ -727,6 +750,9 @@ namespace BaseGames.Enemies
// 重置状态(对象池复用:跳过 Dead 终态守卫,强制恢复到 Controlled)
ForceStateRespawn(EnemyStateType.Controlled);
IsEngaged = false;
// 上一条命若在受击恢复途中被回收,协程已随物体停用而终止,
// 这里清掉句柄,避免跨池化周期持有一个已死的 Coroutine 引用
_stateRecovery = null;
// 重置对象池复用相关的运行时感知数据
// 注意:_playerTransform 不重置(场景中玩家仍存在),只重置追踪历史