onPlayerDamage

Client-side

Server-side

Shared

This event is triggered when a player is damaged, in any way.

Parameters

player attacker, int damage_causing, int bodypart, float loss

attacker: a player element representing the player who was the attacker. If there was no attacker this returns false.

damage_causing: an int representing the cause of damage, either a attacker weapon, or some other types of damage.

bodypart: an int representing the bodypart ID the player was hit on when he got damaged. 3: Torso 4: Ass 5: Left Arm 6: Right Arm 7: Left Leg 8: Right Leg 9: Head

loss: a float representing the percentage of health the player lost.

Source

element: The source of this event is the player who was damaged.

Code Examples

server

This example causes an instant kill when a player is shot in the head, and announces it in the chatbox.

function playerDamage_text ( attacker, weapon, bodypart, loss ) --when a player is damaged
  if ( bodypart == 9 and attacker and attacker ~= source ) then -- if the body part is 9 (head) and there is an attacker and it wasn't self damage
            outputChatBox ( "Headshot!", attacker, 255, 170, 0 ) --output "Headshot" into the chatbox
      killPed ( source, attacker, weapon, bodypart ) -- and kill the player
  end
end
addEventHandler ( "onPlayerDamage", root, playerDamage_text ) --add an event handler for the onPlayerDamage event

onPlayerDamage

Parameters

Source

Code Examples

See Also

Player Events

Player Functions

Reference