View source for GetMonsterState

<!-- This page is generated automatically from the function definition: getMonsterState. -->
= getMonsterState =
Returns a monster's current server-owned AI/action state.

== Syntax ==
<syntaxhighlight lang="lua">
string getMonsterState(string monsterId)
</syntaxhighlight>

== Parameters ==
{| class="wikitable"
! Name !! Type !! Required !! Description
|-
| <code>monsterId</code> || <code>string</code> || yes || The opaque decimal monster identifier returned by <code>spawnMonster</code> or <code>getMonsters</code>.
|}

== Returns ==
Returns the current state string, or <code>missing</code> for an invalid identifier.

== Examples ==
Check whether a monster is dead:
<syntaxhighlight lang="lua" line>
if getMonsterState(monsterId) == "dead" then
    outputDebugString("Monster defeated")
end
</syntaxhighlight>

== Notes ==
* Available only in server-side resource scripts.
* State names are presentation-friendly observations; scripts should use <code>isMonsterAlive</code> for life-state decisions.

[[Category:Lua Functions]]
[[Category:Server Functions]]
[[Category:World Functions]]
[[Category:Monster Functions]]