GetMonsterData: Difference between revisions
Jump to navigation
Jump to search
Document Lua APIs available or improved from G1R:MP 0.1.2 |
Document G1R:MP 0.1.2 navigation collision API |
||
| Line 20: | Line 20: | ||
== Returns == | == Returns == | ||
Returns a table containing <code>id</code>, <code>type</code>, <code>name</code>, <code>nameplateIdVisible</code>, <code>x</code>, <code>y</code>, <code>z</code>, <code>yaw</code>, <code>health</code>, <code>maxHealth</code>, <code>attackDamage</code>, <code>state</code>, <code>targetPlayerId</code>, <code>aggressive</code>, <code>alive</code>, and <code> | Returns a table containing <code>id</code>, <code>type</code>, <code>name</code>, <code>nameplateIdVisible</code>, <code>x</code>, <code>y</code>, <code>z</code>, <code>yaw</code>, <code>health</code>, <code>maxHealth</code>, <code>attackDamage</code>, <code>state</code>, <code>targetPlayerId</code>, <code>aggressive</code>, <code>alive</code>, <code>navigationMode</code>, and <code>navigationCollisionMode</code>; otherwise returns <code>false</code>. | ||
== Examples == | == Examples == | ||
| Line 33: | Line 33: | ||
== Notes == | == Notes == | ||
* Available only in server-side resource scripts. | * Available only in server-side resource scripts. | ||
* Position values use metres and yaw uses degrees. <code>navigationMode</code> is <code>"builtin"</code> or <code>"scripted"</code>. | * Position values use metres and yaw uses degrees. <code>navigationMode</code> is <code>"builtin"</code> or <code>"scripted"</code>; <code>navigationCollisionMode</code> is <code>"combined"</code>, <code>"builtin"</code>, or <code>"custom"</code>. | ||
[[Category:Lua Functions]] | [[Category:Lua Functions]] | ||
Latest revision as of 13:52, 4 September 2026
getMonsterData
IMPROVED FROM UPDATE 0.1.2
This function is available in earlier releases and has corrected or expanded behavior in G1R:MP 0.1.2 and later. The contract below describes the updated behavior.
Returns the complete authoritative state of a server-owned monster.
Syntax
table|false getMonsterData(string monsterId)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
monsterId |
string |
yes | The opaque decimal monster identifier returned by spawnMonster or getMonsters.
|
Returns
Returns a table containing id, type, name, nameplateIdVisible, x, y, z, yaw, health, maxHealth, attackDamage, state, targetPlayerId, aggressive, alive, navigationMode, and navigationCollisionMode; otherwise returns false.
Examples
Inspect a monster:
local monster = getMonsterData(monsterId)
if monster then
outputDebugString(monster.type .. " HP: " .. monster.health .. "/" .. monster.maxHealth)
end
Notes
- Available only in server-side resource scripts.
- Position values use metres and yaw uses degrees.
navigationModeis"builtin"or"scripted";navigationCollisionModeis"combined","builtin", or"custom".