56 lines
3.7 KiB
Markdown
56 lines
3.7 KiB
Markdown
|
# Creating a NavMesh Agent
|
|||
|
|
|
|||
|
|
Once you have a [**NavMesh**][1] baked for your level it is time to create a character which can navigate the [**scene**][2]. We’re going to build our prototype agent from a cylinder and set it in motion. This is done using a NavMesh Agent component and a simple script.
|
|||
|
|
|
|||
|
|
|
|||
|
|
|
|||
|
|
First let’s create the character:
|
|||
|
|
|
|||
|
|
1. Create a **cylinder**: **GameObject > 3D Object > Cylinder**.
|
|||
|
|
2. The default cylinder dimensions (height 2 and radius 0.5) are good for a humanoid shaped agent, so we will leave them as they are.
|
|||
|
|
3. Add a **NavMesh Agent** component: **Component > Navigation > NavMesh Agent**.
|
|||
|
|
|
|||
|
|
Now you have simple NavMesh Agent set up ready to receive commands!
|
|||
|
|
|
|||
|
|
When you start to experiment with a NavMesh Agent, you most likely are going to adjust its dimensions for your character size and speed.
|
|||
|
|
|
|||
|
|
The **NavMesh Agent** component handles both the pathfinding and the movement control of a character. In your [**scripts**][3], navigation can be as simple as setting the desired destination point - the NavMesh Agent can handle everything from there on.
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
// MoveTo.cs
|
|||
|
|
using UnityEngine;
|
|||
|
|
using UnityEngine.AI;
|
|||
|
|
|
|||
|
|
public class MoveTo : MonoBehaviour {
|
|||
|
|
|
|||
|
|
public Transform goal;
|
|||
|
|
|
|||
|
|
void Start () {
|
|||
|
|
NavMeshAgent agent = GetComponent<NavMeshAgent>();
|
|||
|
|
agent.destination = goal.position;
|
|||
|
|
}
|
|||
|
|
}
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
Next we need to build a simple script which allows you to send your character to the destination specified by another Game Object, and a Sphere which will be the destination to move to:
|
|||
|
|
|
|||
|
|
1. Create a new **C# script** (`MoveTo.cs`) and replace its contents with the above script.
|
|||
|
|
2. Assign the MoveTo script to the character you’ve just created.
|
|||
|
|
3. Create a **sphere**, this will be the destination the agent will move to.
|
|||
|
|
4. Move the sphere away from the character to a location that is close to the NavMesh surface.
|
|||
|
|
5. Select the character, locate the MoveTo script, and assign the Sphere to the **Goal** property.
|
|||
|
|
6. **Press Play**; you should see the agent navigating to the location of the sphere.
|
|||
|
|
|
|||
|
|
To sum it up, in your script, you will need to get a reference to the NavMesh Agent component and then to set the agent in motion, you just need to assign a position to its [destination](https://docs.unity3d.com/ScriptReference/AI.NavMeshAgent-destination.html) property. The [Navigation How Tos](./NavHowTos.md) will give you further examples on how to solve common gameplay scenarios with the NavMesh Agent.
|
|||
|
|
|
|||
|
|
### Additional resources
|
|||
|
|
|
|||
|
|
- [Navigation HowTos](./NavHowTos.md) - common use cases for NavMesh Agent, with source code.
|
|||
|
|
- [Inner Workings of the Navigation System](./NavInnerWorkings.md) - learn more about path following.
|
|||
|
|
- [NavMesh Agent component reference](https://docs.unity3d.com/Manual/class-NavMeshAgent.html) – full description of all the NavMeshAgent properties.
|
|||
|
|
- [NavMesh Agent scripting reference](https://docs.unity3d.com/ScriptReference/AI.NavMeshAgent.html) - full description of the NavMeshAgent scripting API.
|
|||
|
|
|
|||
|
|
[1]: ./BuildingNavMesh.md "A mesh that Unity generates to approximate the walkable areas and obstacles in your environment for path finding and AI-controlled navigation."
|
|||
|
|
[2]: https://docs.unity3d.com/Manual/CreatingScenes.html "A 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."
|
|||
|
|
[3]: https://docs.unity3d.com/Manual/CreatingAndUsingScripts.html "A piece of code that allows you to create your own Components, trigger game events, modify Component properties over time and respond to user input in any way you like."
|