---
name: "needReload"
type: command
status: ok
groups: ["Weapons"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/needReload
revid: 376453
updated: 2025-10-14T11:29:23Z
---

# needReload

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

## Description

Returns how much vehicle wants to reload its weapons.

## Syntax

### Syntax 1

```sqf
needReload entity
```

**Parameters:**

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

**Returns:** [Number](../topics/Number.md) - range: 0-1, 0: full mag, 1: empty mag

### Syntax 2

*since arma3 2.22*

```sqf
entity needReload muzzle
```

**Parameters:**

- `entity`: [Object](../topics/Object.md) - unit or vehicle
- `muzzle`: [String](../topics/String.md) - muzzle to check. "" to check all muzzles

**Returns:** [Number](../topics/Number.md) - range: 0-1, 0: full mag, 1: empty mag

## Examples

### Example 1

```sqf
_seriousness = needReload _vehicle;
```

### Example 2

```sqf
if (needReload player == 1) then { reload player };
```

### Example 3

```sqf
player needReload currentMuzzle player;
```

## See also

[needService](../commands/needService.md) · [reload](../commands/reload.md) · [reloadEnabled](../commands/reloadEnabled.md) · [enableReload](../commands/enableReload.md)

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