NavMesh Click-to-Move
Click-to-move character controller using NavMeshAgent. Click anywhere to navigate, with destination marker and path line.
No APIs that Unity 6.0 to 6.6 made obsolete or removed. How this is checked
What it adds to your GameObject
A MonoBehaviour component: attach it to a GameObject. This is the Inspector you get, read from the source: 7 serialized fields with their defaults.
When to use it
Perfect for RTS games, isometric RPGs (Diablo-style), point-and-click adventures, and MOBA-style games. Use this when the player navigates by clicking on the ground rather than using WASD. Works well with a top-down or isometric camera setup and NavMesh-baked environments.
Setup
- Add a NavMeshAgent component to your character
- Attach NavMeshClickToMove
- Bake a NavMesh on your ground/terrain
- Right-click (configurable) to move to a destination
- Optionally assign a destination marker prefab (particle, ring, etc.)
- Path line shows the navigation route in cyan
Features
- Click-to-move navigation using Unity NavMeshAgent
- Visual path line rendered with LineRenderer component
- Destination marker prefab spawned at click position
- NavMesh.SamplePosition for snapping clicks to valid walkable areas
- Configurable mouse button, ground layer, and stopping distance
- Public MoveTo and Stop methods for scripted navigation
Inspector fields
Every field NavMesh Click-to-Move exposes in the Inspector, with the default it starts at.
| Field | Type | Default | Group |
|---|---|---|---|
Mouse ButtonmouseButton | int | 1 | Input |
Ground LayergroundLayer | LayerMask | Nothing | Input |
Destination Marker PrefabdestinationMarkerPrefab | GameObject | None | Visual Feedback |
Show Path LineshowPathLine | bool | true | Visual Feedback |
Path ColorpathColor | Color | #00FFFF | Visual Feedback |
Stopping DistancestoppingDistance | float | 0.5 | Movement |
Move SpeedmoveSpeed | float | 5 | Movement |
Public API
What other scripts can call on NavMeshClickToMove.
| Member | Returns | Description |
|---|---|---|
MoveTo(Vector3 destination) | void | Move to a world position via NavMesh. |
Stop() | void | Stop moving and clear the path. |
Requirements
- Requires NavMeshAgent on the same GameObject. Unity adds it automatically when you attach the script.
- Uses the NavMesh API (UnityEngine.AI): bake a NavMesh with the AI Navigation package first.
- Reads the legacy Input Manager (UnityEngine.Input). If Project Settings > Player > Active Input Handling is set to Input System Package only, Unity throws an InvalidOperationException; set it to Both.
Common mistakes
You must bake a NavMesh on your ground geometry (add a NavMeshSurface component from the AI Navigation package and press Bake) or the agent will not move at all. The groundLayer mask must match the layer of your terrain or floor objects, otherwise clicks pass through. If the destinationMarkerPrefab is not assigned, no visual marker appears but movement still works — this is optional, not an error.
Source code
NavMeshClickToMove.cs, 128 lines, MIT licensed. Paste it into a new C# file of the same name.
using UnityEngine;
using UnityEngine.AI;
/// <summary>
/// Click-to-move controller using NavMeshAgent.
/// Click on the ground to navigate. Optionally shows path and destination marker.
/// </summary>
[RequireComponent(typeof(NavMeshAgent))]
public class NavMeshClickToMove : MonoBehaviour
{
[Header("Input")]
[SerializeField] private int mouseButton = 1; // Right-click
[SerializeField] private LayerMask groundLayer = ~0;
[Header("Visual Feedback")]
[SerializeField] private GameObject destinationMarkerPrefab;
[SerializeField] private bool showPathLine = true;
[SerializeField] private Color pathColor = Color.cyan;
[Header("Movement")]
[SerializeField] private float stoppingDistance = 0.5f;
[SerializeField] private float moveSpeed = 5f;
private NavMeshAgent agent;
private LineRenderer pathLine;
private GameObject activeMarker;
private Camera mainCamera;
private void Awake()
{
agent = GetComponent<NavMeshAgent>();
agent.speed = moveSpeed;
agent.stoppingDistance = stoppingDistance;
if (showPathLine)
{
pathLine = gameObject.AddComponent<LineRenderer>();
pathLine.startWidth = 0.05f;
pathLine.endWidth = 0.05f;
pathLine.material = new Material(Shader.Find("Sprites/Default"));
pathLine.startColor = pathColor;
pathLine.endColor = pathColor;
pathLine.positionCount = 0;
}
}
private void Start()
{
mainCamera = Camera.main;
}
private void Update()
{
if (Input.GetMouseButtonDown(mouseButton))
{
Ray ray = mainCamera.ScreenPointToRay(Input.mousePosition);
if (Physics.Raycast(ray, out RaycastHit hit, 100f, groundLayer))
{
MoveTo(hit.point);
}
}
UpdatePathLine();
UpdateMarker();
}
/// <summary>
/// Move to a world position via NavMesh.
/// </summary>
public void MoveTo(Vector3 destination)
{
if (NavMesh.SamplePosition(destination, out NavMeshHit navHit, 2f, NavMesh.AllAreas))
{
agent.SetDestination(navHit.position);
ShowMarker(navHit.position);
}
}
/// <summary>
/// Stop moving and clear the path.
/// </summary>
public void Stop()
{
agent.ResetPath();
HideMarker();
}
private void ShowMarker(Vector3 position)
{
if (destinationMarkerPrefab == null) return;
if (activeMarker == null)
activeMarker = Instantiate(destinationMarkerPrefab);
activeMarker.transform.position = position + Vector3.up * 0.05f;
activeMarker.SetActive(true);
}
private void HideMarker()
{
if (activeMarker != null)
activeMarker.SetActive(false);
}
private void UpdateMarker()
{
if (activeMarker != null && activeMarker.activeSelf)
{
if (!agent.hasPath || agent.remainingDistance <= stoppingDistance)
HideMarker();
}
}
private void UpdatePathLine()
{
if (pathLine == null) return;
if (agent.hasPath && agent.path.corners.Length > 1)
{
pathLine.positionCount = agent.path.corners.Length;
pathLine.SetPositions(agent.path.corners);
}
else
{
pathLine.positionCount = 0;
}
}
}