DestroyAiNavigationBlocker

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 13:52, 4 September 2026 by QCherry (talk | contribs) (Document G1R:MP 0.1.2 navigation collision API)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

destroyAiNavigationBlocker

AVAILABLE FROM UPDATE 0.1.2
This function is available in G1R:MP 0.1.2 and later. The contract below includes the compatibility guarantees introduced in that update.

Permanently removes one resource-owned navigation blocker.

Syntax

bool destroyAiNavigationBlocker(string blockerId)

Parameters

Name Type Required Description
blockerId string yes The opaque decimal identifier returned by createAiNavigationBlocker. Keep it as a string.

Returns

Returns true when the owned blocker is removed; otherwise returns false.

Examples

Remove a temporary encounter wall:

destroyAiNavigationBlocker(blockerId)
blockerId = nil

Notes

  • Available only in server-side resource scripts.
  • Removing a blocker wakes previously blocked paths only when its former bounds could affect their search. The identifier is not reused during the server process.
  • Resources do not need to destroy blockers during shutdown; ownership cleanup removes every remaining blocker automatically.