ammo: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - " \{\{GameCategory\|[a-z]+[0-9]?\|Scripting Commands\}\}" to "")
m (Text replacement - "user= kju" to "user= .kju")
 
(15 intermediate revisions by the same user not shown)
Line 26: Line 26:
|gr1= Unit Inventory
|gr1= Unit Inventory


|descr= Check how many rounds are left in the currently loaded magazine in the given muzzle. Since Arma v1.56 the command also returns ammo for units in vehicles.
|descr= Check how many rounds are left in the currently loaded magazine in the given muzzle.
{{Feature|informative|In older titles and before {{arma3}} v1.56, the command did not return ammo for units in vehicles.}}


|s1= unit '''ammo''' muzzle
|s1= unit [[ammo]] muzzle


|p1= unit: [[Object]]
|p1= unit: [[Object]]


|p2= muzzle: [[String]] - muzzle of a weapon. See the topic [[:Category:Weapons]] for reference about possible values.
|p2= muzzle: [[String]] - weapon's muzzle - see the [[:Category:Weapons|Weapons]] topic for reference about possible values


|r1=[[Number]]
|r1= [[Number]]


|x1= <code>_count = [[player]] [[ammo]] "M16"; //returns 30 in case of a full magazine</code>
|x1= <sqf>_count = player ammo "M16"; // returns 30 in case of a full magazine</sqf>


|x2= <code>_count = [[player]] [[ammo]] "M203Muzzle";</code>
|x2= <sqf>_count = player ammo "M203Muzzle";</sqf>


|x3= <code>_count = [[player]] [[ammo]] [[primaryWeapon]] [[player]];</code>
|x3= <sqf>_count = player ammo primaryWeapon player;</sqf>


|seealso= [[setAmmo]], [[someAmmo]], [[magazines]]
|seealso= [[setAmmo]] [[someAmmo]] [[magazines]]
}}
}}


<dl class="command_description">
{{Note
 
|user= .kju
<dt><dt>
|timestamp= 20120217223800
<dd class="notedate">Posted on February 17, 2012</dd>
|text= The command works (now?) also for units in vehicles. However only for the vehicle's gunners' weapons - aka those returned by "weapons vehicle".
<dt class="note">[[User:kju|kju]]</dt>
|game= arma2oa
<dd class="note">'''OA 1.60''': The command works (now?) also for units in vehicles. However only for the vehicle's gunners' weapons - aka those returned by "weapons vehicle".
|version= 1.60
 
}}
</dl>


 
{{Note
<dl class="command_description">
|user= .kju
 
|timestamp= 20180830174200
<dt></dt>
|text= Actually the command wants the <sqf inline>currentMuzzle (gunner _vehicle)</sqf> as parameter - not the weapon class.
<dd class="notedate">Posted on August 30, 2018 - 15:42 (UTC)</dd>
<dt class="note">[[User:.kju|.kju]]</dt>
<dd class="note">
Actually the command wants the [[currentMuzzle]] ([[gunner]] _vehicle) as parameter - not the weapon class.
Most of the time both are the same. However when you have custom [[CfgWeapons_Config_Reference#modes.5B.5D.3D_.7B.22this.22.7D|modes[]]] for the weapons, this is likely not true.
Most of the time both are the same. However when you have custom [[CfgWeapons_Config_Reference#modes.5B.5D.3D_.7B.22this.22.7D|modes[]]] for the weapons, this is likely not true.
</dd>
}}
 
</dl>

Latest revision as of 20:33, 3 May 2024

Hover & click on the images for description

Description

Description:
Check how many rounds are left in the currently loaded magazine in the given muzzle.
In older titles and before Arma 3 v1.56, the command did not return ammo for units in vehicles.
Groups:
Unit Inventory

Syntax

Syntax:
unit ammo muzzle
Parameters:
unit: Object
muzzle: String - weapon's muzzle - see the Weapons topic for reference about possible values
Return Value:
Number

Examples

Example 1:
_count = player ammo "M16"; // returns 30 in case of a full magazine
Example 2:
_count = player ammo "M203Muzzle";
Example 3:

Additional Information

See also:
setAmmo someAmmo magazines

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
.kju - c
Posted on Feb 17, 2012 - 22:38 (UTC)

The command works (now?) also for units in vehicles. However only for the vehicle's gunners' weapons - aka those returned by "weapons vehicle".

.kju - c
Posted on Aug 30, 2018 - 17:42 (UTC)
Actually the command wants the currentMuzzle (gunner _vehicle) as parameter - not the weapon class. Most of the time both are the same. However when you have custom modes[] for the weapons, this is likely not true.