企业官网建设流程全解析

回合制战斗AI一直是动作游戏开发里最磨人的部分，尤其是“狂暴敌人”这种带情绪状态切换的角色：平时巡逻、被攻击后追击、血量低于阈值后进入狂暴攻击，这套逻辑如果全靠蓝图蓝图连线会非常混乱，如果只写状态机又不利于复用。等真正动手做的时候才发现，行为树负责“怎么决策”，状态机负责“怎么表现”，两者必须配合，缺一不可。

本文会围绕UE5战斗AI开发，完整拆解一套“狂暴敌人”的实现方案：先讲清行为树和状态机各自的边界，再给出环境准备、黑板设计、AIController配置、行为树节点搭建、自定义Task/Service代码，以及动画蓝图状态机如何与底层逻辑联动。无论你是刚接触UE5 AI的新手，还是已经被节点连线折磨过一遍的开发者，都能直接照着这套思路落地自己的敌人角色。

1. 为什么狂暴敌人需要行为树与状态机结合

很多教程会把行为树和状态机拆开讲，但实际做战斗AI时两者是紧密配合的。理解这一点，比单纯学会节点拖拽重要得多。

1.1 只靠状态机的问题

状态机本身适合描述“稳定状态之间的切换”，比如待机、追击、攻击。每个状态有明确的进入条件、停留行为和退出条件。但在真实战斗中，状态机容易出现两类问题：

一是状态数量膨胀。狂暴敌人如果有巡逻、警觉、追击、攻击、硬直、狂暴、恢复、逃跑、死亡，每个状态再去处理不同的攻击方式、移动逻辑和动画触发，状态之间的连线会指数级增长，维护难度很大。

二是决策逻辑和表现逻辑耦合。比如“是否进入狂暴”这个判断，既涉及血量阈值、攻击冷却、玩家距离，又要触发动画和特效。如果这些逻辑全部写在状态机里，状态切换条件和表现行为会混在一起，后续调整数值会非常痛苦。

1.2 只靠行为树的问题

行为树擅长的是“目标优先级决策”。它可以每帧从根节点向下评估，Selector决定“现在最值得做什么”。但行为树不擅长表达“连续稳定的表现状态”。

典型的问题是：敌人从攻击切换到硬直，再切换回攻击，这个过程如果完全用行为树节点模拟，需要大量复合节点和装饰器。而且动画侧需要一个明确的状态机来维护当前播放的动画，行为树只适合告诉动画侧“现在处于哪个阶段”，而不是负责动画混合。

1.3 两者结合的设计思路

正确的方式是：

• 状态机负责“角色当前处于什么表现状态”，包括动画、移动、受击、硬直、攻击前摇后摇。
• 行为树负责“当前应该做什么事”，比如追击、攻击、狂暴、寻找目标。
• 行为树产生一个“行为意图”，状态机根据这个意图驱动动画与表现。
• 关键事件通过黑板键、接口或通知从状态机回传给行为树，让行为树调整决策。

“狂暴敌人”尤其适合这种结构：狂暴本身是一种全局状态，它会影响属性、速度、攻击频率和动画表现，而不是一个单纯的“行为”。

2. 环境准备与项目结构

在进行实战前，先确认环境。本文示例基于UE5.4/UE5.5的第三人称模板项目，使用的核心模块包括AIModule、GameplayTasksModule和UMG（用于调试显示，非必需）。如果你使用的是UE5.0到UE5.3之间，大部分节点和接口保持一致，但部分AI感知细节需要按版本微调。

2.1 创建项目与目录划分

建议新建一个C++基础项目，项目类型选择“游戏”，蓝图模板选“第三人称”。项目名称这里用FuryAIProject。

创建好的项目结构如下：

FuryAIProject/ ├── Config/ │ └── DefaultEngine.ini ├── Content/ │ ├── Characters/ │ │ ├── BP_Enemy │ │ └── BP_Player │ ├── AIControllers/ │ ├── BehaviorTrees/ │ ├── Blackboards/ │ └── Animations/ ├── Source/ │ └── FuryAIProject/ │ ├── AI/ │ ├── Characters/ │ └── Anim/

后面的代码主要放在Source/FuryAIProject/AI目录下，蓝图则对应放到Content里对应文件夹。C++代码负责底层逻辑，蓝图负责组合配置，这样既有灵活性，又方便美术和策划调整数值。

2.2 模块与插件检查

在FuryAIProject.Build.cs中，确保添加以下模块：

// 文件路径：Source/FuryAIProject/FuryAIProject.Build.cs PublicDependencyModuleNames.AddRange(new string[] { "Core", "CoreUObject", "Engine", "InputCore", "EnhancedInput", "AIModule", "GameplayTasks", "NavigationSystem", "AnimGraphRuntime", "UMG" });

