游戏 AI / 系统课时
Decorator 如何拦截子节点
Decorator 如何拦截子节点
行为树里的 Decorator 包裹一个子节点,在子节点真正执行前增加一层判断或状态处理。最常见的用途是控制进入资格:没有目标时直接返回失败,有目标时才允许攻击节点收到 Tick。本课从一次 Tick 的传播过程理解这种拦截机制。
学习目标
- 理解 Decorator、条件判断和子节点之间的执行顺序
- 实现一个能够阻止不满足条件的子节点执行的 Decorator
- 区分进入条件检查与运行中打断两种行为
Decorator 是子节点前面的一层执行边界
行为树中的 Decorator 与面向对象设计模式里的 Decorator 名称相同,但这里关注的是树节点执行语义。它通常只有一个直接子节点,并在父节点访问这个分支时先执行自己的逻辑。
以“有目标才能攻击”为例,结构可以理解为:父节点 Tick HasTarget Decorator,Decorator 先读取黑板中的目标;条件不满足时直接向父节点返回 FAILURE,攻击节点完全不会执行;条件满足时才把 Tick 继续传给 Attack Action。

这种结构的关键不是“多执行一个条件节点”,而是条件拥有对子节点执行权的控制。如果条件失败,子节点连一次 Tick 都不应该收到,因此子节点内部也不会产生攻击动画、移动请求或冷却修改等副作用。
最小实现先判断再调用子节点
下面实现一个简单的条件 Decorator。ConditionDecorator.Tick 先运行谓词;只有谓词为真时才调用被包裹的 child.Tick。为了验证攻击节点是否真的被拦截,AttackAction 在执行时会打印一行日志。
using System;
public enum NodeStatus
{
Success,
Failure,
Running
}
public sealed class AiContext
{
public bool HasTarget { get; set; }
}
public interface INode
{
NodeStatus Tick(AiContext context);
}
public sealed class AttackAction : INode
{
public NodeStatus Tick(AiContext context)
{
Console.WriteLine("AttackAction executed");
return NodeStatus.Success;
}
}
public sealed class ConditionDecorator : INode
{
private readonly Func<AiContext, bool> condition;
private readonly INode child;
public ConditionDecorator(Func<AiContext, bool> condition, INode child)
{
this.condition = condition;
this.child = child;
}
public NodeStatus Tick(AiContext context)
{
// 条件失败时立即结束,子节点不会收到 Tick。
if (!condition(context))
return NodeStatus.Failure;
// 条件通过后,Decorator把子节点的状态继续向上传播。
return child.Tick(context);
}
}
public static class Program
{
public static void Main()
{
var context = new AiContext();
INode node = new ConditionDecorator(
ctx => ctx.HasTarget,
new AttackAction());
context.HasTarget = false;
Console.WriteLine($"no target: {node.Tick(context)}");
context.HasTarget = true;
Console.WriteLine($"has target: {node.Tick(context)}");
}
}预期输出:
no target: Failure
AttackAction executed
has target: Success第一轮没有出现 AttackAction executed,说明 Decorator 已在子节点之前完成拦截。第二轮条件成立,攻击节点才真正执行,并且它返回的 Success 被 Decorator 继续传给上层节点。
子节点状态通常继续向上传播
最简单的条件 Decorator 只改变“能不能进入”,不改变子节点成功、失败或运行中的含义。当条件通过后,如果子节点返回 RUNNING,Decorator 通常也返回 RUNNING;子节点返回 FAILURE,Decorator 也可以原样返回 FAILURE。
某些 Decorator 会主动改变结果,例如把 SUCCESS 与 FAILURE 反转,或者无论子节点结果如何都固定返回成功。这些属于另一类状态变换语义,不应和进入资格控制混在一个节点里,否则读树的人很难判断失败究竟来自条件还是子节点本身。
运行中条件变化不等于自动打断
一个容易忽略的边界是:进入时检查条件和运行中持续打断不是同一件事。假设 Chase Action 已经返回 RUNNING,下一帧目标突然死亡。如果行为树每帧都会重新从 Decorator 开始 Tick,那么条件再次检查后可以阻止 Chase 继续运行;如果框架会记住当前运行节点并直接恢复它,则还需要显式的条件重评估或 Abort 机制。
因此设计 Decorator 时应明确两个问题:条件多久检查一次,以及条件从真变假后是否需要终止正在运行的子节点。只要求“有目标才允许第一次进入攻击”时,简单前置检查已经足够;要求“目标一失效就立即停止攻击”时,还必须配合框架提供的重新评估、取消或中止能力。
Decorator 最适合承载单一、可读的进入规则,例如 HasTarget、IsInRange 或 CooldownReady。让它只负责是否放行子节点,再由子节点负责真正的行为,可以让整棵行为树的条件与动作边界保持清晰。