用途:在虚幻引擎5中编写敌人与NPC的决策逻辑。以黑板(BB_)保存类型化键值作为AI记忆,例如TargetActor、LastKnownLocation、bIsInvestigating;行为树(BT_)引用该黑板,由AAIController占有Pawn后调用RunBehaviorTree(BT)运行并初始化黑板。
主要能力:用复合节点组织树——Selector从左到右执行至某个子节点成功(优先级回退),Sequence执行至某个子节点失败(顺序执行),Simple Parallel同时运行主任务与次要任务。用Decorator读取黑板键作为条件来限制分支,并设置Observer Aborts使键变化时重新求值。用附在分支上的Service按周期刷新黑板,仅在该分支激活时执行。具体工作由Task完成,返回Succeeded、Failed或InProgress,像MoveTo这类潜伏任务稍后完成。可在PIE中用行为树调试器查看运行节点与实时黑板值。
使用方式:创建BB_与BT_资产对;在AIController的OnPossess中调用RunBehaviorTree(BehaviorTree);代码里通过GetBlackboardComponent()->SetValueAsObject(TEXT("TargetActor"), Target)更新键,清空用ClearValue,键名与类型必须与黑板资产一致;也可用缓存的FBlackboardKeySelector。自定义C++ UBTTaskNode的细节见references/custom-bttask.md。
适用场景:项目已有BT_/BB_资产与AAIController,需要制作敌人/NPC AI时。
限制与注意事项:纯导航与寻路属于引擎NavMesh,MoveTo依赖它;简单一次性逻辑用小状态机可能更省成本。UE 5.8同时提供Behavior Trees与StateTree,行为树未被弃用;若项目已用StateTree或AI本身是带明确转换的模式集合,添加行为树前应先与用户确认。常见问题:AI不启动多因Pawn未被占有或未调用RunBehaviorTree;MoveTo立即失败常因关卡无NavMesh或目标不在导航网格上;分支不响应变化多因装饰器的Observer Aborts为None;任务挂起多因自定义任务返回InProgress却未调用FinishLatentTask;键名拼写错误会静默失效;Sequence与Selector语义相反(AND与OR),互换会颠倒行为。主要文档见Behavior Trees in Unreal Engine。