不需要额外开启项目插件，UE5默认就包含AI感知、行为树、黑板和导航系统。问题最多的是“NavigationMesh”，如果场景中没有生成NavMesh，行为树里所有需要移动的节点都会直接失败。

3. 狂暴敌人逻辑设计：从需求到状态定义

开始做行为树和状态机之前，必须先写清楚这个敌人有哪些行为、哪些状态、哪些触发条件。不要直接拖节点，否则后面改需求时一定会乱。

3.1 敌人行为需求

假设我们要做一个“狂暴近战敌人”，它的需求如下：

• 默认状态下在出生点附近巡逻或待机。
• 当玩家进入感知范围后，敌人进入追击状态，向玩家方向移动。
• 敌人到达攻击距离后，发动连击攻击。
• 当敌人血量低于30%时，进入狂暴状态。
• 狂暴状态中，移动速度提升，攻击间隔缩短，攻击伤害提高。
• 玩家脱离一定距离后，敌人停止追击，回到待机或巡逻状态。
• 敌人被打出硬直时，停止当前行为并播放受击动画。

这些需求可以拆成两个层次：

行为层（Behavior Layer）由行为树决策，包括是否追击、是否攻击、是否狂暴。 表现层（Presentation Layer）由状态机管理，包括待机、移动、攻击、硬直、狂暴、死亡等动画状态。

3.2 五种核心状态

状态机至少需要这些状态：

这里要注意：狂暴不是简单的“另一个状态”。狂暴更像是一个“状态修饰器”。我推荐的做法是，在动画蓝图状态机里保留Idle、Chase、Attack、HitReact、Death，狂暴状态通过修改移动速度、动画播放速率和节点切换条件来表现，而不是单独做一个平行状态。

这样做的原因是：狂暴状态下敌人依然需要追击、攻击、受击，如果单独做一个Fury状态，就会复制大量逻辑。正确思路是给状态机一个全局的bFuryMode标记，所有状态节点根据标记选择不同动画和参数。

3.3 狂暴触发条件设计

狂暴触发条件从简到繁可以分三个层级：

• 简单：血量低于30%，一次性触发。
• 中等：血量低于30%，触发后属性强化。
• 复杂：每次血量下降触发狂暴，且暴怒程度叠加。

本文采用第二个层级。触发点在C++或蓝图里监听OnTakeAnyDamage事件，当血量比例低于阈值时，设置bFuryMode = true，并把这个值写入行为树黑板键IsFury。行为树的Decorator根据该键判断是否切换到狂暴分支，动画状态机也根据该键加快动画播放速率、开启发光材质等表现。

4. 行为树构建实战

一个完整的狂暴敌人行为树，必须包含三个部分：黑板（Blackboard）、AI控制器（AIController）、行为树资产（BehaviorTree）。

4.1 黑板与键值设计

打开UE5内容浏览器，创建一个“Blackboard”资产，命名为BB_Enemy。添加以下Key：

其中TargetActor是最核心的Key，行为树大多数Selector都在判断它是否存在。TargetLastLocation用于目标丢失后去最后位置查探。HomeLocation用来做警戒失效后的返回逻辑。

4.2 AI控制器：感知与组件装配

在C++中创建一个EnemyController类，负责初始化AI感知组件、行为树组件和黑板组件。先看头文件：

// 文件路径：Source/FuryAIProject/AI/FuryEnemyController.h #pragma once #include "CoreMinimal.h" #include "AIController.h" #include "FuryEnemyController.generated.h" class UBehaviorTreeComponent; class UBlackboardComponent; class UAIPerceptionComponent; class UAISenseConfig_Sight; class UAISenseConfig_Hearing; UCLASS() class FURYAI_PROJECT_API AFuryEnemyController : public AAIController { GENERATED_BODY() public: AFuryEnemyController(); virtual void OnPossess(APawn* InPawn) override; virtual void OnUnPossess() override; UFUNCTION(BlueprintCallable, Category = "FuryAI") void SetFuryMode(bool bEnable); UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components") UBehaviorTreeComponent* BehaviorTreeComp; UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components") UBlackboardComponent* BlackboardComp; UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components") UAIPerceptionComponent* PerceptionComp; UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "Components") UAISenseConfig_Sight* SightConfig; UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "AI") UBehaviorTree* BehaviorTree; UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "AI") FName TargetActorKey = "TargetActor"; UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "AI") FName IsFuryKey = "IsFury"; UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "AI") FName HomeLocationKey = "HomeLocation"; protected: UFUNCTION() void OnPerceptionUpdated(const TArray<AActor*>& UpdatedActors); };

