note Help Needed

This wiki is the result of an ongoing community effort — thank you all for helping!

If you want to provide changes to this page then please click here.

GetActorHealth

warning

This function was added in SA-MP 0.3.7 and will not work in earlier versions!

Description

Get the health of an actor.

Name	Description
actorid	The ID of the actor to get the health of.
&Float:health	A float variable, passed by reference, in to which to store the actor's health.

Returns

true - success

false - failure (i.e. actor is not created).

NOTE: The actor's health is stored in the specified variable, not in the return value.

Examples

new gMyActor;

public OnGameModeInit()
{
    gMyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // Actor as salesperson in Ammunation
    
    SetActorHealth(gMyActor, 100.0);

    new Float:actorHealth;
    GetActorHealth(gMyActor, actorHealth);
    printf("Actor ID %d has %.2f health.", gMyActor, actorHealth);
    return 1;
}

Related Functions

CreateActor: Create an actor (static NPC).
SetActorHealth: Set the health of an actor.
SetActorInvulnerable: Set actor invulnerable.
IsActorInvulnerable: Check if actor is invulnerable.