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
| Type | Name | Description |
|---|---|---|
bool | enabled | Default true. |
float | speed | Default 3.5f. |
float | angularSpeed | Default 360.0f. |
float | stoppingDistance | Default 0.1f. |
float | radius | Default 0.5f. |
float | height | Default 1.8f. |
std::string | agentType | Which baked agent type (navmesh) this agent plans on. Empty picks the smallest baked radius the agent's Radius fits. |
uint32_t | includeFlags | Default 0xFFFF. |
uint32_t | excludeFlags | Default 0. |
std::vector<float> | areaCostScale | |
int32_t | navFilterSlot | Default 0. |
bool | onSmartLink | Default false. |
uint64_t | smartLinkEntity | Default 0. |
int32_t | navLane | The crowd lane NavAgentSystem put the agent in (-1 = none). Default -1. |
bool | hasDestination | Default false. |
Vec3 | destination | Default Vec3(0, 0, 0). |
bool | arrived | Default false. |
Vec3 | desiredVelocity | Default Vec3(0, 0, 0). |
Constructors
| Signature | Name | Description |
|---|---|---|
NavAgentComponent() = default | NavAgentComponent |
Function details
NavAgentComponent
C++
NavAgentComponent() = defaultGenerated from AINavigation/NavAgentComponent.h via ainavigation.json · Oct 27, 2026Version 1.0.0