SetWeaponAmmo: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
mNo edit summary
Line 10: 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
==Returns==
Returns a boolean value ''true'' or ''false'' that tells you if it was successful or not.


==Example==   
==Example==   

Revision as of 15:57, 1 August 2007


Dialog-information.png This article needs checking.

Reason(s): 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. --Talidan2 17:06, 29 July 2007 (CDT)

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 )

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

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.

function scriptOnSpawnpointUse ( player )
    giveWeapon ( player, 31, 200 ) -- Gives the M4 weapon with 200 ammo to any player when they use a spawnpoint
    setWeaponAmmo ( player, 31, 50 ) -- Sets ammo to 50 for the M4
end
addEventHandler ( "onSpawnpointUse", root, scriptOnSpawnpointUse )

See Also