---
name: "addPrimaryWeaponItem"
type: command
status: ok
groups: ["Unit Inventory"]
arma3_since: "0.50"
locality: {"argument": "local", "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/addPrimaryWeaponItem
revid: 347500
updated: 2023-09-24T01:03:28Z
---

# addPrimaryWeaponItem

*Command · Unit Inventory · Arma 3 v0.50*

Locality: arguments **local** · effect **global**

## Description

Adds weapon item, including magazine, directly to the [primaryWeapon](../commands/primaryWeapon.md). This is used for infantry weapons.

## Syntax

```sqf
unit addPrimaryWeaponItem item
```

**Parameters:**

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

**Returns:** [Nothing](../topics/Nothing.md) or [Boolean](../topics/Boolean.md) - **false** is returned if **item** can not be added

## Examples

### Example 1

```sqf
player addPrimaryWeaponItem "muzzle_snds_H";
```

## See also

[addWeaponItem](../commands/addWeaponItem.md) · [removePrimaryWeaponItem](../commands/removePrimaryWeaponItem.md) · [removeAllPrimaryWeaponItems](../commands/removeAllPrimaryWeaponItems.md) · [addSecondaryWeaponItem](../commands/addSecondaryWeaponItem.md) · [addHandgunItem](../commands/addHandgunItem.md) · [addBinocularItem](../commands/addBinocularItem.md) · [weaponsItems](../commands/weaponsItems.md) · [handgunItems](../commands/handgunItems.md) · [primaryWeaponItems](../commands/primaryWeaponItems.md) · [secondaryWeaponItems](../commands/secondaryWeaponItems.md) · [binocularItems](../commands/binocularItems.md)

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