Function GetActorHealth get the health of an actor.
Function GetActorHealth was added in 0.3.7 and will not work in earlier versions!

(actorid, &Float:health)
int 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.

Return Values:
  • 1 - success
  • 0 - failure (i.e. actor is not created).
  • NOTE: The actor's health is stored in the specified variable, not in the return value.

new MyActor;
public OnGameModeInit()
    MyActor = CreateActor(179, 316.1, -134.0, 999.6, 90.0); // Actor as salesperson in Ammunation
    SetActorHealth(MyActor, 100);
    new Float:actorHealth;
    GetActorHealth(MyActor, actorHealth);
    printf("Actor ID %d has %.2f health.", MyActor, actorHealth);
    return 1;

Related Functions
The following functions may be useful, as they are related to this function in one way or another.

Related Callbacks
The following callbacks might be useful as well, as they are related to this callback in one way or another.