---
name: "currentWaypoint"
type: command
status: ok
groups: ["Waypoints"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/currentWaypoint
revid: 378132
updated: 2026-02-22T20:40:12Z
---

# currentWaypoint

*Command · Waypoints · Arma 3 v0.50 · introduced in Arma 2 v1.00*

## Description

Returns the *index* of the current waypoint (**not** the waypoint in Waypoint Array format).

- To determine the validity of the index, compare it to the waypoints count.
- If all waypoints are completed, then the index is 1 greater than the last valid index.
- If there are no waypoints, then the index is 0.

By default, a group has one already-completed waypoint at their starting position, making the first waypoint number one, not zero.

## Syntax

```sqf
currentWaypoint groupName
```

**Parameters:**

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

**Returns:** [Number](../topics/Number.md) - index of the current waypoint

## Examples

### Example 1

```sqf
_index = currentWaypoint group player;
```

### Example 2

```sqf
_waypointFormat = [_group, currentWaypoint _group];
```

## See also

[waypoints](../commands/waypoints.md) · [setCurrentWaypoint](../commands/setCurrentWaypoint.md)

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