PT-BR/givePlayerMoney

From Multi Theft Auto: Wiki
Revision as of 00:59, 11 March 2020 by Lettify (talk | contribs) (Nova atribuição no link da palavra 'jogador' que redireciona para uma versão em português)
Jump to navigation Jump to search

Esta função soma uma certa quantia em dinheiro ao dinheiro já existente de um determinado jogador. Se quiser definir o dinheiro do jogador como um todo ao invés de adicionar ao já existente, consulte a função setPlayerMoney.


Post-it.png Nota: Usar esta função no lado cliente (não recomendado) não altera o dinheiro do jogador no lado servidor.

Sintaxe

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

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: player:giveMoney(...)
Variável: .money

Argumentos obrigatórios

  • thePlayer: o jogador o qual receberá o dinheiro.
  • amount: um valor inteiro, positivo, representando a quantidade de dinheiro que será dada ao jogador.
Click to collapse [-]
Client
bool givePlayerMoney ( int amount )

Sintaxe POO(OOP) Não entendeu o que significa isso?

Método: Player.giveMoney(...)

Argumentos obrigatórios

  • amount: um valor inteiro, positivo, representando a quantidade de dinheiro que será dada ao jogador.

Retorno

Retorna true se o dinheiro foi adicionado com sucesso, ou false caso algum parâmetro passado seja inválido.

Exemplo

Click to collapse [-]
Example 1 - Client and Server

Este exemplo dá ao jogador uma certa quantia de dinheiro quando este usar o comando "/givecash <quantidade>". Ao digitar "/givecash 5000", por exemplo, o jogador recebe 5.000. 

-- Função chamada quando o comando "/givecash <quantidade>" é digitado
function consoleGiveCash ( thePlayer, command, amount )

	-- Dá a quantidade informada no comando ao jogador que o digitou
	givePlayerMoney ( thePlayer, amount )
end

-- Cria o comando "givecash" informando qual função deve ser chamada quando o comando for digitado
addCommandHandler ( "givecash", consoleGiveCash  )
Click to collapse [-]
Example 2 - Server

Este exemplo dá ao jogador mil "dólares" como recompensa por matar outro jogador. 

function rewardOnWasted ( ammo, killer, killerweapon, bodypart )
	
	-- Se existir um assassino, e o assassino não for o mesmo jogador que morreu
	if ( killer ) and ( killer ~= source ) then 

		-- Dá ao assassino 1000 em dinheiro
		givePlayerMoney ( killer, 1000 )
	end
end

-- Aplica a função "#rewardOnWasted" ao evento "onPlayerWasted", que é emitido sempre que um jogador morre
addEventHandler ( "onPlayerWasted", getRootElement(), rewardOnWasted )
Click to collapse [-]
Example 3 - Server

Este exemplo cria um coletável no chão que, ao ser coletado, dá 30.000 ao jogador. 

-- Cria o coletável no chão
local money = createPickup (1896.4000244141, -1950.9000244141, 13, 3, 1274, 10000 )

-- Função chamada quando o evento "onPickupUse" é emitido
function pickupUse ( player )
    givePlayerMoney ( player, 30000 )
end

-- Aplica a função "#pickupUse" ao evento "onPickupUse", que é emitido sempre que um jogador para em um coletável estando a pé
addEventHandler ( "onPickupUse", money, pickupUse )

Veja também

Retrieved from "https://wiki.multitheftauto.com/wiki/PT-BR/givePlayerMoney?oldid=65362"