PT-BR/AddCommandHandler - Revision history

Myonlake at 18:31, 21 February 2021

2021-02-21T18:31:30Z

← Older revision		Revision as of 18:31, 21 February 2021
Line 158:		Line 158:

	[[ar:addCommandHandler]]		[[ar:addCommandHandler]]
			[[en:addCommandHandler]]
	[[hu:addCommandHandler]]		[[hu:addCommandHandler]]
	[[pt-br:AddCommandHandler]]		[[pt-br:AddCommandHandler]]

Myonlake at 18:31, 21 February 2021

2021-02-21T18:31:05Z

← Older revision		Revision as of 18:31, 21 February 2021
Line 157:		Line 157:
	{{Server functions}}		{{Server functions}}

	[[en:addCommandHandler]]		[[ar:addCommandHandler]]
	[[hu:addCommandHandler]]		[[hu:addCommandHandler]]
			[[pt-br:AddCommandHandler]]

LordHenry at 19:17, 6 August 2020

2020-08-06T19:17:52Z

← Older revision		Revision as of 19:17, 6 August 2020
Line 17:		Line 17:
	<section name="Lado servidor" class="server" show="true">		<section name="Lado servidor" class="server" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool addCommandHandler ( string ~~nomeDoComando~~, function handlerFunction [, bool ~~restrito~~ = false, bool ~~casoSensitivo~~ = true ] )		bool addCommandHandler ( string commandName, function handlerFunction [, bool restricted = false, bool caseSensitive = true ] )
	</syntaxhighlight>		</syntaxhighlight>

	===Argumentos Necessários===		===Argumentos Necessários===
	*'''~~nomeDoComando~~:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.		*'''commandName:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
	*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, ~~jogadorSource~~ e ~~nomeDoComando~~, seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.		*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, ''playerSource'' e ''commandName'', seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.

	====Parâmetros da função callback====		====Parâmetros da função callback====
	:Esses são os parâmetros que serão definidos na função quando o comando for executado		:Esses são os parâmetros que serão definidos na função quando o comando for executado
	:<syntaxhighlight lang="lua">player ~~jogadorSource~~, string ~~nomeDoComando~~ [, string arg1, string arg2, ... ] </syntaxhighlight>		:<syntaxhighlight lang="lua">player playerSource, string commandName [, string arg1, string arg2, ... ] </syntaxhighlight>

	:* '''~~jogadorSource~~:''' O jogador que acionou o comando ou o [[Element/Console\|server console]]. Se não for acionado por um jogador e nem pelo console do servidor, isso será '' false ''.		:* '''playerSource:''' O jogador que acionou o comando ou o [[Element/Console\|server console]]. Se não for acionado por um jogador e nem pelo console do servidor, isso será '' false ''.
	:* '''~~nomeDoComando~~:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.		:* '''commandName:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.
	:* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Exemplo 2 (server-side)''' abaixo.		:* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Exemplo 2 (server-side)''' abaixo.
	</br>		</br>
	===Argumentos Opcionais===		===Argumentos Opcionais===
	{{BR/ArgOpcional}}		{{BR/ArgOpcional}}
	*'''~~restrito~~:''' Especifique se esse comando deve ou não ser restrito por padrão. Use isso em comandos que devem estar inacessíveis para todos como padrão, exceto usuários especiais especificados na ACL (Lista de controle de acesso). Isso é para garantir que comandos de administração, como por exemplo: 'punish' não estará disponível para todos se um administrador de servidor esquecer de mascará-lo na ACL. Certifique-se de adicionar o comando à sua ACL no grupo apropriado para que seja útil (ou seja, <right name = "command.~~killEveryone~~" access = "true"> </right>). O argumento padrão é false se nada for especificado.		*'''restricted:''' Especifique se esse comando deve ou não ser restrito por padrão. Use isso em comandos que devem estar inacessíveis para todos como padrão, exceto usuários especiais especificados na ACL (Lista de controle de acesso). Isso é para garantir que comandos de administração, como por exemplo: 'punish' não estará disponível para todos se um administrador de servidor esquecer de mascará-lo na ACL. Certifique-se de adicionar o comando à sua ACL no grupo apropriado para que seja útil (ou seja, <right name = "command.punish" access = "true"> </right>). O argumento padrão é false se nada for especificado.
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''~~casoSensitivo~~:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.		*'''caseSensitive:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
	}}		}}

Line 44:		Line 44:
	<section name="Lado cliente" class="client" show="true">		<section name="Lado cliente" class="client" show="true">
	<syntaxhighlight lang="lua">		<syntaxhighlight lang="lua">
	bool addCommandHandler ( string ~~nomeDoComando~~, function handlerFunction [, bool ~~casoSensitivo~~ = true ] )		bool addCommandHandler ( string commandName, function handlerFunction [, bool caseSensitive = true ] )
	</syntaxhighlight>		</syntaxhighlight>

	===Argumentos Necessários===		===Argumentos Necessários===
	*'''~~nomeDoComando~~:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.		*'''commandName:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
	*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter ~~dois parâmetros, jogadorSource e nomeDoComando~~, ~~seguidos~~ de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.		*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter o parâmetro ''commandName'', seguido de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.
	====Parâmetros da função callback====		====Parâmetros da função callback====
	:Esses são os parâmetros que serão definidos na função quando o comando for executado		:Esses são os parâmetros que serão definidos na função quando o comando for executado
	:<syntaxhighlight lang="lua">string ~~nomeDoComando~~ [, string arg1, string arg2, ... ] </syntaxhighlight>		:<syntaxhighlight lang="lua">string commandName [, string arg1, string arg2, ... ] </syntaxhighlight>
	:* '''~~nomeDoComando~~:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.		:* '''commandName:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.
	:* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Exemplo 2 (server-side)''' abaixo.		:* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Exemplo 2 (server-side)''' abaixo.
	</br>		</br>
Line 59:		Line 59:
	{{BR/ArgOpcional}}		{{BR/ArgOpcional}}
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''~~casoSensitivo~~:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.		*'''caseSensitive:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
	}}		}}
	</section>		</section>
