GetPedAmmoInClip: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
(6 intermediate revisions by 5 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 ammo in a specified [[ped]]'s weapon. See [[weapon|Weapon Info]]
This function returns an integer that contains the ammo in a specified [[ped]]'s weapon. See [[weapon|Weapon Info]]


Line 10: Line 7:
int getPedAmmoInClip ( ped thePed [, int weaponSlot = current ] )
int getPedAmmoInClip ( ped thePed [, int weaponSlot = current ] )
</syntaxhighlight>
</syntaxhighlight>
{{OOP||[[ped]]:getAmmoInClip|ammoInClip}}


===Required Arguments===
===Required Arguments===
Line 23: Line 22:
This example outputs the amount of ammo the specified player has in his current slot. For example: 'ammo someguy'.
This example outputs the amount of ammo the specified player has in his current slot. For example: 'ammo someguy'.
<syntaxhighlight lang="lua">
<syntaxhighlight lang="lua">
function showAmmo( command, who )
function showAmmo(thePlayer, command, who )
local targetPlayer = getPlayerFromNick ( who )
local targetPlayer = getPlayerFromName ( who )
if ( thePlayer ) then
if ( thePlayer ) then
local ammo = getPedAmmoInClip ( targetPlayer )
local ammo = getPedAmmoInClip ( targetPlayer )
Line 34: Line 33:
addCommandHandler( "ammo", showAmmo )
addCommandHandler( "ammo", showAmmo )
</syntaxhighlight>
</syntaxhighlight>
== Issues ==
{{Issues|
{{Issue|7719|[[getPedTotalAmmo]]() & [[getPedAmmoInClip]]() serverside sometimes return invalid values}}
}}


==See Also==
==See Also==
{{Client_ped_functions}}
{{Client_ped_functions}}
[[hu:getPedAmmoInClip]]

Revision as of 15:59, 25 September 2018

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

Syntax

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


OOP Syntax Help! I don't understand this!

Method: ped:getAmmoInClip(...)
Variable: .ammoInClip


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 currently selected slot if not specified).

Returns

Returns an int containing the amount of ammo in the specified ped's currently selected or specified clip, or 0 if the ped specified is invalid.

Example

This example outputs the amount of ammo the specified player has in his current slot. For example: 'ammo someguy'.

function showAmmo(thePlayer, command, who )
	local targetPlayer = getPlayerFromName ( who )
	if ( thePlayer ) then
		local ammo = getPedAmmoInClip ( targetPlayer )
		outputChatBox ( who .. " has " .. ammo .. " ammo in his active clip" )
	else
		outputChatBox ( "Player '" .. who .. "' not found." )
	end
end
addCommandHandler( "ammo", showAmmo )

Issues

Issue ID Description
#7719 getPedTotalAmmo() & getPedAmmoInClip() serverside sometimes return invalid values

See Also