QCherry: Update Lua event reference

2026-08-14T22:31:25Z

Update Lua event reference

New page

= onMonsterDamage =
Triggered after authoritative damage changes a monster's health.

== Availability ==
This event is available in '''server-side''' scripts.

== Callback signature ==
<syntaxhighlight lang="lua">
onMonsterDamage(monsterId, damage, healthAfter, sourcePlayerId, damageKind, sourceResource)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Description
|-
| <code>monsterId</code> || <code>string</code> || The damaged monster ID.
|-
| <code>damage</code> || <code>number</code> || Validated damage applied.
|-
| <code>healthAfter</code> || <code>number</code> || Authoritative health after damage.
|-
| <code>sourcePlayerId</code> || <code>int</code> || The attacking player ID, if any.
|-
| <code>damageKind</code> || <code>string</code> || Damage kind such as melee, bow, crossbow, spell, or script.
|-
| <code>sourceResource</code> || <code>string</code> || The resource associated with the damage.
|}

== Examples ==
Handle the event:
<syntaxhighlight lang="lua" line>
addEventHandler("onMonsterDamage", root, function(monsterId, damage, healthAfter, sourcePlayerId, damageKind, sourceResource)
outputDebugString("Monster " .. monsterId .. " has " .. healthAfter .. " HP")
end)
</syntaxhighlight>

== Notes ==
* Do not apply the same damage again from this observation event.

[[Category:Lua Events]]
[[Category:Server Events]]
[[Category:Monster Events]]

OnMonsterDamage - Revision history

QCherry: Update Lua event reference