onClientPlayerWasted | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

onClientPlayerWasted

Client-side
Server-side
Shared

This event is triggered whenever a player, including those remote, dies.

Parameters

element killer, int weapon, int bodypart, bool stealth, int animGroup, int animID
  • killer: A player, ped or vehicle element representing the killer.
  • weapon: An integer representing the killer weapon or the damage types.
  • 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
  • stealth: A boolean representing whether or not this was a stealth kill.
  • animGroup: an integer representing the player's current animation group.
  • animID: an integer representing the player's current animation ID.

Source

element: The source of this event is the player that died.

Code Examples

client

This example outputs a mocking message when the local player dies.

local messages = {
  "Better luck next time",
  "Don't think you're so cool now, do you?",
  "Nice one, pal",
  "Your opinion is void"
}


-- add an event for the local player only
addEventHandler("onClientPlayerWasted", localPlayer, function(killer, weapon, bodyPart)
  local randomMessage = messages[math.random(#messages)] -- get a random message from the table
  outputChatBox(randomMessage, 255, 0, 0) -- output the message
end)

See Also

Player Events
Player Functions
Reference