addWeaponGlobal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "|=GROUP1" to "|GROUP1=")
(Fix note)
 
(41 intermediate revisions by 2 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 |Multiplayer Arguments=
|eff= global


|eff= global |Multiplayer Effects=
|gr1= Vehicle Inventory


|gr1= Broken Commands |GROUP1=
|gr2= Unit Inventory
|gr2= Weapons |GROUP2=
____________________________________________________________________________________________


| 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]].
|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]].


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


| unit '''addWeaponGlobal''' weapon |SYNTAX=
|s1= object [[addWeaponGlobal]] weapon


|p1= unit: [[Object]] - unit or vehicle to add the weapon to |PARAMETER1=
|p1= object : [[Object]] - unit or vehicle to add the weapon to


|p2= weapon: [[String]] - weapon class name |PARAMETER2=
|p2= weapon: [[String]] - weapon class name


| [[Nothing]] |RETURNVALUE=
|r1= [[Nothing]]
____________________________________________________________________________________________
 
|x1= <code>{
_x [[addMagazineGlobal]] "Laserbatteries";
_x [[addWeaponGlobal]] "Laserdesignator";
} [[forEach]] [[allUnits]];</code> |EXAMPLE1=


|x2= <code>{
|x1= <sqf>
[[if]] ([[typeOf]] _x == "O_Heli_Attack_02_black_F") [[then]] {
{
_x [[addMagazineGlobal]] "38Rnd_80mm_rockets";
_x addMagazineGlobal "Laserbatteries";
_x [[addWeaponGlobal]] "rockets_Skyfire";
_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> |EXAMPLE2=
} forEach vehicles;
____________________________________________________________________________________________
</sqf>


| [[removeWeaponGlobal]], [[addWeapon]], [[addMagazine]], [[addMagazineGlobal]] |SEEALSO=
|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}}}}]]
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on July 7, 2015 - 18:42 (UTC)</dd>
<dt class="note">[[User:Killzone Kid|Killzone Kid]]</dt>
<dd class="note">
If you do not remove weapon first, using this command from dedicated server will duplicate weapon.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 13:40, 26 July 2023

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.