onClientPlayerDamage | Multi Theft Auto: Wiki Skip to content

onClientPlayerDamage

Client-side

Server-side

Shared

This event is triggered whenever a player is damaged.

This event is only triggered for players that are streamed in

Parameters

element attacker, int damage_causing, int bodypart, float loss

attacker: A player element representing the attacker or vehicle element (when being run over or falling off a bike).

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

bodypart: An integer representing the bodypart the player was 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 that got damaged. (Streamed in players only)

Canceling

If this event is canceled, then any damaging effects to the local player will cease.

Code Examples

client

This example prevents any damage from the minigun.

function stopMinigunDamage(attacker, weapon, bodypart)
  if (weapon == 38) then --if the weapon used was the minigun
    cancelEvent() --cancel the event
  end
end
addEventHandler("onClientPlayerDamage", localPlayer, stopMinigunDamage)

See Also

Player Events

Player Functions

Reference

Scripting Events