OnPedDamage: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
(Added onPedDamage event docs)
 
mNo edit summary
 
(5 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server event}}
{{Server event}}
This event is triggered when a ped is killed or dies. It is not triggered for players.
This event is triggered when a ped is damaged. For player damage, use [[onPlayerDamage]] instead.
{{Note|This event is not triggered prior to r21247.}}


==Parameters==
==Parameters==
<syntaxhighlight lang="lua">float healthDelta</syntaxhighlight>
<syntaxhighlight lang="lua">float loss</syntaxhighlight>
 
*'''deltaHealth''': an [[int]] representing the delta between old ped health and new health (oldHealth - newHealth).


*'''loss''': an [[int]] representing the percentage of health the ped lost.


==Source==
==Source==
The [[event system#Event source|source]] of this event is the [[ped]] that got damaged.
The [[event system#Event source|source]] of this event is the [[ped]] that got damaged.
==Cancel Effect==
Canceling this event has no effect. Cancel the client-side event [[onClientPedDamage]] instead.


==Example==
==Example==
This example outputs to the console that the ped is now dead.
This example outputs a message to the console when a specific ped is damaged.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
ped1 = createPed(112, 0, 0, 0) --Create our Ped
local ped1 = createPed(112, 0, 0, 0) -- create our ped
function onDamaged(delta)
 
     outputConsole("Your ped is damaged!")
function pedDamaged(loss)
    outputConsole("delta was: " .. tostring(delta)
     outputConsole("ped1 damaged! loss: " .. tostring(loss))
end
end
addEventHandler("onPedDamage", ped1, onDamaged) --Add the Event when ped1 dies
 
addEventHandler("onPedDamage", ped1, pedDamaged) -- triggered only when ped1 gets damaged
</syntaxhighlight>
</syntaxhighlight>


{{See also/Server event|Ped events}}
{{See also/Server event|Ped events}}

Latest revision as of 20:22, 31 May 2022

This event is triggered when a ped is damaged. For player damage, use onPlayerDamage instead.

[[{{{image}}}|link=|]] Note: This event is not triggered prior to r21247.

Parameters

float loss
  • loss: an int representing the percentage of health the ped lost.

Source

The source of this event is the ped that got damaged.

Cancel Effect

Canceling this event has no effect. Cancel the client-side event onClientPedDamage instead.

Example

This example outputs a message to the console when a specific ped is damaged. 

local ped1 = createPed(112, 0, 0, 0) -- create our ped

function pedDamaged(loss)
    outputConsole("ped1 damaged! loss: " .. tostring(loss))
end

addEventHandler("onPedDamage", ped1, pedDamaged) -- triggered only when ped1 gets damaged

See Also

Ped events


Event functions


Retrieved from "https://wiki.multitheftauto.com/wiki/OnPedDamage?oldid=74693"