这个头文件声明了感知组件、行为树组件和黑板组件。注意TargetActorKey等键名要和黑板资产里的Key保持一致，最好不要写死字符串，而是用常量或属性配置。

接下来看CPP文件：

// 文件路径：Source/FuryAIProject/AI/FuryEnemyController.cpp #include "FuryEnemyController.h" #include "BehaviorTree/BehaviorTreeComponent.h" #include "BehaviorTree/BlackboardComponent.h" #include "BehaviorTree/BehaviorTree.h" #include "Perception/AIPerceptionComponent.h" #include "Perception/AISenseConfig_Sight.h" #include "Perception/AISenseConfig_Hearing.h" #include "Perception/AIPerceptionTypes.h" #include "GameFramework/Character.h" AFuryEnemyController::AFuryEnemyController() { BehaviorTreeComp = CreateDefaultSubobject<UBehaviorTreeComponent>(TEXT("BehaviorTreeComponent")); BlackboardComp = CreateDefaultSubobject<UBlackboardComponent>(TEXT("BlackboardComponent")); PerceptionComp = CreateDefaultSubobject<UAIPerceptionComponent>(TEXT("PerceptionComponent")); SightConfig = CreateDefaultSubobject<UAISenseConfig_Sight>(TEXT("SightConfig")); SightConfig->SightRadius = 1200.0f; SightConfig->LoseSightRadius = 1500.0f; SightConfig->PeripheralVisionAngleDegrees = 90.0f; SightConfig->SetMaxAge(5.0f); SightConfig->AutoSuccessRangeFromLastSeenLocation = 500.0f; SightConfig->DetectionByAffiliation.bDetectEnemies = true; SightConfig->DetectionByAffiliation.bDetectNeutrals = false; SightConfig->DetectionByAffiliation.bDetectFriendlies = false; PerceptionComp->ConfigureSense(*SightConfig); PerceptionComp->SetDominantSense(UAISenseConfig_Sight::StaticClass()); PerceptionComp->OnPerceptionUpdated.AddDynamic(this, &AFuryEnemyController::OnPerceptionUpdated); } void AFuryEnemyController::OnPossess(APawn* InPawn) { Super::OnPossess(InPawn); if (UBlackboardComponent* Blackboard = GetBlackboardComponent()) { Blackboard->SetValueAsVector(HomeLocationKey, InPawn->GetActorLocation()); } if (BehaviorTree && BlackboardComp) { BlackboardComp->InitializeBlackboard(*BehaviorTree->BlackboardAsset); BehaviorTreeComp->StartTree(*BehaviorTree); } } void AFuryEnemyController::OnUnPossess() { Super::OnUnPossess(); if (BehaviorTreeComp) { BehaviorTreeComp->StopTree(); } } void AFuryEnemyController::SetFuryMode(bool bEnable) { if (BlackboardComp) { BlackboardComp->SetValueAsBool(IsFuryKey, bEnable); } } void AFuryEnemyController::OnPerceptionUpdated(const TArray<AActor*>& UpdatedActors) { if (!BlackboardComp) return; for (AActor* Actor : UpdatedActors) { if (!Actor) continue; // 感知到有效目标时写入黑板 FAIStimulus Stimulus; if (PerceptionComp->GetActorsPerception(Actor, Stimulus)) { if (Stimulus.WasSuccessfullySensed()) { BlackboardComp->SetValueAsObject(TargetActorKey, Actor); BlackboardComp->SetValueAsVector("TargetLastLocation", Actor->GetActorLocation()); } } } }

代码里有三个关键点：

第一，OnPossess中启用行为树前，必须先调用InitializeBlackboard初始化黑板，再调用StartTree启动行为树。顺序反了会导致行为树启动时报错。

第二，OnPerceptionUpdated是感知事件回调。这里把所有感知到的Actor都视为目标写入黑板，实际项目中应该判断Actor是否属于玩家阵营，或是否拥有FuryAITarget接口。

第三，SightConfig->DetectionByAffiliation控制感知阵营，默认情况下UE5的Team ID需要通过SetGenericTeamId设置，否则全部算中立。这里先用bDetectEnemies和bDetectNeutrals保证无论玩家是敌是中都能看到。

4.3 行为树节点布局

创建行为树资产BT_EnemyFury，关联刚才的BB_Enemy黑板。整体布局如下：

Root

• Sequence（主逻辑）
  • Selector（优先级决策）
    • Task：MoveTo（追击目标）
    • Task：FindNewTarget（在HomeLocation附近巡逻）
  • Decorator：IsFury == true
    • Task：FuryAttack（狂暴攻击）
  • Service：UpdateTarget（每0.2秒刷新目标位置）
• Task：Wait

实际布局为：

