addWeapon: Difference between revisions

From Bohemia Interactive Community
m (Text replacement - "<sqf>([^↵][^\/]*↵[^\/]*)<\/sqf>" to "<sqf> $1 </sqf>")
mNo edit summary
 
(2 intermediate revisions by 2 users not shown)
Line 45: Line 45:


|r1= [[Nothing]]
|r1= [[Nothing]]
|s2= object [[addWeapon]] [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: [[String]] - (Optional, default [[true]]) [[false]] to abort weapon autoselection if no weapon was selected.
|r2= [[Nothing]]


|x1= <sqf>
|x1= <sqf>

Latest revision as of 08:14, 4 April 2025

Hover & click on the images for description

Description

Description:
Add a weapon to a unit. For a global version of this command see addWeaponGlobal. Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further addWeapon commands are ignored.
a magazine must be added first for the added weapon to be loaded.
In Arma 3 this command can also link items to the inventory slots, the functionality is identical to linkItem command, which it global and thus differ in how it should be used.
Groups:
Unit InventoryVehicle Inventory

Syntax

Syntax:
object addWeapon weapon
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.
Return Value:
Nothing

Alternative Syntax

Syntax:
object addWeapon [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: String - (Optional, default true) false to abort weapon autoselection if no weapon was selected.
Return Value:
Nothing

Examples

Example 1:
player addMagazine "30Rnd_556x45_Stanag"; player addWeapon "BAF_L85A2_RIS_SUSAT";
Example 2:
An_2 addMagazine "100Rnd_762x51_M240"; An_2 addWeapon "M240_veh";

Additional Information

See also:
addWeaponGlobal addWeaponTurret removeWeapon removeAllWeapons addMagazine

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