GetPedTotalAmmo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
(Updated issues)
 
(11 intermediate revisions by 7 users not shown)
Line 1: Line 1:
__NOTOC__
__NOTOC__
{{Server client function}}
{{Server client function}}
{{New feature|4|1.0.4|
This function is added server-side in 1.0.4. This means this function will only be available client-side for non-1.0.4 servers.
}}
This function returns an integer that contains the total ammo in a specified [[ped]]'s weapon. See [[weapon|Weapon Info]]
This function returns an integer that contains the total ammo in a specified [[ped]]'s weapon. See [[weapon|Weapon Info]]
{{Note|Clientside, this function will not return a correct value for remote player weapons that aren't in hand.}}


==Syntax==
==Syntax==
Line 10: Line 8:
int getPedTotalAmmo ( ped thePed, [ int weaponSlot = current ] )
int getPedTotalAmmo ( ped thePed, [ int weaponSlot = current ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ped]]:getTotalAmmo}}


===Required Arguments===
===Required Arguments===
Line 24: Line 23:
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
-- Find the player called 'Someguy'
-- Find the player called 'Someguy'
myPlayer = getPlayerFromNick ( "Someguy" )
myPlayer = getPlayerFromName ( "Someguy" )
-- If a player called 'Someguy' was found then
-- If a player called 'Someguy' was found then
if ( myPlayer ) then
if ( myPlayer ) then
Line 33: Line 32:
end
end
</syntaxhighlight>
</syntaxhighlight>
==Issues==
{{Issues|
{{Issue|481|Flame Thrower Ammo Multiples By Ten}}
{{Issue|734|Sometimes wrong count of player ammo, if get it in onPlayerWeaponFire}}
}}


==See Also==
==See Also==
{{Client_ped_functions}}
{{Client_ped_functions}}

Latest revision as of 10:18, 30 January 2022

This function returns an integer that contains the total ammo in a specified ped's weapon. See Weapon Info

[[{{{image}}}|link=|]] Note: Clientside, this function will not return a correct value for remote player weapons that aren't in hand.

Syntax

int getPedTotalAmmo ( ped thePed, [ int weaponSlot = current ] )

OOP Syntax Help! I don't understand this!

Method: ped:getTotalAmmo(...)


Required Arguments

  • thePed: The ped whose ammo you want to check.

Optional Arguments

  • weaponSlot: an integer representing the weapon slot (set to the ped's current slot if not given)

Returns

Returns an int containing the total amount of ammo for the specified ped's weapon, or 0 if the ped specified is invalid.

Example

This example outputs the total amount of ammo a player called Someguy has for his weapon. 

-- Find the player called 'Someguy'
myPlayer = getPlayerFromName ( "Someguy" )
-- If a player called 'Someguy' was found then
if ( myPlayer ) then
	-- Retrieve the total amount of ammo for that player, and store it in a variable called 'ammo'
	ammo = getPedTotalAmmo ( myPlayer )
	-- Tell all the players how much ammo 'Someguy' has
	outputChatBox ( "Someguy's current total ammo: " .. ammo .. "." )
end

Issues

Issue ID Description
#481 Flame Thrower Ammo Multiples By Ten
#734 Sometimes wrong count of player ammo, if get it in onPlayerWeaponFire

See Also


Retrieved from "https://wiki.multitheftauto.com/wiki/GetPedTotalAmmo?oldid=73883"