---
name: "setWaypointPosition"
type: command
status: ok
groups: ["Waypoints"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setWaypointPosition
revid: 377573
updated: 2026-01-02T06:56:26Z
---

# setWaypointPosition

*Command · Waypoints · Arma 3 v0.50 · introduced in Operation Flashpoint: Elite v1.00*

## Description

Attempts to move given waypoint to a random position inside a circle with the given center and radius.
The waypoint will be placed similar to `"NONE"` attribute in [setVehiclePosition](../commands/setVehiclePosition.md), even if the radius is 0, which means it could still be off center. In order to force waypoint to the exact position, similar to `"CAN_COLLIDE"` attribute, use a negative radius (see [#Example 2](../commands/setWaypointPosition.md#example-2)).

## Syntax

```sqf
waypoint setWaypointPosition [center, radius]
```

**Parameters:**

- `waypoint`: Waypoint
- `center`: [Object](../topics/Object.md) or [PositionAGL](../topics/Position.md#positionagl) or [PositionASL](../topics/Position.md#positionasl) if *radius* is negative
- `radius`: [Number](../topics/Number.md) - random placement radius in meters. Set it to -1 and convert center to [PositionASL](../topics/Position.md#positionasl) for the exact center placement

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

## Examples

### Example 1

```sqf
[_grp, 2] setWaypointPosition [position player, 0];
```

### Example 2

Exact placement using a negative *radius* and [PositionASL](../topics/Position.md#positionasl):

```sqf
_wp setWaypointPosition [getPosASL player, -1];
```

## See also

[waypointPosition](../commands/waypointPosition.md) · [setWPPos](../commands/setWPPos.md) · [waypoints](../commands/waypoints.md) · [deleteWaypoint](../commands/deleteWaypoint.md) · [copyWaypoints](../commands/copyWaypoints.md) · [setCurrentWaypoint](../commands/setCurrentWaypoint.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) · [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

**Killzone_Kid** — 2018-11-14

If you want AI to understand height of the waypoint, for example set waypoint at the top of Military Cargo Tower, use [#Example 2](../commands/setWaypointPosition.md#example-2) with position in ASL format and -1 radius.

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