addWeaponGlobal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Version fixed - shouldn't be present in version 0.74.)
No edit summary
 
(61 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma3 |= Game name
|game1= arma3
|version1= 0.76


|0.76|= Game version
|arg= global


|arg= global |= Arguments in MP
|eff= global


|eff= global |= Effects in MP
|gr1= Vehicle Inventory
____________________________________________________________________________________________


| Add a weapon to a unit. Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further [[addWeaponGlobal]] commands are ignored.
|gr2= Unit Inventory


To make sure the added weapon is loaded and ready, add the magazine first. |= Description
|descr= Add a weapon to a unit. Infantry units can only carry weapons in their respective slots (primary, secondary and handgun),
____________________________________________________________________________________________
the [[addWeaponGlobal]] command will replace the weapon currently in a slot with the added weapon if it shares the same slot.
This command can link items to respective slots as well, in which case the functionality is identical to [[linkItem]].


| unit '''addWeaponGlobal''' weapon |= Syntax
To make sure the added weapon is loaded and ready, add the magazine first.
{{Feature|informative|This command was broken when used on dedicated server and fixed on {{GVI|arma3|2.00|size= 0.75}}.}}


|p1= unit: [[Object]] - unit or vehicle to add the weapon to |= Parameter 1
|s1= object [[addWeaponGlobal]] weapon


|p2= weapon: [[String]] - weapon class name |= Parameter 2
|p1= object : [[Object]] - unit or vehicle to add the weapon to


| [[Nothing]] |= Return value
|p2= weapon: [[String]] - weapon class name
____________________________________________________________________________________________
 
|x1= <code>{
_x [[addMagazineGlobal]] "Laserbatteries";
_x [[addWeaponGlobal]] "Laserdesignator";
} [[forEach]] [[allUnits]];</code> |= Example 1


|x2= <code>{
|r1= [[Nothing]]
[[if]] ([[typeOf]] _x == "O_Heli_Attack_02_black_F") [[then]] {
_x [[addMagazineGlobal]] "38Rnd_80mm_rockets";
_x [[addWeaponGlobal]] "rockets_Skyfire";
};
} [[forEach]] [[vehicles]];</code> |= Example 2
____________________________________________________________________________________________


| [[removeWeaponGlobal]], [[addWeapon]], [[addMagazine]], [[addMagazineGlobal]] |= See also
|s2= object [[addWeaponGlobal]] [weapon, autoselect]
|s2since= arma3 2.20
|p21= object: [[Object]] - unit or vehicle to add the weapon to


}}
|p22= weapon: [[String]] - weapon class name. See the topic [[:Category:Weapons]] for reference about possible values.
|p23= autoselect (Optional): [[String]] - [[false]] to abort weapon autoselection if no weapon was selected. Default: [[true]]


<h3 style="display:none">Notes</h3>
|r2= [[Nothing]]
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|x1= <sqf>
</dl>
{
_x addMagazineGlobal "Laserbatteries";
_x addWeaponGlobal "Laserdesignator";
} forEach allUnits;
</sqf>


<h3 style="display:none">Bottom Section</h3>
|x2= <sqf>
{
if (typeOf _x == "O_Heli_Attack_02_black_F") then
{
_x addMagazineGlobal "38Rnd_80mm_rockets";
_x addWeaponGlobal "rockets_Skyfire";
};
} forEach vehicles;
</sqf>


|seealso= [[removeWeaponGlobal]] [[addWeapon]] [[addMagazine]] [[addMagazineGlobal]]
}}


[[Category:Scripting Commands|ADDWEAPON]]
{{Note
[[Category:Scripting Commands OFP 1.96|ADDWEAPON]]
|user= Killzone_Kid
[[Category:Scripting Commands OFP 1.46|ADDWEAPON]]
|timestamp= 20150707184200
[[Category:Scripting Commands ArmA|ADDWEAPON]]
|text= If you do not remove weapon first, using this command from dedicated server will duplicate weapon.
[[Category:Command_Group:_Weapons|{{uc:{{PAGENAME}}}}]]
}}
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]

Latest revision as of 23:53, 11 March 2025

Hover & click on the images for description

Description

Description:
Add a weapon to a unit. Infantry units can only carry weapons in their respective slots (primary, secondary and handgun), the addWeaponGlobal command will replace the weapon currently in a slot with the added weapon if it shares the same slot. This command can link items to respective slots as well, in which case the functionality is identical to linkItem. To make sure the added weapon is loaded and ready, add the magazine first.
This command was broken when used on dedicated server and fixed on Arma 3 logo black.png2.00.
Groups:
Vehicle InventoryUnit Inventory

Syntax

Syntax:
object addWeaponGlobal weapon
Parameters:
object : Object - unit or vehicle to add the weapon to
weapon: String - weapon class name
Return Value:
Nothing

Alternative Syntax

Syntax:
object addWeaponGlobal [weapon, autoselect]
Parameters:
object: Object - unit or vehicle to add the weapon to
weapon: String - weapon class name. See the topic Category:Weapons for reference about possible values.
autoselect (Optional): String - false to abort weapon autoselection if no weapon was selected. Default: true
Return Value:
Nothing

Examples

Example 1:
{ _x addMagazineGlobal "Laserbatteries"; _x addWeaponGlobal "Laserdesignator"; } forEach allUnits;
Example 2:
{ if (typeOf _x == "O_Heli_Attack_02_black_F") then { _x addMagazineGlobal "38Rnd_80mm_rockets"; _x addWeaponGlobal "rockets_Skyfire"; }; } forEach vehicles;

Additional Information

See also:
removeWeaponGlobal addWeapon addMagazine addMagazineGlobal

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
Killzone_Kid - c
Posted on Jul 07, 2015 - 18:42 (UTC)
If you do not remove weapon first, using this command from dedicated server will duplicate weapon.