You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
⚠️ This branch might require features only available starting with **Unity 2017.2**.
1
+
>This branch requires **Unity 2017.2**. For older or future versions of Unity please use a matching branch ([master](../..), [5.6](../../tree/5.6), [2017.1](../../tree/2017.1), [2018.1](../../tree/2018.1)).
2
2
3
3
# Components for Runtime NavMesh Building
4
4
5
5
Here we introduce four components for the navigation system:
6
6
7
-
*__NavMeshSurface__ – for building and enabling a navmesh surface for one agent type.
8
-
*__NavMeshModifier__ – affects the navmesh generation of navmesh area types, based on the transform hierarchy.
9
-
*__NavMeshModifierVolume__ – affects the navmesh generation of navmesh area types, based on volume.
10
-
*__NavMeshLink__ – connects same or different navmesh surfaces for one agent type.
7
+
*__NavMeshSurface__ – for building and enabling a NavMesh surface for one agent type.
8
+
*__NavMeshModifier__ – affects the NavMesh generation of NavMesh area types, based on the transform hierarchy.
9
+
*__NavMeshModifierVolume__ – affects the NavMesh generation of NavMesh area types, based on volume.
10
+
*__NavMeshLink__ – connects same or different NavMesh surfaces for one agent type.
11
11
12
12
These components comprise the high level controls for building and using NavMeshes at runtime as well as edit time.
Detailed information can be found in the [Documentation](Documentation) section or in the [NavMesh building components](https://docs.unity3d.com/Manual/NavMesh-BuildingComponents.html) section of the Unity Manual.
17
15
18
16
# How To Get Started
19
17
20
-
Download and install the latest release of Unity 5.6.
18
+
Download and install Unity 5.6 or newer.
21
19
22
-
Clone or download this repository and open the project using the feature build.
23
-
Alternatively, you can copy the contents of `Assets/NavMeshComponents` to an existing project.
20
+
Clone or download this repository and open the project in Unity.
21
+
Alternatively, you can copy the contents of `Assets/NavMeshComponents` to an existing project. Make sure to select a branch of the repository that matches the Unity version.
24
22
25
23
Additional examples are available in the `Assets/Examples` folder.
26
24
The examples are provided "as is". They are neither generic nor robust, but serve as inspiration.
27
25
28
-
_Note: During the beta cycle features and API are subject to change. Back up existing projects before using.
29
-
**Make sure to backup an existing project before opening it with this build**_.
26
+
_Note: During the beta cycle features and API are subject to change.\
27
+
**Make sure to backup an existing project before opening it with a beta build.**_
30
28
31
29
# FAQ
32
30
33
-
Q: Can I bake navmesh at runtime?
34
-
A: yes
31
+
Q: Can I bake a NavMesh at runtime?
32
+
A: Yes.
35
33
36
-
Q: Can I use navmesh'es for more than one agent size?
37
-
A: yes
34
+
Q: Can I use NavMesh'es for more than one agent size?
35
+
A: Yes.
38
36
39
-
Q: Can I put a navmesh in a prefab?
40
-
A: yes - with some limitations.
37
+
Q: Can I put a NavMesh in a prefab?
38
+
A: Yes - with some limitations.
41
39
42
-
Q: How do i connect two navmesh surfaces?
43
-
A: Use the NavMeshLink to connect the two sides
40
+
Q: How do I connect two NavMesh surfaces?
41
+
A: Use the NavMeshLink to connect the two sides.
44
42
45
-
Q: How do i query the navmesh for one specific size of agent?
46
-
A: Use the NavMeshQuery filter when querying the navmesh
43
+
Q: How do I query the NavMesh for one specific size of agent?
44
+
A: Use the NavMeshQuery filter when querying the NavMesh.
47
45
48
46
Q: What's the deal with the 'DefaultExecutionOrder' attribute?
49
-
A: It gives a way of controlling the order of execution of scripts - specifically it allows us to build a navmesh before the
50
-
(native) navmeshagent component is enabled.
47
+
A: It gives a way of controlling the order of execution of scripts - specifically it allows us to build a NavMesh before the
48
+
(native) NavMeshAgent component is enabled.
51
49
52
50
Q: What's the use of the new delegate 'NavMesh.onPreUpdate'?
53
-
A: It allows you to hook in to controlling the navmesh data and links set up before the navigation update loop is called on the native side.
51
+
A: It allows you to hook in to controlling the NavMesh data and links set up before the navigation update loop is called on the native side.
54
52
55
53
Q: Can I do moving NavMesh platforms?
56
54
A: No - new API is required for consistently moving platforms carrying agents.
@@ -59,4 +57,4 @@ Q: Is OffMeshLink now obsolete?
59
57
A: No - you can still use OffMeshLink - however you'll find that NavMeshLink is more flexible and have less overhead.
60
58
61
59
Q: What happened to HeightMesh and Auto Generated OffMeshLinks?
62
-
A: They're not supported in the new navmesh building feature. HeightMesh will be added at some point. Auto OffMeshLink generation will possibly be replaced with a solution that allows better control of placement.
60
+
A: They're not supported in the new NavMesh building feature. HeightMesh will be added at some point. Auto OffMeshLink generation will possibly be replaced with a solution that allows better control of placement.
0 commit comments