游戏引擎 / 系统课时

建立血量与伤害流程

建立血量与伤害流程

战斗循环最容易失控的地方不是扣一次血,而是让投射物、近战、陷阱等不同来源都走同一入口,并保证生命值不会越界、死亡只触发一次。本课用 UE5 的 Damage 入口集中处理扣血,再把死亡判定固定在生命值更新之后。

学习目标

  • 能区分“发起伤害”和“接收伤害”两侧的职责。
  • 能在 TakeDamage 中统一执行扣血、范围限制和死亡判定。
  • 能验证普通伤害、致死伤害和重复伤害不会破坏角色状态。

把伤害入口和生命值职责分开

攻击方只负责描述“对谁造成多少伤害”,不应直接修改目标的 CurrentHealth。这样子弹、近战和环境伤害都可以调用同一个入口,目标角色再在自己的 TakeDamage 中决定实际扣除多少、是否死亡,以及后续要触发哪些反馈。

最小流程是:攻击行为调用 UGameplayStatics::ApplyDamage,引擎把伤害交给目标 Actor 的 TakeDamage,目标先计算实际伤害,再把生命值限制在 0 到 MaxHealth,最后检查是否第一次进入死亡状态。多人游戏中,这条权威流程应运行在服务器。

伤害入口到死亡判定的统一流程

实现统一扣血流程

下面是片段示例:把类加入启用 C++ 的 UE5 项目。DealDamageTo 模拟任意攻击来源调用伤害入口,TakeDamage 是统一接收点;bDead 防止死亡逻辑重复执行,返回值表示这次真正损失的生命值。

cpp
// 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();
};
cpp
// 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 的生命值变化:

text
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 内计算“有效伤害”,而不改变统一入口和死亡判定的整体结构。

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

目录与阅读设置

阅读设置

17

记录一个想法

建立血量与伤害流程

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

登录哪都通