View source for OnClientObjectDamage

__NOTOC__
{{Client event}}
This event is fired before an object gets damaged.
{{Note|This event is only triggered for objects that are streamed in.}}
==Parameters==
<syntaxhighlight lang="lua">
float loss, element attacker
</syntaxhighlight>
*'''loss:''' the health loss caused by the damage. This parameter contains the theoretical loss, which could be less than 0, if you substract it of the current health. If you want to get the real loss, you have to substract the new health of the old health (use a timer for this).
*'''attacker:''' the vehicle/ped/player who is damaging the object.

==Source==
The source of this event is the object which was damaged.

==Cancel effect==
If this event is [[Event system#Canceling|canceled]], the object will not be damaged.

==Example==
This example outputs the theoretical and real loss:
<syntaxhighlight lang="lua">
function outputLoss(loss)
    local oldHealth = getElementHealth(source)
    setTimer(function(source)
        local newHealth = getElementHealth(source)
        outputChatBox("Real loss: "..(newHealth-oldHealth))
        outputChatBox("Theoretical loss: "..loss)
    end,100,1,source)
end
addEventHandler("onClientObjectDamage", root, outputLoss)
</syntaxhighlight>

==Requirements==
{{Requirements|n/a|1.3-9.05086|}}

==See Also==
===Client object events===
{{Client_object_events}}
===Client event functions===
{{Client_event_functions}}