Avisos

Exemplo completo de configuração

Aqui está um exemplo de como configurar os avisos do plugin:

warns:
  chatting:
    reason: 'Ofensa-Chat'
    # máximo de warns para executar o comando
    max: 2
    # em segundos
    expire: 60
    # comando que será executado ao atingir o max
    commands: [ "tempmute {player} 1d {server} null Ofensa-Chat" ]

Opções disponíveis na configuração

warns

Lista de avisos pré-configurados disponíveis com o comando /warn.

Estrutura básica

Cada aviso possui a seguinte estrutura:

warns:
  [identificador]:
    reason: 'Motivo do aviso'
    max: número
    expire: tempo_em_segundos
    commands: [ "comando1", "comando2" ]

reason

Define o motivo do aviso que será exibido.

Exemplo:

reason: 'Ofensa-Chat'

max

Define o número máximo de avisos antes de executar os comandos configurados.

Exemplo:

max: 2

Quando o jogador atingir este número de avisos ativos, os comandos serão executados automaticamente.

expire

Define o tempo de expiração do aviso em segundos.

Exemplos:

expire: 60      # 1 minuto
expire: 300     # 5 minutos
expire: 1800    # 30 minutos
expire: 3600    # 1 hora
expire: 86400   # 1 dia
expire: 604800  # 7 dias

Após este tempo, o aviso expira e não conta mais para o limite máximo.

commands

Define a lista de comandos que serão executados quando o jogador atingir o número máximo de avisos.

Placeholders disponíveis nos comandos:

{player} - Nome do jogador
{server} - Servidor atual
{reason} - Motivo do aviso

Exemplo:

commands: 
  - "tempmute {player} 1d {server} null Ofensa-Chat"
  - "broadcast &c{player} foi punido por acumular avisos!"

Os comandos são executados sem a barra / no início.

Criando avisos personalizados

Você pode criar quantos avisos personalizados quiser:

warns:
  chatting:
    reason: 'Ofensa-Chat'
    max: 2
    expire: 3600
    commands: [ "tempmute {player} 1d {server} null Ofensa-Chat" ]
  
  spam:
    reason: 'Spam'
    max: 3
    expire: 1800
    commands: [ "tempmute {player} 30m {server} null Spam" ]
  
  caps:
    reason: 'Caps Lock'
    max: 5
    expire: 600
    commands: [ "tempmute {player} 10m {server} null Caps Lock" ]
  
  flood:
    reason: 'Flood'
    max: 3
    expire: 1800
    commands: 
      - "tempmute {player} 1h {server} null Flood"
      - "broadcast &e{player} foi silenciado por flood!"

Tipos de punição nos comandos

Você pode usar diferentes tipos de punição nos comandos:

Mute temporário

commands: [ "tempmute {player} <tempo> {server} <prova/null> <motivo>" ]

Exemplo:

commands: [ "tempmute {player} 1d {server} null Acúmulo de avisos" ]

Mute permanente

commands: [ "mute {player} {server} <prova/null> <motivo>" ]

Exemplo:

commands: [ "mute {player} {server} null Acúmulo de avisos graves" ]

Ban temporário

commands: [ "tempban {player} <tempo> {server} <prova/null> <motivo>" ]

Exemplo:

commands: [ "tempban {player} 3d {server} null Múltiplas infrações" ]

Ban permanente

commands: [ "ban {player} {server} <prova/null> <motivo>" ]

Exemplo:

commands: [ "ban {player} {server} null Comportamento inadequado persistente" ]

Kick

commands: [ "kick {player} <prova/null> <motivo>" ]

Exemplo:

commands: [ "kick {player} null Avisos acumulados" ]

Usando avisos

Para usar os avisos configurados, utilize o comando:

/warn <player> <server/all> <prova/null> <tipo>

Exemplo:

/warn Steve lobby null chatting

Isso aplicará um aviso do tipo chatting ao jogador Steve no servidor lobby.

Use all no lugar do servidor para aplicar o aviso em todos os servidores da rede.

Verificando avisos

Os jogadores e staff podem verificar avisos usando:

/avisos - Abre o menu de avisos do próprio jogador
/avisos [player] - Abre o menu de avisos de outro jogador (requer permissão)
/checkwarn <player> - Lista os avisos de um jogador no chat

Sistema de contagem

O sistema de avisos funciona da seguinte forma:

Jogador recebe um aviso do tipo configurado
O sistema conta quantos avisos ativos (não expirados) o jogador possui daquele tipo
Se atingir o número max, os comandos configurados são executados
Após o tempo de expire, o aviso expira e não conta mais para o limite

Exemplo:

warns:
  chatting:
    max: 3
    expire: 3600  # 1 hora
    commands: [ "tempmute {player} 1d {server} null Ofensa-Chat" ]

Jogador recebe 1º aviso: 1/3 avisos ativos
Jogador recebe 2º aviso: 2/3 avisos ativos
Jogador recebe 3º aviso: 3/3 avisos ativos → Comandos executados (mute de 1 dia)
Após 1 hora: Avisos expiram, contador volta para 0/3

Após adicionar ou modificar avisos, é necessário usar /ypunish reload ou reiniciar o servidor.

Nesta página