currentMuzzle: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
(Added note about correct use with vehicles)
m (Text replacement - "<code>([^\[]+)<\/code>" to "<sqf>$1</sqf>")
 
(48 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{Command|= Comments
{{RV|type=command
____________________________________________________________________________________________


| arma2oa |= Game name
|game1= arma2oa
|version1= 1.50


|1.51|= Game version
|game2= tkoh
____________________________________________________________________________________________
|version2= 1.00


| Returns current muzzle of unit's weapon. |= Description
|game3= arma3
____________________________________________________________________________________________
|version3= 0.50


| '''currentMuzzle''' gunner |= Syntax
|gr1= Weapons


|p1= gunner: [[Object]] |=  
|descr= Returns a unit's current weapon muzzle. Does not work on vehicles.


| [[String]] - current muzzle |= Return value
|s1= [[currentMuzzle]] unit
____________________________________________________________________________________________


|x1= <code>_muzzle = [[currentMuzzle]] [[player]];</code> |=
|p1= unit: [[Object]]
|x2= <code>_muzzle = [[currentMuzzle]] ([[gunner]] ([[vehicle]] [[player]]));</code> |=
____________________________________________________________________________________________


| [[currentWeapon]] |= See also
|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= <sqf>_muzzle = currentMuzzle player;</sqf>


<h3 style="display:none">Notes</h3>
|x2= <sqf>_muzzle = currentMuzzle (gunner (vehicle player));</sqf>
<dl class="command_description">
<!-- Note Section BEGIN -->


<!-- Note Section END -->
|seealso= [[currentWeapon]] [[currentMagazine]] [[currentThrowable]]
</dl>
}}
 
<h3 style="display:none">Bottom Section</h3>
 
[[Category:Scripting Commands|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands ArmA2|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting Commands Arma 3|{{uc:{{PAGENAME}}}}]]
[[Category:Scripting_Commands_Take_On_Helicopters|{{uc:{{PAGENAME}}}}]]
[[Category:ArmA 2 OA: New Scripting Commands List|{{uc:{{PAGENAME}}}}]]
 
<!-- CONTINUE Notes -->
<dl class="command_description">
<dd class="notedate">Posted on December 13, 2014 - 22:27 (UTC)</dd>
<dt class="note">[[User:Commy2|Commy2]]</dt>
<dd class="note">
The return value is not always STRING. As of Arma 3 v1.36, this command returns 0 (NUMBER) for vehicles.<br>
<br>
E.g. when inside a vehicle:<br>
<code>[[currentMuzzle]] ([[vehicle]] [[player]])</code><br>
-> 0
 
</dd>
</dl>
 
<dl class="command_description">
<dd class="notedate">Posted on November 9, 2016</dd>
<dt class="note">[[User:Kju|Kju]]</dt>
<dd class="note">
Note:  <code>[[currentMuzzle]] ([[gunner]] ([[vehicle]] [[player]]))</code> still works fine.
</dd>
</dl>
<!-- DISCONTINUE Notes -->

Latest revision as of 21:08, 13 May 2022

Hover & click on the images for description

Description

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

Syntax

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;

Examples

Example 1:
_muzzle = currentMuzzle player;
Example 2:
_muzzle = currentMuzzle (gunner (vehicle player));

Additional Information

See also:
currentWeapon currentMagazine currentThrowable

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