https://g1r-mp.com/wiki/index.php?action=history&feed=atom&title=UpdateAiNavigationBlockerUpdateAiNavigationBlocker - Revision history2026-09-19T06:22:15ZRevision history for this page on the wikiMediaWiki 1.46.0https://g1r-mp.com/wiki/index.php?title=UpdateAiNavigationBlocker&diff=756&oldid=prevQCherry: Document G1R:MP 0.1.2 navigation collision API2026-09-04T13:52:37Z<p>Document G1R:MP 0.1.2 navigation collision API</p>
<p><b>New page</b></p><div>= updateAiNavigationBlocker =<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 />
Atomically replaces the geometry of a resource-owned navigation blocker.<br />
<br />
== Syntax ==<br />
<syntaxhighlight lang="lua"><br />
bool updateAiNavigationBlocker(string blockerId, table definition)<br />
</syntaxhighlight><br />
<br />
== Parameters ==<br />
{| class="wikitable"<br />
! Name !! Type !! Required !! Description<br />
|-<br />
| <code>blockerId</code> || <code>string</code> || yes || The opaque decimal identifier returned by <code>createAiNavigationBlocker</code>. Keep it as a string.<br />
|-<br />
| <code>definition</code> || <code>table</code> || yes || A validated <code>box</code>, <code>cylinder</code>, or convex <code>polygon</code> definition in metres.<br />
|}<br />
<br />
== Returns ==<br />
Returns <code>true</code> when the ID, ownership and complete replacement definition are valid; otherwise returns <code>false</code> and keeps the previous geometry.<br />
<br />
== Examples ==<br />
Move and resize an existing blocker:<br />
<syntaxhighlight lang="lua" line><br />
updateAiNavigationBlocker(blockerId, {<br />
shape = "cylinder",<br />
x = 130.0, y = -45.0, z = 2.0,<br />
radius = 1.5, height = 4.0,<br />
})<br />
</syntaxhighlight><br />
<br />
== Notes ==<br />
* Available only in server-side resource scripts.<br />
* The accepted shape and unit contract is identical to <code>createAiNavigationBlocker</code>.<br />
* Omitting <code>enabled</code> preserves the current enabled state. Supplying it applies the new geometry and requested state together.<br />
* A successful material change records a bounded spatial revision. Only affected active paths are revalidated, and relevant removals wake previously blocked paths.<br />
* Use updates for occasional world-state changes, not per-tick animation. Moving characters are handled by the mandatory dynamic capsule layer.<br />
<br />
[[Category:Lua Functions]]<br />
[[Category:Server Functions]]<br />
[[Category:World Functions]]<br />
[[Category:Navigation Functions]]</div>QCherry