OnClientPedWasted: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (params)
 
(8 intermediate revisions by 5 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==
Line 19: Line 20:
==Example==
==Example==
<section name="Client" class="client" show="true">
<section name="Client" class="client" show="true">
This example outputs when a player kills another player.
This example outputs a message every time a player kills another player.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- define the event handler function
-- define the event handler function
function onWasted(killer, weapon, bodypart)
function onWasted(killer, weapon, bodypart)
if killer then
    if ( killer and getElementType(killer) == "player" and getElementType(source) == "player" ) then
if getElementType(killer) == "player" then
        outputChatBox(getPlayerName(killer).." has killed ".. getPlayerName(source) ..".") -- output the kill message to the chatbox.
outputChatBox(getPlayerName(killer).." has killed ".. getPlayerName(source) ..".",thePlayer) -- output the kill message to the chatbox.
     end
     end
  end
end
end


-- add the event handler
-- add the event handler
addEventHandler("onClientPedWasted",getRootElement(),onWasted)
addEventHandler("onClientPedWasted", getRootElement(), onWasted)
</syntaxhighlight>
</syntaxhighlight>
</section>
</section>

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