setPlayerMoney | Multi Theft Auto: Wiki Skip to content
Multi Theft Auto: Wiki

setPlayerMoney

Client-side
Server-side
Shared

Pair: getPlayerMoney

Manual Review Required

Please finish this page using the corresponding Old Wiki article. Go to Contribution guidelines for more information.

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.

Note

Using this function client side (not recommended) will not change a players money server side.

OOP Syntax Help! I don't understand this!

  • Method:player:setMoney(...)
  • Variable: .money

Syntax 

bool setPlayerMoney ( int amount, [ bool instant = false ] )
Required Arguments
  • amount: A whole integer specifying the new amount of money the local player will have.
Optional Arguments

NOTE: When using optional arguments, you might need to supply all arguments before the one you wish to use.

  • instant (default: false): If set to true money will be set instantly without counting up/down like in singleplayer.

Returns

  • bool: value

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

Code Examples

server

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

See Also

Player Functions
Player Events
Reference