游戏 AI / 系统课时
攻击节点怎样等待动画事件
攻击节点怎样等待动画事件
攻击动作通常跨越多个游戏帧:节点先触发攻击动画,随后等待命中帧,再等待动画结束或取消。正确实现的关键是让行为树节点保持 RUNNING,并由动画事件推动节点进入成功或失败,而不是按固定时间猜测攻击何时完成。
学习目标
- 把攻击动画的命中、结束和取消事件映射到节点生命周期
- 避免节点在动画刚播放时就提前返回成功
- 处理重复命中事件、取消和迟到回调等边界情况
攻击节点本质上是一个事件驱动的小状态机
攻击开始后至少有三个异步事件需要区分:命中事件表示“现在结算伤害”,结束事件表示“本次攻击完整结束”,取消事件表示“本次动作没有正常完成”。其中命中并不意味着节点可以返回 Success,因为后摇阶段可能仍然影响角色是否能切换到其他行为。

这种设计把“伤害何时发生”和“节点何时结束”拆开,能适配带前摇、命中帧、后摇、连击窗口的攻击动画。
用事件更新节点状态
下面用自定义动画驱动接口实现一个完整示例。动画系统只负责发出事件,攻击节点保存本次动作状态;Tick 本身不阻塞。
using System;
enum NodeStatus { Running, Success, Failure }
interface IAttackAnimation
{
event Action? Hit;
event Action? Finished;
event Action? Cancelled;
void PlayAttack(string clipName);
void CancelAttack();
}
sealed class AttackNode
{
private readonly IAttackAnimation animation;
private bool started;
private bool damageCommitted;
private NodeStatus? terminal;
public AttackNode(IAttackAnimation animation)
{
this.animation = animation;
animation.Hit += OnHit;
animation.Finished += OnFinished;
animation.Cancelled += OnCancelled;
}
public NodeStatus Tick()
{
if (terminal.HasValue)
{
NodeStatus result = terminal.Value;
ResetLocalState();
return result;
}
if (!started)
{
started = true;
animation.PlayAttack("light_attack");
}
return NodeStatus.Running;
}
public void Abort()
{
if (!started || terminal.HasValue)
return;
animation.CancelAttack();
terminal ??= NodeStatus.Failure;
}
private void OnHit()
{
if (!started || terminal.HasValue || damageCommitted)
return;
damageCommitted = true;
Console.WriteLine("DAMAGE COMMITTED");
}
private void OnFinished()
{
if (started && !terminal.HasValue)
{
Console.WriteLine("ANIM FINISHED");
terminal = NodeStatus.Success;
}
}
private void OnCancelled()
{
if (started && !terminal.HasValue)
terminal = NodeStatus.Failure;
}
private void ResetLocalState()
{
started = false;
damageCommitted = false;
terminal = null;
}
}
sealed class FakeAttackAnimation : IAttackAnimation
{
public event Action? Hit;
public event Action? Finished;
public event Action? Cancelled;
public void PlayAttack(string clipName) =>
Console.WriteLine($"ANIM PLAY {clipName}");
public void CancelAttack()
{
Console.WriteLine("ANIM CANCEL");
Cancelled?.Invoke();
}
public void RaiseHit() => Hit?.Invoke();
public void RaiseFinished() => Finished?.Invoke();
}
class Program
{
static void Main()
{
var animation = new FakeAttackAnimation();
var node = new AttackNode(animation);
Console.WriteLine($"tick1={node.Tick()}");
animation.RaiseHit();
Console.WriteLine($"tick2={node.Tick()}");
animation.RaiseFinished();
Console.WriteLine($"tick3={node.Tick()}");
}
}预期输出:
ANIM PLAY light_attack
tick1=Running
DAMAGE COMMITTED
tick2=Running
ANIM FINISHED
tick3=Success可以看到,命中事件只负责一次伤害结算,节点仍继续返回 Running;只有结束事件到来后,下一次 Tick 才返回 Success。
取消和迟到事件必须可控
当更高优先级行为打断攻击、角色死亡或状态机切到受击状态时,应调用 Abort。动画驱动收到取消后可以停止动画并触发 Cancelled,节点最终收敛到 Failure。父节点据此决定后续分支。
实际项目还应给每次攻击分配 attackInstanceId。动画事件、伤害结算和网络确认都携带这个 ID,只处理当前实例的事件。这样旧动画的迟到 Finished 不会把已经开始的新攻击错误标记为完成。
命中事件要做幂等保护
同一个命中通知可能因为动画层重复派发、状态切换或网络重放而出现多次。示例里的 damageCommitted 就是最小保护:一次攻击实例只允许提交一次伤害。多段攻击则应把保护粒度改成“攻击实例 + 命中段编号”,而不是简单布尔值。
攻击节点的稳定边界是:首次 Tick 只启动动画,等待期间持续 Running,命中事件负责业务结算,结束事件负责 Success,取消事件负责 Failure。这样动画节奏可以自由变化,而行为树仍然只关心明确的节点状态。