Skip to content

Latest commit

 

History

History
45 lines (32 loc) · 2.06 KB

index.md

File metadata and controls

45 lines (32 loc) · 2.06 KB

Navigation

Navigation

Flax supports navigation and pathfinding utilities that can be used across various types of games. You can use navigation system to control how AI characters and other objects navigate around game evironment without colliding with the walls and avoiding obstacles.

Nav Mesh

Nav Mesh

Navigation meshes (shorten as navmeshes) are polygon surfaces that define the 'walkable' area of the scene. They are used to query paths for objects to navigate around the game level. Flax supports both runtime generated navmesh and prebuild in Editor. The navmesh building process is asynchronious and does not block game logic thread. Progress reporting is also supported.

Under the hood, navigation mesh is split into tiles that are stored per scene. When you game loads a given scene, engine will stream the navigation mesh tiles into one big Nav Mesh object that is used to perform navigation queries including pathfinding. This allows to split huge worlds into smaller scenes and stream them at runtime while navigation agents will still work ina proper way.

Queries and Pathfinding

Navigation system exposes a unified API for performing navigation queries via C# API. Here is an example script that finds the closest navmesh wall nearby the parent object location.

public class TestFindDistanceToWall : Script
{
    public override void OnUpdate()
    {
        if (Navigation.FindDistanceToWall(Actor.Position, out var hit))
        {
            DebugDraw.DrawCircle(Actor.Position, Vector3.Up, hit.Distance, Color.Red);
            DebugDraw.DrawLine(hit.Position, hit.Position + hit.Normal * 150.0f, Color.BlueViolet);
        }
    }
}

In this section

Tutorials