Unity 3D AI: NavMesh Navigation

5 Attilio Carotenuto Jul 22, 2014

In this tutorial, we'll dive into artificial intelligence with Unity 3D by introducing the built-in navigation system. I'll show you how to define a NavMesh in your scene, make an agent intelligently walk through it to reach different targets, and how to connect separate areas of a scene.

NavMesh is a commonly-used technique in Game AI to define a walkable area in an environment. It's also used to calculate a path between two points, make an NPC walk from its position to a goal, let an enemy reach a player or move the player to a desired destination (e.g. a point-and-click adventure game or a RTS).

Unity offers a built-in implementation of this navigation system, available in both free and pro versions. Some advanced features, like off-mesh links, are pro-only.

You can access the navigation system through the Navigation panel using Window – Navigation, and it will open next to the Inspector.

Navigation Panel

For the purpose of this tutorial we're going to use a 3D project. Also, I'll assume you have familiarity with the Unity editor and know basics operations like adding objects to a scene, adding components, and scripting in C#.

Note: This tutorial is based on Unity 4. The screenshots have been captured from version 4.5.1. As new releases are distributed, menus, names or layouts in the editor may differ.

Marking Scene objects and baking

First thing's first. In the Object tab, define whether the selected object is Navigation static or not. Walls, floors and platforms are all static objects.

Make sure to go through all your objects in the hierarchy and set them appropriately. You can use the Scene filter in the Navigation panel to show only Mesh Renderers or Terrains. When doing this, make sure to select the actual object with a mesh, not the parent.

Objects that are not Navigation static will be ignored when generating the NavMesh.

Next, define the Navigation Layer for the object using the related drop-down. You can choose between Default (walkable), Not Walkable and Jump. You can also define custom layers in case you want to have terrains with different traversal cost -- more on this later.

We're now ready to bake the nav mesh onto your scene. Here, you can see an initial scene without NavMesh:

Unity Scene without NavMap baked

After hitting the Bake button, you'll see that the scene has a blue overlay in certain areas, that's the NavMesh:

Unity Scene with NavMap baked

Actors will be able to walk only on the blue area of the map. Just note that every time you make a modification to the scene you'll need to Bake the NavMesh again.

In this example, the floor is composed of smaller adjacent pieces. This will become handy when we'll want to define different traversal cost for different areas of the level.

Setting NavMesh properties

You can customize your NavMesh in the Bake Tab.

Radius is the distance between the walls and the navigation mesh, and represents the agent's radius. If you feel that your agent keeps bumping on walls or objects while moving, increase the radius to make it smoother.

Height represents the agent's height and specifies the minimum height of areas where the agent will be able to venture into. Max slope specifies the maximum slope for a surface to be considered walkable, while Step Height is the height difference between two surfaces to be considered connected.

Under the Advanced group, you can set the width and height inaccuracy, which specify the approximation allowed when generating the NavMesh. Lower values will give a higher quality NavMesh, but are more computationally expensive. Generating a more accurate NavMesh will also take longer.

The NavMesh Agent

Now that we've got a NavMesh in our scene, we need a way to tell our character to walk through it. This is done using the NavMeshAgent component. You'll find it in the Component Menu, under Navigation.

As you can see in the previous image, I have two cubes in my scene, the blue one represents the player, while the red one marks the position to reach.

Add a NavMeshAgent component to your player game object. This component is responsible for the agent pathfinding and its actual movement control.

NavMeshAgent Component

There are many properties that you can set in the component. Again, Radius specifies the radius of the agent (and defines whether they can go through a narrow path), while Height is the agent's height and defines whether they can pass under obstacles.

Speed, Acceleration and Angular Speed are self-explanatory. They define how your agent will move, while Stopping Distance defines how close the agent will get to the target position before stopping.

We now need to tell the agent what to do via scripting. Here's a quick example of how to make the agent move to a target destination:

using UnityEngine;
using System.Collections;

public class AgentWalkScript : MonoBehaviour 

    public Transform destination;

    private NavMeshAgent agent;

    void Start () 
        agent = gameObject.GetComponent<NavMeshAgent>();



When the scene starts, the script will retrieve a reference to the game object's NavMeshAgent component, and will use SetDestination to tell it to move to the destination.

Attach the script to your player game object in the editor, and make sure to set the destination field to another game object in your scene (in my case, I used the red cube). As soon as you hit play, you'll see your character moving to its target destination. If the agent can't reach the target (e.g. if you put it in a closed space) it will still try to get as close as possible and stop in the best position available.

If you tick Auto Braking in the inspector, the agent will slow down before reaching the target, smoothly stopping at its position. If the path is broken for any reason, the agent can rebuild a new one in realtime. To do this, tick Auto Repath.

If you want to recreate RTS-style controls (i.e. moving the agent where you click in the scene), you'll need to cast a ray from the screen point using the camera, and then check Raycast collision with the world using that ray. In case any collision is detected, the agent will attemp to move to that position:

void Update()
    if (Input.GetMouseButtonDown(0))
        Ray screenRay = Camera.main.ScreenPointToRay(Input.mousePosition);

        RaycastHit hit;
        if (Physics.Raycast(screenRay, out hit))

Manually creating a path

There are cases in which you want to have more control over how your agent generates a path to the target and when it starts moving. Path-finding is a fairly expensive operation, and sometimes it's better to calculate and store a path before using it. This can be done using CalculatePath:

agent = gameObject.GetComponent<NavMeshAgent>();

NavMeshPath path = new NavMeshPath();
bool hasFoundPath = agent.CalculatePath(destination.position, path);

