addWeaponGlobal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Updated description to reflect true behaviour)
(Fix note)
 
(57 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 weapons in their respective slots (primary, secondary and handgun), the [[addWeaponGlobal]] command will replace the weapon currently in a slot with the new weapon.
|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";
|x1= <sqf>
_x [[addWeaponGlobal]] "rockets_Skyfire";
{
_x addMagazineGlobal "Laserbatteries";
_x addWeaponGlobal "Laserdesignator";
} forEach allUnits;
</sqf>
 
|x2= <sqf>
{
if (typeOf _x == "O_Heli_Attack_02_black_F") then
{
_x addMagazineGlobal "38Rnd_80mm_rockets";
_x addWeaponGlobal "rockets_Skyfire";
};
};
} [[forEach]] [[vehicles]];</code> |= Example 2
} forEach vehicles;
____________________________________________________________________________________________
</sqf>


| [[removeWeaponGlobal]], [[addWeapon]], [[addMagazine]], [[addMagazineGlobal]] |= See also
|seealso= [[removeWeaponGlobal]] [[addWeapon]] [[addMagazine]] [[addMagazineGlobal]]
}}


{{Note
|user= Killzone_Kid
|timestamp= 20150707184200
|text= If you do not remove weapon first, using this command from dedicated server will duplicate weapon.
}}
}}
<h3 style="display:none">Notes</h3>
<dl class="command_description">
<!-- Note Section BEGIN -->
<!-- Note Section END -->
</dl>
<h3 style='display:none'>Bottom Section</h3>
[[Category:Arma_3:_New_Scripting_Commands_List|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]

Latest revision as of 13:40, 26 July 2023

Arma 3 logo black.png0.76
GAGlobalGEGlobal
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

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.
Retrieved from "https://community.bistudio.com/wiki?title=addWeaponGlobal&oldid=343844"