Root └── Sequence ├── Selector │ ├── [Decorator] TargetActor != None │ │ └── MoveTo TargetActor │ └── Task: PatrolAroundHome ├── [Decorator] TargetActor != None │ └── Sequence │ ├── [Decorator] bCanAttack == true │ │ └── Task: MeleeAttack │ └── Task: ChaseAndWait └── Service: UpdateTarget

这里我简化成一个更清晰、更适合初学者的布局：

1. 根节点下挂一个Sequence。
2. 第一个子节点是Selector，判断目标是否存在。
   • 如果TargetActor有值，进入MoveTo任务，将敌人移动到目标身边。
   • 如果TargetActor没值，进入PatrolAroundHome任务，返回出生点附近。
3. 第二个子节点是IsFury装饰器控制的狂暴攻击分支。
   • 当IsFury为true时，执行BTTask_FuryAttack。
   • 当IsFury为false时，执行普通攻击节点。
4. 根节点的Sequence上挂一个BTService_UpdateTarget，每帧刷新目标位置和目标距离。

这样布局的好处是：狂暴分支优先级高于普通攻击，目标丢失时敌人不会原地发呆，而是自动回到出生点。

4.4 自定义BTService实时追踪目标

行为树默认的MoveTo节点只会使用黑板中的静态目标值。为了让敌人实时更新对玩家的追踪，需要写一个BTService。

// 文件路径：Source/FuryAIProject/AI/BTService_UpdateTarget.h #pragma once #include "CoreMinimal.h" #include "BehaviorTree/BTService.h" #include "BTService_UpdateTarget.generated.h" UCLASS() class FURYAI_PROJECT_API UBTService_UpdateTarget : public UBTService { GENERATED_BODY() public: UBTService_UpdateTarget(); protected: virtual void TickNode(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory, float DeltaSeconds) override; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "AI") FBlackboardKeySelector TargetKey; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "AI") FBlackboardKeySelector DistanceKey; };

实现：

// 文件路径：Source/FuryAIProject/AI/BTService_UpdateTarget.cpp #include "BTService_UpdateTarget.h" #include "BehaviorTree/BlackboardComponent.h" #include "BehaviorTree/Blackboard/BlackboardKeyType_Object.h" #include "GameFramework/Pawn.h" #include "AIController.h" UBTService_UpdateTarget::UBTService_UpdateTarget() { NodeName = "UpdateTarget"; Interval = 0.2f; RandomDeviation = 0.05f; } void UBTService_UpdateTarget::TickNode(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory, float DeltaSeconds) { Super::TickNode(OwnerComp, NodeMemory, DeltaSeconds); UBlackboardComponent* BlackboardComp = OwnerComp.GetBlackboardComponent(); AAIController* AIController = OwnerComp.GetAIOwner(); if (!BlackboardComp || !AIController || !AIController->GetPawn()) return; UObject* TargetObj = BlackboardComp->GetValueAsObject(TargetKey.SelectedKeyName); AActor* TargetActor = Cast<AActor>(TargetObj); // 如果当前战略目标无效或死亡，搜索附近Pawn作为新目标 if (!IsValid(TargetActor)) { const APawn* SelfPawn = AIController->GetPawn(); FCollisionQueryParams Params; Params.AddIgnoredActor(SelfPawn); TArray<FOverlapResult> Overlaps; GetWorld()->OverlapMultiByChannel( Overlaps, SelfPawn->GetActorLocation(), FQuat::Identity, ECC_Pawn, FCollisionShape::MakeSphere(1500.0f), Params ); for (const FOverlapResult& Overlap : Overlaps) { APawn* HitPawn = Cast<APawn>(Overlap.GetActor()); if (HitPawn && HitPawn != SelfPawn) { BlackboardComp->SetValueAsObject(TargetKey.SelectedKeyName, HitPawn); break; } } } // 刷新目标最近位置 if (TargetActor) { BlackboardComp->SetValueAsVector("TargetLastLocation", TargetActor->GetActorLocation()); } }

这段代码的使用场景是做“低级别感知补偿”。如果AI的感知组件因为遮挡或距离没有及时更新目标，Service会就近扫描Pawn并自动补充目标。但对于正式项目，还是应该以UAIPerceptionComponent为主，不要用每帧Overlap扫描替代感知系统，否则性能会受影响。

4.5 自定义BTTask狂暴攻击

狂暴攻击是行为树的“动作输出”。这个Task负责通知角色开启攻击动画、设置攻击冷却、施加伤害。

