OnClientPlayerWasted

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

Parameters

element killer, int weapon, int bodypart, bool stealth

• 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: A number representing the player's current animation group.
• animID: A number representing the player's current animation ID.

Source

The source of this event is the player that died.

Example

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

Client player events

• onClientPlayerChangeNick
• onClientPlayerChoke
• onClientPlayerDamage
• onClientPlayerHeliKilled
• onClientPlayerHitByWaterCannon
• onClientPlayerJoin
• onClientPlayerPickupHit
• onClientPlayerPickupLeave
• onClientPlayerQuit
• onClientPlayerRadioSwitch
• onClientPlayerSpawn
• onClientPlayerStealthKill
• onClientPlayerStuntFinish
• onClientPlayerStuntStart
• onClientPlayerTarget
• onClientPlayerVehicleEnter
• onClientPlayerVehicleExit
• onClientPlayerVoicePause
• onClientPlayerVoiceResumed
• onClientPlayerVoiceStart
• onClientPlayerVoiceStop
• onClientPlayerWasted
• onClientPlayerWeaponFire
• onClientPlayerWeaponSwitch

Client event functions

• triggerLatentServerEvent
• triggerServerEvent


• Shared
• addEvent
• addEventHandler
• cancelEvent
• cancelLatentEvent
• getEventHandlers
• getLatentEventHandles
• getLatentEventStatus
• removeEventHandler
• triggerEvent
• wasEventCancelled