---
name: "BIS_fnc_addVirtualItemCargo"
type: function
status: ok
groups: ["Inventory"]
arma3_since: "1.24"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_addVirtualItemCargo
revid: 325299
updated: 2022-07-10T22:41:08Z
---

# BIS_fnc_addVirtualItemCargo

*Function · Inventory · Arma 3 v1.24*

## Description

Add virtual items to an object (e.g., ammo box). Virtual items can be selected in the Arsenal.
If parameters 4 and 5 are used this function can replace [BIS_fnc_addVirtualWeaponCargo](../functions/BIS_fnc_addVirtualWeaponCargo.md), [BIS_fnc_addVirtualMagazineCargo](../functions/BIS_fnc_addVirtualMagazineCargo.md) and [BIS_fnc_addVirtualBackpackCargo](../functions/BIS_fnc_addVirtualBackpackCargo.md).

## Syntax

```sqf
[object, itemClasses, addItemsGlobal, arsenal, mode, itemType] call BIS_fnc_addVirtualItemCargo
```

**Parameters:**

- `object`: [Object](../topics/Object.md) - object to which items will be added
- `itemClasses`: [Boolean](../topics/Boolean.md), [String](../topics/String.md) or [Array](../topics/Array.md) of [String](../topics/String.md)s - item classes
- `addItemsGlobal`: [Boolean](../topics/Boolean.md) - (Optional, default [false](../commands/false.md)) [true](../commands/true.md) to add items globally
- `arsenal`: [Boolean](../topics/Boolean.md) - (Optional, default [true](../commands/true.md)) [true](../commands/true.md) to add Arsenal action
- `mode`: [Number](../topics/Number.md) - (Optional, default 1) defines what the function will do, can be:
  - -1 - remove given items
  -  0 - return current content
  -  1 - add given items
- `itemType`: [Number](../topics/Number.md) - (Optional, default 0) define the item type, can be:
  - 0 - items
  - 1 - weapons
  - 2 - magazines
  - 3 - backpacks

**Returns:** [Array](../topics/Array.md) of [String](../topics/String.md)s - all virtual items

## Examples

### Example 1

```sqf
[BIS_ammoBox, ["class_1", "class_2"], false, true] call BIS_fnc_addVirtualItemCargo;
```

## See also

Arsenal · [BIS_fnc_addVirtualBackpackCargo](../functions/BIS_fnc_addVirtualBackpackCargo.md) · [BIS_fnc_addVirtualMagazineCargo](../functions/BIS_fnc_addVirtualMagazineCargo.md) · [BIS_fnc_addVirtualWeaponCargo](../functions/BIS_fnc_addVirtualWeaponCargo.md) · [BIS_fnc_arsenal](../functions/BIS_fnc_arsenal.md) · [BIS_fnc_getVirtualBackpackCargo](../functions/BIS_fnc_getVirtualBackpackCargo.md) · [BIS_fnc_getVirtualItemCargo](../functions/BIS_fnc_getVirtualItemCargo.md) · [BIS_fnc_getVirtualMagazineCargo](../functions/BIS_fnc_getVirtualMagazineCargo.md) · [BIS_fnc_getVirtualWeaponCargo](../functions/BIS_fnc_getVirtualWeaponCargo.md) · [BIS_fnc_removeVirtualBackpackCargo](../functions/BIS_fnc_removeVirtualBackpackCargo.md) · [BIS_fnc_removeVirtualItemCargo](../functions/BIS_fnc_removeVirtualItemCargo.md) · [BIS_fnc_removeVirtualMagazineCargo](../functions/BIS_fnc_removeVirtualMagazineCargo.md) · [BIS_fnc_removeVirtualWeaponCargo](../functions/BIS_fnc_removeVirtualWeaponCargo.md)

## Community notes

**Kamaradski** — 2014-10-16

In AmmoboxInit mode, for the ammobox to ONLY contain your white-listed items in the ammobox, you should first issue the [BIS_fnc_removeVirtualItemCargo](../functions/BIS_fnc_removeVirtualItemCargo.md) command. Otherwise the box will contain non whitelisted clutter.

**Example:**

```sqf
["AmmoboxInit", [_myBox, true]] call BIS_fnc_arsenal;
[_myBox, [true], true] call BIS_fnc_removeVirtualItemCargo;
[_myBox, ["U_B_CombatUniform_mcam", "U_B_CombatUniform_mcam_tshirt"], true] call BIS_fnc_addVirtualItemCargo;
```

<sub>Source: [BI Community Wiki — BIS fnc addVirtualItemCargo](https://community.bistudio.com/wiki/BIS_fnc_addVirtualItemCargo) (revision 325299).</sub>