游戏 AI / 系统课时
创建 Blackboard 与行为树资产
创建 Blackboard 与行为树资产
本课在 Unreal Engine 5 中创建一套敌人 AI 的基础资源:用 Blackboard 声明状态键,用 Behavior Tree 组织决策节点,并完成两者绑定。完成后可以在编辑器内检查资源关系,避免把黑板误当成执行逻辑,或把行为树误当成状态仓库。
学习目标
- 创建 Blackboard、Behavior Tree 资产并正确关联。
- 为目标对象、巡逻位置和目标标记选择合适的键类型。
- 区分资产内的键定义、AI 实例的运行时键值和任务执行。
明确 Blackboard 与 Behavior Tree 的分工
Blackboard 是一份键的定义:例如 TargetActor 是对象引用,PatrolLocation 是空间位置,HasTarget 是布尔状态。敌人运行时的具体值由其 Blackboard 组件保存;多个敌人可以引用同一个 Blackboard 资产,却各自拥有不同的目标。
Behavior Tree 则描述执行规则。Sequence 按顺序执行子节点,Selector 按优先级寻找可行分支,Task 执行动作,Decorator 根据条件决定分支是否允许执行。控制器负责启动树,树中的节点再读写运行时黑板状态。

在内容浏览器创建 Blackboard
在内容浏览器或 Content Drawer 中,新建 AI/Enemy 文件夹,将相关资源放在一起,便于后续查找。
- 点击
+ Add,进入Artificial Intelligence,选择Blackboard,命名为BB_Enemy。 - 双击打开
BB_Enemy,在 Keys 区域依次新增三个键。 - 对
TargetActor选择Object类型,并在该键的 Details 中将 Base Class 设为Actor。 - 保存 Blackboard 资产。
| 键名 | 键类型 | 用途 |
|---|---|---|
TargetActor |
Object,基类 Actor | 保存要追踪的目标对象 |
PatrolLocation |
Vector | 保存巡逻目的地的世界坐标 |
HasTarget |
Bool | 表示当前是否已有有效目标 |
这里添加的是键的名称与类型,不是为所有敌人设置同一个目标值。TargetActor 尚未被赋值时不代表系统故障;真正的目标通常由感知逻辑或任务在运行时写入。
TargetActor 和 HasTarget 并不是必须同时存在。前者能保存具体对象,后者适合表达明确的业务状态。对于最小项目,可以只保留 TargetActor,通过对象是否有效判断有无目标。本例同时建立两个键,是为了展示不同类型的职责。
创建并绑定 Behavior Tree
- 在同一文件夹点击
+ Add→Artificial Intelligence→Behavior Tree,命名为BT_Enemy。 - 双击打开
BT_Enemy,选中图中的Root节点。 - 在
Details面板中找到Blackboard Asset,选为BB_Enemy。确认 Blackboard 面板能看到刚建立的三个键。 - 从
Root拉出连接创建Sequence,再在其下添加内置WaitTask,将Wait Time设为1.0秒、Random Deviation设为0,保存资产。
Root 的直接子节点应是 Sequence、Selector 等 Composite,而不是直接连接 Task。这里的 Wait 只用于保证树上有一个有效的叶子动作;创建资产不会让敌人自动执行行为树,启动工作仍由 AI Controller 完成。
在实际项目中,黑板资产应表达 AI 决策需要共享的状态,而不是保存所有角色属性。例如角色的基础生命值通常仍由角色或属性组件管理;黑板可以只保存 IsLowHealth 这类影响行为选择的状态,避免出现两套互相矛盾的数据来源。
核对资源关系
重新打开 BT_Enemy 并选中 Root,逐项检查:
Blackboard Asset指向BB_Enemy,而不是其他同名资源。- Blackboard 面板列出
TargetActor、PatrolLocation和HasTarget。 - 图中存在
Root → Sequence → Wait的有效连接。 - 两个资产均已保存,没有未保存的修改。
此时不需要 NavMesh,因为这个最小动作不涉及寻路。黑板面板显示键名,也不意味着键已经在运行时被赋值。
如果右侧找不到 Blackboard 关联项,先确认选中的是 Root,而非 Sequence 或 Wait;如果键列表没有刷新,保存两个资产并重新选择 Blackboard。不要用同名但不同目录的 Blackboard 替换现有引用,否则后续 Task 可能找不到预期的键。
官方操作入口可参考 Behavior Tree User Guide。完成此处的验收意味着资源结构已建立,不意味着游戏运行时已产生 AI 决策。