addMagazine: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "_{10,} " to "")
m (Text replacement - " *\| *([Cc]omments|COMMENTS|Game|[Gg]ame [Nn]ame|Game [Vv]ersion|Game Version \(number surrounded by NO SPACES\)|Multiplayer Arguments \("local" or "global"\)|Multiplayer Effects \("local" or "global"\)|Multiplayer Execution \("serv...)
Line 1: Line 1:
{{Command|Comments=
{{Command


| ofp |Game name=
| ofp


|1.00|Game version=
|1.00


|arg= local |Multiplayer Arguments=
|arg= local |Multiplayer Arguments=
Line 9: Line 9:
|eff= global |Multiplayer Effects=
|eff= global |Multiplayer Effects=


|gr1= Unit Inventory |GROUP1=
|gr1= Unit Inventory


| 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 {{arma3}}), any further [[addMagazine]] commands are ignored. If class of magazine does not exist, an error message is printed in .rpt:
| 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 {{arma3}}), any further [[addMagazine]] commands are ignored. If class of magazine does not exist, an error message is printed in .rpt:
<code>[[player]] [[addMagazine]] "dasdsa"; {{cc|.rpt: Given magazine[dasdsa] not found)}}</code>
<code>[[player]] [[addMagazine]] "dasdsa"; {{cc|.rpt: Given magazine[dasdsa] not found)}}</code>
{{Informative | Use [[addMagazine]] ''before'' [[addWeapon]] for the weapon to be loaded with magazine automatically.}} |DESCRIPTION=
{{Informative | Use [[addMagazine]] ''before'' [[addWeapon]] for the weapon to be loaded with magazine automatically.}}


| unitName [[addMagazine]] magazineName |SYNTAX=
| unitName [[addMagazine]] magazineName


|p1= unitName: [[Object]] - person to add the magazines to |PARAMETER1=
|p1= unitName: [[Object]] - person to add the magazines to


|p2= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. |PARAMETER2=
|p2= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values.


| [[Nothing]] |RETURNVALUE=
| [[Nothing]]


|s2= unitName [[addMagazine]] [magazineName, ammoCount]<br>
|s2= unitName [[addMagazine]] [magazineName, ammoCount]<br>
{{GVI|arma2oa|1.62}} {{EffArg|cmd|arg|local}}{{EffArg|cmd|eff|glob}}<br>
{{GVI|arma2oa|1.62}} {{EffArg|cmd|arg|local}}{{EffArg|cmd|eff|glob}}<br>
{{GVI|arma3|1.00}} {{EffArg|cmd|arg|global}}{{EffArg|cmd|eff|glob}} |Alternative Syntax=
{{GVI|arma3|1.00}} {{EffArg|cmd|arg|global}}{{EffArg|cmd|eff|glob}}


|p21= unitName: [[Object]] - person to add the magazines to |Alternative Parameter 1=
|p21= unitName: [[Object]] - person to add the magazines to


|p22= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. |Alternative Parameter 2=
|p22= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values.


|p23= ammoCount: [[Number]] - Ammo quantity to be added to magazine. If it goes beyond maximum magazine capacity, the magazine will be given full and not overloaded.|Alternative Parameter 3=
|p23= ammoCount: [[Number]] - Ammo quantity to be added to magazine. If it goes beyond maximum magazine capacity, the magazine will be given full and not overloaded.


|r2= [[Nothing]] |Alternative Return value=
|r2= [[Nothing]] |Alternative Return value=
   
   
|x1= <code>[[player]] [[addMagazine]] "30Rnd_556x45_STANAG";</code> |EXAMPLE1=
|x1= <code>[[player]] [[addMagazine]] "30Rnd_556x45_STANAG";</code>


|x2= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// since Arma 2 OA 1.62}}</code> |EXAMPLE2=
|x2= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// since Arma 2 OA 1.62}}</code>


|x3= <code>nonLocalUnit [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// global argument since Arma 3}}</code> |EXAMPLE3=
|x3= <code>nonLocalUnit [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// global argument since Arma 3}}</code>


|x4= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 9999]; {{codecomment|// will give a 30 rounds magazine anyway}}</code> |EXAMPLE4=
|x4= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 9999]; {{codecomment|// will give a 30 rounds magazine anyway}}</code>


| [[addMagazineGlobal]], [[addMagazines]], [[addMagazineCargo]], [[addMagazineCargoGlobal]], [[addMagazinePool]], [[addMagazineTurret]], [[removeMagazine]], [[removeMagazines]], [[addWeapon]], [[loadMagazine]]|SEEALSO=
| [[addMagazineGlobal]], [[addMagazines]], [[addMagazineCargo]], [[addMagazineCargoGlobal]], [[addMagazinePool]], [[addMagazineTurret]], [[removeMagazine]], [[removeMagazines]], [[addWeapon]], [[loadMagazine]]
}}
}}



Revision as of 00:03, 18 January 2021

Hover & click on the images for description

Description

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)
Use addMagazine before addWeapon for the weapon to be loaded with magazine automatically.
Groups:
Unit Inventory

Syntax

Syntax:
unitName addMagazine magazineName
Parameters:
unitName: Object - person to add the magazines to
magazineName: String - magazine name. See the topic Category:Weapons for reference about possible values.
Return Value:
Nothing

Alternative Syntax

Syntax:
unitName addMagazine [magazineName, ammoCount]
A2 OA Logo.png1.62 Template:EffArgTemplate:EffArg
Arma 3 logo black.png1.00 Template:EffArgTemplate:EffArg
Parameters:
unitName: Object - person to add the magazines to
magazineName: String - magazine name. See the topic Category:Weapons for reference about possible values.
ammoCount: Number - Ammo quantity to be added to magazine. If it goes beyond maximum magazine capacity, the magazine will be given full and not overloaded.
Return Value:
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

Additional Information

See also:
addMagazineGlobaladdMagazinesaddMagazineCargoaddMagazineCargoGlobaladdMagazinePooladdMagazineTurretremoveMagazineremoveMagazinesaddWeaponloadMagazine

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

Notes

Posted on August 2, 2006 - 06:59
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.
Posted on February 21, 2010 - 20:13
Vigilante
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; << ).
Posted on May 12, 2010 - 20:09
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 0 to (N - 1) do {this addMagazine "magazineClassName"};
Posted on November 28, 2017 - 13:10 (UTC)
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)

Bottom Section