// 文件路径：Source/FuryAIProject/AI/BTTask_FuryAttack.h #pragma once #include "CoreMinimal.h" #include "BehaviorTree/BTTaskNode.h" #include "BTTask_FuryAttack.generated.h" UCLASS() class FURYAI_PROJECT_API UBTTask_FuryAttack : public UBTTaskNode { GENERATED_BODY() public: UBTTask_FuryAttack(); virtual EBTNodeResult::Type ExecuteTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory) override; virtual void TickTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory, float DeltaSeconds) override; protected: UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attack") FBlackboardKeySelector TargetKey; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attack") float AttackRange = 250.0f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attack") float AttackCooldown = 0.8f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "Attack") float AttackDamage = 25.0f; private: float CurrentCooldown; bool bAttackFinished; };

实现：

// 文件路径：Source/FuryAIProject/AI/BTTask_FuryAttack.cpp #include "BTTask_FuryAttack.h" #include "BehaviorTree/BlackboardComponent.h" #include "BehaviorTree/Blackboard/BlackboardKeyType_Object.h" #include "AIController.h" #include "GameFramework/Character.h" #include "GameFramework/DamageType.h" #include "Kismet/GameplayStatics.h" UBTTask_FuryAttack::UBTTask_FuryAttack() { NodeName = "FuryAttack"; bNotifyTick = true; bAttackFinished = false; CurrentCooldown = 0.0f; } EBTNodeResult::Type UBTTask_FuryAttack::ExecuteTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory) { AAIController* AIController = OwnerComp.GetAIOwner(); if (!AIController || !AIController->GetPawn()) return EBTNodeResult::Failed; UBlackboardComponent* BlackboardComp = OwnerComp.GetBlackboardComponent(); if (!BlackboardComp) return EBTNodeResult::Failed; AActor* TargetActor = Cast<AActor>(BlackboardComp->GetValueAsObject(TargetKey.SelectedKeyName)); if (!TargetActor) return EBTNodeResult::Failed; // 通知角色播放攻击动画 if (ACharacter* EnemyChar = Cast<ACharacter>(AIController->GetPawn())) { IAnimInstanceInterface* AnimInstance = EnemyChar->GetMesh()->GetAnimInstance(); // 实际项目中这里通过接口或事件通知动画蓝图触发攻击Montage // EnemyChar->PlayAnimMontage(FuryAttackMontage); } // 检测攻击距离 float Distance = AIController->GetPawn()->GetDistanceTo(TargetActor); if (Distance <= AttackRange) { UGameplayStatics::ApplyDamage( TargetActor, AttackDamage, AIController, AIController->GetPawn(), UDamageType::StaticClass() ); bAttackFinished = true; return EBTNodeResult::Succeeded; } CurrentCooldown = AttackCooldown; bAttackFinished = false; return EBTNodeResult::InProgress; } void UBTTask_FuryAttack::TickTask(UBehaviorTreeComponent& OwnerComp, uint8* NodeMemory, float DeltaSeconds) { Super::TickTask(OwnerComp, NodeMemory, DeltaSeconds); if (bAttackFinished) { FinishLatentTask(OwnerComp, EBTNodeResult::Succeeded); return; } if (CurrentCooldown > 0.0f) { CurrentCooldown -= DeltaSeconds; if (CurrentCooldown <= 0.0f) { bAttackFinished = true; FinishLatentTask(OwnerComp, EBTNodeResult::Succeeded); } } }

这个Task有一个完整的执行流程：先判断目标是否存在，然后播放攻击动画，再检测距离是否进入范围，之后进入冷却逻辑。注意FinishLatentTask必须配对bNotifyTick和InProgress返回值，否则Task一直占用行为树，后面的节点不会执行。

5. 战斗状态机实现

行为树负责输出“行为意图”，状态机负责把这些意图转换成角色动画和表现。下面从动画蓝图和C++两个层面实现状态机。

5.1 动画蓝图状态机

打开敌人骨骼对应的动画蓝图，新建一个状态机EnemyStateMachine。状态机里的状态包括：

• Idle：默认状态，播放站立动画。
• Chase：播放跑步动画。
• Attack：播放攻击动画，攻击动画结束后回到Idle或Chase。
• HitReact：播放受击动画，结束后回到Idle或Chase。
• Death：死亡状态，不自动切换。

状态机转换规则建议如下：

在动画蓝图中，条件判断使用变量：TargetDistance、IsValidTarget、IsAttacking、IsFuryMode。其中IsFuryMode是个特殊变量，它不直接触发状态切换，而是作为Idle、Chase、Attack这些状态的动画播放速率系数。

比如在Chase状态中，进入时判断：

if (IsFuryMode) { PlayRate = 1.5f; } else { PlayRate = 1.0f; }

这样狂暴状态下跑步动画会明显变快，玩家能立刻感觉到敌人“疯了”。

5.2 C++状态枚举与切换