if(path.status == NavMeshPathStatus.PathComplete)
    print("The agent can reach the destionation");
 else if(path.status == NavMeshPathStatus.PathPartial)
     print("The agent can only get close to the destination");
  else if(path.status == NavMeshPathStatus.PathInvalid)
     print("The agent cannot reach the destination");
     print("hasFoundPath will be false");

In this example, I manually calculate a path and then check its status to see whether the agent can reach the destination. Note that in this case the agent won't start moving. Later on, when you want the agent to start moving, you can use SetPath and pass the path object you generated before:


This is very useful when lots of things happen in the game, and you don't want to slow down the action using SetDestination, which will start a path-finding calculation.

If you want to clear the path, you can use ResetPath:


The agent will also stop if it's moving, because it doesn't have a valid path to follow.

Pausing, resuming and warping

While your agent is moving towards its target, you can temporarily stop it using Stop. By default, the game object will still decelerate and be affected by the avoidance system while stopping. To prevent this, pass true as paramenter:

   agent.Stop(true); // Stops immediately
   agent.Stop(); // Decelerate

Later on you can use Resume to make the agent move again:


In some cases you may want to move the agent to another position. In this case, instead of applying the transformation to its Transform, you should use Warp, passing the new position:


In this instance, the agent will also stop moving, so you'll need to calculate a new path manually or by using SetDestination.

Layers cost

As we said before, each walkable mesh has a layer assigned, and a relative traversal cost. While the default layer has a cost of 1, custom layers can be defined with different costs to, for example, define areas that may be dangerous to the agent for example.

To do that, let's return to the Navigation panel and go to the Layers tab. Here, I've defined three custom layers with higher costs:

NavMesh Layers

You can then return to the Object tab and use these new layers in the Navigation Layer dropdown. Areas with a higher cost will have a different color, just remember that you need to re-bake your NavMesh every time you change a layer to apply the changes.

For example, here I assigned the MoreExpensive layer to the light-brown portion of the platform:

Unity Scene with a different NavMesh layer

In the current scenario depicted in the image, the blue agent will go all the way up and around the target in order to avoid the expensive area of the map.

You can check the cost of a navigation layer using GetLayerCost, passing the layer index. Default layer has an index of 0, and so on. For example, here I'm checking the cost of the Expensive layer:

 float layerCost = agent.GetLayerCost(3);

You can also override layer cost using SetLayerCost:

agent.SetLayerCost(4, 10);

Here, I changed the MoreExpensive layer cost, using its index 4, from 4 to 10. Just note that when the agent is disabled this cost will be reset to its default value defined in the editor.

By default, a NavMeshAgent can walk on every layers defined in the NavMesh. If you want to prevent your agent from walking on certain layers, you can use the "NavMesh Walkable" dropdown menu located in the component properties.

Dynamic Obstacles

While it's useful to have static objects defined in your map, your agent will also need to take into account and avoid dynamic objects in the scene. They can be moving objects, or objects generated at runtime that cannot be taken into account when baking the NavMesh. To do this, we'll use NavMeshObstacle components.

In my example, I created another game object (the brown cube), and added a NavMeshObstacle to it:

Unity Scene with a NavMesh obstacle

You can change the obstacle radius and height from the inspector.

NavMesh obstacles won't affect the NavMesh, but the agent will avoid them and go around their radius, or stop altogether if they cannot find a valid path as a result of the obstacle being in the way. For this reason, NavMesh obstacles are not taken into account when generating a path.

If you want to check for obstacles during path-finding, you can tick the Carve in the Inspector. In this case, the obstacles will create a hole in the NavMesh and the agent will try to find an alternative route in case this obstacle is blocking its path to the target.

By default, your agent's Obstacle Avoidance is set to High Quality. This gives smooth movement between obstacles, but it's also quite expensive. If you want to test lower quality but faster Obstacle Avoidance types you can change it from your game object's NavMeshAgent component, in the Inspector. Setting it as None will disable Obstacle Avoidance altogether, and your agent will ignore dynamic obstacles in the scene.


Or enter your name and Email
  • HB Heini van Biljon 2 years ago
    Hello there, I am a little stuck with the navmesh in Unity as I have a player controlled character, as well as a cube that works with a navmeshagenet which follows the player. When it reaches it's stopping point the cube stops but if I move closer to it and then away again it doesn't stop at the stopping distance any more but pushes my character off of the map. The other issue is as soon as the cube navmesh character touches any object in the environment it starts moving away from the target in what I would call a glitching shaking movement . The other issue as well is if my character is still, and the cube navmesh reaches stopping distance it stops then after a second it starts moving in violation of the assigned stopping distance. Any help would really be appreciated
  • LC Lucas Tadeu Chiarelli 2 years ago
    Well explained. I didn't understand it until now. Thank you so much and keep it up with these works, because I will read them all!
  • DK Dusan Kostic 3 years ago
    Nice tutorial to get you started. I have a couple of questions: "For example, here I assigned the MoreExpensive layer to the light-brown portion of the platform" I'd like to know how you did that. If the whole maze is a single mesh, how do you assign different navmesh layers to certain parts of the single big mesh? Also, Warp() has a return value of bool, meaning if it's successful or not. How do I know why it didn't succeed? What are all the possible scenarios?
    • AC Attilio Carotenuto 3 years ago
      Hi Dusan, thanks! In my example, the maze is actually composed of smaller, adjacent rectangles. This way I can define different cost for each portion of the maze. Regarding Warp(), I would expect it to fail if you try to warp somewhere outside the NavMesh, or where the agent cannot walk, I'm not sure if there's any other possible scenario for it to return false.
    • A alexander 8 months ago
      Hi all the the tutorial is fine and good. But if there is a demo for the above code.. it will be more good. so kindly upload the demo also.