Arma 3 Scripting

Command in Unit Inventory

addMagazine

Also available as Markdown and JSON, or read the original wiki page.

Description

Adds a magazine to a person. Infantry units can only carry a specific number of magazines, once the magazine slots are filled (or uniform/vest/bagpack are full in Arma 3), any further addMagazine commands are ignored. If class of magazine does not exist, an error message is printed in .rpt:

player addMagazine "dasdsa"; // .rpt: Given magazine[dasdsa] not found

Note

Use addMagazine before addWeapon for the weapon to be loaded with the magazine automatically.

Syntax

Syntax 1

unitName addMagazine magazineName Local ArgumentGlobal Effect

Parameters:

Returns: Nothing

Syntax 2

since arma2oa 1.62

unitName addMagazine [magazineName, ammoCount] Arma 2: Operation Arrowhead v1.62 Local ArgumentGlobal Effect Arma 3 v1.00 Global ArgumentGlobal Effect

Parameters:

Returns: Nothing

Examples

Example 1

player addMagazine "30Rnd_556x45_STANAG";

Example 2

player addMagazine ["30Rnd_556x45_STANAG", 15];            // since Arma 2:OA 1.62

Example 3

nonLocalUnit addMagazine ["30Rnd_556x45_STANAG", 15];    // global argument since Arma 3

Example 4

player addMagazine ["30Rnd_556x45_STANAG", 9999];        // will give a 30 rounds magazine anyway

See also

addMagazineGlobal · addMagazines · addMagazineCargo · addMagazineCargoGlobal · addMagazinePool · addMagazineTurret · removeMagazine · removeMagazines · addWeapon · loadMagazine

Community notes

Hoz

If the unit has magazines already, you may need to use the commands removeMagazine or removeMagazines to make space for the mags you want to add.

PhilippRauch

In turreted vehicles the magazine is added to the first turret with >> primaryGunner = 1; << set in the Vehicles turret config part (and the magazine is ONLY added to the very first turret if more than one is configged with >> primaryGunner = 1; << ).

Inkompetent

When wanting to add many magazines to an object's init-line it can be easier to use loops than to just repeat the addMagazine command.

If you want to add N magazines to an object either of the two below ways are handy, the first for fewer magazines, and the latter when you want to add many since it then is the easiest of the two to read.

{ this addMagazine "magazineClassName" } forEach [1,2,3, /*..., */ N];
for "_i" from 1 to N do { this addMagazine "magazineClassName" };
Pisces_72

If adding a magazine to an empty artillery support with this command in Arma 3, use reload. If you do not reload, Artillery calls will not fire rounds, because the AI won't reload automatically (tested with 82mm mortar)