Up to date
This page is up to date for Godot
If you still find outdated information, please open an issue.
Navigation Debug Tools¶
The debug tools, properties and functions are only available in Godot debug builds. Do not use any of them in code that will be part of a release build.
Enabling debug navigation¶
The navigation debug visualization is enabled by default inside the Editor.
To visualize navigation meshes and connections also at runtime
enable the option
Visible Navigation in the editor debug menu.
In Godot debug builds the navigation debug can also be toggled on the NavigationServers from scripts.
Debug navigation settings¶
The appearance of navigation debug can be change in the ProjectSettings under
Certain debug features can also be enabled or disabled at will but may require a scene restart to apply.
Debug navigation mesh polygons¶
enable_edge_lines is enabled the edges of navigation mesh polygons will be highlighted.
enable_edge_lines_xray is also enabled the edges of navigationmeshes will be visible through geometry.
enable_geometry_face_random_color is enabled each navigation mesh face receives
a random color that is mixed with the main color from
Debug edge connections¶
Different navigation meshes connected within
edge_connection_margin distance are overlaid.
The color of the overlay is controlled with the navigation debug
The connections can be made visible through geometry with the navigation debug
Edge connections are only visible when the NavigationServer is active.
To measure NavigationServer performance a dedicated monitor exists that can be found within the Editor Debugger under Debugger->Monitors->NavigationProcess.
NavigationProcess shows how long the NavigationServer spends updating its internals this update frame in milliseconds. NavigationProcess works similar to Process for visual frame rendering and PhysicsProcess for collision and fixed updates.
NavigationProcess accounts for all updates to
navigation regions and
navigation agents as well as all the