游戏 AI / 系统课时
整理资产与复用接口
整理资产与复用接口
近战和远程敌人如果各复制一套 Controller、Blackboard 与 Task,后续修复追击或感知逻辑时很容易漏改。本课将公共决策契约、共享节点和敌种专属分支拆开,再检查资产引用与运行时数据是否保持独立。
学习目标
- 按 Controller、Blackboard、Behavior Tree、Task、Service 的职责整理 UE5 资产。
- 设计可复用的 Blackboard 键及节点输入接口。
- 验证两种敌人能复用资产,但不会共享同一份运行时状态。
按职责组织资产
把可复用类放在 /Game/AI/Common/:Controllers/BP_EnemyAIController 负责占有 Pawn 和启动行为树;Blackboards/BB_EnemyCore 定义公共决策键;Tasks/BTT_SetMoveSpeed 执行一次性的速度设置;Services/BTS_UpdateCombatDistance 以适当间隔刷新距离信息。
把敌种差异放在 /Game/AI/Types/Melee/BT_Melee 和 /Game/AI/Types/Ranged/BT_Ranged。两棵树都可使用共享 Task 与 Service,但近战攻击和远程选位分别保留独立分支。可以在敌人基类中定义 BehaviorTreeAsset 变量,由 BP_EnemyMelee、BP_EnemyRanged 分别指定自己的行为树;共享 Controller 在 OnPossess 中读取该配置并调用 Run Behavior Tree,不必复制控制器逻辑。

固定 Blackboard 键契约
两棵行为树先统一键名、类型与写入者,再谈节点复用。以下是一套可直接在 BB_EnemyCore 中建立的最小约定:
| Key | 类型 | 唯一主要写入方 |
|---|---|---|
TargetActor |
Object,Base Class 为 Actor | 感知事件 |
CanSeeTarget |
Bool | 感知事件 |
LastKnownLocation |
Vector | 感知事件 |
HasLastKnownLocation |
Bool | 搜索状态管理逻辑 |
IsDead |
Bool | 生命值组件或死亡处理 |
DistanceToTarget |
Float | 距离更新 Service |
例如失去视野时,可把 CanSeeTarget 置为 false、清除 TargetActor,同时保留 LastKnownLocation 并设置 HasLastKnownLocation=true,以便搜索分支读取。不要用 Vector 是否等于世界原点判断是否有记录,原点本身也可能是合法位置。
BB_EnemyCore 是键定义,不是所有敌人的共享内存;每个 AI 的 BlackboardComponent 仍保存自己的值。特殊敌种需要额外键时,可新建 Blackboard 并在 Details 中将 Parent 指向公共 Blackboard,避免修改已有键的名称或类型。
用接口隔离敌种差异
共享 Task 只接收所需输入并返回明确结果:例如 BTT_SetMoveSpeed 从受控 Pawn 读取该敌种的配置速度,成功设置后调用 Finish Execute(true);没有有效 Pawn 或移动组件则返回失败。不要在 Task 类默认变量中保存某只敌人的可变目标或计时状态。
Service 负责低频、可容忍延迟的派生信息,如距离;视觉获得和丢失应由感知事件写入,而不是让每个 Service Tick 反复查询并覆盖。Task 与 Service 中的 Blackboard Key Selector 应在树节点上指定对应键,避免把键名散落硬编码在多个蓝图里。
若两种敌人共享巡逻与追击主干、只替换攻击子树,可使用 Run Behavior 引用固定子树;只有需要运行时更换子树时才考虑 Run Behavior Dynamic。后者不支持注入子树 Root 层的 Decorator,关键门槛条件应留在父树合适的分支上。
迁移后检查引用
- 在 Content Browser 内移动或重命名资产,处理重定向器并保存引用它们的资产,避免直接在操作系统中搬动
.uasset。 - 打开每棵 Behavior Tree 的 Root,确认 Blackboard Asset 指向预期的公共或继承 Blackboard;检查每个 Blackboard Key Selector 的类型。
- 确认 Pawn 的 AI Controller Class、自动占有设置和 Controller 的
Run Behavior Tree选择与敌种匹配。 - 同时放置两名不同敌人进入 PIE,分别观察选中的 AI:目标键值应独立变化,近战与远程应进入各自攻击分支。
还可以在启用 Python Editor Script Plugin 后,用编辑器 Python 控制台进行路径存在性检查。以下脚本的路径对应本课建议结构;如项目命名不同,先替换清单:
import unreal
# 只检查编辑器内容资产是否存在,不把它当成引用正确性的证明。
required = {
"Controller": "/Game/AI/Common/Controllers/BP_EnemyAIController",
"Blackboard": "/Game/AI/Common/Blackboards/BB_EnemyCore",
"Task": "/Game/AI/Common/Tasks/BTT_SetMoveSpeed",
"Service": "/Game/AI/Common/Services/BTS_UpdateCombatDistance",
"Melee BT": "/Game/AI/Types/Melee/BT_Melee",
"Ranged BT": "/Game/AI/Types/Ranged/BT_Ranged",
}
missing = [
name for name, path in required.items()
if not unreal.EditorAssetLibrary.does_asset_exist(path)
]
if missing:
raise RuntimeError("缺失资产: " + ", ".join(missing))
print(f"PASS: {len(required)} 个资产路径存在")预期输出(上述六个资产已按路径创建):
PASS: 6 个资产路径存在路径检查通过后仍需在 PIE 验证行为树实际运行、各 AI 黑板值互不串扰,并确认被重命名资产的引用没有失效。目录清晰只是基础,真正可复用的边界是稳定键契约、独立实例状态与可替换的行为分支。