Line 157:		Line 157:
	{{Server functions}}		{{Server functions}}

			[[en:addCommandHandler]]
	[[hu:addCommandHandler]]		[[hu:addCommandHandler]]

LordHenry: LordHenry moved page AddCommandHandler/PT-BR to PT-BR/AddCommandHandler over redirect: Default from other languages.

2020-08-06T19:00:20Z

LordHenry moved page AddCommandHandler/PT-BR to PT-BR/AddCommandHandler over redirect: Default from other languages.

← Older revision

Revision as of 19:00, 6 August 2020

Lettify at 19:05, 13 June 2020

2020-06-13T19:05:37Z

← Older revision		Revision as of 19:05, 13 June 2020
Line 36:		Line 36:
	*'''restrito:''' Especifique se esse comando deve ou não ser restrito por padrão. Use isso em comandos que devem estar inacessíveis para todos como padrão, exceto usuários especiais especificados na ACL (Lista de controle de acesso). Isso é para garantir que comandos de administração, como por exemplo: 'punish' não estará disponível para todos se um administrador de servidor esquecer de mascará-lo na ACL. Certifique-se de adicionar o comando à sua ACL no grupo apropriado para que seja útil (ou seja, <right name = "command.killEveryone" access = "true"> </right>). O argumento padrão é false se nada for especificado.		*'''restrito:''' Especifique se esse comando deve ou não ser restrito por padrão. Use isso em comandos que devem estar inacessíveis para todos como padrão, exceto usuários especiais especificados na ACL (Lista de controle de acesso). Isso é para garantir que comandos de administração, como por exemplo: 'punish' não estará disponível para todos se um administrador de servidor esquecer de mascará-lo na ACL. Certifique-se de adicionar o comando à sua ACL no grupo apropriado para que seja útil (ou seja, <right name = "command.killEveryone" access = "true"> </right>). O argumento padrão é false se nada for especificado.
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo ~~com os caracteres maiúsculos e minúsculos exatamente~~ como especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.		*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
	}}		}}

Line 59:		Line 59:
	{{BR/ArgOpcional}}		{{BR/ArgOpcional}}
	{{New feature\|3\|1.0\|		{{New feature\|3\|1.0\|
	*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo ~~com os caracteres maiúsculos e minúsculos exatamente~~ como especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.		*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo da mesma forma como foi especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
	}}		}}
	</section>		</section>

Lettify: Alteração da posição das sintaxes da função callback do command handler

2020-05-01T23:18:08Z

