View source for PT-BR/SetPlayerMoney

__NOTOC__
{{BR/Funcao compartilhada}}
Define o dinheiro de um jogador para um determinado valor, independente do dinheiro atual do jogador. Se o valor definido for um valor negativo não funcionará e dará ao jogador grandes quantias de dinheiro.
{{BR/Nota|Usar essa função no lado cliente (não recomendável) não irá mudar o dinheiro do jogador no servidor.}}

==Sintaxe== 
<section name="Server" class="server" show="true">
<syntaxhighlight lang="lua">
bool setPlayerMoney ( player thePlayer, int amount [, bool instant = false ] ) </syntaxhighlight> 
{{PT-BR/POO||[[player]]:setMoney|money|getPlayerMoney}}
===Argumentos necessários=== 
*'''thePlayer:''' O jogador que você deseja definir o dinheiro.
*'''amount:''' Valor que você deseja definir ao jogador (deve ser um número inteiro e positivo).

===Argumentos opcionais===
{{BR/ArgOpcional}}
{{New items|3.0140|1.4|
*'''instant:''' Se definido com ''true'', definirá o valor instantaneamente (sem a animação do dinheiro sendo adicionado na hud do GTA SA)}}
</section>
<section name="Client" class="client" show="true">
<syntaxhighlight lang="lua">
bool setPlayerMoney ( int amount [, bool instant = false ] ) </syntaxhighlight> 
{{OOP||[[Player]].setMoney||getPlayerMoney}}
===Argumentos necessários=== 
*'''amount:''' Valor que você deseja definir ao jogador (deve ser um número inteiro e positivo).

===Argumentos opcionais===
{{BR/ArgOpcional}}
{{New items|3.0140|1.4|
*'''instant:''' Se definido com ''true'', definirá o valor instantaneamente (sem a animação do dinheiro sendo adicionado na hud do GTA SA)}}
</section>

===Retorna===
Retorna ''true'' se o dinheiro foi definido com sucesso ou ''false'' se os parâmetros passados são inválidos.
==Exemplos==  
'''Exemplo 1:''' Este exemplo define o dinheiro do jogador ao digitar o comando "setcash".
<syntaxhighlight lang="lua">
function setCash(thePlayer, command, amount)       -- when the setcash function is called
	setPlayerMoney(thePlayer, tonumber(amount))    -- change player's money to the desired amount
end
addCommandHandler("setcash", setCash)           -- add a command handler for setcash
</syntaxhighlight>
'''Exemplo 2:''' Este exemplo define o dinheiro de todos os jogadores em 1337 quando o comando "leet" é digitado no console.
<syntaxhighlight lang="lua">
function leetmoney()
	setPlayerMoney(root, 1337)
end
addCommandHandler("leet", leetmoney)
</syntaxhighlight>

==Veja também==
{{Player functions}}

[[en:setPlayerMoney]]
[[ru:setPlayerMoney]]