游戏引擎 / 系统课时
用组件拆分Gameplay能力
用组件拆分Gameplay能力
当交互、血量、拾取都直接写进角色或道具 Actor,类会很快同时承担输入、状态和业务规则。Actor Component 更适合承载可复用的 Gameplay 能力:Actor 决定“我拥有哪些能力”,组件负责各能力自己的状态与行为。本课用三个组件划清边界,并给出可编译的血量组件示例。
学习目标
- 判断哪些 Gameplay 逻辑适合拆成
UActorComponent。 - 为交互、血量和拾取能力划分清晰的状态与职责边界。
- 用组件事件把能力结果暴露给 Actor、UI 或蓝图,而不是制造组件之间的强耦合。
先按能力边界拆,而不是按函数数量拆
一个组件应该围绕一组会一起变化的状态与规则。例如血量组件拥有最大血量、当前血量和受伤规则;交互组件负责“这个 Actor 能否被交互、交互时发生什么”;拾取组件负责一次性拾取、是否已消费以及拾取结果。

拆分后,Actor 仍然负责组合。例如敌人可以只有血量组件,门只有交互组件,补给品同时拥有交互和拾取组件。是否挂载组件本身就表达了 Actor 的能力集合,避免在一个超大的基类里堆大量布尔开关。
写一个真正可复用的血量组件
下面示例把最大血量、当前血量和伤害处理放进 UHealthComponent,并通过动态多播事件通知外部。它不直接访问 HUD,也不假设 Owner 一定是玩家或敌人,因此可以挂到不同 Actor 上。
// HealthComponent.h
#pragma once
#include "CoreMinimal.h"
#include "Components/ActorComponent.h"
#include "HealthComponent.generated.h"
DECLARE_DYNAMIC_MULTICAST_DELEGATE_TwoParams(
FOnHealthChanged,
float, CurrentHealth,
float, MaxHealth
);
UCLASS(ClassGroup=(Gameplay), meta=(BlueprintSpawnableComponent))
class UHealthComponent : public UActorComponent
{
GENERATED_BODY()
public:
UHealthComponent();
UFUNCTION(BlueprintCallable, Category="Health")
void ApplyDamage(float Amount);
UFUNCTION(BlueprintPure, Category="Health")
float GetHealth() const { return CurrentHealth; }
UPROPERTY(BlueprintAssignable, Category="Health")
FOnHealthChanged OnHealthChanged;
protected:
virtual void BeginPlay() override;
UPROPERTY(EditAnywhere, BlueprintReadOnly, Category="Health", meta=(ClampMin="1.0"))
float MaxHealth = 100.0f;
UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category="Health")
float CurrentHealth = 0.0f;
};// HealthComponent.cpp
#include "HealthComponent.h"
UHealthComponent::UHealthComponent()
{
PrimaryComponentTick.bCanEverTick = false;
}
void UHealthComponent::BeginPlay()
{
Super::BeginPlay();
CurrentHealth = MaxHealth;
OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
}
void UHealthComponent::ApplyDamage(float Amount)
{
if (Amount <= 0.0f || CurrentHealth <= 0.0f)
{
return;
}
CurrentHealth = FMath::Clamp(CurrentHealth - Amount, 0.0f, MaxHealth);
OnHealthChanged.Broadcast(CurrentHealth, MaxHealth);
}预期结果
组件开始运行后:CurrentHealth = MaxHealth
调用 ApplyDamage(25):CurrentHealth 从 100 变为 75,并广播 OnHealthChanged(75, 100)
重复伤害直到 0:CurrentHealth 不会变成负数
Amount <= 0:忽略本次调用在角色 C++ 构造函数中可用 CreateDefaultSubobject<UHealthComponent> 固定挂载,也可以在 Actor 蓝图里使用 Add Component 添加它。组件不 Tick 时应像示例一样关闭 Tick,避免为纯事件驱动能力付出无意义的每帧成本。
给交互与拾取组件划清职责
交互与拾取经常被写成一件事,但二者不是同一层。交互解决“玩家对目标发起了什么动作”,拾取解决“这个物体被领取后如何进入已消费状态”。门可以交互却不能拾取,道具可以既能交互又能拾取。
| 组件 | 自己保存的状态 | 对外入口 | 典型事件 |
|---|---|---|---|
UInteractableComponent |
是否启用、交互提示或交互类型 | Interact(AActor* Interactor) |
OnInteracted |
UHealthComponent |
最大血量、当前血量 | ApplyDamage(float Amount) |
OnHealthChanged |
UPickupComponent |
是否已拾取、可否重复拾取 | TryPickup(AActor* Picker) |
OnPickedUp |
交互组件不应直接把物品塞进某个具体背包类;更稳妥的做法是先广播“发生了交互”。拾取组件收到交互后再判断是否可领取,并广播拾取结果;背包、任务或音效系统订阅结果,各自处理后续动作。这样换 UI、换库存系统时,不需要改交互组件。
在 Actor 中组合能力并连接事件
组件化不等于所有组件彼此通信。优先让 Owner 或更高层 Gameplay 对象负责组装关系:Actor 在构造阶段挂载组件,在 BeginPlay 或蓝图事件图中绑定组件事件,再把事件转成该 Actor 的表现或业务行为。
片段示例:以下代码依赖前面的 UHealthComponent,展示一个角色如何把组件作为能力挂载;它不是独立程序入口。
// MyCharacter.cpp
#include "MyCharacter.h"
#include "HealthComponent.h"
AMyCharacter::AMyCharacter()
{
HealthComponent = CreateDefaultSubobject<UHealthComponent>(TEXT("HealthComponent"));
}生效行为:该角色实例创建时会同时创建一个血量组件;组件的 MaxHealth 可在蓝图默认值中配置,UI 或死亡逻辑可以绑定 OnHealthChanged,而不需要把这些职责写回 UHealthComponent。
什么时候不要继续拆组件
只有一个 Actor 使用、没有独立状态、也没有复用或替换需求的两三行逻辑,留在 Actor 内通常更清楚。反过来,如果一个组件开始直接查找 HUD、GameMode、库存、任务和音频对象,它已经重新变成“万能类”,只是从 Actor 换了位置。
实际项目中可以用一个简单标准判断:组件应当拥有明确能力边界、独立状态和少量稳定入口;跨系统协作通过事件、接口或 Owner 组装完成。这样交互、血量和拾取才能真正成为可组合能力,而不是把原来的耦合复制到三个新文件里。