GivePlayerMoney
This function adds money to a player's current money amount. To set absolute values, setPlayerMoney can be used.
Syntax
bool givePlayerMoney ( player thePlayer, int amount )
OOP Syntax Help! I don't understand this!
- Method: player:giveMoney(...)
- Variable: .money
Required Arguments
- thePlayer: the player you are giving the money to.
- amount: a positive integer number specifying the amount of money to give to the player.
bool givePlayerMoney ( int amount )
OOP Syntax Help! I don't understand this!
- Method: Player.giveMoney(...)
Required Arguments
- amount: a positive integer number specifying the amount of money to give to the player.
Returns
Returns true if the money was added, or false if invalid parameters were passed.
Remarks
As of MTA SA version 1.5.9, despite the documentation claiming that amount should be a positive integer, this function does work with negative values or zero. In that case the function does still add the number to the game money value, in the negative case resulting in a decreased value.
Example
This example gives a player money when using "givecash" command.
function consoleGiveCash ( thePlayer, command, amount ) --when the givecash command is called givePlayerMoney ( thePlayer, amount ) --give the player money according to the amount end addCommandHandler ( "givecash", consoleGiveCash ) --add a handler function for the command "givecash"
This example gives a player one thousand dollars, as a reward for killing another player.
function rewardOnWasted ( ammo, killer, killerweapon, bodypart ) --if there is a killer, and that killer is not the same person as whoever died if ( killer ) and ( killer ~= source ) then givePlayerMoney ( killer, 1000 ) --reward the killer with 1000 cash. end end addEventHandler ( "onPlayerWasted", root, rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.
This example Creates money Money (dollar symbol) pickup and gives 30,000 dollars on Pick up hit.
local money = createPickup (1896.4000244141, -1950.9000244141, 13, 3, 1274, 10000 ) function pickupUse ( player ) givePlayerMoney ( player, 30000 ) end addEventHandler ( "onPickupUse", money, pickupUse )
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