OnClientPedWasted: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Killer element type)
m (params)
 
Line 6: Line 6:
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart, float loss / bool stealth
element killer, int weapon, int bodypart, mixed lossOrStealth
</syntaxhighlight>  
</syntaxhighlight>  


Line 13: Line 13:
*'''bodypart''': An [[int|integer]] representing the bodypart the player was damaged.
*'''bodypart''': An [[int|integer]] representing the bodypart the player was damaged.
{{BodyParts}}
{{BodyParts}}
*'''loss''': A [[float]] representing the percentage of health the ped lost in the final "hit". ''Note: Only for client-side created peds.''
*'''lossOrStealth''': A [[float]] representing the percentage of health the ped lost in the final "hit" (''only for client-side created peds.'') or a [[boolean]] representing whether or not this was a stealth kill
'''OR'''
*'''stealth''': A [[boolean]] representing whether or not this was a stealth kill.


==Source==
==Source==

Latest revision as of 12:23, 31 May 2025

This event is triggered whenever a ped dies.

Parameters

element killer, int weapon, int bodypart, mixed lossOrStealth
  • 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
  • lossOrStealth: A float representing the percentage of health the ped lost in the final "hit" (only for client-side created peds.) or a boolean representing whether or not this was a stealth kill

Source

The source of this event is the ped that died.

Example

Click to collapse [-]
Client

This example outputs a message every time a player kills another player.

-- define the event handler function
function onWasted(killer, weapon, bodypart)
    if ( killer and getElementType(killer) == "player" and getElementType(source) == "player" ) then
        outputChatBox(getPlayerName(killer).." has killed ".. getPlayerName(source) ..".") -- output the kill message to the chatbox.
    end
end

-- add the event handler
addEventHandler("onClientPedWasted", getRootElement(), onWasted)

See Also

Client ped events


Client event functions