OnClientPedWasted: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (added info about death reasons)
m (params)
 
(9 intermediate revisions by 6 users not shown)
Line 6: Line 6:
==Parameters==
==Parameters==
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
element killer, int weapon, int bodypart
element killer, int weapon, int bodypart, mixed lossOrStealth
</syntaxhighlight>  
</syntaxhighlight>  


*'''killer''': A [[player]] [[element]] representing the killer.
*'''killer''': A [[player]], [[ped]] or [[vehicle]] [[element]] representing the killer.
*'''weapon''': An integer representing the [[Weapons|killer weapon]] or the [[Death Reasons|death reason]].
*'''weapon''': An [[int|integer]] representing the [[Weapons|killer weapon]] or the [[Damage Types|damage types]].
*'''bodypart''': An integer representing the bodypart the player was damaged.
*'''bodypart''': An [[int|integer]] representing the bodypart the player was damaged.
{{BodyParts}}
{{BodyParts}}
*'''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==
==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that died.
The [[event system#Event source|source]] of this event is the [[ped]] that died.


==Example==  
==Example==
<section name="Client" class="client" show="true">
This example outputs a message every time a player kills another player.
<syntaxhighlight lang="lua">
-- 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)
</syntaxhighlight>
</section>


==See Also==
==See Also==

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