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 das dominações de arena. 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 das dominações 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

Define o atraso em ticks para carregar os dados do jogador após o login. Útil principalmente para servidores em rede BungeeCord/Velocity onde o jogador precisa sincronizar dados entre servidores.

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

Valores recomendados:

• Servidor único: 20 ticks (1 segundo)
• Rede BungeeCord: 40-60 ticks (2-3 segundos)

limit

Sistema de limite para coleta de recompensas. Controla quantas recompensas podem ser coletadas de uma vez para evitar sobrecarga no servidor.

limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Valores recomendados por tipo de servidor:

• Pequeno (até 50 players): 500-1000
• Médio (50-150 players): 300-500
• Grande (150+ players): 100-300

update-period

Define a frequência de atualização das partículas da esfera e status das arenas, em ticks (20 ticks = 1 segundo).

# Task de atualização da arena
# Partículas e status
# em ticks
update-period: 3

Como funciona:

• Valor menor = partículas mais fluidas, mas mais uso de recursos
• Valor maior = menos lag, mas partículas podem parecer "travadas"

Valores recomendados:

• Performance: 5-10 ticks (para servidores com muitos players)
• Balanceado: 3-4 ticks (recomendado)
• Visual: 1-2 ticks (apenas para servidores potentes)

message-time

Intervalo em segundos para enviar mensagens globais sobre qual clan está dominando cada arena.

# Enviar a mensagem de dominância global a cada x tempo
# em segundos
message-time: 60

Exemplo de uso:

• 30 - Anúncios a cada 30 segundos (pode ser spam)
• 60 - Anúncios a cada 1 minuto (recomendado)
• 120 - Anúncios a cada 2 minutos (menos intrusivo)
• 300 - Anúncios a cada 5 minutos (discreto)

Use valores menores para criar mais tensão e competitividade, ou valores maiores para reduzir spam no chat.

first-battle

Define se a dominação só começa a contar após uma batalha (quando jogadores de clans diferentes entram na área).

# Começar a dominar apenas depois de uma batalha
first-battle: false

Como funciona:

• false - Clan começa a dominar imediatamente ao entrar na arena (mais casual)
• true - Clan só começa a dominar após uma batalha começar (mais competitivo)

Recomendação por estilo de servidor:

# Servidor PvP competitivo
first-battle: true  # Força confrontos

# Servidor casual/RP
first-battle: false  # Permite dominação pacífica

particles

Ativa ou desativa o sistema de partículas da esfera de dominação.

# Ativar as partículas
particles: true

Quando desativar:

• Servidor com muitos players e baixa performance
• Players reclamando de lag visual
• Testes/debug sem poluição visual

Exemplo de configuração otimizada para servidor grande:

particles: true
update-period: 5  # Reduz frequência de atualização