struct

NavAgentComponent

An entity that moves itself toward a destination using the navigation system. The agent's TransformComponent.position is steered each tick; it doesn't interact with physics rigid bodies directly (that's a separate "physics-driven nav agent" pattern, deferred).

Module
AINavigation
Header
#include "AINavigation/NavAgentComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Phase-1 movement: straight-line steering at speed m/s. Once Recast is vendored the system replaces this with a Detour-pathed sequence of waypoints + smooth corner following + dynamic avoidance. The component surface stays the same — gameplay code that just calls SetDestination won't need to change when the upgrade lands.

Properties

TypeNameDescription
boolenabledDefault true.
floatspeedDefault 3.5f.
floatangularSpeedDefault 360.0f.
floatstoppingDistanceDefault 0.1f.
floatradiusDefault 0.5f.
floatheightDefault 1.8f.
std::stringagentTypeWhich baked agent type (navmesh) this agent plans on. Empty picks the smallest baked radius the agent's Radius fits.
uint32_tincludeFlagsDefault 0xFFFF.
uint32_texcludeFlagsDefault 0.
std::vector<float>areaCostScale
int32_tnavFilterSlotDefault 0.
boolonSmartLinkDefault false.
uint64_tsmartLinkEntityDefault 0.
int32_tnavLaneThe crowd lane NavAgentSystem put the agent in (-1 = none). Default -1.
boolhasDestinationDefault false.
Vec3destinationDefault Vec3(0, 0, 0).
boolarrivedDefault false.
Vec3desiredVelocityDefault Vec3(0, 0, 0).

Constructors

SignatureNameDescription
NavAgentComponent() = defaultNavAgentComponent

Function details

C++
NavAgentComponent() = default
Generated from AINavigation/NavAgentComponent.h via ainavigation.json · Oct 27, 2026Version 1.0.0