游戏引擎 / 系统课时
建立血量与伤害流程
建立血量与伤害流程
战斗循环最容易失控的地方不是扣一次血,而是让投射物、近战、陷阱等不同来源都走同一入口,并保证生命值不会越界、死亡只触发一次。本课用 UE5 的 Damage 入口集中处理扣血,再把死亡判定固定在生命值更新之后。
学习目标
- 能区分“发起伤害”和“接收伤害”两侧的职责。
- 能在
TakeDamage中统一执行扣血、范围限制和死亡判定。 - 能验证普通伤害、致死伤害和重复伤害不会破坏角色状态。
把伤害入口和生命值职责分开
攻击方只负责描述“对谁造成多少伤害”,不应直接修改目标的 CurrentHealth。这样子弹、近战和环境伤害都可以调用同一个入口,目标角色再在自己的 TakeDamage 中决定实际扣除多少、是否死亡,以及后续要触发哪些反馈。
最小流程是:攻击行为调用 UGameplayStatics::ApplyDamage,引擎把伤害交给目标 Actor 的 TakeDamage,目标先计算实际伤害,再把生命值限制在 0 到 MaxHealth,最后检查是否第一次进入死亡状态。多人游戏中,这条权威流程应运行在服务器。

实现统一扣血流程
下面是片段示例:把类加入启用 C++ 的 UE5 项目。DealDamageTo 模拟任意攻击来源调用伤害入口,TakeDamage 是统一接收点;bDead 防止死亡逻辑重复执行,返回值表示这次真正损失的生命值。
// CombatCharacter.h
#pragma once
#include "CoreMinimal.h"
#include "GameFramework/Character.h"
#include "CombatCharacter.generated.h"
UCLASS()
class ACombatCharacter : public ACharacter
{
GENERATED_BODY()
public:
UFUNCTION(BlueprintCallable, Category = "Combat")
void DealDamageTo(AActor* TargetActor, float DamageAmount);
virtual float TakeDamage(
float DamageAmount,
struct FDamageEvent const& DamageEvent,
AController* EventInstigator,
AActor* DamageCauser
) override;
protected:
virtual void BeginPlay() override;
UPROPERTY(EditDefaultsOnly, BlueprintReadOnly, Category = "Health",
meta = (ClampMin = "1.0"))
float MaxHealth = 100.0f;
UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Health")
float CurrentHealth = 100.0f;
UPROPERTY(VisibleInstanceOnly, BlueprintReadOnly, Category = "Health")
bool bDead = false;
private:
void Die();
};// CombatCharacter.cpp
#include "CombatCharacter.h"
#include "GameFramework/CharacterMovementComponent.h"
#include "GameFramework/DamageType.h"
#include "Kismet/GameplayStatics.h"
void ACombatCharacter::BeginPlay()
{
Super::BeginPlay();
CurrentHealth = MaxHealth;
bDead = false;
}
void ACombatCharacter::DealDamageTo(AActor* TargetActor, float DamageAmount)
{
if (!HasAuthority() || !IsValid(TargetActor) || DamageAmount <= 0.0f)
{
return;
}
const float AppliedDamage = UGameplayStatics::ApplyDamage(
TargetActor,
DamageAmount,
GetController(),
this,
UDamageType::StaticClass()
);
UE_LOG(
LogTemp,
Display,
TEXT("DealDamage result: %.1f"),
AppliedDamage
);
}
float ACombatCharacter::TakeDamage(
float DamageAmount,
FDamageEvent const& DamageEvent,
AController* EventInstigator,
AActor* DamageCauser
)
{
if (!HasAuthority() || bDead || DamageAmount <= 0.0f)
{
return 0.0f;
}
const float RequestedDamage = Super::TakeDamage(
DamageAmount,
DamageEvent,
EventInstigator,
DamageCauser
);
const float EffectiveDamage = FMath::Max(0.0f, RequestedDamage);
const float OldHealth = CurrentHealth;
CurrentHealth = FMath::Clamp(
CurrentHealth - EffectiveDamage,
0.0f,
MaxHealth
);
const float HealthLost = OldHealth - CurrentHealth;
UE_LOG(
LogTemp,
Display,
TEXT("Health: %.1f -> %.1f"),
OldHealth,
CurrentHealth
);
if (CurrentHealth <= 0.0f && !bDead)
{
Die();
}
return HealthLost;
}
void ACombatCharacter::Die()
{
bDead = true;
if (UCharacterMovementComponent* Movement = GetCharacterMovement())
{
Movement->DisableMovement();
}
SetActorEnableCollision(false);
UE_LOG(LogTemp, Display, TEXT("Character died"));
}预期结果:准备两个 ACombatCharacter 实例,在服务器权威侧让攻击者对满血目标执行 DealDamageTo(Target, 30.0f),日志应对应一次从 100 到 70 的生命值变化:
LogTemp: Display: Health: 100.0 -> 70.0
LogTemp: Display: DealDamage result: 30.0随后再造成足以致死的伤害,CurrentHealth 会被限制为 0.0,Character died 只出现一次;死亡后的再次伤害因为 bDead 守卫直接返回,不会重复执行死亡逻辑。
为什么要限制生命值并返回实际伤害
假设角色只剩 20 点生命值,却收到 50 点伤害。若直接做减法,生命值会变成 -30,后续 UI、击杀统计或治疗逻辑都要额外处理无意义的负值。用 FMath::Clamp 把结果固定在合法区间后,状态始终满足 0 <= CurrentHealth <= MaxHealth。
示例返回 HealthLost 而不是原始的 DamageAmount。因此剩余 20 点生命值时收到 50 点伤害,实际损失仍是 20。这让调用方拿到的结果更接近“本次真正造成了多少生命值变化”,也避免把溢出部分误算进统计。
处理死亡与多人边界
死亡是一次状态转换,不应该只是每次发现 CurrentHealth <= 0 就重新播放逻辑。bDead 既保护 TakeDamage,也保证 Die() 只执行一次;实际项目可以在 Die() 中继续触发死亡动画、掉落、计分或重生计时,但这些动作都应建立在同一个死亡状态上。
多人游戏里,生命值与死亡判定应由服务器决定,再把权威结果同步给客户端。不要让客户端自己调用扣血并把结果当成最终状态;客户端更适合负责输入、命中特效和 UI 表现。后续若需要护甲、无敌帧、伤害类型或暴击,可把它们放在 TakeDamage 内计算“有效伤害”,而不改变统一入口和死亡判定的整体结构。