addWeapon: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
m (Text replacement - "{{Feature|Informative|" to "{{Feature|informative|")
 
(75 intermediate revisions by 15 users not shown)
Line 1: Line 1:
[[Category:Scripting Commands|A]]
{{RV|type=command
[[Category:Scripting Commands OFP 1.97|A]]
[[Category:Scripting Commands OFP 1.46|A]]
[[Category:Scripting Commands ArmA|A]]


back to [[Scripting_Reference#A|COMREF]]
|game1= ofp
|version1= 1.00


|game2= ofpe
|version2= 1.00


<h2 style="color:#000066">'''''unit'' addWeapon ''weaponName'''''</h2>
|game3= arma1
|version3= 1.00


|game4= arma2
|version4= 1.00


'''Operand types:'''
|game5= arma2oa
|version5= 1.50


'''unit:''' [[Object]]
|game6= tkoh
|version6= 1.00


'''weaponName:''' [[String]]
|game7= arma3
|version7= 0.50


'''Type of returned value:'''
|arg= local


[[Nothing]]
|eff= global


'''Description:'''
|gr1= Unit Inventory


Add weapon to unit.
|gr2= Vehicle Inventory


Note: You can create invalid combinations with this function, like two rifles.
|descr= Add a weapon to a unit. For a global version of this command see [[addWeaponGlobal]].


When doing so, application behaviour is undefined.
Infantry units can only carry a specific number of weapons, once the weapon slots are filled, any further [[addWeapon]] commands are ignored.


{{Feature|informative|a '''magazine''' must be added first for the added weapon to be loaded.}}


'''Example:'''
{{Feature|warning| 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.}}


player '''addWeapon''' "AK74"
|s1= object [[addWeapon]] weapon


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


'''Comments:'''
|p2= weapon: [[String]] - weapon class name. See the topic [[:Category:Weapons]] for reference about possible values.


To ensure that the weapon is loaded at the start of the mission, add at least one magazine ([[addMagazine]]) before adding the weapon.
|r1= [[Nothing]]


To remove weapons use the [[removeAllWeapons]] or the [[removeWeapon]] commands.
|x1= <sqf>player addMagazine "30Rnd_556x45_Stanag";
player addWeapon "BAF_L85A2_RIS_SUSAT";</sqf>
 
|x2= <sqf>An_2 addMagazine "100Rnd_762x51_M240";
An_2 addWeapon "M240_veh";</sqf>
 
|seealso= [[addWeaponGlobal]] [[addWeaponTurret]] [[removeWeapon]] [[removeAllWeapons]] [[addMagazine]]
}}

Latest revision as of 01:25, 2 February 2024

Logo A0.png1.00ofpe logo.png1.00Logo A1 black.png1.00Logo A2.png1.00A2 OA Logo.png1.50tkoh logo small.png1.00Arma 3 logo black.png0.50
LALocalGEGlobal
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

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