GivePlayerMoney - Revision history

Quiret: added remarks regarding the amount parameter

2021-10-07T05:45:05Z

added remarks regarding the amount parameter

← Older revision		Revision as of 05:45, 7 October 2021
Line 21:		Line 21:
	===Returns===		===Returns===
	Returns ''true'' if the money was added, or ''false'' if invalid parameters were passed.		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==		==Example==

2020-11-04T07:53:38Z

← Older revision		Revision as of 07:53, 4 November 2020
Line 42:		Line 42:
	end		end
	end		end
	addEventHandler ( "onPlayerWasted", ~~getRootElement()~~, rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.		addEventHandler ( "onPlayerWasted", root, rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.
	</syntaxhighlight>		</syntaxhighlight>
	</section>		</section>

2020-08-06T18:20:57Z

2017-09-28T03:39:21Z

2015-04-11T18:11:15Z

Example

← Older revision		Revision as of 18:11, 11 April 2015
Line 44:		Line 44:
	addEventHandler ( "onPlayerWasted", getRootElement(), rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.		addEventHandler ( "onPlayerWasted", getRootElement(), rewardOnWasted ) --attach the rewardOnWasted function to the relevant event.
	</syntaxhighlight>		</syntaxhighlight>
			</section>
			<section show="true" name="Example 3 - Server" class="server">
			This example Creates money Money (dollar symbol) pickup and gives 30,000 dollars on Pick up hit.
			<syntaxhighlight lang="lua">
			local money = createPickup (1896.4000244141, -1950.9000244141, 13, 3, 1274, 10000 )
			function pickupUse ( player )
			givePlayerMoney ( player, 30000 )
			end
			addEventHandler ( "onPickupUse", money, pickupUse )</syntaxhighlight>
	</section>		</section>

2014-12-29T04:26:56Z

fix oop syntax

← Older revision		Revision as of 04:26, 29 December 2014
Line 14:		Line 14:
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>		<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>
	{{OOP\|\|[[Player]].giveMoney~~\|money~~}}		{{OOP\|\|[[Player]].giveMoney}}
	===Required Arguments===		===Required Arguments===
	*'''amount:''' a positive integer number specifying the amount of money to give to the player.		*'''amount:''' a positive integer number specifying the amount of money to give to the player.

2014-12-28T23:19:15Z

add client oop syntax

← Older revision		Revision as of 23:19, 28 December 2014
Line 7:		Line 7:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>		<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>
	{{OOP\|\|[[player]]:giveMoney\|money\|}}		{{OOP\|\|[[player]]:giveMoney\|money}}
	===Required Arguments===		===Required Arguments===
	*'''thePlayer:''' the [[player]] you are giving the money to.		*'''thePlayer:''' the [[player]] you are giving the money to.
Line 14:		Line 14:
	<section name="Client" class="client" show="true">		<section name="Client" class="client" show="true">
	<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>		<syntaxhighlight lang="lua">bool givePlayerMoney ( int amount )</syntaxhighlight>
			{{OOP\|\|[[Player]].giveMoney\|money}}
	===Required Arguments===		===Required Arguments===
	*'''amount:''' a positive integer number specifying the amount of money to give to the player.		*'''amount:''' a positive integer number specifying the amount of money to give to the player.

2014-07-15T04:11:52Z

Syntax: OOP syntax added

← Older revision		Revision as of 04:11, 15 July 2014
Line 7:		Line 7:
	<section name="Server" class="server" show="true">		<section name="Server" class="server" show="true">
	<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>		<syntaxhighlight lang="lua">bool givePlayerMoney ( player thePlayer, int amount )</syntaxhighlight>
			{{OOP\|\|[[player]]:giveMoney\|money\|}}
	===Required Arguments===		===Required Arguments===
	*'''thePlayer:''' the [[player]] you are giving the money to.		*'''thePlayer:''' the [[player]] you are giving the money to.

2012-10-17T09:09:29Z

2012-10-17T07:05:52Z