Alteração da posição das sintaxes da função callback do command handler

@@ Line 20: / Line 20: @@
 </syntaxhighlight>
-===Required Arguments===
+===Argumentos Necessários===
 *'''nomeDoComando:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
 *'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, jogadorSource e nomeDoComando, seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.
 ===Argumentos Opcionais===
 {{BR/ArgOpcional}}
@@ Line 38: / Line 47: @@
 </syntaxhighlight>
-===Required Arguments===
+===Argumentos Necessários===
 *'''nomeDoComando:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
 *'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, jogadorSource e nomeDoComando, seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.
 ===Argumentos Opcionais===
 {{BR/ArgOpcional}}
@@ Line 48: / Line 63: @@
 </section>
 ===Retornos===

Lettify: Lettify moved page PT-BR/AddCommandHandler to AddCommandHandler/PT-BR: Deixar pesquisa pela página mais abrangente

2020-02-04T19:45:57Z

Lettify moved page PT-BR/AddCommandHandler to AddCommandHandler/PT-BR: Deixar pesquisa pela página mais abrangente

← Older revision

Revision as of 19:45, 4 February 2020

Lettify: Lettify moved page BR/AddCommandHandler to PT-BR/AddCommandHandler: Padronização com os restantes das funções que foram traduzidas de formas semelhantes

2020-02-03T03:10:43Z

Lettify moved page BR/AddCommandHandler to PT-BR/AddCommandHandler: Padronização com os restantes das funções que foram traduzidas de formas semelhantes

← Older revision

Revision as of 03:10, 3 February 2020

Lettify: Lettify moved page PT/AddCommandHandler to BR/AddCommandHandler

2020-02-03T03:08:44Z

Lettify moved page PT/AddCommandHandler to BR/AddCommandHandler

← Older revision

Revision as of 03:08, 3 February 2020

Lettify: Created page with "NOTOC {{BR/Função compartilhada}} {{BR/Nota Importante|'''NÃO''' use o mesmo nome do comando para a sua função, pois isso pode causar confusão se várias funções..."

2020-02-03T03:07:29Z

Created page with "__NOTOC__ {{BR/Função compartilhada}} {{BR/Nota Importante|'''NÃO''' use o mesmo nome do comando para a sua função, pois isso pode causar confusão se várias funções..."

New page

__NOTOC__
{{BR/Função compartilhada}}
{{BR/Nota Importante|'''NÃO''' use o mesmo nome do comando para a sua função, pois isso pode causar confusão se várias funções forem usadas pelo mesmo comando. Use um nome que descreva o objetivo de sua função mais especificamente.}}
Essa função anexará uma função (handler) de script à um comando do console, para que sempre que um jogador ou administrador use o comando, a função seja chamada.

Vários manipuladores de comando podem ser anexados a um único comando e serão chamados na ordem em que os manipuladores foram anexados. Da mesma forma, vários comandos podem ser manipulados por uma única função e o parâmetro '' nomeDoComando '' é usado para decidir o curso da ação.

Para usuários, um comando está no formato:

''nomeDoComando'' ''argumento1'' ''argumento2''

Isso pode ser acionado no console do jogador ou diretamente da caixa de bate-papo, prefixando a mensagem com uma barra ('' / ''). O administrador do servidor também poderá executar o comando através do console do servidor, da mesma maneira que são acionados no console do jogador.
{{BR/Nota|Você não pode usar "check", "list", "test" ou outro nome que já exista de forma nativa como um nome de comando.}}

==Sintaxe==

<section name="Lado servidor" class="server" show="true">
<syntaxhighlight lang="lua">
bool addCommandHandler ( string nomeDoComando, function handlerFunction [, bool restrito = false, bool casoSensitivo = true ] )
</syntaxhighlight>

