游戏 AI / 系统课时
用 Move To 驱动追踪
用 Move To 驱动追踪
本课把敌人感知到的玩家写入 Blackboard,再交给行为树的 Move To 沿 NavMesh 追踪。完成后,敌人能够绕开静态障碍接近目标,并在目标无效或路径不可用时退出追踪,而不是原地反复触发移动命令。
学习目标
- 分清目标 Actor、Blackboard 键与 Move To 的职责。
- 配好导航范围、移动节点和到达判定。
- 写入目标引用,并验证成功、失败及回退行为。
让敌人具备导航条件
在 UE5 中准备一个由 AIController 控制的 Character 敌人,确认其具有可工作的 CharacterMovement。在关卡内放入 Nav Mesh Bounds Volume 并覆盖敌人与玩家之间的可行走地面;按 P 查看绿色导航区域。只有地面被 NavMesh 覆盖,并且当前导航代理能够通过时,Move To 才有可用路径。
在 Blackboard 资产 BB_Enemy 中新建 TargetActor,类型选 Object,Base Class 设为 Actor。与此不同,PatrolPoint 或 LastKnownLocation 使用 Vector:前者保存一个会移动的对象引用,后者只保存某一时刻的位置快照。
还需确认敌人的 AI Controller Class 指向实际控制器,Auto Possess AI 覆盖当前放置或生成方式。否则即使导航区域正常,行为树也可能没有启动。
把追踪分支连接到 Move To
在使用 BB_Enemy 的行为树 BT_Enemy 中,将高优先级追踪分支放在 Selector 左侧:
- 创建
Chase Sequence,并添加BlackboardDecorator。 - 将 Decorator 的 Key 设置为
TargetActor,条件设为Is Set,Observer Aborts设为Self。 - 在 Sequence 下添加
Move To,将 Blackboard Key 设置为TargetActor。 - 在 Selector 右侧保留具有合法位置目标的巡逻分支,或使用
Wait作为安全兜底。
在 Move To 的 Details 中先采用以下测试参数。UE 默认长度单位为厘米。
| 属性 | 建议起点 | 作用 |
|---|---|---|
| Blackboard Key | TargetActor |
读取 Actor 引用作为移动目标 |
| Acceptable Radius | 120 |
靠近到允许范围后判定到达 |
| Track Moving Goal | 开启 | 目标 Actor 移动时可更新跟随路径 |
| Observe Blackboard Value | 开启 | 目标键变化时重定向移动 |
| Allow Partial Path | 关闭 | 避免依赖无法抵达目标的不完整路径 |
Reach Test Includes Agent Radius 和 Reach Test Includes Goal Radius 会影响实际到达距离。如果开启,相关碰撞体半径也参与到达测试。因此,不要把 Acceptable Radius 直接理解为两个角色中心之间的精确距离,更不要未经验证就将它等同于攻击距离。

这里的职责边界很重要:Blackboard 只保存目标,Behavior Tree 决定何时执行追踪,Move To 提交导航请求,实际移动由导航路径跟随与角色移动组件完成。Move To 返回成功表示满足其到达判定,并不自动证明玩家处于武器的有效攻击范围。
让控制器写入追踪目标
下面给出可集成到 UE5 C++ 项目的最小控制器。项目模块的 Build.cs 需要包含 AIModule 依赖。将类文件放入项目源码并编译,然后为敌人选择该控制器,在控制器蓝图的默认属性中将 TreeAsset 指向 BT_Enemy。
ChaseAIController.h:
#pragma once
#include "CoreMinimal.h"
#include "AIController.h"
#include "ChaseAIController.generated.h"
class UBehaviorTree;
UCLASS()
class AChaseAIController : public AAIController
{
GENERATED_BODY()
public:
UPROPERTY(EditDefaultsOnly, Category="AI")
TObjectPtr<UBehaviorTree> TreeAsset;
UFUNCTION(BlueprintCallable, Category="AI")
void SetChaseTarget(AActor* Target);
protected:
virtual void OnPossess(APawn* InPawn) override;
};ChaseAIController.cpp:
#include "ChaseAIController.h"
#include "BehaviorTree/BehaviorTree.h"
#include "BehaviorTree/BlackboardComponent.h"
void AChaseAIController::OnPossess(APawn* InPawn)
{
Super::OnPossess(InPawn);
// 占有 Pawn 后启动行为树并初始化关联黑板
if (TreeAsset)
RunBehaviorTree(TreeAsset);
}
void AChaseAIController::SetChaseTarget(AActor* Target)
{
UBlackboardComponent* BB = GetBlackboardComponent();
if (!BB) return;
// 目标失效时清除引用,让 Decorator 退出追踪
if (IsValid(Target))
BB->SetValueAsObject(TEXT("TargetActor"), Target);
else
BB->ClearValue(TEXT("TargetActor"));
}预期结果:敌人被控制器占有后运行 BT_Enemy;感知逻辑调用 SetChaseTarget 并传入有效玩家 Actor 时,Blackboard 中的 TargetActor 更新,追踪分支开始移动。传入空引用后,追踪条件失效,执行中的追踪可以被中止。
实际项目中,可以从 AI Perception 的感知回调调用 SetChaseTarget。只有确认目标可追踪时才写入有效 Actor;玩家销毁、死亡或明确放弃追踪时清空引用。短暂丢失视线是否立即清空,应由感知记忆和追踪规则决定,而非由 Move To 自行猜测。
在关卡里逐项验收
- 播放关卡,让玩家位于绿色 NavMesh 上并被敌人发现。预期行为树调试器显示追踪分支运行,敌人绕过障碍,满足到达条件后 Move To 返回成功。
- 把玩家移到不可达区域,并保持
Allow Partial Path关闭。预期 Move To 无法正常到达目标,可能返回失败;应结合路径和节点状态判断具体原因。 - 清空
TargetActor。预期Is Set条件失效,追踪分支被中断,随后进入可执行的巡逻或等待分支。 - 将玩家移回可达区域,再写入有效 Actor。预期追踪能够重新启动,而不是停留在先前失败的移动任务中。
如果敌人完全不移动,按 Possess 是否成功、TreeAsset 是否赋值、Blackboard 键类型是否正确、NavMesh 是否覆盖路径的顺序检查。若敌人停在目标附近,优先核对 Acceptable Radius 与两项半径参与设置;若绕墙失败,则重点检查导航连续性和障碍碰撞。
Move To 是由行为树管理的持续移动任务,不应在 Tick 中反复手动调用另一个 AI MoveTo 与之争夺移动控制。节点属性的定义可参阅 Unreal Engine 官方 Move To 文档。