class

NavMeshObstacleSystem

Per-frame sync between NavMeshObstacleComponent entities and the scene's dtTileCache. When a baked nav mesh has dynamicObstacles enabled, this system:

Module
AINavigation
Header
#include "AINavigation/NavMeshObstacleSystem.h"
Namespace
Mowo
  • Adds an obstacle to the cache the first time it sees a component (or first time it sees one whose registered flag is false). - Re-adds (remove + add — dtTileCache has no "move") when the host entity teleported more than kObstacleMoveEpsilon from where the obstacle was last anchored. - Removes when the component is disabled or the entity is gone. - Calls dtTileCache::update(dt, navMesh) once per frame so pending adds/removes apply incrementally without blocking the main thread.

With no nav mesh or with dynamicObstacles=false, the system early- outs every tick — leaving NavMeshObstacleComponents inert.

Public functions

ReturnsNameDescription
voidInitialize
voidShutdown
voidUpdate
voidSetNavMeshWired by Scene::SetNavMesh — same pattern as NavAgentSystem.
Ref<NavMeshAsset>GetNavMesh

Function details

Initialize

C++
void Initialize(World* world) override

Shutdown

C++
void Shutdown() override

Update

C++
void Update(float deltaTime) override

SetNavMesh

C++
void SetNavMesh(Ref<NavMeshAsset> nav)

Wired by Scene::SetNavMesh — same pattern as NavAgentSystem.

GetNavMesh

C++
Ref<NavMeshAsset> GetNavMesh() const
Generated from AINavigation/NavMeshObstacleSystem.h via ainavigation.json · Oct 27, 2026Version 1.0.0