The NavMeshA mesh that Unity generates to approximate the walkable areas and obstacles in your environment for path finding and AI-controlled navigation. More info
See in Glossary Link component is not in the Unity standard install; see documentation on high-level NavMesh building components for information on how to access it.
NavMesh Link creates a navigable link between two locations that use NavMeshes.
This link can be from point to point or it can span a gap, in which case the Agent uses the nearest location along the entry edge to cross the link.
You must use a NavMesh Link to connect different NavMesh Surfaces.
To use the NavMesh Link component, navigate to GameObjectThe fundamental object in Unity scenes, which can represent characters, props, scenery, cameras, waypoints, and more. A GameObject’s functionality is defined by the Components attached to it. More info
See in Glossary > AI > NavMesh Link.
PropertyA generic term for the editable fields, buttons, checkboxes, or menus that comprise a component. An editable property is also referred to as a field. More info See in Glossary |
Function |
---|---|
Agent Type | The Agent type that can use the link. - Humanoid - Ogre |
Start Point | The start point of the link, relative to the GameObject. Defined by XYZ measurements. |
End Point | The end point of the link, relative to the GameObject. Defined by XYZ measurements. |
Align Transform To Points | Clicking this button moves the GameObject at the link’s center point and aligns the transform’s forward axis with the end point. |
Bidirectional | With this tickbox checked, NavMesh Agents traverse the NavMesh Link both ways (from the start point to the end point, and from the end point back to the start point). When this tickbox is unchecked, the NavMesh Link only functions one-way (from the start point to the end point only). |
Area Type | The area type of the NavMesh Link (this affects pathfinding costs). - Walkable (this is the default option) - Not Walkable - Jump |
If you want an Agent to move between multiple NavMesh Surfaces in a SceneA Scene contains the environments and menus of your game. Think of each unique Scene file as a unique level. In each Scene, you place your environments, obstacles, and decorations, essentially designing and building your game in pieces. More info
See in Glossary, they must be connected using a NavMesh Link.
In the example Scene above, the blue and red NavMeshes are defined in different NavMesh Surfaces, with a NavMesh link connecting them.
Note that when connecting NavMesh Surfaces:
You can connect NavMesh Surfaces using multiple NavMesh Links.
Both the NavMesh Surfaces and the NavMesh Link must have same Agent type.
The NavMesh Link’s start and end point must only be on one NavMesh Surface - be careful if you have multiple NavMeshes at the same location.
If you are loading a second NavMesh Surface and you have unconnected NavMesh Links in the first Scene, check that they do not connect to any unwanted NavMesh Surfaces.
2017–05–26 Page published with limited editorial review
New feature in 5.6
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Is something described here not working as you expect it to? It might be a Known Issue. Please check with the Issue Tracker at issuetracker.unity3d.com.
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thanks for helping to make the Unity documentation better!