游戏 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,关键门槛条件应留在父树合适的分支上。

迁移后检查引用

  1. 在 Content Browser 内移动或重命名资产,处理重定向器并保存引用它们的资产,避免直接在操作系统中搬动 .uasset。
  2. 打开每棵 Behavior Tree 的 Root,确认 Blackboard Asset 指向预期的公共或继承 Blackboard;检查每个 Blackboard Key Selector 的类型。
  3. 确认 Pawn 的 AI Controller Class、自动占有设置和 Controller 的 Run Behavior Tree 选择与敌种匹配。
  4. 同时放置两名不同敌人进入 PIE,分别观察选中的 AI:目标键值应独立变化,近战与远程应进入各自攻击分支。

还可以在启用 Python Editor Script Plugin 后,用编辑器 Python 控制台进行路径存在性检查。以下脚本的路径对应本课建议结构;如项目命名不同,先替换清单:

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)} 个资产路径存在")

预期输出(上述六个资产已按路径创建):

text
PASS: 6 个资产路径存在

路径检查通过后仍需在 PIE 验证行为树实际运行、各 AI 黑板值互不串扰,并确认被重命名资产的引用没有失效。目录清晰只是基础,真正可复用的边界是稳定键契约、独立实例状态与可替换的行为分支。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

整理资产与复用接口

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通