Legacy Documentation: Version 5.0
Creating a NavMesh Obstacle
Building Off-Mesh Links Automatically

Creating an Off-mesh Link

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Sumbission failed

For some reason your suggested change could not be submitted. Please try again in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Off-Mesh Links are used to create paths crossing outside the walkable navigation mesh surface. For example, jumping over a ditch or a fence, or opening a door before walking through it, can be all described as Off-mesh links.

We’re going to add an Off-Mesh Link component to describe a jump from the upper platform to the ground.

  1. First create two cylinders: Game Object > 3D Obejct > Sphere.
  2. You can scale the cylinders to (0.1, 0.5, 0.1) to make it easier to work with them.
  3. Move the first cylinder at the edge of the top platform, close to the NavMesh surface.
  4. Place the second cylinder on the ground, close to the NavMesh, at the location where the link should land.
  5. Select the cylinder on the left and add an Off-Mesh Link component to it. Choose Add Component from the inspector and choose Navigation > Off Mesh Link.
  6. Assign the leftmost cylinder in the Start field and rightmost cylinder in the End field.

Now you have functioning Off-Mesh Link set up! If the path via the off-mesh link is shorter than via walking along the Navmesh, the off-mesh link will be used.

You can use any game object in the scene to hold the Off-Mesh link component, for example a fence prefab could contain the off-mesh link component. Similarly you can use any game object with a Transform as the start and end marker.

The NavMesh bake process can detect and create common jump-across and drop-down links automatically. Take a look at the Building Off-Mesh Links Automatically for more details.

Further Reading

Creating a NavMesh Obstacle
Building Off-Mesh Links Automatically