===Required Arguments===
*'''nomeDoComando:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, jogadorSource e nomeDoComando, seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.
===Argumentos Opcionais===
{{BR/ArgOpcional}}
*'''restrito:''' Especifique se esse comando deve ou não ser restrito por padrão. Use isso em comandos que devem estar inacessíveis para todos como padrão, exceto usuários especiais especificados na ACL (Lista de controle de acesso). Isso é para garantir que comandos de administração, como por exemplo: 'punish' não estará disponível para todos se um administrador de servidor esquecer de mascará-lo na ACL. Certifique-se de adicionar o comando à sua ACL no grupo apropriado para que seja útil (ou seja, <right name = "command.killEveryone" access = "true"> </right>). O argumento padrão é false se nada for especificado.
{{New feature|3|1.0|
*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo com os caracteres maiúsculos e minúsculos exatamente como especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
}}

</section>

<section name="Lado cliente" class="client" show="true">
<syntaxhighlight lang="lua">
bool addCommandHandler ( string nomeDoComando, function handlerFunction [, bool casoSensitivo = true ] )
</syntaxhighlight>

===Required Arguments===
*'''nomeDoComando:''' Este é o nome do comando ao qual você deseja anexar um manipulador. É isso que deve ser digitado no console para ativar a função.
*'''handlerFunction:''' Essa é a função que você deseja que o comando seja acionado, que deve ser definida antes da adição do manipulador. Esta função pode ter dois parâmetros, jogadorSource e nomeDoComando, seguidos de quantos parâmetros você espera após o seu comando (veja abaixo). Tudo isso é opcional.
===Argumentos Opcionais===
{{BR/ArgOpcional}}
{{New feature|3|1.0|
*'''casoSensitivo:''' Especifica se o manipulador de comando ignorará o caso sensitivo para esse nome de comando. Se true, para executar o comando deve digitá-lo com os caracteres maiúsculos e minúsculos exatamente como especificado no 1° argumento, se false, independente de maiúsculas ou minúsculas, o comando será executado.
}}
</section>

====Parâmetros da função acionada pelo comando====
Esses são os parâmetros para a função manipuladora que é chamada quando o comando é usado.
<section name="Lado servidor" class="server" show="true">
<syntaxhighlight lang="lua">player jogadorSource, string nomeDoComando [, string arg1, string arg2, ... ] </syntaxhighlight>

* '''jogadorSource:''' O jogador que acionou o comando ou o [[Element/Console|server console]]. Se não for acionado por um jogador e nem pelo console do servidor, isso será '' false ''.
* '''nomeDoComando:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.
* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Server Example 2''' abaixo.
</section>

<section name="Lado cliente" class="client" show="true">
<syntaxhighlight lang="lua">string nomeDoComando [, string arg1, string arg2, ... ] </syntaxhighlight>
* '''nomeDoComando:''' O nome do comando acionado. Isso é útil se vários comandos acionam uma só função.
* '''arg1, arg2, ...:''' Cada palavra após o nome do comando no comando original é passada aqui em uma variável separada. Se não houver valor para um argumento, sua variável conterá [[nil]]. Você pode lidar com um número variável de argumentos usando a expressão vararg, conforme mostrado em '''Server Example 2''' abaixo.
</section>

===Retornos===
Retorna ''true'' se o manipulador de comandos foi adicionado com sucesso, ''false'' caso contrário.

==Exemplos==
<section name="Lado servidor" class="server" show="true">
'''Exemplo 1:''' Este exemplo criará um comando chamado ''createmarker''. Isso vai criar um [[marker]] vermelho na posição do jogador que o usa.
<syntaxhighlight lang="lua">
-- Defina nossa função que será chamada pelo comando
function consoleCreateMarker ( playerSource, commandName )
-- Se um jogador quem acionou a função (em vez do administrador) então
if ( playerSource ) then
-- Obtém a posição do jogador
local x, y, z = getElementPosition ( playerSource )
-- Cria um marker vermelho do tipo checkpoint e de tamanho 2 na posição do jogador
createMarker ( x, y, z, "checkpoint", 2, 255, 0, 0, 255 )
-- Diga ao jogador sobre o marker
outputChatBox ( "Você tem um marker vermelho :D", playerSource )
end
end
-- Anexe a função 'consoleCreateMarker' ao comando "createmarker"
addCommandHandler ( "createmarker", consoleCreateMarker )
</syntaxhighlight>
</section>

<section name="Lado servidor" class="server" show="hide">
'''Exemplo 2:''' Este exemplo utiliza a expressão vararg de Lua para implementar um comando ''check_parameters'' para contar o número de parâmetros passados, mesclá-los todos em uma única string e produzi-los. Isso também mostra como você pode usar o ''table.concat'' para mesclar todos os argumentos passados. Isso é particularmente útil quando você deseja ler uma frase do texto passada pelo usuário.
<syntaxhighlight lang="lua">
-- Defina a função que será acionada pelo comando (que pode aceitar várias quantidades de variáveis de argumentos após commandName)
function consoleCheckParameters ( playerSource, commandName, ... )
-- Se o jogador (não admin) que chamou esta função
if playerSource then
local arg = {...}
-- Obtém o número de argumentos na tabela arg (a tabela arg é o mesmo que: {...})
local parameterCount = #arg
-- Mencione isso no chat do jogador
outputChatBox ( "Number of parameters: " .. parameterCount, playerSource )
-- Junte-os em uma única sequência separada por vírgula
local stringWithAllParameters = table.concat( arg, ", " )
-- Mostre isto para o jogador através do chat
outputChatBox ( "Parameters passed: " .. stringWithAllParameters, playerSource )
end
end
-- Anexe a função 'consoleCheckParameters' ao comando "check_parameters"
addCommandHandler ( "check_parameters", consoleCheckParameters )
</syntaxhighlight>
</section>

<section name="Lado servidor" class="server" show="hide">
'''Exemplo 3:''' Este exemplo mostra o uso de uma única função que é acionada por vários comandos. Isso não é recomendado para uso geral, pois torna o código mais difícil de entender, mas onde vários comandos compartilham alguma lógica, pode ser uma maneira útil de reduzir o código duplicado. Geralmente, seria preferível colocar essa lógica compartilhada em uma função separada, pois isso oferece mais controle sobre o fluxo.

<syntaxhighlight lang="lua">
-- crie a função
function moneyCmd(player, commandName, amount)
if getElementData(player, "canUseMoneyFunctions") then -- a lógica compartilhada
if commandName == "givemoney" then
amount = tonumber(amount)
if amount then
givePlayerMoney(player, amount)
else
outputChatBox("[usage] /givemoney [amount]", player)
end
else if commandName == "takemoney" then
amount = tonumber(amount)
if amount then
takePlayerMoney(player, amount)
else
outputChatBox("[usage] /takemoney [amount]", player)
end
end
else
outputChatBox("Você não pode usar este comando", player)
end
end

addCommandHandler("givemoney", moneyCmd);
addCommandHandler("takemoney", moneyCmd);
</syntaxhighlight>
</section>

<section name="Lado cliente" class="client" show="false">
'''Example 1:''' Este exemplo direciona o player para um local aleatório próximo (útil para quando um player fica preso em algum lugar).

<syntaxhighlight lang="lua">function escapeMe ( commandName )
local x, y, z = getElementPosition ( localPlayer ) -- Obtém a posição do jogador
setElementPosition ( localPlayer, x+(math.random(-10,10)), y+(math.random(-10,10)), z+(math.random(1,15)) ) -- Move o jogador aleatoriamente para uma posição perto da anterior. X é x + um número entre -10, 10 e assim por diante.
end
addCommandHandler ( "escape", escapeMe ) -- Quando o jogador digita o comando "/escape" no chat, ou "escape" in console
</syntaxhighlight>
</section>

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

[[hu:addCommandHandler]]

PT-BR/AddCommandHandler - Revision history

Myonlake at 18:31, 21 February 2021

Myonlake at 18:31, 21 February 2021

LordHenry at 19:17, 6 August 2020

LordHenry: LordHenry moved page AddCommandHandler/PT-BR to PT-BR/AddCommandHandler over redirect: Default from other languages.

Lettify at 19:05, 13 June 2020

Lettify: Alteração da posição das sintaxes da função callback do command handler

Lettify: Lettify moved page PT-BR/AddCommandHandler to AddCommandHandler/PT-BR: Deixar pesquisa pela página mais abrangente

Lettify: Lettify moved page BR/AddCommandHandler to PT-BR/AddCommandHandler: Padronização com os restantes das funções que foram traduzidas de formas semelhantes

Lettify: Lettify moved page PT/AddCommandHandler to BR/AddCommandHandler

Lettify: Created page with "__NOTOC__ {{BR/Função compartilhada}} {{BR/Nota Importante|'''NÃO''' use o mesmo nome do comando para a sua função, pois isso pode causar confusão se várias funções..."

Lettify: Created page with "NOTOC {{BR/Função compartilhada}} {{BR/Nota Importante|'''NÃO''' use o mesmo nome do comando para a sua função, pois isso pode causar confusão se várias funções..."