PT-BR/RedirectPlayer: Difference between revisions

Latest revision as of 20:22, 1 April 2023

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 1: / Line 1: @@
 __NOTOC__
-{{BR/Funcao servidor}}
+{{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)}}
@@ Line 58: / Line 58: @@
 addCommandHandler("reentrar", Reentrar) -- Anexe o comando à função designada
 </syntaxhighlight>
-|PT-BR}}
+}}
 ==Veja também==
 {{BR/Funções de Jogador}}
 [[en:redirectPlayer]]