GetVehicleHealth

GetVehicleHealth

Description:

Function GetVehicleHealth get the health of a vehicle.

Full vehicle health is 1000, however higher values are possible and increase the health of the vehicle. For more information on health values, see here.

A vehicle catches on fire when its health is below 250. It will explode a few seconds later.

Parameters:

(vehicleid, &Float:health)

int

vehicleid

The ID of the vehicle to get the health of.

float

health

A float variable in which to store the vehicle's health, passed by reference.

Return Values:

• 1 - success
• 0 - failure (invalid vehicle ID).
• The vehicle's health is stored in the referenced variable, not in the return value.

Examples:

Example 1

if(strcmp(cmdtext, "/repair", true) == 0)
{
    new Float:health;
    new veh = GetPlayerVehicleID(playerid);
    GetVehicleHealth(veh, health);
    if(health > 500) return SendClientMessage(playerid, COLOR_RED, "Vehicle doesn't need repairing!");
    SetVehicleHealth(veh, 1000);
    SendClientMessage(playerid, COLOR_GREEN, "Vehicle repaired!");
}

Related Functions

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

• SetVehicleHealth: Set the health of a vehicle.
• GetPlayerHealth: Find out how much health a player has.
• GetPlayerArmour: Find out how much armour a player has.