# onPlayerConnect (Servidor)

> Disparado quando uma conexão vai ser aceita, antes de o jogador existir. Cancelar o evento recusa a entrada.

- **Plataforma**: MY Multiplayer (MYMP)
- **Tipo**: Evento Lua
- **Lado**: Servidor
- **Categoria**: Jogadores e contas
- **Cancelável**: `cancelEvent`
- **URL**: https://wiki.mymp.gg/pt/onPlayerConnect

## Sintaxe

```lua
addEventHandler("onPlayerConnect", root, function(string playerName) ... end)
```

## Parâmetros do handler

| Nome | Tipo | Descrição |
| --- | --- | --- |
| `playerName` | `string` | Nome com que o jogador vai entrar: `Nome#Tag` da conta num servidor com `server_key`, senão o nome que ele trouxe. |

## Source

O elemento raiz (`root`). O jogador ainda não existe.

## Exemplo

```lua
local banned = { ["Griefer#0001"] = true }

addEventHandler("onPlayerConnect", root, function(playerName)
    if banned[playerName] then
        cancelEvent()
    end
end)
```

## Veja também

- [onPlayerJoin (Servidor)](https://wiki.mymp.gg/pt/onPlayerJoin.md): Disparado quando um jogador terminou de entrar e já recebeu o estado inicial do servidor.
- [onPlayerQueue (Servidor)](https://wiki.mymp.gg/pt/onPlayerQueue.md): Disparado quando uma conta vai entrar na fila de um servidor cheio. Cancelar o evento recusa a entrada.
- [kickPlayer (Servidor)](https://wiki.mymp.gg/pt/kickPlayer.md): Desconecta um jogador do servidor com um motivo.