---
name: "getForcedSpeed"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "2.12"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getForcedSpeed
revid: 338349
updated: 2023-02-28T14:44:10Z
---

# getForcedSpeed

*Command · Object Manipulation · Arma 3 v2.12*

## Description

Returns forced speed set with [forceSpeed](../commands/forceSpeed.md) or -1 if not set.

## Syntax

```sqf
getForcedSpeed entity
```

**Parameters:**

- `entity`: [Object](../topics/Object.md)

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

## Examples

### Example 1

```sqf
_spd = getForcedSpeed _heli;
```

## See also

[forceSpeed](../commands/forceSpeed.md) · [getSpeed](../commands/getSpeed.md) · [forceWalk](../commands/forceWalk.md)

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