LBLLBL Docs
Discord Bot

Banimentos de Fila

Como banir temporariamente jogadores da fila

Banimentos de Fila

Admins podem banir jogadores da fila por uma duração fixa ou por um número de partidas. Jogadores banidos são removidos imediatamente da fila e não podem entrar novamente até o banimento expirar.

Banir um Jogador

/banir-fila add jogador:@User duração:1 unidade:Partidas [motivo:Texto]

Parâmetros:

ParâmetroDescrição
jogadorO jogador a ser banido
duraçãoValor da duração (mínimo 1)
unidadeUnidade: Partidas, Minutos, Horas ou Dias
motivoMotivo opcional exibido ao jogador

Tipos de Banimento

Por número de partidas

Bane o jogador por um número definido de partidas. O contador decrementa 1 a cada vez que qualquer partida é finalizada no servidor.

/banir-fila add jogador:@User duração:3 unidade:Partidas motivo:Abandono de fila

O jogador vê:

🚫 Você está banido da fila por 3 partidas. Motivo: Abandono de fila

Por tempo

Bane o jogador por um período fixo de tempo.

/banir-fila add jogador:@User duração:24 unidade:Horas
/banir-fila add jogador:@User duração:7 unidade:Dias
/banir-fila add jogador:@User duração:30 unidade:Minutos

O jogador vê uma mensagem com o tempo restante formatado em dias, horas ou minutos conforme o mais legível.


Remover um Banimento

Remove um banimento antecipadamente antes de expirar:

/banir-fila remove jogador:@User

O jogador pode entrar na fila novamente imediatamente após a remoção.


Listar Banimentos Ativos

Veja todos os banimentos ativos no servidor:

/banir-fila list

O embed exibe cada jogador banido com:

  • Contagem restante de partidas (para banimentos por partida)
  • Timestamp de expiração como tempo relativo do Discord (para banimentos por tempo)
  • Motivo do banimento (se fornecido)

Expiração Automática

Os banimentos expiram automaticamente — sem necessidade de ação do admin:

  • Banimentos por tempo — expiram no momento em que expiresAt é atingido. Se o jogador tentar entrar após a expiração, o registro do banimento é limpo automaticamente.
  • Banimentos por partida — o contador decrementa 1 a cada partida finalizada. Quando chega a 0, o banimento é deletado e o jogador pode entrar na próxima fila.

O bot também executa uma limpeza na inicialização e a cada hora para remover registros de banimentos por tempo expirados do banco de dados.


Experiência do Jogador

Quando um jogador banido tenta entrar na fila pelo botão, ele recebe uma mensagem efêmera visível apenas para ele:

🚫 Você está banido da fila por 2 partidas. Motivo: Abandono de fila

Nenhum outro jogador no canal vê a mensagem.