1. Epic GamesDeveloper
  3. Navigation System

Navigation System

Reference for the Navigation System section of the Unreal Engine Project Settings.

Navigation System
This page is not available in the language you have chosen. It will be displayed in English by default. If you would like to view it in a different language, you can try selecting another language.
Section Description
Default Agent Name

If not None, indicates which of the Navigation Data and supported agents are going to be used as the default ones.

If a navigation agent of this type does not exist or is not enabled, then the first available Navigation Data will be used as default.
Crowd Manager Class

Crowd manager class.

You can choose from the following options:

  • None
  • Crowd Manager
Section Description
Auto Create Navigation Data Specifies whether the navigation system should spawn default Navigation Data when there's none and there are navigation bounds present.
Spawn Nav Data in Nav Bounds Level

If enabled, will try to spawn the Navigation Data instance in the sublevel with navigation bounds.

If disabled, it will spawn in the persistent level.
Allow Client Side Navigation If disabled, will not create a nav collision when connecting as a client.
Should Discard Sub Level Nav Data If enabled, games should ignore Navigation Data inside loaded sublevels.
Tick While Paused If enabled, will update navigation even when the game is paused.
Initial Building Locked

If enabled, will result in the navigation system not rebuilding navigation until a call to ReleaseInitialBuildingLock() is made.

Does not influence editor-time generation (that is, it only influences PIE and Game).

Disabled by default.
Skip Agent Height Check when Picking Nav Data

Disabled by default.

If enabled, nav agent height will be ignored when trying to match Navigation Data to passed in the nav agent.
Data Gathering Mode

Sets how Navigation Data should be gathered when building collision information.

You can choose from the following options:

  • Instant
  • Lazy
Dirty Areas Update Freq Dirty areas update frequency.
Dirty Area Warning Size Threshold

-1.0 by default.

If set to a positive value, dirty areas with any dimensions in 2D over the threshold created at runtime will be logged.
Gathering Nav Modifiers Warning Limit Time

-1.0 by default.

If set to a positive value, all calls to GetNavigationData will be timed and compared to it.

Calls that go over the limit will be logged as a warning.

This value is in seconds.

This setting is meant for non-shipping builds only.
Section Description
Generate Navigation Only Around Navigation Invokers

If set to true, navigation will be generated only around registered "navigation enforcers".

This has a range of consequences (including how navigation octree operates) so it needs to be a conscious decision.

Enabling this option will make the whole world navigable.
Active Tiles Update Interval Minimal time, in seconds, between active tiles set update.

Agents

Section Description
Supported Agents List of agent types supported by navigation system.
Supported Agents Mask

NavigationSystem's properties in Project Settings define all possible supported agents, but a specific navigation system can choose to support only a subset of agents.

Set via NavigationSystemConfig.

Ask questions and help your peers Developer Forums

Write your own tutorials or read those from others Learning Library

On this page