AActor::TakeDamage

function Engine Since 4.0

#include "GameFramework/Actor.h"

Access: public Specifiers: virtual

Description

Entry point for applying damage to this actor. Override this in subclasses to implement health deduction, armor, shields, or any damage response logic.

Signature

virtual float TakeDamage(float DamageAmount, struct FDamageEvent const& DamageEvent, class AController* EventInstigator, AActor* DamageCauser)

Parameters

Name	Type	Description	Default
DamageAmount	float	The raw damage amount before any modifiers.	—
DamageEvent	struct FDamageEvent const&	Data package describing the type and properties of the damage.	—
EventInstigator	class AController*	The controller responsible for the damage (e.g. the shooter).	—
DamageCauser	AActor*	The actor that directly caused the damage (e.g. the projectile).	—

Return Type

float

Caveats & Gotchas

• The base implementation simply fires the AnyDamage Blueprint event. It does *not* track health — you must implement that yourself.
• Do not call damage logic directly; prefer UGameplayStatics::ApplyDamage or UGameplayStatics::ApplyPointDamage which route through TakeDamage and handle the EventInstigator correctly.
• The return value is the actual damage applied after modifiers — callers can use this to credit kills, etc.

Example

Basic health deduction override C++

float AMyCharacter::TakeDamage(float DamageAmount, FDamageEvent const& DamageEvent, AController* EventInstigator, AActor* DamageCauser)
{
    float ActualDamage = Super::TakeDamage(DamageAmount, DamageEvent, EventInstigator, DamageCauser);
    Health = FMath::Max(0.f, Health - ActualDamage);
    if (Health <= 0.f)
    {
        Die();
    }
    return ActualDamage;
}

Version History

Introduced in: 4.0

Version	Status	Notes
5.6	stable	—

Feedback

Was this helpful?