---
name: "getUnitLoadout"
type: command
status: ok
groups: ["Unit Inventory"]
arma3_since: "1.58"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/getUnitLoadout
revid: 377568
updated: 2026-01-02T06:55:51Z
---

# getUnitLoadout

*Command · Unit Inventory · Arma 3 v1.58*

## Description

Returns a **Unit Loadout Array** with all assigned items, weapons, containers and their stored items.

> [!NOTE]
> The config should contain the following standard entries:
>
> ```cpp
> class MyLoadout
> {
>     uniformClass = "U_B_CombatUniform_mcam";
>     backpack = "B_AssaultPack_mcamo";
>     linkedItems[] = { "V_PlateCarrier1_rgr", "H_HelmetB", "ItemCompass", "ItemWatch", "ItemRadio", "NVGoggles" };
>     weapons[] = { "arifle_MX_ACO_pointer_F", "hgun_P07_F" };
>     items[] = { "FirstAidKit", "FirstAidKit", "FirstAidKit" };
>     magazines[] = {
>         "30Rnd_65x39_caseless_mag", "16Rnd_9x21_Mag",
>         "SmokeShell",
>         "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade",
>         "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade",
>         "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade", "HandGrenade"
>     };
> };
> ```

## Syntax

### Syntax 1

```sqf
getUnitLoadout unit
```

**Parameters:**

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

**Returns:** Unit Loadout Array

### Syntax 2

```sqf
getUnitLoadout [unit, fullMagazines]
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `fullMagazines`: [Boolean](../topics/Boolean.md) - [true](../commands/true.md) to top up used magazines

**Returns:** Unit Loadout Array

### Syntax 3

```sqf
getUnitLoadout name
```

**Parameters:**

- `name`: [String](../topics/String.md) - `CfgVehicles` classname from which to extract the loadout

**Returns:** Unit Loadout Array

### Syntax 4

```sqf
getUnitLoadout config
```

**Parameters:**

- `config`: [Config](../topics/Config.md) - loadout config class

**Returns:** Unit Loadout Array

## Examples

### Example 1

```sqf
getUnitLoadout player;
```

### Example 2

```sqf
getUnitLoadout [player, true];
```

### Example 3

```sqf
getUnitLoadout "B_Soldier_F";
```

### Example 4

```sqf
getUnitLoadout (configFile >> "CfgVehicles" >> "B_Soldier_F");
```

### Example 5

```sqf
getUnitLoadout (missionConfigFile >> "MyLoadout");
```

## See also

[setUnitLoadout](../commands/setUnitLoadout.md)

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