GivePlayerMoney: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 2: Line 2:
{{Server client function}}
{{Server client function}}
This function adds money to a [[player]]'s current money amount.  To set absolute values, [[setPlayerMoney]] can be used.
This function adds money to a [[player]]'s current money amount.  To set absolute values, [[setPlayerMoney]] can be used.
'''Note:''' Using this function client side (not recommended) will not change a players money server side.


==Syntax==  
==Syntax==  

Revision as of 14:02, 15 September 2011

This function adds money to a player's current money amount. To set absolute values, setPlayerMoney can be used. Note: Using this function client side (not recommended) will not change a players money server side.

Syntax

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

Required Arguments

  • thePlayer: the player to whom you are giving the money.
  • amount: a positive integer number specifying the amount of money to give to the player.
Click to collapse [-]
Client
bool givePlayerMoney ( int amount )

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.

Example

Example 1: This example gives a player money when he types "givecash" in console.

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"

Example 2: This example gives a player $1000 money 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", getRootElement(), rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.

See Also