---
name: "uniqueUnitItems"
type: command
status: ok
groups: ["Unit Inventory"]
arma3_since: "2.06"
locality: {"argument": "global", "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/uniqueUnitItems
revid: 310366
updated: 2022-05-05T17:43:22Z
---

# uniqueUnitItems

*Command · Unit Inventory · Arma 3 v2.06*

Locality: arguments **global**

## Description

Returns hashmap of all items in units inventory as [classname, count] pairs.

> [!NOTE]
> - *weaponItems*, *uniformItems*, *vestItems*, *backpackItems* arguments use the following [Number](../topics/Number.md) values:
>   - 0: do not return value
>   - 1: returns container only (weapon or container)
>   - 2: returns container and its content
> - weapons/containers that are stored inside containers (e.g weapon in backpack) always return all contents if contents for the parent container are enabled.

## Syntax

### Syntax 1

```sqf
uniqueUnitItems unit
```

**Parameters:**

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

**Returns:** [HashMap](../topics/HashMap.md) in format itemClassname ([String](../topics/String.md)) → amount ([Number](../topics/Number.md))

### Syntax 2

```sqf
uniqueUnitItems [unit, weaponsItems, uniformItems, vestItems, backpackItems, assignedItems]
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `weaponsItems`: [Number](../topics/Number.md) - (Optional, default 2) weapons (including binoculars) and their accessories (flashlight etc), loaded magazines
- `uniformItems`: [Number](../topics/Number.md) - (Optional, default 2)
- `vestItems`: [Number](../topics/Number.md) - (Optional, default 2)
- `backpackItems`: [Number](../topics/Number.md) - (Optional, default 2)
- `assignedItems`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) returns [assignedItems](../commands/assignedItems.md) as well as [headgear](../commands/headgear.md) and [goggles](../commands/hmd.md)

**Returns:** [HashMap](../topics/HashMap.md) in format itemClassname ([String](../topics/String.md)) → amount ([Number](../topics/Number.md))

## Examples

### Example 1

```sqf
private _unitUniqueItems = uniqueUnitItems [player, 0, 2, 2, 2, true];
if (_unitUniqueItems getOrDefault ["FirstAidKit", 0] > 5) then { hint "I'm rich of FAK to give!"; };
```

### Example 2

```sqf
private _unitUniqueItems = uniqueUnitItems [cursorObject];
```

## See also

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

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