hasWeapon: Difference between revisions

Latest revision as of 10:14, 13 May 2022

Hover & click on the images for description

Description:: Checks if a unit has the given weapon in hands or on back/in holster. Weapons inside unit containers such as vest and backpack are not counted.
Groups:: Weapons Unit Inventory

Syntax:: unitName hasWeapon weaponName
Parameters:: unitName: Object
: weaponName: String - the name of the weapon to check for.
Return Value:: Boolean - returns true if the unit has the weapon, false if not.

Example 1:: if !(player hasWeapon "arifle_MX_ACO_pointer_F") then { player addWeapon "arifle_MX_ACO_pointer_F" };

: 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

Benargee - c: Posted on Sep 11, 2014 - 10:49 (UTC)
: This command doesn't work for Items in Arma 3, use this instead (e.g ItemGPS).
"ItemGPS" in (items player + assignedItems player)
Returns true if unit has gps in inventory, assigned or not.

@@ Line 1: / Line 1: @@
-back to [[Scripting_Reference#H|COMREF]]
+{{RV|type=command
-<h2 style="color:#000066">'''''unit'' hasWeapon ''weaponName'''''</h2>
+|game1= ofp
+|version1= 1.00
+|game2= ofpe
+|version2= 1.00
-'''Operand types:'''
+|game3= arma1
+|version3= 1.00
-'''unit:''' [[Object]]
+|game4= arma2
+|version4= 1.00
-'''weaponName:''' [[String]]
+|game5= arma2oa
+|version5= 1.50
-'''Type of returned value:'''
+|game6= tkoh
+|version6= 1.00
-[[Boolean]]
+|game7= arma3
+|version7= 0.50
-'''Description:'''
+|arg= global
-Check if unit has given weapon.
+|gr1= Weapons
+|gr2= Unit Inventory
-'''Example:'''
+|descr= Checks if a unit has the given weapon in hands or on back/in holster. Weapons inside unit containers such as vest and backpack are not counted.
-? ([[player]] '''hasWeapon''' "M16") : [[goto]] "ready"
+|s1= unitName [[hasWeapon]] weaponName
+|p1= unitName: [[Object]]
+|p2= weaponName: [[String]] - the name of the weapon to check for.
+|r1= [[Boolean]] - returns true if the unit has the weapon, false if not.
+|x1= <sqf>if !(player hasWeapon "arifle_MX_ACO_pointer_F") then { player addWeapon "arifle_MX_ACO_pointer_F" };</sqf>
+|seealso= [[weapons]]
+}}
+{{Note
+|user= Benargee
+|timestamp= 20140911104900
+|text= This command doesn't work for Items in Arma 3, use this instead (e.g [[Arma_3_CfgWeapons_Items#ItemGPS|ItemGPS]]).
+<sqf>"ItemGPS" in (items player + assignedItems player)</sqf>
+Returns [[true]] if unit has gps in inventory, assigned or not.
+}}