https://g1r-mp.com/wiki/index.php?action=history&feed=atom&title=SetMonsterIdVisibleSetMonsterIdVisible - Revision history2026-09-19T06:25:36ZRevision history for this page on the wikiMediaWiki 1.46.0https://g1r-mp.com/wiki/index.php?title=SetMonsterIdVisible&diff=705&oldid=prevQCherry: Document Lua APIs available or improved from G1R:MP 0.1.22026-09-03T18:40:06Z<p>Document Lua APIs available or improved from G1R:MP 0.1.2</p>
<p><b>New page</b></p><div>= setMonsterIdVisible =<br />
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"><br />
<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE FROM UPDATE 0.1.2</div><br />
<div style="color:#111111; margin-top:0.25rem;">This function is available in G1R:MP 0.1.2 and later. The contract below includes the compatibility guarantees introduced in that update.</div><br />
</div><br />
<br />
Shows or hides the numeric identifier in a resource-owned monster's nameplate.<br />
<br />
== Syntax ==<br />
<syntaxhighlight lang="lua"><br />
bool setMonsterIdVisible(string monsterId, bool visible)<br />
</syntaxhighlight><br />
<br />
== Parameters ==<br />
{| class="wikitable"<br />
! Name !! Type !! Required !! Description<br />
|-<br />
| <code>monsterId</code> || <code>string</code> || yes || The opaque decimal monster identifier returned by <code>spawnMonster</code> or <code>getMonsters</code>.<br />
|-<br />
| <code>visible</code> || <code>bool</code> || yes || True to show the numeric monster ID or false to hide it.<br />
|}<br />
<br />
== Returns ==<br />
Returns <code>true</code> when the visibility change is accepted and replicated; otherwise returns <code>false</code>.<br />
<br />
== Examples ==<br />
Keep a monster's display name but hide its technical identifier:<br />
<syntaxhighlight lang="lua" line><br />
setMonsterName(monsterId, "Cave Guardian")<br />
setMonsterIdVisible(monsterId, false)<br />
</syntaxhighlight><br />
<br />
== Notes ==<br />
* Available only in server-side resource scripts.<br />
* Only the resource that created the monster may change this field.<br />
* The state is exposed as <code>getMonsterData(monsterId).nameplateIdVisible</code> and replayed during relevance entry and late join.<br />
* When the value changes, the server emits <code>onMonsterIdVisibilityChange(monsterId, previousVisible, visible, sourceResource)</code>. Repeating the current value remains a successful no-op and does not emit the event.<br />
* <code>setMonsterNameplateIdVisible</code> is a compatibility alias for this function; use <code>setMonsterIdVisible</code> in new resources.<br />
<br />
[[Category:Lua Functions]]<br />
[[Category:Server Functions]]<br />
[[Category:World Functions]]<br />
[[Category:Monster Functions]]</div>QCherry