Garry's Mod Wiki

Revision Difference

Player:GetAmmoCount#512634

<function name="GetAmmoCount" parent="Player" type="classfunc">⤶ <description>Gets the amount of ammo the player has.</description>⤶ <realm>Shared</realm>⤶ <args>⤶ <arg name="ammotype" type="any">The ammunition type. Can be either &lt;page&gt;number&lt;/page&gt; ammo ID or &lt;page&gt;string&lt;/page&gt; ammo name.</arg>⤶ </args>⤶ <rets>⤶ <ret name="" type="number">The amount of ammo player has in reserve.</ret>⤶ </rets>⤶ </function>⤶ ⤶ <example>⤶ <description>A function that returns the ammo for the weapon the player is currently holding.</description>⤶ <code>⤶ function GetAmmoForCurrentWeapon( ply )⤶ if ( !IsValid( ply ) ) then return -1 end⤶ ⤶ local wep = ply:GetActiveWeapon()⤶ if ( !IsValid( wep ) ) then return -1 end⤶ ⤶ return ply:GetAmmoCount( wep:GetPrimaryAmmoType() )⤶ end⤶ </code>⤶ <output>31</output>⤶ ⤶ </example>⤶ ⤶ ⤶ <example>⤶ <description>Example usage. "pistol" ammo type has ID of 3.</description>⤶ <code>⤶ print(Entity(1):GetAmmoCount( 3 ))⤶ print(Entity(1):GetAmmoCount( "3" ))⤶ print(Entity(1):GetAmmoCount( "pistol" ) )⤶ </code>⤶ <output>⤶ ⤶ ```⤶ 255⤶ 0⤶ 255⤶ ```⤶ ⤶ </output>⤶ ⤶ </example>