技能介绍

解决什么问题

在 UE5 中，当 NPC 需要根据环境、目标或自身状态切换行为时，把逻辑塞满 AIController 会导致代码难以维护。行为树（Behavior Tree）通过可视化节点描述“优先攻击、否则追击、否则巡逻”的决策流，黑板（Blackboard）则作为 AI 的共享内存保存 TargetActor、LastKnownLocation 等键值。该技能面向 UE 5.4+，帮助工程师从资产对创建到 PIE 调试，建立一套结构清晰的 AI 决策系统。

核心工作流

创建资产对：先定义 BB_ 黑板，声明带类型的键（如 bIsInvestigating）；再创建 BT_ 行为树并引用该黑板。
驱动与运行：AAIController 拥有 Pawn 后调用 RunBehaviorTree(BT)，同时初始化黑板。
组合分支：使用 Selector 实现 OR 优先级回退，Sequence 实现 AND 顺序执行，Simple Parallel 让一个主任务与一个次级任务并行。
装饰器门控：装饰器读取黑板键决定分支是否可执行，配合 Observer Aborts（Self / Lower Priority / Both）在键变化时立即重新评估。
服务更新：Service 周期性 tick，仅在所属分支激活时刷新黑板，例如通过视距检查更新 TargetActor。
任务执行：BTTask 返回 Succeeded、Failed 或 InProgress，MoveTo 等 latent 任务会在稍后完成。
PIE 验证：利用行为树调试器高亮当前节点并查看实时黑板值，确认实际执行路径。

适用边界与避坑

该技能聚焦 UE 行为树的具体实现，不涉及跨引擎 AI 概念选型（如 FSM 与 BT 的取舍）或纯导航数学，路径计算仍依赖引擎 NavMesh。若只是一次性简单逻辑，小型状态机可能比完整树更轻量。

常见问题：AI 不启动通常是 Pawn 未被拥有或未调用 RunBehaviorTree；MoveTo 瞬间失败多因缺少 Nav Mesh Bounds Volume 或目标在导航网格外；分支不响应变化需检查装饰器的 Observer Aborts 是否为 None；自定义任务返回 InProgress 后必须调用 FinishLatentTask，否则会卡住整棵树；黑板键名或类型不匹配（如把 Target 误写为 Taget）会静默失效，建议使用缓存的 FBlackboardKeySelector。此外，Sequence 与 Selector 语义相反，误用会直接反转 AI 行为。