View source for PT-BR/RedirectPlayer

__NOTOC__
{{PT-BR/Server_function}}
Esta função redireciona o jogador para um servidor específico.
{{BR/Nota|O mod que usar esta função precisará de '''permissões de ACL''' para funcionar (function.redirectPlayer)}}

==Sintaxe==
<syntaxhighlight lang="lua">
bool redirectPlayer ( player thePlayer, string serverIP = "", int serverPort = 0 [, string serverPassword = "" ] )
</syntaxhighlight>
{{PT-BR/POO||[[player]]:redirect||}}
===Argumentos necessários===
*'''thePlayer:''' O jogador que você quer redirecionar.
*'''serverIP:''' O endereço IP (ou nome de domínio que o endereço utilize) do servidor para qual quer redirecionar o jogador. '''Use uma string vazia para reconectar no servidor em que já estava.'''
*'''serverPort:''' A porta do servidor para qual quer redirecionar o jogador, que geralmente é 22003. '''Coloque 0 para que a porta usada seja a mesma do servidor em que está atualmente.'''

===Argumento opcional===
*'''serverPassword:''' A senha para o servidor, caso o mesmo esteja trancado.

===Retorna===
Retorna ''true'' se o jogador foi redirecionado com sucesso, ''false'' se argumentos inválidos foram especificados.

==Exemplo==

Este exemplo auto-redireciona todos os jogadores que entrarem no servidor para o servidor especificado' IP:PORTA.
<syntaxhighlight lang="lua">
local ip_port = "123.123.1.2:1234"	-- coloque o IP e porta do servidor no seguinte formato: 192.168.1.1:22003
local senha = "senha_para_conectar" -- Se o servidor estiver trancado, coloque a senha aqui (Se não, não precisa especificar a variável na função)

function Redirecionar()
	redirectPlayer(source, gettok(ip_port,1,":"), tonumber(gettok(ip_port,2,":")), senha)
end
addEventHandler ("onPlayerJoin", root, Redirecionar)
</syntaxhighlight>

Este exemplo adiciona o comando "irservidor" usando a sintaxe, "/irservidor IP_servidor Port_servidor [Sen_servidor]".
<syntaxhighlight lang="lua">
function irParaOServidor (playerSource, commandName, IP_servidor, Port_servidor, Sen_servidor)
	if IP_servidor and Port_servidor then -- Se o IP e a Porta foram especificados, então
		if Sen_servidor then -- Se a senha também foi especificada
			redirectPlayer (playerSource, IP_servidor, tonumber(Port_servidor), Sen_servidor) -- redireciona o jogador
		else -- Se a senha não foi especificada
			redirectPlayer (playerSource, IP_servidor, tonumber(Port_servidor))  -- redireciona o jogador para o servidor sem especificar o parâmetro da senha
		end
	else -- Se o IP e a Porta não foram especificados
		outputChatBox ("Erro! Siga a sintaxe: /irservidor IP Porta [Senha]", playerSource) -- Exiba a mensagem de erro para o jogador
	end
end

addCommandHandler ("irservidor", irParaOServidor) 
</syntaxhighlight>

{{New feature/item|3.0120|1.2|3429|
Este exemplo adiciona o comando "reentrar" que pode se parecer com o '''/reconnect''' nativo do MTA.
<syntaxhighlight lang="lua">
function Reentrar (oJogador, cmd)
	redirectPlayer(oJogador)
end
addCommandHandler("reentrar", Reentrar) -- Anexe o comando à função designada
</syntaxhighlight>
}}

==Veja também==
{{BR/Funções de Jogador}}
[[en:redirectPlayer]]