为了让行为树和动画蓝图之间有一个稳定的“数据接口”，建议在C++中定义状态枚举，并通过AI控制器对外暴露。

// 文件路径：Source/FuryAIProject/AI/EEnemyState.h #pragma once #include "CoreMinimal.h" UENUM(BlueprintType) enum class EEnemyState : uint8 { Idle UMETA(DisplayName = "Idle"), Chase UMETA(DisplayName = "Chase"), Attack UMETA(DisplayName = "Attack"), HitReact UMETA(DisplayName = "HitReact"), Fury UMETA(DisplayName = "Fury"), Death UMETA(DisplayName = "Death") };

在角色类中增加状态管理函数：

// 文件路径：Source/FuryAIProject/Characters/FuryEnemyCharacter.h #pragma once #include "CoreMinimal.h" #include "GameFramework/Character.h" #include "AI/EEnemyState.h" #include "FuryEnemyCharacter.generated.h" UCLASS() class FURYAI_PROJECT_API AFuryEnemyCharacter : public ACharacter { GENERATED_BODY() public: AFuryEnemyCharacter(); UFUNCTION(BlueprintCallable, Category = "FuryAI") void ChangeState(EEnemyState NewState); UFUNCTION(BlueprintPure, Category = "FuryAI") EEnemyState GetCurrentState() const { return CurrentState; } UFUNCTION(BlueprintCallable, Category = "FuryAI") void SetFuryMode(bool bEnable); protected: virtual float TakeDamage(float DamageAmount, FDamageEvent const& DamageEvent, AController* EventInstigator, AActor* DamageCauser) override; virtual void BeginPlay() override; UPROPERTY(VisibleAnywhere, BlueprintReadOnly, Category = "State") EEnemyState CurrentState; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "FuryAI") float FuryHealthPercent = 0.3f; UPROPERTY(EditAnywhere, BlueprintReadWrite, Category = "FuryAI") float MaxHealth = 100.0f; float CurrentHealth; bool bFuryMode; };

实现：

// 文件路径：Source/FuryAIProject/Characters/FuryEnemyCharacter.cpp #include "FuryEnemyCharacter.h" #include "AI/FuryEnemyController.h" AFuryEnemyCharacter::AFuryEnemyCharacter() { CurrentState = EEnemyState::Idle; bFuryMode = false; } void AFuryEnemyCharacter::BeginPlay() { Super::BeginPlay(); CurrentHealth = MaxHealth; } void AFuryEnemyCharacter::ChangeState(EEnemyState NewState) { if (CurrentState == NewState) return; CurrentState = NewState; // 通知动画蓝图状态切换 // 可以通过接口或AnimInstance变量同步 } void AFuryEnemyCharacter::SetFuryMode(bool bEnable) { bFuryMode = bEnable; if (AFuryEnemyController* FuryController = Cast<AFuryEnemyController>(GetController())) { FuryController->SetFuryMode(bEnable); } } float AFuryEnemyCharacter::TakeDamage(float DamageAmount, FDamageEvent const& DamageEvent, AController* EventInstigator, AActor* DamageCauser) { float ActualDamage = Super::TakeDamage(DamageAmount, DamageEvent, EventInstigator, DamageCauser); CurrentHealth = FMath::Max(0.0f, CurrentHealth - ActualDamage); // 血量低于阈值时触发狂暴 if (!bFuryMode && CurrentHealth <= MaxHealth * FuryHealthPercent) { SetFuryMode(true); } // 死亡 if (CurrentHealth <= 0.0f) { ChangeState(EEnemyState::Death); } else { ChangeState(EEnemyState::HitReact); } return ActualDamage; }

这段C++代码的核心是：所有状态变化都集中到ChangeState，所有伤害都经过TakeDamage。这样无论是狂暴触发、受击硬直还是死亡，都能在同一个入口处理，方便日后接技能系统或音效系统。

5.3 状态机与动画的联动

C++状态发生变化后，动画蓝图需要感知。常见方案有两种：

方案一：动画蓝图每帧轮询角色身上的GetCurrentState()，根据状态切换状态机条件。 方案二：角色状态变化时，通过事件通知动画蓝图。

推荐方案一，简单且稳定：

// 动画蓝图Event Blueprint Update Animation FEnemyAnimInstance::NativeUpdateAnimation(float DeltaSeconds) { Super::NativeUpdateAnimation(DeltaSeconds); ACharacter* Owner = Cast<ACharacter>(GetOwningActor()); if (Owner) { if (AFuryEnemyCharacter* EnemyChar = Cast<AFuryEnemyCharacter>(Owner)) { CurrentState = EnemyChar->GetCurrentState(); IsFuryMode = EnemyChar->bFuryMode; } } }

