onPlayerConnect

Disparado quando um cliente termina de se conectar, antes de ele entrar no servidor. É o momento de barrar alguém: o jogador ainda não recebeu nenhum dado do mundo.

Origem

A raiz (root). O elemento do jogador ainda não faz parte do servidor neste ponto, então prenda o manipulador em root.

Parâmetros

Posição	Nome	Tipo	Descrição
1	apelido	string	Apelido que o cliente pediu.
2	ip	string	Endereço de onde o cliente se conectou.
3	senha	string	Sempre vazia — a senha nunca é entregue ao manipulador.
4	identificadores	table	Lista sequencial dos identificadores disponíveis para esta conexão.
5	versao	number	Número do protocolo de rede que o servidor está usando.
6	versaoDoJogador	string	O mesmo número escrito como "0.maior.menor".

Cada item de identificadores é uma string que já vem com o tipo no prefixo: mtax:, mtax2:, ip: ou discord:. Essa é a ordem estável da lista, mas identificadores indisponíveis são omitidos; procure pelo prefixo em vez de depender de um índice fixo. O item ip: repete, com prefixo, o endereço recebido no segundo argumento.

Cancelável

Sim.

Se cancelado, a conexão é recusada e o cliente é desconectado com o motivo passado ao cancelEvent. Um cliente recusado nunca dispara onPlayerJoin nem onPlayerQuit.

Exemplo

local bloqueados = { ["192.0.2.10"] = true }

addEventHandler("onPlayerConnect", root, function(apelido, ip, senha, identificadores)
    if bloqueados[ip] then
        cancelEvent(true, "Endereço bloqueado")
        return
    end

    for _, identificador in ipairs(identificadores) do
        outputDebugString(apelido .. ": " .. identificador)
    end
end)

Veja também

• onPlayerJoin — Disparado quando um jogador termina de conectar e entra no servidor.
• onPlayerQuit — Disparado quando um jogador sai do servidor.
• onPlayerSpawn — Disparado depois que spawnPlayer coloca um jogador no mundo.
• onPlayerChangeNick — Disparado quando o apelido de um jogador vai mudar.
• onPlayerVehicleEnter — Disparado quando um jogador passa a ocupar um veículo.
• onPlayerVehicleExit — Disparado quando um jogador deixa de ocupar um veículo.
• onPlayerWeaponReload — Disparado quando reloadPedWeapon é chamado para um jogador, antes da recarga acontecer.
• onPlayerDetonateSatchels — Disparado quando um jogador vai detonar as próprias cargas explosivas — tanto pelo comando do jogo quanto por detonateSatchels.