SetPlayerArmour

Description:

Set a player's armor level.

Parameters:

(playerid, Float:armour)

playerid

The ID of the player to set the armour of.

Float:armour

The amount of armour to set, as a percentage (float). Values larger than 100 are valid, but won't be displayed in the HUD's armour bar.

Return Values:

1: The function executed successfully.
0: The function failed to execute. This means the player specified does not exist.

Important
Note

Armour is obtained rounded to integers: set 50.15, but get 50.0

Note

The function's name is armour, not armor (Americanized). This is inconsistent with the rest of SA-MP, so remember that.

Example Usage:

public OnPlayerSpawn(playerid)
{
    // Give players full armour (100%) when they spawn.
    SetPlayerArmour(playerid, 100.0);
    return 1;
}

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