游戏 AI / 系统课时
搭建巡逻追击战斗主树
搭建巡逻追击战斗主树
本节在 Unreal Engine 5 中搭建一棵可观察、可中断的敌人主行为树:平时巡逻,看见玩家后追击,接近后攻击,失去目标时到最后已知位置搜索,再回到警戒与巡逻。重点是让各分支按优先级切换,而不是把任务简单串在一起。
学习目标
- 创建可运行的 AIController、Blackboard 和 Behavior Tree。
- 将攻击、近身等待、追击、搜索、警戒和巡逻组织成可抢占的主树。
- 通过行为树调试器验证任务结果、目标丢失和攻击冷却的回退路径。
先接通控制器、感知和导航
以 UE5 第三人称项目为起点,关卡中放置玩家和敌人。先完成资源与运行前提,再编辑行为树,否则 Move To 失败可能只是缺少导航网格。
- 创建
BP_EnemyCharacter与继承AIController的BP_EnemyAIController。将敌人角色的AI Controller Class指向控制器,并将Auto Possess AI设为Placed in World or Spawned。 - 创建 Blackboard
BB_Enemy:TargetActor(Object,Base Class 为 Actor)、HasLineOfSight、IsInAttackRange、CanAttack、HasLastKnownLocation、IsAlerted(均为 Bool),以及LastKnownLocation、PatrolPoint(Vector)。 - 创建
BT_EnemyCombat,在行为树编辑器中指定BB_Enemy。在BP_EnemyAIController的On Possess事件上调用Run Behavior Tree,传入BT_EnemyCombat。 - 为控制器添加
AIPerception并配置 Sight,在玩家身上添加AIPerceptionStimuliSource并注册 Sight,确认阵营过滤允许检测;Sight 回调更新目标与记忆。由距离更新逻辑维护IsInAttackRange,战斗组件维护CanAttack。 - 在关卡铺设覆盖可行走区域的
NavMeshBoundsVolume。在编辑器按P检查导航覆盖;敌人出生点和巡逻点都应在可达区域。
从左到右排列行为分支
在 Root 下放 Selector,从左到右接六个 Sequence。每个分支的条件用 Blackboard Decorator 表示,任务按表中的顺序执行。BTTask_ 前缀表示本项目要创建的自定义 Blueprint Task,不是引擎内置节点。
| 分支 | 进入条件 | 顺序执行的任务 |
|---|---|---|
| 攻击 | 目标有效、可见、在攻击范围且 CanAttack |
Rotate to Face BB Entry → BTTask_Attack |
| 近身等待 | 目标有效、可见、在攻击范围 | Rotate to Face BB Entry → Wait(0.2 s) |
| 追击 | 目标有效且可见 | Move To(TargetActor)→ Wait(0.2 s) |
| 搜索 | HasLastKnownLocation=true |
Move To(LastKnownLocation)→ Wait(1 s) |
| 警戒 | IsAlerted=true |
Wait(1 s) |
| 巡逻 | 兜底,无 Decorator | BTTask_PickPatrolPoint → Move To(PatrolPoint)→ Wait(1 s) |
追击的 Move To 可先把 Acceptable Radius 设为 200 cm,实际进攻判定仍以距离检查键为准,不要把导航任务成功直接等同于能够攻击。BTTask_PickPatrolPoint 可调用蓝图导航节点 Get Random Reachable Point in Radius,以敌人位置为圆心、700 cm 为半径;成功时写入 PatrolPoint 并 Finish Execute(true),失败则 Finish Execute(false)。

配置中断与任务完成时机
在攻击、近身等待、追击、搜索和警戒的 Blackboard Decorator 上配置 Observer Aborts。目标有效性、可见性、距离和记忆有效性等变化需要立即退出当前分支并允许更高优先级抢占时,使用 Both;各条件均成立后才能进入对应 Sequence。
有一个关键例外:攻击分支上的 CanAttack Decorator 只设 Lower Priority。开始攻击后战斗组件通常马上把 CanAttack 设为 false;如果这里选 Both,正在播放的攻击任务会被自己的冷却变化中断。其余条件仍可按设计中断攻击,例如玩家离开攻击范围。各选项的含义可对照 Epic 官方 Decorator 节点参考。
BTTask_Attack 继承 BTTask_BlueprintBase:在 Receive Execute AI 中检查战斗组件、启动一次攻击;若攻击由蒙太奇异步完成,应在完成回调中调用 Finish Execute(true),无法出招则返回失败。实现 Receive Abort AI 时应取消尚未完成的攻击回调并按实际取消策略处理动画,最后调用 Finish Abort,避免失效回调再次结束任务。
搜索与警戒的退出不应依赖 Wait 自行清空黑板。由控制器在丢失目标时启动记忆过期计时(例如 5 秒),到期清除 HasLastKnownLocation,再过约 2 秒清除 IsAlerted;重新看见玩家时取消旧计时。若搜索点不可导航,及时清掉无效记忆,避免 Move To 失败后反复选择同一位置。
启动主树并完成验收
片段示例:使用 C++ 控制器时,可用下面的方法替代蓝图 On Possess → Run Behavior Tree。它依赖已声明的 AEnemyAIController、OnPossess 覆写,以及头文件中可在类默认值指定的 UPROPERTY(EditDefaultsOnly) 类型为 TObjectPtr<UBehaviorTree> 的 BehaviorTreeAsset;模块需要 AIModule。
#include "EnemyAIController.h"
#include "BehaviorTree/BehaviorTree.h"
void AEnemyAIController::OnPossess(APawn* InPawn)
{
Super::OnPossess(InPawn);
// 只在占有 Pawn 且资源已指定后启动,便于区分启动失败和任务失败。
const bool bStarted =
BehaviorTreeAsset && RunBehaviorTree(BehaviorTreeAsset);
UE_LOG(LogTemp, Log, TEXT("BehaviorTree started: %s"),
bStarted ? TEXT("true") : TEXT("false"));
}预期输出(配置正确、AI 已占有敌人时,日志前缀可能带有实际时间):
LogTemp: BehaviorTree started: true运行 PIE,在 Behavior Tree 编辑器中选择正在运行的敌人实例,对照活动分支与 Blackboard 键验证以下路径:
- 未见玩家时,巡逻 Task 选出可达点并执行
Move To。 - 玩家进入视野,追击抢占巡逻;贴近后进入攻击;冷却期间停留在近身等待,而不是高频重新寻路。
- 玩家离开攻击范围,攻击分支退出并回到追击;在 200~250 cm 的滞回带内不应来回震荡。
- 玩家躲到墙后,实时目标清空但记忆位置保留;搜索到点后记忆过期,接着警戒并恢复巡逻。
- 搜索或巡逻过程中玩家再次出现,更高优先级分支应立即抢占;若不切换,先检查相应键值及
Observer Aborts,若不移动则先检查 NavMesh、目标位置和任务返回状态。
通过这组验收后,战斗动作、导航和感知已经由同一棵主树协调。后续增加远程攻击或掩体时,优先新增独立的高优先级分支,而不是在巡逻 Task 中叠加战斗条件。