---
name: "BIS_fnc_limitAmmunition"
type: function
status: ok
groups: ["Inventory"]
arma3_since: "1.00"
locality: {"argument": null, "effect": null, "server_exec": false}
source: https://community.bistudio.com/wiki/BIS_fnc_limitAmmunition
revid: 349399
updated: 2023-11-08T16:27:25Z
---

# BIS_fnc_limitAmmunition

*Function · Inventory · Arma 3 v1.00*

## Description

Limits the number of magazines carried by individual unit. Each container (uniform, vest and backpack) can be limited separately or left untouched.
	The function limits the number of magazines of each unique ammo category in respective container. Items like First Aid Kit or Mine Detector are not affected by the function

Set the minimum and maximum values in an array, for example [0.5,1] will set the magazine count anywhere between 50-100% of default count.

## Syntax

```sqf
[unit,uniformMags,vestMags,BackpackMags] call BIS_fnc_limitAmmunition
```

**Parameters:**

- `unit`: [Object](../topics/Object.md)
- `uniformMags`: [Array](../topics/Array.md) - (Optional, default [0.4,0.8]) amount of magazines in uniform. Array in form:
  - 0:minMags - Minimum amount of magazines in percent (%)
  - 1:maxMags - Maximum amount of magazines in percent (%)
- `vestMags`: [Array](../topics/Array.md) - (Optional, default [0.4,0.8]) amount of magazines in vest. Array in form:
  - 0:minMags - Minimum amount of magazines in percent (%)
  - 1:maxMags - Maximum amount of magazines in percent (%)
- `backpackMags`: [Array](../topics/Array.md) - (Optional, default [0.4,0.8]) amount of magazines in backpack. Array in form:
  - 0:minMags - Minimum amount of magazines in percent (%)
  - 1:maxMags - Maximum amount of magazines in percent (%)

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

## Examples

### Example 1

```sqf
player call BIS_fnc_limitAmmunition;
```

### Example 2

```sqf
[player,[],[0.5,0.5],[0,1]] call BIS_fnc_limitAmmunition;
```

## See also

[BIS_fnc_limitWeaponItems](../functions/BIS_fnc_limitWeaponItems.md) · [BIS_fnc_limitItems](../functions/BIS_fnc_limitItems.md)

<sub>Source: [BI Community Wiki — BIS fnc limitAmmunition](https://community.bistudio.com/wiki/BIS_fnc_limitAmmunition) (revision 349399).</sub>