OnClientPlayerWasted: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
m (Using predefined variables in "Example" code) |
||
| (8 intermediate revisions by 8 users not shown) | |||
| Line 1: | Line 1: | ||
__NOTOC__ | |||
{{Client event}} | |||
This event is triggered whenever a player, including those remote, dies. | |||
==Parameters== | |||
== | |||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
element killer, int weapon, int bodypart, bool stealth | |||
</syntaxhighlight> | </syntaxhighlight> | ||
*'''killer''': A [[player]], [[ped]] or [[vehicle]] [[element]] representing the killer. | |||
*'''weapon''': An [[int|integer]] representing the [[Weapons|killer weapon]] or the [[Damage Types|damage types]]. | |||
*'''bodypart''': An [[int|integer]] representing the bodypart the player was damaged. | |||
{{BodyParts}} | |||
*'''stealth''': A [[boolean]] representing whether or not this was a stealth kill. | |||
==Source== | |||
The [[event system#Event source|source]] of this event is the [[player]] that died. | |||
==Example== | ==Example== | ||
This example | This example outputs a mocking message when the local player dies. | ||
<syntaxhighlight lang="lua"> | <syntaxhighlight lang="lua"> | ||
-- | 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) | |||
</syntaxhighlight> | </syntaxhighlight> | ||
==See Also== | |||
===Client player events=== | |||
{{Client_player_events}} | |||
===Client event functions=== | |||
{{Client_event_functions}} | |||
Latest revision as of 11:22, 27 June 2023
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.
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
Shared
- addEvent
- addEventHandler
- cancelEvent
- cancelLatentEvent
- getEventHandlers
- getLatentEventHandles
- getLatentEventStatus
- removeEventHandler
- triggerEvent
- wasEventCancelled