---
name: "setConvoySeparation"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "1.68"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/setConvoySeparation
revid: 376358
updated: 2025-10-07T21:39:25Z
---

# setConvoySeparation

*Command · Object Manipulation · Arma 3 v1.68*

## Description

Sets the distance to keep to the vehicle which is **in front**.

- This command has to be applied to all vehicles in a convoy in order to have a separation of, for example, 50 m.
- Vehicles in a convoy can also have different distances.
- It's recommended that small values (<10m) should only be used for slowly moving convoys, otherwise AI driven vehicles will leave the road frequently to avoid collisions

## Syntax

```sqf
vehicle setConvoySeparation distance
```

**Parameters:**

- `vehicle`: [Object](../topics/Object.md)
- `distance`: [Number](../topics/Number.md)

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

## Examples

### Example 1

```sqf
cursorObject setConvoySeparation 20;
```

## See also

[forceFollowRoad](../commands/forceFollowRoad.md) · [useAISteeringComponent](../commands/useAISteeringComponent.md)

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