currentMuzzle: Difference between revisions

Latest revision as of 20:08, 13 May 2022

Hover & click on the images for description

Description:: Returns a unit's current weapon muzzle. Does not work on vehicles.
Groups:: Weapons

Syntax:: currentMuzzle unit
Parameters:: unit: Object
Return Value:: String - current muzzle
⚠
In earlier games/versions, this command could return a Number (0) if unit was in a vehicle.
Use the following to circumvent the issue:

_muzzle = weaponState unit select 1;

: 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

@@ Line 1: / Line 1: @@
 {{RV|type=command
-| arma2oa
+|game1= arma2oa
+|version1= 1.50
-|1.51
+|game2= tkoh
+|version2= 1.00
+|game3= arma3
+|version3= 0.50
 |gr1= Weapons
-| Returns current muzzle of unit's weapon.
+|descr= Returns a unit's current weapon muzzle. Does not work on vehicles.
-{{Feature|Warning|This command will return 0 [[Number]] if given object  is a unit that is in a vehicle.<br>
+|s1= [[currentMuzzle]] unit
-You can alternatively use <code>_muzzle {{=}} [[weaponState]] [[player]] select 1;</code>}}
-| '''currentMuzzle''' gunner
+|p1= unit: [[Object]]
-|p1= gunner: [[Object]]
 |r1= [[String]] - current muzzle
+{{Feature|important|In earlier games/versions, this command could return a [[Number]] ({{hl|0}}) if ''unit'' was in a vehicle.
+Use the following to circumvent the issue:
+<sqf>_muzzle = weaponState unit select 1;</sqf>}}
-|x1= <code>_muzzle = [[currentMuzzle]] [[player]];</code>
+|x1= <sqf>_muzzle = currentMuzzle player;</sqf>
-|x2= <code>_muzzle = [[currentMuzzle]] ([[gunner]] ([[vehicle]] [[player]]));</code>
+|x2= <sqf>_muzzle = currentMuzzle (gunner (vehicle player));</sqf>
-|seealso= [[currentWeapon]]
+|seealso= [[currentWeapon]] [[currentMagazine]] [[currentThrowable]]
 }}
-{{GameCategory|arma2|Scripting Commands}}
-{{GameCategory|arma3|Scripting Commands}}
-{{GameCategory|tkoh|Scripting Commands}}