SetPlayerMoney: Difference between revisions
Eficiencia (talk | contribs) No edit summary |
m (mtasa-blue/Client/game_sa/CPlayerInfoSA.cpp, lMoney is a long value, that means it can hold a value up to 2147483647. Some people would assume, because of the admin panel, that the max value is 99999999, but it is not.) |
||
Line 3: | Line 3: | ||
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. | 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.}} | {{Note|Using this function client side (not recommended) will not change a players money server side.}} | ||
{{Note|The max amount of money you can set is 2147483647, after that the value will reverse itself.}} | |||
==Syntax== | ==Syntax== |
Revision as of 10:24, 29 June 2022
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
bool setPlayerMoney ( player thePlayer, int amount [, bool instant = false ] )
OOP Syntax Help! I don't understand this!
- Method: player:setMoney(...)
- Variable: .money
- Counterpart: getPlayerMoney
Required Arguments
- thePlayer: Which player to set the money of.
- amount: A whole integer specifying the new amount of money the player will have.
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.
- instant: If set to true money will be set instantly without counting up/down like in singleplayer.
bool setPlayerMoney ( int amount [, bool instant = false ] )
OOP Syntax Help! I don't understand this!
- Method: Player.setMoney(...)
- Counterpart: getPlayerMoney
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. For more information on optional arguments, see optional arguments.
- instant: If set to true money will be set instantly without counting up/down like in singleplayer.
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 sets all players the amount of 1337 money when "leet" is typed in console.
function leetmoney() setPlayerMoney(root, 1337) end addCommandHandler("leet", leetmoney)
See Also
- getPlayerTeam
- getPlayerBlurLevel
- setPlayerBlurLevel
- getPlayerSerial
- forcePlayerMap
- getPlayerScriptDebugLevel
- getPlayerFromName
- getPlayerMoney
- getPlayerName
- getPlayerNametagColor
- getPlayerNametagText
- getPlayerPing
- getPlayerWantedLevel
- givePlayerMoney
- isPlayerMapForced
- isPlayerNametagShowing
- setPlayerHudComponentVisible
- setPlayerMoney
- setPlayerNametagColor
- setPlayerNametagShowing
- setPlayerNametagText
- takePlayerMoney
- countPlayersInTeam
- getPlayersInTeam
- isVoiceEnabled
- setControlState
- getControlState