addMagazine: Difference between revisions
Jump to navigation
Jump to search
Lou Montana (talk | contribs) m (Fix SQF) |
Lou Montana (talk | contribs) m (Text replacement - "<sqf>([^↵][^<]*↵[^<]*)<\/sqf>" to "<sqf> $1 </sqf>") |
||
(2 intermediate revisions by the same user not shown) | |||
Line 21: | Line 21: | ||
|game7= arma3 | |game7= arma3 | ||
|version7= 0.50 | |version7= 0.50 | ||
|gr1= Unit Inventory | |gr1= Unit Inventory | ||
|descr= 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: | |descr= 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. | ||
<sqf>player addMagazine "dasdsa"; // .rpt: Given magazine[dasdsa] not found | If class of magazine does not exist, an error message is printed in {{Link|Crash Files|.rpt}}: | ||
{{Feature | | <sqf>player addMagazine "dasdsa"; // .rpt: Given magazine[dasdsa] not found</sqf> | ||
{{Feature|informative|Use [[addMagazine]] ''before'' [[addWeapon]] for the weapon to be loaded with the magazine automatically.}} | |||
|s1= unitName [[addMagazine]] magazineName | |s1= unitName [[addMagazine]] magazineName<br> | ||
{{Icon|localArgument|32}}{{Icon|globalEffect|32}} | |||
|p1= unitName: [[Object]] - person to add the magazines to | |p1= unitName: [[Object]] - person to add the magazines to | ||
Line 43: | Line 41: | ||
{{GVI|arma2oa|1.62}} {{Icon|localArgument|32}}{{Icon|globalEffect|32}}<br> | {{GVI|arma2oa|1.62}} {{Icon|localArgument|32}}{{Icon|globalEffect|32}}<br> | ||
{{GVI|arma3|1.00}} {{Icon|globalArgument|32}}{{Icon|globalEffect|32}} | {{GVI|arma3|1.00}} {{Icon|globalArgument|32}}{{Icon|globalEffect|32}} | ||
|s2since= arma2oa 1.62 | |||
|p21= unitName: [[Object]] - person to add the magazines to | |p21= unitName: [[Object]] - person to add the magazines to | ||
Line 48: | Line 48: | ||
|p22= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. | |p22= magazineName: [[String]] - magazine name. See the topic [[:Category:Weapons]] for reference about possible values. | ||
|p23= ammoCount: [[Number]] - | |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]] | |r2= [[Nothing]] | ||
Line 54: | Line 54: | ||
|x1= <sqf>player addMagazine "30Rnd_556x45_STANAG";</sqf> | |x1= <sqf>player addMagazine "30Rnd_556x45_STANAG";</sqf> | ||
|x2= <sqf>player addMagazine ["30Rnd_556x45_STANAG", 15]; // since | |x2= <sqf>player addMagazine ["30Rnd_556x45_STANAG", 15]; // since {{Name|arma2oa|short}} 1.62</sqf> | ||
|x3= <sqf>nonLocalUnit addMagazine ["30Rnd_556x45_STANAG", 15]; // global argument since | |x3= <sqf>nonLocalUnit addMagazine ["30Rnd_556x45_STANAG", 15]; // global argument since {{arma3}}</sqf> | ||
|x4= <sqf>player addMagazine ["30Rnd_556x45_STANAG", 9999]; // will give a 30 rounds magazine anyway</sqf> | |x4= <sqf>player addMagazine ["30Rnd_556x45_STANAG", 9999]; // will give a 30 rounds magazine anyway</sqf> | ||
|seealso= [[addMagazineGlobal]] [[addMagazines]] [[addMagazineCargo]] [[addMagazineCargoGlobal]] [[addMagazinePool]] [[addMagazineTurret]] [[removeMagazine]] [[removeMagazines]] [[addWeapon]] [[loadMagazine]] | |seealso= [[addMagazineGlobal]] [[addMagazines]] [[addMagazineCargo]] [[addMagazineCargoGlobal]] [[addMagazinePool]] [[addMagazineTurret]] [[removeMagazine]] [[removeMagazines]] [[addWeapon]] [[loadMagazine]] | ||
Line 81: | Line 81: | ||
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. | ||
<sqf>{ this addMagazine "magazineClassName" } forEach [1,2,3, /*..., */ N]; | <sqf> | ||
for "_i" from 1 to N do { this addMagazine "magazineClassName" };</sqf> | { this addMagazine "magazineClassName" } forEach [1,2,3, /*..., */ N]; | ||
for "_i" from 1 to N do { this addMagazine "magazineClassName" }; | |||
</sqf> | |||
}} | }} | ||
Latest revision as of 19:43, 3 September 2024
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:
- Groups:
- Unit Inventory
Syntax
- Syntax:
- unitName addMagazine magazineName
LALocalGEGlobal - 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 LALocalGEGlobal
1.00 GAGlobalGEGlobal - 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:
- Example 2:
- Example 3:
- nonLocalUnit addMagazine ["30Rnd_556x45_STANAG", 15]; // global argument since Arma 3
- Example 4:
Additional Information
- See also:
- addMagazineGlobal addMagazines addMagazineCargo addMagazineCargoGlobal addMagazinePool addMagazineTurret removeMagazine removeMagazines addWeapon loadMagazine
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
- Posted on Aug 02, 2006 - 06:59 (UTC)
- 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 Feb 21, 2010 - 20:13 (UTC)
- 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 (UTC)
- 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.
- Posted on Nov 28, 2017 - 13:10 (UTC)
- 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)
Categories:
- Scripting Commands
- Introduced with Operation Flashpoint version 1.00
- Operation Flashpoint: New Scripting Commands
- Operation Flashpoint: Scripting Commands
- Operation Flashpoint: Elite: Scripting Commands
- ArmA: Armed Assault: Scripting Commands
- Arma 2: Scripting Commands
- Arma 2: Operation Arrowhead: Scripting Commands
- Take On Helicopters: Scripting Commands
- Arma 3: Scripting Commands
- Command Group: Unit Inventory