Punições

Exemplo completo de configuração

Aqui está um exemplo de como configurar as punições do plugin:

punishes:
  chatting:
    reason: 'Ofensa-Chat'
    # Permissão para executar a punição
    permission: 'ypunish.punish.chatting'
    # Mensagem de permissão
    message: '&cVocê precisa ser SUPORTE para executar esta punição.'
    # Tipo de punição
    # BAN - TEMPBAN - MUTE - TEMPMUTE - KICK
    type: 'TEMPMUTE'
    # Duração da punição (apenas para o TEMPMUTE e TEMPBAN)
    duration: 10

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

punishes

Lista de punições pré-configuradas disponíveis com o comando /punir.

Estrutura básica

Cada punição possui a seguinte estrutura:

punishes:
  [identificador]:
    reason: 'Motivo da punição'
    permission: 'ypunish.punish.[identificador]'
    message: '&cMensagem quando não tem permissão.'
    type: 'TIPO'
    duration: tempo

reason

Define o motivo da punição que será exibido.

Exemplo:

reason: 'Ofensa-Chat'

permission

Define a permissão necessária para aplicar esta punição.

Exemplo:

permission: 'ypunish.punish.chatting'

Recomenda-se seguir o padrão ypunish.punish.[identificador] para manter organização.

message

Define a mensagem exibida quando o staff não tem permissão para aplicar a punição.

Exemplo:

message: '&cVocê precisa ser SUPORTE para executar esta punição.'

type

Define o tipo de punição que será aplicada.

Valores válidos:

BAN - Banimento permanente
TEMPBAN - Banimento temporário
MUTE - Mute permanente
TEMPMUTE - Mute temporário
KICK - Expulsão

Exemplo:

type: 'TEMPMUTE'

duration

Define a duração da punição (apenas para TEMPBAN e TEMPMUTE).

Formato de tempo:

Segundos: 10 ou 10s
Minutos: 30m
Horas: 2h
Dias: 7d

Exemplo:

duration: 10  # 10 segundos
duration: 30m  # 30 minutos
duration: 2h  # 2 horas
duration: 7d  # 7 dias

O campo duration é ignorado para punições do tipo BAN, MUTE e KICK.

Criando punições personalizadas

Você pode criar quantas punições personalizadas quiser:

punishes:
  chatting:
    reason: 'Ofensa-Chat'
    permission: 'ypunish.punish.chatting'
    message: '&cVocê precisa ser SUPORTE para executar esta punição.'
    type: 'TEMPMUTE'
    duration: 10m
  
  spam:
    reason: 'Spam'
    permission: 'ypunish.punish.spam'
    message: '&cVocê não tem permissão.'
    type: 'TEMPMUTE'
    duration: 5m
  
  hack:
    reason: 'Uso de hacks'
    permission: 'ypunish.punish.hack'
    message: '&cVocê não tem permissão.'
    type: 'TEMPBAN'
    duration: 7d
  
  toxicidade:
    reason: 'Comportamento tóxico'
    permission: 'ypunish.punish.toxic'
    message: '&cVocê não tem permissão.'
    type: 'BAN'

Usando punições

Para usar as punições configuradas, utilize o comando:

/punir <player> <motivo>

O motivo deve corresponder ao identificador configurado (por exemplo: chatting, spam, hack).

Exemplo:

/punir Steve chatting

Isso aplicará a punição configurada em punishes.chatting ao jogador Steve.

O comando /punir sem especificar o motivo exibirá uma lista de todos os motivos disponíveis.

Após adicionar ou modificar punições, é necessário usar /ypunish reload ou reiniciar o servidor.

Nesta página