SetPlayerMoney: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:


==Syntax==  
==Syntax==  
<syntaxhighlight lang="lua"> bool setPlayerMoney ( player thePlayer, int amount ) </syntaxhighlight>  
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setPlayerMoney ( player thePlayer, int amount ) </syntaxhighlight>  


===Required Arguments===  
===Required Arguments===  
*'''thePlayer:''' Which player to set the money of
*'''thePlayer:''' Which player to set the money of
*'''amount:''' A whole integer specifying the new amount of money the player will have
*'''amount:''' A whole integer specifying the new amount of money the player will have
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setPlayerMoney (int amount ) </syntaxhighlight>
===Required Arguments===
*'''amount:''' A whole integer specifying the new amount of money the local player will have
</section>


===Returns===
===Returns===

Revision as of 22:06, 22 September 2009

Sets a player's money to a certain value, regardless of current player money. It should be noted that setting negative values does not work and in fact gives the player large amounts of money.

Syntax

Click to collapse [-]
Server
bool setPlayerMoney ( player thePlayer, int amount ) 

Required Arguments

  • thePlayer: Which player to set the money of
  • amount: A whole integer specifying the new amount of money the player will have
Click to collapse [-]
Client
bool setPlayerMoney (int amount ) 

Required Arguments

  • amount: A whole integer specifying the new amount of money the local player will have

Returns

Returns true if the money was added, or false if invalid parameters were passed.

Example

Example 1: This example sets the player's money to the desired amount when he types "setcash" in console.

function setCash ( thePlayer, command, amount )       -- when the setcash function is called
    setPlayerMoney ( thePlayer, tonumber(amount) )    -- change player's money to the desired amount
end
addCommandHandler ( "setcash", setCash )           -- add a command handler for setcash

Example 2: This gives all players the amount of 1337 money when "leet" is typed in console.

function leetmoney()
	setPlayerMoney( getRootElement(), 1337 )
end
addCommandHandler("leet", leetmoney)

See Also