Legacy Documentation: Version 4.6(go to latest)
Language: English
  • C#
  • JS
  • Boo

Script language

Select your preferred scripting language. All code snippets will be displayed in this language.

NavMeshAgent.SetDestination

Switch to Manual
public function SetDestination(target: Vector3): bool;

Parameters

target The target point to navigate to.

Description

Sets or updates the destination thus triggering the calculation for a new path.

Note that the path may not become available until after a few frames later. While the path is being computed, pathPending will be true. If a valid path becomes available then the agent will resume movement.

// Script to move a NavMeshAgent to the place where
// the mouse is clicked.
	private var agent: NavMeshAgent;

function Start () { agent = GetComponent.<NavMeshAgent>(); }

function Update () { var hit: RaycastHit;

// When the mouse is clicked... if (Input.GetMouseButtonDown(0)) { // If the click was on an object then set the agent's // destination to the point where the click occurred. var ray = Camera.main.ScreenPointToRay(Input.mousePosition); if (Physics.Raycast(ray, hit)) { agent.SetDestination(hit.point); } } }