addMagazine: Difference between revisions
Jump to navigation
Jump to search
No edit summary |
Lou Montana (talk | contribs) (Merging addMagazine and addMagazine_array) |
||
Line 11: | Line 11: | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| Add a magazine to a person. Infantry units can only carry a specific number of magazines, once the magazine slots are filled, any further addMagazine commands are ignored.<br><br> | | Add 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.<br> | ||
<br> | |||
'' | '''NOTE:''' use [[addMagazine]] ''before'' [[addWeapon]] for the weapon to be loaded. | ||
|= Description | |= Description | ||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| unitName | | unitName [[addMagazine]] magazineName |= Syntax | ||
|p1= unitName: [[Object]] - person to add the magazines to |= Parameter 1 | |p1= unitName: [[Object]] - person to add the magazines to |= Parameter 1 | ||
Line 27: | Line 25: | ||
| [[Nothing]] |= Return value | | [[Nothing]] |= Return value | ||
|s2= unitName [[addMagazine]] [magazineName, ammoCount]<br> | |||
|s2= | {{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 | |||
|p21= unitName: [[Object]] - person to add the magazines to |= Alternative Parameter 1 | |p21= unitName: [[Object]] - person to add the magazines to |= Alternative Parameter 1 | ||
Line 36: | Line 36: | ||
|p23= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. |= Alternative Parameter 3 | |p23= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. |= Alternative Parameter 3 | ||
|p24= ammoCount: [[Number]] - Ammo quantity to be added to magazine.|= Alternative Parameter 4 | |p24= 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 4 | ||
|r2= [[Nothing]] |= Alternative Return value | |r2= [[Nothing]] |= Alternative Return value | ||
Line 42: | Line 42: | ||
|x1= <code>[[player]] [[addMagazine]] "30Rnd_556x45_STANAG";</code> |= Example 1 | |x1= <code>[[player]] [[addMagazine]] "30Rnd_556x45_STANAG";</code> |= Example 1 | ||
|x2= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 15];</code> |= Example 2 | |||
|x2= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// since Arma 2 OA 1.62}}</code> |= Example 2 | |||
|x3= <code>nonLocalUnit [[addMagazine]] ["30Rnd_556x45_STANAG", 15]; {{codecomment|// global argument since Arma 3}}</code> |= Example 3 | |||
|x4= <code>[[player]] [[addMagazine]] ["30Rnd_556x45_STANAG", 9999]; {{codecomment|// will give a 30 rounds magazine anyway}}</code> |= Example 4 | |||
____________________________________________________________________________________________ | ____________________________________________________________________________________________ | ||
| [[addMagazineGlobal | | [[addMagazineGlobal]], [[addMagazines]], [[addMagazineCargo]], [[addMagazineCargoGlobal]], [[addMagazinePool]], [[addMagazineTurret]], [[removeMagazine]], [[removeMagazines]], [[addWeapon]], [[loadMagazine]]|= See also | ||
}} | }} | ||
Line 54: | Line 59: | ||
<dd class="notedate">Posted on August 2, 2006 - 06:59 | <dd class="notedate">Posted on August 2, 2006 - 06:59 | ||
<dt class="note"> | <dt class="note">[[User:Hoz|Hoz]] | ||
<dd class="note">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. | |||
<dd class="notedate">Posted on February 21, 2010 - 20:13 | <dd class="notedate">Posted on February 21, 2010 - 20:13 | ||
<dt class="note"> | <dt class="note">[[User:Vigilante|Vigilante]] | ||
<dd class="note">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; << ). | |||
<dd class="notedate">Posted on May 12, 2010 - 20:09 | <dd class="notedate">Posted on May 12, 2010 - 20:09 | ||
<dt class="note"> | <dt class="note">[[User:Inkompetent|Inkompetent]] | ||
<dd class="note">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. | 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. | ||
<code>{this [[addMagazine]] "magazineClassName"} [[forEach]] [1,2,3,...,N]; | <code>{this [[addMagazine]] "magazineClassName"} [[forEach]] [1,2,3,...,N]; | ||
[[for]] "_i" [[from]] 0 [[to]] (N - 1) [[do]] {this [[addMagazine]] "magazineClassName"};</code> | [[for]] "_i" [[from]] 0 [[to]] (N - 1) [[do]] {this [[addMagazine]] "magazineClassName"};</code> | ||
<dd class="notedate">Posted on November 28, 2017 - 13:10 (UTC) | |||
<dt class="note">[[User:Pisces_72|Pisces_72]] | |||
<dd class="note">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) | |||
<!-- Note Section END --> | <!-- Note Section END --> | ||
</dl> | </dl> | ||
Line 75: | Line 88: | ||
[[Category:Scripting Commands OFP 1.96|ADDMAGAZINE]] | [[Category:Scripting Commands OFP 1.96|ADDMAGAZINE]] | ||
[[Category:Scripting Commands OFP 1.46|ADDMAGAZINE]] | [[Category:Scripting Commands OFP 1.46|ADDMAGAZINE]] | ||
[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]] | |||
[[Category:Scripting Commands ArmA|ADDMAGAZINE]] | [[Category:Scripting Commands ArmA|ADDMAGAZINE]] | ||
[[Category:Command_Group:_Weapons|{{uc:{{PAGENAME}}}}]] | [[Category:Command_Group:_Weapons|{{uc:{{PAGENAME}}}}]] | ||
Line 80: | Line 94: | ||
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]] | ||
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]] | [[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]] | ||
Revision as of 20:15, 25 March 2018
Description
- Description:
- Add 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.
NOTE: use addMagazine before addWeapon for the weapon to be loaded. - Groups:
- Uncategorised
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]
1.62 Template:EffArgTemplate:EffArg
1.00 Template:EffArgTemplate:EffArg - Parameters:
- unitName: Object - person to add the magazines to
- [magazineName, ammoCount]: Array
- 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
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Command Group: Uncategorised
- Scripting Commands: Global Effect
- Scripting Commands OFP 1.99
- Scripting Commands OFP 1.96
- Scripting Commands OFP 1.46
- ArmA 2 OA: New Scripting Commands List
- Scripting Commands ArmA
- Command Group: Weapons
- Scripting Commands ArmA2
- Scripting Commands Arma 3
- Scripting Commands Take On Helicopters