addWeaponGlobal: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Bot: Replacing category Scripting Commands Arma 3 with Arma 3: Scripting Commands)
(Fix note)
 
(52 intermediate revisions by 4 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 added weapon if it shares the same slot.
|gr2= Unit Inventory
 
|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}}.}}
____________________________________________________________________________________________
 
|s1= object [[addWeaponGlobal]] weapon


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


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


|p2= weapon: [[String]] - weapon class name |= Parameter 2
|r1= [[Nothing]]


| [[Nothing]] |= Return value
|x1= <sqf>
____________________________________________________________________________________________
{
 
_x addMagazineGlobal "Laserbatteries";
|x1= <code>{
_x addWeaponGlobal "Laserdesignator";
_x [[addMagazineGlobal]] "Laserbatteries";
} forEach allUnits;
_x [[addWeaponGlobal]] "Laserdesignator";
</sqf>
} [[forEach]] [[allUnits]];</code> |= Example 1


|x2= <code>{
|x2= <sqf>
[[if]] ([[typeOf]] _x == "O_Heli_Attack_02_black_F") [[then]] {
{
_x [[addMagazineGlobal]] "38Rnd_80mm_rockets";
if (typeOf _x == "O_Heli_Attack_02_black_F") then
_x [[addWeaponGlobal]] "rockets_Skyfire";
{
_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>
<!-- 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 -->
[[Category:Arma 3: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
[[Category:Arma 3: Scripting Commands]]
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Broken 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"