---
name: "reload"
type: command
status: ok
groups: ["Weapons"]
arma3_since: "0.50"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/reload
revid: 347639
updated: 2023-10-03T09:06:43Z
---

# reload

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

## Description

Main syntax: Reload first found muzzle that needs reloading (with some inconsistencies).

Alternative syntax: this syntax allows to reload given muzzle with given magazine while playing proper animation.
If *param* is omitted or is empty string, default value is used. The default behaviour is to find the best matching magazine for the provided muzzle from the pool of available magazines.
If specific magazine is requested, the reload will fail if unit has run out of this type of magazines. If an empty array `[]` is given, the behaviour is similar to pressing the "Reload" key.
The command reloads the given muzzle but does not select it. In case of [throwable](../commands/currentThrowable.md) muzzles, each throwable has its own muzzle, they are autoreloaded after throw.
Using [reload](../commands/reload.md) on the throwable muzzle will just swap throwable for another one of the same type from inventory.

## Syntax

### Syntax 1

```sqf
reload unitName
```

**Parameters:**

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

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

### Syntax 2

*since arma3 2.08*

```sqf
unit reload [muzzle, magazine]
```

**Parameters:**

- `unit`: [Object](../topics/Object.md) - person
- `muzzle`: [String](../topics/String.md) - (Optional, default [currentMuzzle](../commands/currentMuzzle.md)) muzzle name or "" for the current muzzle.
- `magazine`: [String](../topics/String.md) - (Optional, default given muzzle magazine) magazine name or "" for given muzzle's magazine. If given muzzle is [currentMuzzle](../commands/currentMuzzle.md) then [currentMagazine](../commands/currentMagazine.md)

**Returns:** [Boolean](../topics/Boolean.md) - [true](../commands/true.md) on success

## Examples

### Example 1

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

### Example 2

```sqf
player reload ["GL_3GL_F", "1Rnd_HE_Grenade_shell"];
```

### Example 3

Reload current muzzle:

```sqf
player reload [];
```

## See also

[reloadEnabled](../commands/reloadEnabled.md) · [needReload](../commands/needReload.md) · [enableReload](../commands/enableReload.md) · [setWeaponReloadingTime](../commands/setWeaponReloadingTime.md)

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