PT-BR/RedirectPlayer

From Multi Theft Auto: Wiki
Jump to navigation Jump to search
The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

Esta função redireciona o jogador para um servidor específico.

Post-it.png 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