BehaviorTree

自动关联目录:BehaviorTree

官方依据:Behavior Trees(UE 5.8 Documentation)。已核实的官方表述:行为树资产用于执行包含逻辑的分支,它依赖 Blackboard 作为"大脑" 来决定执行哪些分支;黑板包含用户定义的 Key,保存决策所需信息(官方示例:布尔键 Is Light On 变化时走不同分支)。

行为树把 AI 决策表达成一棵可复用、可可视化调试的树。它比状态机更好扩展,因为分支可以任意复用,而状态迁移不会变成网状。

四类节点

节点作用返回值
Composite控制流(Selector / Sequence / Simple Parallel)—
Decorator条件判断,挂在其它节点上bool
Service周期性执行的辅助逻辑(不返回)—
Task行为叶子节点,真正做事Success / Failed / InProgress

控制流

节点语义
Selector从左到右,谁成功就用谁("或")
Sequence从左到右,全成功才成功("且")
Simple Parallel主任务 + 背景任务并行

Selector 的优先级就是树的顺序——越靠左优先级越高。这是行为树调优最直接的方式:想让 AI 更倾向于逃跑,就把逃跑分支往前挪。

黑板(Blackboard)

黑板是行为树与代码之间的唯一数据契约。

要点说明
键的类型Object / Vector / Float / Int / Bool / String / Class / Enum
谁写Service、Task、感知组件、C++ 代码
谁读Decorator 条件、Task 参数
同步BlackboardKey 直接引用,改键名要同步所有引用

实践建议:键要少而稳定。AI 的"记忆"应尽量压缩成几个关键值(目标、移动点、状态枚举)而不是把整个感知结果塞进去。

执行流程

Root
└── Selector
    ├── Sequence(战斗)
    │   ├── Decorator: 黑板 HasTarget == true
    │   ├── Task: 移动到攻击距离
    │   └── Task: 攻击
    ├── Sequence(搜索)
    │   ├── Service: 每 1 秒感知一次
    │   └── Task: 去最后已知位置
    └── Task: 巡逻(兜底)

从左到右求值,失败则回退到上一层重新求值——这意味着高优先级分支的条件一旦满足,会立刻打断当前行为。

打断与中止

设置说明
Observer AbortsNone / Self / Both / Lower Priority
Self条件变化时中止自己
Lower Priority条件变化时中止低优先级分支
Both两者都中止

最常用的组合:高优先级分支用 Both,这样"发现敌人"能立刻打断巡逻,"失去目标"能立刻退出战斗。

自定义节点

类型继承要点
TaskUBTTaskNodeExecuteTask 返回 Succeeded/Failed/InProgress;要有超时
DecoratorUBTDecoratorCalculateRawConditionValue
ServiceUBTServiceTickNode,注意间隔

Task 必须实现 OnTaskFinished/超时逻辑,否则 AI 会卡在某个 Task 上永远不动。

性能

开销优化
每帧重新求值整棵树用 Service 降频、减少装饰节点
TickNode 里做重计算缓存结果,只在需要时更新
大量 AI 同时跑分帧、按 Significance 降频

代价与权衡

设计收益代价什么时候不该用
行为树分支可复用、可视化调试树变复杂后难维护;每帧重新求值状态驱动型逻辑更该用 StateTree(见 StateTree 与 Mass)
Selector 顺序即优先级调优直观顺序误改会整体行为变化顺序应有注释或命名约定
Observer Aborts = Both反应最快条件抖动会频繁打断抖动的条件要加迟滞
Service 降频省 CPU感知与更新有延迟需要即时反应的分支不该降太多
黑板作为唯一契约解耦键名是隐式耦合,改名易漏键要少而稳定

常见坑

坑说明
Task 返回 InProgress 但没结束路径AI 永久卡住
Decorator 没设 Observer Aborts条件变了也不切换
黑板键改名不同步引用失效,静默出错
所有逻辑塞进一个 Task失去行为树的意义
忘记兜底分支所有条件都不满足时 AI 呆立
Both 中止配上抖动条件AI 在两个分支间反复横跳
Service 间隔太短白付 CPU
Task 里做耗时计算阻塞行为树 tick

排查顺序

1. AI 呆立?→ 是否所有分支都不满足(缺兜底);某个 Task 卡在 InProgress
2. 行为不对?→ Gameplay Debugger 看活跃分支 + 黑板键值
3. 不切换?→ Decorator 的 Observer Aborts 是否设置
4. 反复横跳?→ 条件是否抖动,加迟滞
5. 慢?→ Service 间隔、装饰器数量、Task 里的计算

调试

手段用途
Gameplay Debugger → BehaviorTree 页签看活跃分支与黑板键值(见 AI 调试与性能)
Visual Logger回放行为树执行
Log LogBehaviorTree Verbose详细日志