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 Aborts | None / Self / Both / Lower Priority |
Self | 条件变化时中止自己 |
Lower Priority | 条件变化时中止低优先级分支 |
Both | 两者都中止 |
最常用的组合:高优先级分支用 Both,这样"发现敌人"能立刻打断巡逻,"失去目标"能立刻退出战斗。
自定义节点
| 类型 | 继承 | 要点 |
|---|---|---|
| Task | UBTTaskNode | ExecuteTask 返回 Succeeded/Failed/InProgress;要有超时 |
| Decorator | UBTDecorator | CalculateRawConditionValue |
| Service | UBTService | TickNode,注意间隔 |
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 | 详细日志 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/37cfb5e6.html
更新于:2026年11月16日