---
name: "BIS_fnc_showRespawnMenuDisableItem"
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_showRespawnMenuDisableItem
revid: 349083
updated: 2023-11-08T14:47:24Z
---

# BIS_fnc_showRespawnMenuDisableItem

*Function · Respawn · Arma 3 v1.60*

Locality: effect **global**

## Description

Disables respawn loadout, role or position for Arma 3: Respawn.
- 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.
- If disabling a position then respawnReference must be supplied

## Syntax

```sqf
[mode, uiControl, listboxItem, message, respawnReference] call BIS_fnc_showRespawnMenuDisableItem
```

**Parameters:**

- **mode**: [String](../topics/String.md) - available options are *disable*, *enable* and *state*
- **uiControl**: [Control](../topics/Control.md) - list in which item should be disabled/enabled
  - BIS_RscRespawnControlsMap_ctrlLocList
  - BIS_RscRespawnControlsMap_ctrlRoleList
  - BIS_RscRespawnControlsMap_ctrlComboLoadout
- **listboxItem**: [Number](../topics/Number.md) or [String](../topics/String.md) - index or name of item in the respawn loadout/role/position listbox
- **message**: [String](../topics/String.md) - message shown when disabled item is selected, use "" for default message
- **respawnReference**: [String](../topics/String.md) - reference to respawn position either Marker name or [Object var name](../commands/vehicleVarName.md)

**Returns:** [Nothing](../topics/Nothing.md)

## Examples

### Example 1

```sqf
[
    "disable",
    uiNamespace getVariable "BIS_RscRespawnControlsMap_ctrlLocList",
    2,
    "Restricted for this part of mission!",
    myRespawnModule call BIS_fnc_objectVar
] call BIS_fnc_showRespawnMenuDisableItem;
```

## See also

[BIS_fnc_addRespawnInventory](../functions/BIS_fnc_addRespawnInventory.md) · [BIS_fnc_addRespawnPosition](../functions/BIS_fnc_addRespawnPosition.md) · Arma 3: Respawn

<sub>Source: [BI Community Wiki — BIS fnc showRespawnMenuDisableItem](https://community.bistudio.com/wiki/BIS_fnc_showRespawnMenuDisableItem) (revision 349083).</sub>