---
name: "combatPace"
type: command
status: ok
groups: ["Object Manipulation"]
arma3_since: "2.22"
locality: {"argument": "local", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/combatPace
revid: 378225
updated: 2026-03-15T12:52:32Z
---

# combatPace

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

Locality: arguments **local**

## Description

Sets or gets the combat pace for the local player. If the right-hand array is empty, the command will simply return the current combat pace mode without making any changes to combat pace.

## Syntax

```sqf
soldier combatPace [enable, duration]
```

**Parameters:**

- `soldier`: [Object](../topics/Object.md) - The local player unit.
- `enable`: [Boolean](../topics/Boolean.md) - (Optional, no default) Whether to enable or disable combat pace. This param is optional, i.e. the right-hand array can be completely empty (see [#Example 1](../commands/combatPace.md#example-1)).
- `duration`: [Scalar](../topics/Number.md) - (Optional, default -1) Duration of combat pace in seconds (maximum 5 seconds). If duration < 0, combat pace will be toggled. If duration >= 0, short combat pace will be used. duration == 0 means use the default short combat pace duration in config, similar to when the player presses the fire button and weapon is raised. Note that the combat pace modes are mutually exclusive (enabling one disables the other)

**Returns:** [String](../topics/String.md) - previous combat pace. Possible values: "None", "Timer", "Toggle"

## Examples

### Example 1

```sqf
private _isCombatPaceToggled = player combatPace [] == "Toggle"; // current combat pace is toggled
```

### Example 2

```sqf
private _isInCombatPace = player combatPace [] != "None"; // either using timer or toggled combat pace
```

### Example 3

```sqf
player combatPace [false]; // disables combat pace (both short and toggle)
```

### Example 4

```sqf
player combatPace [true]; // enables combat pace toggle and disables timer mode
```

### Example 5

```sqf
player combatPace [true, 1]; // disables combat pace toggle, enables timer mode for 1 second
```

### Example 6

```sqf
player combatPace [player combatPace [] != "Toggle"]; // toggle combat pace (enable<->disable)
```

## See also

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

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