OnClientPlayerWasted: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Add correct type for the new arguments (animGroup & animID))
(Add beta header)
 
(One intermediate revision by the same user not shown)
Line 4: Line 4:


==Parameters==
==Parameters==
{{New feature/item|3.0161|1.6.0|22620|
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart, bool stealth, int animGroup, int animID
</syntaxhighlight>
}}
{{Deprecated_feature|3|1.0|<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart, bool stealth
element killer, int weapon, int bodypart, bool stealth
</syntaxhighlight>  
</syntaxhighlight>}}


*'''killer''': A [[player]], [[ped]] or [[vehicle]] [[element]] representing the killer.
*'''killer''': A [[player]], [[ped]] or [[vehicle]] [[element]] representing the killer.
Line 13: Line 19:
{{BodyParts}}
{{BodyParts}}
*'''stealth''': A [[boolean]] representing whether or not this was a stealth kill.
*'''stealth''': A [[boolean]] representing whether or not this was a stealth kill.
*'''animGroup''': A [[int|integer]] representing the player's current animation group.
{{New feature/item|3.0161|1.6.0|22620|
*'''animID''': A [[int|integer]] representing the player's current animation ID.
*'''animGroup''': an [[int|integer]] representing the player's current animation group.
}}
{{New feature/item|3.0161|1.6.0|22620|
*'''animID''': an [[int|integer]] representing the player's current animation ID.
}}


==Source==
==Source==

Latest revision as of 21:03, 15 July 2024

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

Parameters

ADDED/UPDATED IN VERSION 1.6.0 r22620:
element killer, int weapon, int bodypart, bool stealth, int animGroup, int animID
  • 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.
ADDED/UPDATED IN VERSION 1.6.0 r22620:
  • animGroup: an integer representing the player's current animation group.
ADDED/UPDATED IN VERSION 1.6.0 r22620:
  • animID: an integer 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


Client event functions