---
name: "forceSpeed"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/forceSpeed
revid: 379421
updated: 2026-10-31T00:04:17Z
---

# forceSpeed

*Command · Object Manipulation · Arma 3 v0.50 · introduced in Armed Assault v1.00*

## Description

Force the speed limit on given object (object will never attempt to move faster than given by forceSpeed). Use negative value to return to default behaviour.

> [!IMPORTANT]
> This has no effect on [players](../commands/player.md).

## Syntax

```sqf
object forceSpeed speed
```

**Parameters:**

- `object`: [Object](../topics/Object.md)
- `speed`: [Number](../topics/Number.md) - in metre per second

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

## Examples

### Example 1

```sqf
_helicopter forceSpeed 150;
```

### Example 2

```sqf
_vtol forceSpeed 0; // vtol stop and hover
```

### Example 3

```sqf
_vtol forceSpeed -1; // vtol resume
```

## See also

[getForcedSpeed](../commands/getForcedSpeed.md) · [forceWalk](../commands/forceWalk.md) · [isWalking](../commands/isWalking.md) · [isForcedWalk](../commands/isForcedWalk.md) · [getSpeed](../commands/getSpeed.md) · [limitSpeed](../commands/limitSpeed.md)

## Community notes

**Donnervogel** — 2007-03-02

Setting forceSpeed to -1 will make the unit move according to the group speed mode (often specified by the waypoint) again. Setting forceSpeed to 0 will halt the unit ignoring waypoints or orders.

---

**Kronzky** — 2008-02-09

Does not seem to do *anything* at the current time (V1.08.5163)

---

**Igneous01** — 2011-12-14

If a unit (man) has forceSpeed set to anything under jogging (walking only) the unit will refuse to get into vehicles. He will automatically be unassigned from a vehicle everytime he is ordered to get in (via scripts or direct action)

---

**TMZulu** — 2020-05-01

This command must be executed on the client to which the object/unit is local and will only take effect where the unit is local. If locality changes, the command must be reapplied.

---

**Leopard20** — 2021-11-17

In the case of infantry units, it is recommended to use [getSpeed](../commands/getSpeed.md) for better and more accurate results:

```sqf
_unit forceSpeed (_unit getSpeed "NORMAL"); // force the unit to run
```

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