在动画蓝图里，只需要新建两个变量：CurrentState（枚举类型EEnemyState）和IsFuryMode（Bool）。状态机转换规则中对变量做Switch比较即可。

5.4 狂暴状态的特殊处理

狂暴是这套逻辑最容易出问题的部分。推荐下面几种“狂暴”表达方案，可以根据项目体量选择：

• 数值层：攻击伤害、移动速度、攻击频率提升。
• 动画层：动画播放速率提升，攻击Montage替换为狂暴版本。
• 特效层：启用材质发光、增加粒子、改变武器拖尾颜色。
• 音效层：切换狂暴形态下的脚步声、呼吸声、攻击音效。

在C++中，狂暴触发后可以通过修改CharacterMovementComponent的MaxWalkSpeed、MaxAcceleration，以及设置动画里PlayRate系数实现。例如：

// 在SetFuryMode中增加数值强化 void AFuryEnemyCharacter::SetFuryMode(bool bEnable) { bFuryMode = bEnable; UCharacterMovementComponent* MoveComp = GetCharacterMovement(); if (MoveComp) { MoveComp->MaxWalkSpeed = bFuryMode ? 700.0f : 450.0f; MoveComp->MaxAcceleration = bFuryMode ? 2048.0f : 1024.0f; } if (AFuryEnemyController* FuryController = Cast<AFuryEnemyController>(GetController())) { FuryController->SetFuryMode(bEnable); } }

6. 行为树与状态机的整合效果

前半部分分别讲了行为树和状态机，实际运行时它们并不是两条独立流水线，而是通过黑板和事件互相驱动。

6.1 配合方式总览

整体流程可以概括为：

感知组件发现玩家 → 控制器写入黑板TargetActor → 行为树评估并决定“追击”或“攻击” → 行为树Task通知角色播放动画 → 动画蓝图状态机切换状态 → 动画播放完毕通知行为树继续下一节点。

其中比较关键的是“动画通知行为树”这一步。比如攻击动作播放到A帧时，需要让行为树知道“这次攻击可以结算伤害了”。可以使用AnimNotify，在动画Montage中插入一个AnimNotify_AttackHit，然后从角色转发给行为树。

6.2 关键整合流程示意

文字流程如下：

1. 玩家进入Enemy的感知半径。
2. AIController的OnPerceptionUpdated被调用，黑板TargetActor被设置为玩家。
3. 行为树Selector中，TargetActor != None的Decorator通过，进入MoveTo任务。
4. 敌人移动到攻击范围附近，BTService_UpdateTarget持续刷新TargetLastLocation。
5. 行为树进入FuryAttack或普通攻击分支。
6. BTTask调用角色接口，角色播放攻击Montage，动画蓝图状态机切换到Attack。
7. 攻击动画某个帧触发AnimNotify，对目标应用伤害。
8. 攻击结束后，BTTask返回Succeeded，行为树继续循环。
9. 如果敌人血量低于30%，角色TakeDamage触发SetFuryMode(true)，黑板IsFury变为true。
10. 行为树中的IsFury装饰器让后续攻击进入狂暴分支，动画速度同步提升。

6.3 数据流向

关键数据流如下：

• TargetActor：感知组件产生 → AI控制器写入黑板 → 行为树读取 → BTTask使用。
• TargetLastLocation：感知组件写入 → 行为树读取 → MoveTo定位。
• IsFury：角色受击产生 → AI控制器写入黑板 → 行为树分支切换 → 动画蓝图调速。

这种设计下，行为树的节点组合可以随意调整而不影响状态机内部逻辑，状态机的状态切换也不会干扰行为树的决策，两者解耦。

7. 常见问题与排查思路

实战中这套AI系统最常遇到的问题集中在行为树不执行、感知失效、状态切换抖动和狂暴逻辑不生效四类，下面按排查顺序整理。

7.1 行为树不执行或启动失败

如果场景运行时敌人毫无反应，优先看Output Log。常见的报错是：

Error: Failed to start behavior tree 'BT_EnemyFury'. Missing Blackboard.

这个报错说明行为树资产没有正确关联黑板。在行为树资产详情中，确认Blackboard Asset一项已经选择BB_Enemy，并在AI控制器组件中的BehaviorTree属性里也指定了同一个行为树。

7.2 AI感知常见问题

AI感知在UE5中备受争议，其实大部分问题都是因为TeamID没有设置。在AI控制器创建时，给控制器设置队伍ID：

