PT-BR/givePlayerMoney: Difference between revisions

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
m (Segunda alteração em templates da página: →‎Nota)
m (Nova atribuição no link da palavra 'jogador' que redireciona para uma versão em português)
Line 1: Line 1:
__NOTOC__  
__NOTOC__  
{{BR/Funcao compartilhada}}
{{BR/Funcao compartilhada}}
Esta função soma uma certa quantia em dinheiro ao dinheiro já existente de um determinado [[player|jogador]]. Se quiser definir o dinheiro do jogador como um todo ao invés de adicionar ao já existente, consulte a função [[setPlayerMoney]].
Esta função soma uma certa quantia em dinheiro ao dinheiro já existente de um determinado [[Elemento/Player|jogador]]. Se quiser definir o dinheiro do jogador como um todo ao invés de adicionar ao já existente, consulte a função [[setPlayerMoney]].


{{BR/Nota|Usar esta função no lado cliente (não recomendado) não altera o dinheiro do jogador no lado servidor.}}
{{BR/Nota|Usar esta função no lado cliente (não recomendado) não altera o dinheiro do jogador no lado servidor.}}

Revision as of 00:59, 11 March 2020

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"