游戏 AI / 系统课时

Decorator 如何拦截子节点

Decorator 如何拦截子节点

行为树里的 Decorator 包裹一个子节点,在子节点真正执行前增加一层判断或状态处理。最常见的用途是控制进入资格:没有目标时直接返回失败,有目标时才允许攻击节点收到 Tick。本课从一次 Tick 的传播过程理解这种拦截机制。

学习目标

  • 理解 Decorator、条件判断和子节点之间的执行顺序
  • 实现一个能够阻止不满足条件的子节点执行的 Decorator
  • 区分进入条件检查与运行中打断两种行为

Decorator 是子节点前面的一层执行边界

行为树中的 Decorator 与面向对象设计模式里的 Decorator 名称相同,但这里关注的是树节点执行语义。它通常只有一个直接子节点,并在父节点访问这个分支时先执行自己的逻辑。

以“有目标才能攻击”为例,结构可以理解为:父节点 Tick HasTarget Decorator,Decorator 先读取黑板中的目标;条件不满足时直接向父节点返回 FAILURE,攻击节点完全不会执行;条件满足时才把 Tick 继续传给 Attack Action。

Decorator 在条件检查前后拦截子节点 Tick 的执行流程

这种结构的关键不是“多执行一个条件节点”,而是条件拥有对子节点执行权的控制。如果条件失败,子节点连一次 Tick 都不应该收到,因此子节点内部也不会产生攻击动画、移动请求或冷却修改等副作用。

最小实现先判断再调用子节点

下面实现一个简单的条件 Decorator。ConditionDecorator.Tick 先运行谓词;只有谓词为真时才调用被包裹的 child.Tick。为了验证攻击节点是否真的被拦截,AttackAction 在执行时会打印一行日志。

csharp
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)}");
    }
}

预期输出:

text
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。让它只负责是否放行子节点,再由子节点负责真正的行为,可以让整棵行为树的条件与动作边界保持清晰。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

Decorator 如何拦截子节点

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通