https://g1r-mp.com/wiki/index.php?action=history&feed=atom&title=SetMonsterNavigationCollisionModeSetMonsterNavigationCollisionMode - Revision history2026-09-19T06:22:09ZRevision history for this page on the wikiMediaWiki 1.46.0https://g1r-mp.com/wiki/index.php?title=SetMonsterNavigationCollisionMode&diff=754&oldid=prevQCherry: Document G1R:MP 0.1.2 navigation collision API2026-09-04T13:52:33Z<p>Document G1R:MP 0.1.2 navigation collision API</p>
<p><b>New page</b></p><div>= setMonsterNavigationCollisionMode =<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 />
Selects which static navigation-collision layers a resource-owned monster uses.<br />
<br />
== Syntax ==<br />
<syntaxhighlight lang="lua"><br />
bool setMonsterNavigationCollisionMode(string monsterId, string mode)<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>mode</code> || <code>string</code> || yes || Case-sensitive collision source: <code>"combined"</code>, <code>"builtin"</code>, or <code>"custom"</code>.<br />
|}<br />
<br />
== Returns ==<br />
Returns <code>true</code> when the monster, ownership and mode are valid; otherwise returns <code>false</code>.<br />
<br />
== Examples ==<br />
Use only blockers created by this server's Lua resources:<br />
<syntaxhighlight lang="lua" line><br />
if setMonsterNavigationCollisionMode(monsterId, "custom") then<br />
setMonsterNavigationMode(monsterId, "scripted")<br />
end<br />
</syntaxhighlight><br />
<br />
== Notes ==<br />
* Available only in server-side resource scripts.<br />
* New monsters start in <code>"combined"</code> mode. <code>"combined"</code> uses the baked MainMap layer plus all enabled custom blockers, <code>"builtin"</code> uses only the baked layer, and <code>"custom"</code> uses only custom blockers.<br />
* The setting is independent from <code>setMonsterNavigationMode</code>: collision mode selects static blocker sources, while navigation mode selects built-in AI decisions or direct scripted goals.<br />
* Authoritative player, NPC and monster capsule separation always remains active. No collision mode grants client authority or permits characters to overlap.<br />
* Changing the mode clears cached paths and forces the server to validate movement against the new collision view. <code>getMonsterData</code> returns the current value as <code>navigationCollisionMode</code>.<br />
* Only the resource that created the monster may change this setting.<br />
<br />
[[Category:Lua Functions]]<br />
[[Category:Server Functions]]<br />
[[Category:World Functions]]<br />
[[Category:Monster Functions]]<br />
[[Category:Navigation Functions]]</div>QCherry