Difference between revisions of "ammo"

From Bohemia Interactive Community
Jump to navigation Jump to search
m (Text replacement - "<dl class="command_description"> <dd class="notedate">" to "<dl class="command_description"> <dt></dt> <dd class="notedate">")
m (Text replacement - "\|x([0-9])= *<code>([^<]*)<\/code>" to "|x$1= <sqf>$2</sqf>")
(25 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
{{RV|type=command
 
{{RV|type=command
  
| ofp
+
|game1= ofp
 +
|version1= 1.00
  
|1.00
+
|game2= ofpe
 +
|version2= 1.00
 +
 
 +
|game3= arma1
 +
|version3= 1.00
 +
 
 +
|game4= arma2
 +
|version4= 1.00
 +
 
 +
|game5= arma2oa
 +
|version5= 1.50
 +
 
 +
|game6= tkoh
 +
|version6= 1.00
 +
 
 +
|game7= arma3
 +
|version7= 0.50
  
 
|arg= global
 
|arg= global
Line 9: Line 26:
 
|gr1= Unit Inventory
 
|gr1= Unit Inventory
  
| 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. Since Arma v1.56 the command also returns ammo for units in vehicles.
  
| unit '''ammo''' muzzle
+
|s1= unit [[ammo]] muzzle
  
 
|p1= unit: [[Object]]
 
|p1= unit: [[Object]]
Line 17: Line 34:
 
|p2= muzzle: [[String]] - muzzle of a weapon. See the topic [[:Category:Weapons]] for reference about possible values.
 
|p2= muzzle: [[String]] - muzzle of a weapon. See the topic [[:Category:Weapons]] for reference about possible values.
  
| [[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">
 
<dl class="command_description">
<!-- Note Section BEGIN -->
 
  
 +
<dt><dt>
 
<dd class="notedate">Posted on February 17, 2012</dd>
 
<dd class="notedate">Posted on February 17, 2012</dd>
 
<dt class="note">[[User:kju|kju]]</dt>
 
<dt class="note">[[User:kju|kju]]</dt>
 
<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".
 
<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".
  
<!-- Note Section END -->
 
</dl>
 
 
 
 
{{GameCategory|arma1|Scripting Commands}}
 
{{GameCategory|arma2|Scripting Commands}}
 
{{GameCategory|arma3|Scripting Commands}}
 
{{GameCategory|tkoh|Scripting Commands}}
 
  
<!-- CONTINUE Notes -->
 
<dl class="command_description">
 
 
<dt></dt>
 
<dt></dt>
 
<dd class="notedate">Posted on August 30, 2018 - 15:42 (UTC)</dd>
 
<dd class="notedate">Posted on August 30, 2018 - 15:42 (UTC)</dd>
Line 54: Line 60:
 
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>
 
</dd>
 +
 
</dl>
 
</dl>
<!-- DISCONTINUE Notes -->
 

Revision as of 11:21, 13 May 2022

Hover & click on the images for description

Description

Description:
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.
Groups:
Unit Inventory

Syntax

Syntax:
unit ammo muzzle
Parameters:
unit: Object
muzzle: String - muzzle of a weapon. See the topic Weapons 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
Posted on February 17, 2012
kju
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".
Posted on August 30, 2018 - 15:42 (UTC)
.kju
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.