Configuração

O plugin deve funcionar sem necessidade de configuração adicional, mas se você precisar alterar o comportamento do plugin, você está no lugar certo.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

Configuração do plugin (config.yml)

O arquivo config.yml é o coração do plugin, onde você controla todos os aspectos do funcionamento do sistema de prisão. Abaixo estão todas as opções disponíveis com explicações detalhadas.

debug-mode

Ativa ou desativa o modo de depuração. Quando ativado, o plugin registrará informações detalhadas no console para ajudar a identificar problemas.

# Determina o funcionamento da depuração. Valores válidos: [false, true]
debug-mode: false

database

Define como e onde os dados dos jogadores presos serão armazenados. O plugin suporta três tipos de armazenamento:

• SQLITE: Armazena dados em um arquivo local. Ideal para servidores pequenos.
• MYSQL: Conecta a um servidor MySQL externo. Recomendado para servidores médios.
• HIKARI: Usa pool de conexões para MySQL. Recomendado para servidores grandes por melhor performance.

database:
  # Determina o tipo de banco de dados. Valores válidos: [SQLITE, MYSQL, HIKARI (recomendado)]
  storage-type: SQLITE

  # Dados para conexão ao banco de dados MYSQL.
  data:
    # Endereço de conexão do banco de dados. [EX: 127.0.0.1]
    host: localhost
    # Porta de conexão do banco de dados. [EX: 3306]
    port: 3306
    # Nome do banco de dados a ser conectado. [EX: minecraft]
    database: ''
    # Usuário de conexão. [EX: root]
    username: ''
    # Senha do usuário de conexão: [EX: 123]
    password: ''

login-delay

Tempo de espera em ticks (20 ticks = 1 segundo) para carregar os dados do jogador após o login. Essencial para servidores com mina em servidor separado ou redes BungeeCord/Velocity.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Quando ajustar:

• Rede BungeeCord/Velocity: mantenha 20 ou aumente para 40 ticks
• Servidor único: pode usar 10 ticks

load-delay

Tempo de espera em ticks para carregar dados após o servidor iniciar. Previne problemas de carregamento ao iniciar o servidor.

# Delay para carregar os dados depois do servidor ligar
# Necessário para as crates em bloco
# Recomendado: 20 ticks
load-delay: 20

break-only-plugin

Define se jogadores presos só podem quebrar blocos usando a ferramenta fornecida pelo plugin ao serem presos.

# Quebrar somente com o item dado pelo plugin?
break-only-plugin: true

• true - Apenas a ferramenta do plugin funciona (recomendado)
• false - Qualquer ferramenta pode quebrar blocos

minus-offline

Define se o tempo de pena diminui quando o jogador está offline. Afeta diretamente a duração efetiva das penas.

# Diminuir o tempo de jogadores offline
minus-offline: false

• false - Tempo só diminui quando online (recomendado)
• true - Tempo diminui mesmo offline

Exemplo de impacto:

• false: Jogador preso por 1 hora deve ficar 1 hora online na prisão
• true: Jogador preso por 1 hora será solto após 1 hora real, mesmo deslogado

arrest-ip

Define se a prisão é vinculada ao IP do jogador. Útil para evitar que jogadores usem contas alternativas.

# Prender por IP
arrest-ip: false

• true - Todas as contas do mesmo IP ficam presas
• false - Apenas a conta presa fica na jail

increase-once

Limita cada jogador a aumentar a pena de um preso apenas uma vez. Evita que um jogador sozinho aumente infinitamente a pena de alguém.

# Ativar incrementar a pena apenas 1x por usuário para cada preso
increase-once: true

• true - Cada jogador pode aumentar a pena 1x por preso (recomendado)
• false - Jogadores podem aumentar ilimitadamente (respeitando o delay)

Cenário com true:

• Player1 aumenta a pena de Preso1 → sucesso
• Player1 tenta aumentar a pena de Preso1 novamente → bloqueado
• Player2 aumenta a pena de Preso1 → sucesso

tag

Tag exibida para jogadores presos através do placeholder relacional do PlaceholderAPI. Visível apenas para quem tem permissão de ver presos.

# Tag para o jogador preso
# é uma placeholder relacional
# Placeholder: %rel_yjail_arrested_tag%
tag: '&c[PRESO]'

Uso comum em plugins de chat:

# Exemplo DeluxeChat
format: '%rel_yjail_arrested_tag% {displayname}: {message}'

nbt-item-delete

Lista de NBT tags de itens que serão deletados em vez de guardados no inventário temporário quando o jogador é preso. Útil para evitar que itens de eventos sejam guardados.

# NBT de Itens que não serão guardados, mas sim deletados
nbt-item-delete:
  - 'yEventos-Item'
  - 'yGuerra-Item'

Exemplo de uso:

nbt-item-delete:
  - 'yEventos-Item'
  - 'yGuerra-Item'
  - 'EventoTemporario'
  - 'ItemBoss'

Todos os itens com essas NBT tags serão removidos permanentemente ao prender o jogador.

general

Configurações gerais de integrações com outros plugins e sistemas externos.

general:
  # Sistema de notificar jogadores presos/soltos (yDiscordHook)
  discordhook:
    enabled: true
    channel: ''
    # Placeholders disponíveis:
    # {player}
    # {staff}
    # {reason}
    # {time}
    embed-arrested: ''
    embed-released: ''
  # Sistema de notificar jogadores presos/soltos em webhook
  webhook:
    enabled: true
    # Placeholders disponíveis:
    # {player}
    # {staff}
    # {reason}
    # {time}
    embed-arrested: 'arrested'
    embed-released: 'released'

discordhook

Integração com o plugin yDiscordHook para enviar notificações personalizadas ao Discord.

Como configurar:

1. Instale o plugin yDiscordHook
2. Configure os embeds no arquivo discord.yml do yDiscordHook
3. Defina o ID do canal e do embed aqui

Exemplo:

discordhook:
  enabled: true
  channel: 'canal-prisoes'
  embed-arrested: 'embed-preso'
  embed-released: 'embed-solto'

webhook

Sistema direto de webhook do Discord. Use o arquivo discord.yml do yJail para configurar os embeds.

Como funciona:

• enabled: true - Ativa o sistema de webhook
• embed-arrested - Nome do embed configurado em discord.yml para quando jogadores são presos
• embed-released - Nome do embed configurado em discord.yml para quando jogadores são soltos