void AFuryEnemyController::OnPossess(APawn* InPawn) { Super::OnPossess(InPawn); SetGenericTeamId(FGenericTeamId(1)); if (UBlackboardComponent* Blackboard = GetBlackboardComponent()) { Blackboard->SetValueAsVector(HomeLocationKey, InPawn->GetActorLocation()); } if (BehaviorTree && BlackboardComp) { BlackboardComp->InitializeBlackboard(*BehaviorTree->BlackboardAsset); BehaviorTreeComp->StartTree(*BehaviorTree); } }

玩家的控制器设置TeamId为0，这样DetectionByAffiliation.bDetectEnemies才会把玩家识别为“敌方”。

此外，默认AI感知组件不会自动感知“所有Pawn”。如果要感知的目标没有CharacterMovementComponent或没有Collision，也可能漏检测。这时可以在AI感知上添加HearingConfig做辅助，或用GetActorsPerception手动查询。

7.3 状态切换抖动

状态切换抖动通常由距离阈值频繁跨越导致。例如AttackRange是200，目标在199和201之间来回波动，状态就会在Chase和Attack之间反复切换。

解决方案是引入“滞回区间”：

const float AttackRangeEnter = 220.0f; // 进入攻击状态的距离 const float AttackRangeExit = 260.0f; // 退出攻击状态的距离

行为树Service中判断时，进入攻击用Enter值，退出攻击用Exit值。这个细节非常影响手感，值得单独做一层配置文件。

7.4 狂暴后行为树不切换

狂暴逻辑容易出现“数值已经变了，行为树还是老样子”的问题。先检查黑板键名是否拼错，再检查行为树里IsFury的Decorator是否用了正确的黑板键。

另一个隐藏原因是蓝图中的SetFuryMode没有调用AI控制器，而是只改了角色自己的bFuryMode。因为行为树读的是黑板，角色自己修改布尔值不会同步到黑板。务必在角色SetFuryMode中调用控制器来更新黑板。

8. 最佳实践与工程建议

这套AI系统完成基本功能后，建议从设计、性能、调试三个维度继续优化。

8.1 设计层面：接口优于硬耦合

不要去直接修改其他系统的内部变量。狂暴逻辑应该走一条清晰的调用链：

角色TakeDamage → 角色SetFuryMode → AI控制器SetFuryMode → 黑板IsFury → 行为树Decorator → 动画蓝图IsFuryMode

每一步之间用函数或黑板键解耦。这样后续替换技能系统、增加多人网络、或者把敌人AI换成Boss AI，都只需要替换中间的部分实现，不需要改整条链路。

8.2 性能层面：控制Service频率

行为树中的Service默认每0.5秒跑一次。不要为了实时性把所有Service都改成0.01秒。感知组件本身已经有更新频率，行为树只需要在需要时刷新。BTService_UpdateTarget的Interval建议设置为0.15秒到0.3秒，攻击检测这类高频逻辑可以放在状态机Tick中完成。

此外，敌人数量增加时，Overlap扫描非常昂贵。生产环境中建议用UAIPerceptionComponent的感知结果来驱动行为树，而不要每个敌人每帧都在场景里做SphereOverlap。

8.3 调试层面：可视化优先

在调试AI时，打开AI感知的可视化Debug：

PerceptionComp->bDebugOwnsComponent = true;

或在运行时，使用DrawDebugSphere显示攻击范围、感知范围。行为树调试时打开Behavior Tree Debugger窗口，可以看到每个节点当前是Success、Failed还是Running。这是排查“为什么敌人不发狂”的最直接工具。

8.4 生产环境注意事项

• 敌人AI不要依赖FindAllActorsOfClass每帧找玩家，应该在感知事件中缓存目标引用。
• 行为树Wait任务如果一直运行，会导致AI发呆，建议限制最大Wait时间。
• 狂暴状态必须设置一次性触发保护，否则敌人受击后每次HitReact都可能重新触发狂暴逻辑。
• 状态机切换不要放在Tick里双条件同时满足，否则容易出现死亡后还播放攻击动画的恶性Bug。

9. 结语与下一步方向

狂暴敌人的实现到这里就完整覆盖了：行为树负责决策，状态机负责表现，AI控制器负责感知与数据传递，黑板的IsFury键把狂暴状态串联到整条AI链路。这个框架稍加改动就能复用到普通敌人、巡逻守卫、Boss战等多个战斗AI场景。

做完基础版本后，下一步可以继续深入几个方向。一是把攻击逻辑接入UE5的Gameplay Ability System（GAS），让伤害、冷却、Buff全部走技能框架；二是加入EQS环境查询，让敌人在追击时动态选取更合理的绕后路径；三是把狂暴状态改成多层怒气机制，每次受击积累怒气，怒气满后进入暴走，而不是简单的血量阈值触发。建议先把本文的链路完整跑通，理解每一步数据是怎么流动的，再逐步给系统增加复杂度。