PT-BR/RedirectPlayer: Difference between revisions

Revision as of 20:21, 6 August 2020

Template:BR/Funcao servidor Esta função redireciona o jogador para um servidor específico.

	Nota: O mod que usar esta função precisará de permissões de ACL para funcionar (function.redirectPlayer)

Sintaxe

bool redirectPlayer ( player thePlayer, string serverIP = "", int serverPort = 0 [, string serverPassword = "" ] )

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

Método: 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.

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)

Este exemplo adiciona o comando "irservidor" usando a sintaxe, "/irservidor IP_servidor Port_servidor [Sen_servidor]".

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)

Este exemplo adiciona o comando "reentrar" que pode se parecer com o /reconnect nativo do MTA.

function Reentrar (oJogador, cmd)
	redirectPlayer(oJogador)
end
addCommandHandler("reentrar", Reentrar) -- Anexe o comando à função designada

Veja também

@@ Line 6: / Line 6: @@
 ==Sintaxe==
 <syntaxhighlight lang="lua">
-bool redirectPlayer ( player oJogador, string serverIP = "", int serverPort = 0 [, string serverPassword = "" ] )
+bool redirectPlayer ( player thePlayer, string serverIP = "", int serverPort = 0 [, string serverPassword = "" ] )
 </syntaxhighlight>
 {{PT-BR/POO||[[player]]:redirect||}}
 ===Argumentos necessários===
-*'''oJogador:''' O jogador que você quer redirecionar
+*'''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.'''
@@ Line 54: / Line 54: @@
 <syntaxhighlight lang="lua">
 function Reentrar (oJogador, cmd)
-    redirectPlayer(oJogador)
+	redirectPlayer(oJogador)
 end
 addCommandHandler("reentrar", Reentrar) -- Anexe o comando à função designada
@@ Line 62: / Line 62: @@
 ==Veja também==
 {{BR/Funções de Jogador}}
+[[en:redirectPlayer]]