---
title: "Ban | open.mp"
description: "Bane um jogador que está atualmente online no servidor."
canonical: https://omp.itsneufox.com/pt-BR/docs/scripting/functions/Ban
language: pt-BR
---

# Ban

## Descrição

Bane um jogador que está atualmente online no servidor. Ele não poderá mais entrar no servidor. A proibição será baseada em IP e será salva no arquivo **bans.json** no diretório raiz do servidor. O BanEx pode ser usado para justificar o banimento. Os banimentos de IP podem ser adicionados ou removidos usando os comandos RCON banip e unbanip (SendRconCommand).

| Nome | Descrição |
| --- | --- |
| playerid | O ID do jogador a ser banido. |

## Retorno

Esta função não retorna nenhum valor específico.

## Exemplos

```c
public OnPlayerCommandText(playerid, cmdtext[])
{
    if (strcmp(cmdtext, "/banme", true) == 0)
    {
        // Bane o jogador que executar este comando.
        Ban(playerid);
        return 1;
    }
}
```

```c
// Para exibir uma mensagem (por exemplo, motivo) para o jogador antes que a conexão seja fechada
// você tem que usar um cronômetro (timer) para criar um atraso. Esse atraso precisa ser de apenas alguns milissegundos,
// mas este exemplo usa um segundo inteiro apenas por garantia.

forward DelayedBan(playerid);
public DelayedBan(playerid)
{
    Ban(playerid);
}

public OnPlayerCommandText(playerid, cmdtext[])
{
    if (strcmp(cmdtext, "/banme", true) == 0)
    {
        // Bane o jogador que executar este comando.

        // Primeiro, manda a ele uma mensagem.
        SendClientMessage(playerid, 0xFF0000FF, "Você foi banido!");

        // Bane-os um segundo depois da execução do comando por um cronômetro (timer).
        SetTimerEx("DelayedBan", 1000, false, "d", playerid);
        return 1;
    }
    return 0;
}
```

## Notas

aviso

Qualquer ação realizada diretamente antes do Ban() (como enviar uma mensagem com SendClientMessage) não chegará ao jogador. Um cronômetro (timer) deve ser usado para atrasar o banimento.

## Funções Relacionadas

-   [BanEx](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/BanEx): Bane um jogador com uma razão específica.
-   [Kick](https://omp.itsneufox.com/pt-BR/docs/scripting/functions/Kick): Expulsa um jogador do servidor.