hasWeapon: Difference between revisions

Latest revision as of 10:14, 13 May 2022

1.00

Hover & click on the images for description

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

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.

Examples

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

Additional Information

See also:: weapons

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

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: @@
-[[Category:Scripting Commands]]
+{{RV|type=command
-[[Category:Scripting Commands OFP 1.97]]
-[[Category:Scripting Commands OFP 1.46]]
-[[Category:Scripting Commands ArmA]]
-back to [[Scripting_Reference#H|COMREF]]
+|game1= ofp
+|version1= 1.00
-<h2 style="color:#000066">'''''unit'' hasWeapon ''weaponName'''''</h2>
+|game2= ofpe
+|version2= 1.00
+|game3= arma1
+|version3= 1.00
-'''Operand types:'''
+|game4= arma2
+|version4= 1.00
-'''unit:''' [[Object]]
+|game5= arma2oa
+|version5= 1.50
-'''weaponName:''' [[String]]
+|game6= tkoh
+|version6= 1.00
-'''Type of returned value:'''
+|game7= arma3
+|version7= 0.50
-[[Boolean]]
+|arg= global
-'''Description:'''
+|gr1= Weapons
-Check if unit has given weapon.
+|gr2= Unit Inventory
+|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.
-'''Example:'''
+|s1= unitName [[hasWeapon]] weaponName
-? ([[player]] '''hasWeapon''' "M16") : [[goto]] "ready"
+|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.
+}}