---
name: "setCurrentWaypoint"
type: command
status: ok
groups: ["Waypoints"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setCurrentWaypoint
revid: 379230
updated: 2026-10-30T23:04:20Z
---

# setCurrentWaypoint

*Command · Waypoints · Arma 3 v0.50 · introduced in Armed Assault v1.05*

Locality: arguments **local**

## Description

Sets the currently active waypoint for a group.

## Syntax

```sqf
groupName setCurrentWaypoint waypoint
```

**Parameters:**

- `groupName`: [Group](../topics/Group.md)
- `waypoint`: [Waypoint](../topics/Waypoint.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
_grp setCurrentWaypoint [_grp, 1];
```

## See also

[waypoints](../commands/waypoints.md) · [deleteWaypoint](../commands/deleteWaypoint.md) · [copyWaypoints](../commands/copyWaypoints.md) · [setWaypointBehaviour](../commands/setWaypointBehaviour.md) · [setWaypointCombatMode](../commands/setWaypointCombatMode.md) · [setWaypointCompletionRadius](../commands/setWaypointCompletionRadius.md) · [setWaypointDescription](../commands/setWaypointDescription.md) · [setWaypointFormation](../commands/setWaypointFormation.md) · [setWaypointHousePosition](../commands/setWaypointHousePosition.md) · [setWaypointPosition](../commands/setWaypointPosition.md) · [setWaypointScript](../commands/setWaypointScript.md) · [setWaypointSpeed](../commands/setWaypointSpeed.md) · [setWaypointStatements](../commands/setWaypointStatements.md) · [setWaypointTimeout](../commands/setWaypointTimeout.md) · [setWaypointType](../commands/setWaypointType.md) · [setWaypointVisible](../commands/setWaypointVisible.md) · [waypointAttachVehicle](../commands/waypointAttachVehicle.md) · [waypointAttachedVehicle](../commands/waypointAttachedVehicle.md) · [setWaypointLoiterRadius](../commands/setWaypointLoiterRadius.md) · [waypointLoiterRadius](../commands/waypointLoiterRadius.md) · [addWaypoint](../commands/addWaypoint.md) · [setWaypointLoiterType](../commands/setWaypointLoiterType.md) · [waypointSpeed](../commands/waypointSpeed.md)

## Community notes

**Way** — 2007-08-27

(A1 1.08) Does not seem to work with Game Logic. Crashes to desktop.

---

**Ceeeb** — 2008-11-26

Note that a waypoints number as seen in the mission editor is not the same as it is waypoint number using this command. In the mission editor, waypoint 0 refers to the first placed waypoint, whereas waypoint 0 with the setCurrentWaypoint command refers to the unit's initial position waypoint.

---

**Galzohar** — 2010-01-17

(A2 1.05) This command may crash the game to desktop if you call it from the on act field of a waypoint that belongs to that same unit.

---

**Igneous01** — 2012-08-13

Using this command forces the last waypoint to complete. Any code in the on Act of that waypoint will run.

<sub>Source: [BI Community Wiki — setCurrentWaypoint](https://community.bistudio.com/wiki/setCurrentWaypoint) (revision 379230).</sub>