SetWeaponAmmo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{Server function}}  
{{Server function}}  
{{Needs_Checking|I cant actually think of a use for this function anymore.  giveWeapon is capable of doing everything this function does - and from my testing this function doesnt allow giving ammo to a weapon that shares ammo with another, e.g. giving AK-47 ammo when a player has M4 will not work. --[[User:Talidan2|Talidan2]] 17:06, 29 July 2007 (CDT)}} what about getWeaponAmmo, shouldn't we have that? --[[User:Norby89|Norby89]] 06:49, 13 August 2007 (CDT)
Sets the ammo to a certain amount for a specified weapon (if they already have it), regardless of current ammo.
Sets the ammo to a certain amount for a specified weapon (if they already have it), regardless of current ammo.


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua">bool setWeaponAmmo ( player thePlayer, int weapon, int ammo )</syntaxhighlight>  
<syntaxhighlight lang="lua">bool setWeaponAmmo ( player thePlayer, int weapon, int ammo, [int ammoInClip = current] )</syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
Line 11: Line 10:
*'''weapon:''' A whole number integer that refers to a [[weapon]] ID.
*'''weapon:''' A whole number integer that refers to a [[weapon]] ID.
*'''ammo:''' A whole number integer serving as the ammo amount for the given weapon
*'''ammo:''' A whole number integer serving as the ammo amount for the given weapon
===Optional Arguments===
{{OptionalArg}}
{{New feature|3|1.0|
*'''ammoInClip:''' The amount of ammo to set in the player's clip.  This will be taken from the main ammo.  If left unspecified, the current clip will remain.
}}


==Returns==
==Returns==

Revision as of 00:28, 14 February 2009

Sets the ammo to a certain amount for a specified weapon (if they already have it), regardless of current ammo.

Syntax

bool setWeaponAmmo ( player thePlayer, int weapon, int ammo, [int ammoInClip = current] )

Required Arguments

  • thePlayer: A player object referencing the specified player
  • weapon: A whole number integer that refers to a weapon ID.
  • ammo: A whole number integer serving as the ammo amount for the given weapon

Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use. For more information on optional arguments, see optional arguments.

  • ammoInClip: The amount of ammo to set in the player's clip. This will be taken from the main ammo. If left unspecified, the current clip will remain.


Returns

Returns a boolean value true or false that tells you if it was successful or not.

Example

This example will give players an M4 weapon with 200 ammo followed by 5 more ammo when they spawn.

-- TODO: Old code was outdated

See Also


Template:Example Needed