---
name: "BIS_fnc_addRespawnInventory"
type: function
status: ok
groups: ["Respawn"]
arma3_since: "1.60"
locality: {"argument": null, "effect": "global", "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_addRespawnInventory
revid: 369448
updated: 2024-09-06T05:10:03Z
---

# BIS_fnc_addRespawnInventory

*Function · Respawn · Arma 3 v1.60*

Locality: effect **global**

## Description

Add a respawn inventory for respawn menu.

Available loadouts are defined in [CfgRespawnInventory](../topics/Description.ext.md#cfgrespawninventory). Or you may use an existing CfgVehicles soldier class as reference.

## Syntax

```sqf
[target, inventoryParams] call BIS_fnc_addRespawnInventory
```

**Parameters:**

- `target`: Receiver of the respawn loadout
  - [Namespace](../topics/Namespace.md) - use [missionNamespace](../commands/missionNamespace.md) to add the loadout to everyone
  - [Side](../topics/Side.md)
  - [Group](../topics/Group.md)
  - [Object](../topics/Object.md)
- `inventoryParams`: [Array](../topics/Array.md) or [String](../topics/String.md)
  - [String](../topics/String.md) - [CfgRespawnInventory](../topics/Description.ext.md#cfgrespawninventory) class or CfgVehicles soldier class
  - [Array](../topics/Array.md) - format [class, number, limit]
    - class: [String](../topics/String.md) - [CfgRespawnInventory](../topics/Description.ext.md#cfgrespawninventory) class or CfgVehicles soldier class
    - number: [Number](../topics/Number.md) - Number of players who can use this inventory (-1 = no limit, default)
    - limit: [Number](../topics/Number.md) - Limit for role assigned to given loadout (-1 = no limit, default)
      - Only role or only loadout can be limited at one moment, if there is limit for both, then only role uses limit.
      - If the limit definition for role is called multiple times with different numbers, then the highest number is used.

**Returns:** [Array](../topics/Array.md) - format [target, id] used in [BIS_fnc_removeRespawnInventory](../functions/BIS_fnc_removeRespawnInventory.md)

## Examples

### Example 1

```sqf
[west, "WEST1"] call BIS_fnc_addRespawnInventory;
```

### Example 2

```sqf
private _myRespawnInventory = [missionNamespace, "ATSniper"] call BIS_fnc_addRespawnInventory;
```

## See also

Arma 3: Respawn · [BIS_fnc_removeRespawnInventory](../functions/BIS_fnc_removeRespawnInventory.md) · [BIS_fnc_getRespawnInventories](../functions/BIS_fnc_getRespawnInventories.md) · [BIS_fnc_setRespawnInventory](../functions/BIS_fnc_setRespawnInventory.md)

<sub>Source: [BI Community Wiki — BIS fnc addRespawnInventory](https://community.bistudio.com/wiki/BIS_fnc_addRespawnInventory) (revision 369448).</sub>