SetWeaponAmmo: Difference between revisions
Jump to navigation
Jump to search
(Added an example.) |
No edit summary |
||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{Server function}} | {{Server client function}} | ||
<section name="setWeaponAmmo" class="server" show="true"> | |||
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. | ||
| Line 24: | Line 25: | ||
setWeaponAmmo(randPlayer,35,50) -- Decide we're only going to give them 50 rockets. | setWeaponAmmo(randPlayer,35,50) -- Decide we're only going to give them 50 rockets. | ||
</syntaxhighlight> | </syntaxhighlight> | ||
</section> | |||
<section name="setWeaponAmmo (custom weapons)" class="client" show="true"> | |||
Set the ammo of a custom weapon. | |||
==Syntax== | |||
<syntaxhighlight lang="lua">bool setWeaponAmmo ( weapon theWeapon, int Ammo )</syntaxhighlight> | |||
===Required Arguments=== | |||
* '''theWeapon:''' The weapon to set the ammo of. | |||
* '''Ammo:''' The amount of ammo the weapon has total. | |||
==Returns== | |||
Returns ''true'' on success, ''false'' otherwise. | |||
</section> | |||
==See Also== | ==See Also== | ||
{{Weapon functions}} | {{Weapon functions}} | ||
[[ru:setWeaponAmmo]] | [[ru:setWeaponAmmo]] | ||
Revision as of 23:54, 25 August 2012
Click to collapse [-]
setWeaponAmmoSets 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 totalAmmo, [int ammoInClip = 0] )
Required Arguments
- thePlayer: A player object referencing the specified player
- weapon: A whole number integer that refers to a weapon ID.
- totalAmmo: A whole number integer serving as the total ammo amount for the given weapon (including ammo in clip).
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 or set to 0, the current clip will remain.
Returns
Returns a boolean value true or false that tells you if it was successful or not.
Example
local randPlayer = getRandomPlayer() -- Get a random player giveWeapon(randPlayer,35,100) -- Give them a rocket launcher with 100 rockets. setWeaponAmmo(randPlayer,35,50) -- Decide we're only going to give them 50 rockets.
Click to collapse [-]
setWeaponAmmo (custom weapons)Set the ammo of a custom weapon.
Syntax
bool setWeaponAmmo ( weapon theWeapon, int Ammo )
Required Arguments
- theWeapon: The weapon to set the ammo of.
- Ammo: The amount of ammo the weapon has total.
Returns
Returns true on success, false otherwise.