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. 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

Delay para carregar os dados do jogador após o login. Essencial quando usado em servidores de mina separados conectados via 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

Por que é necessário?

Em configurações multi-servidor, há um pequeno delay entre o jogador entrar e seus dados de clan estarem disponíveis. Este valor garante que o plugin aguarde antes de processar dados do jogador.

limit

Sistema de limite para recolher recompensas. Essencial para prevenir lag e problemas de performance ao coletar grandes quantidades de itens.

# Este limite serve para recolher recompensas
# Desativar ou aumentar o limite pode gerar lag
# e em alguns casos crashar o servidor.
limit:
  enabled: true
  # Máximo que irá recolher por vez
  max: 1000

Como funciona:

Quando um jogador tem muitas recompensas acumuladas, o plugin limita quantas podem ser coletadas de uma vez. Isso previne:

• Lag ao processar muitos itens simultaneamente
• Possível crash do servidor em casos extremos
• Sobrecarga de comandos sendo executados ao mesmo tempo

update-period

Define a frequência de atualização do sistema de partículas e status das dominações. Valor em ticks (20 ticks = 1 segundo).

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

Impacto na performance:

• Valor menor (1-3 ticks): Partículas mais suaves e atualizações mais frequentes, mas consome mais recursos
• Valor maior (5-10 ticks): Menor consumo de recursos, mas partículas podem parecer "travadas"

O valor padrão de 3 ticks oferece bom equilíbrio entre visual fluido e performance.

particle-distance

Define a distância máxima em blocos que um jogador precisa estar para visualizar as partículas da esfera de dominação.

# Distância que irá mostrar a partícula pros jogadores
# em blocos
particle-distance: 20

Otimização de performance:

Este parâmetro é crucial para performance, pois partículas em packet-based consomem banda e processamento:

• 20 blocos (padrão): Bom para visualização sem comprometer muito a performance
• 30-40 blocos: Melhor visualização, mas aumenta uso de recursos
• 10-15 blocos: Economiza recursos em servidores com muitos jogadores

Cálculo de impacto:

Se uma dominação está ativa com 10 jogadores próximos:

• Com 20 blocos: ~10 jogadores recebem partículas
• Com 40 blocos: ~25 jogadores recebem partículas
• Mais jogadores = mais pacotes enviados = mais processamento

Configurações das Minas (Arquivo individual)

Cada dominação criada possui seu próprio arquivo de configuração na pasta plugins/yDominarMina/mines/. Abaixo estão os parâmetros disponíveis:

DOMINATION-TIME

Tempo em segundos que um clan precisa ficar dentro da área sem contestação para começar a dominar.

Exemplo: Com valor 60, o clan precisa ficar 1 minuto ininterrupto na área para iniciar o processo de dominação.

REWARD-INTERVAL

Tempo em segundos entre cada entrega de recompensa enquanto o clan está dominando.

Exemplo: Com valor 300 (5 minutos), a cada 5 minutos de dominação ativa, o clan recebe recompensas configuradas.

MESSAGE-TIME

Intervalo em segundos para enviar a mensagem global informando qual clan está dominando.

Exemplo: Com valor 120 (2 minutos), a cada 2 minutos uma mensagem global anuncia o clan dominante.

PARTICLES

Ativa ou desativa as partículas visuais da esfera/cubo de dominação.

Valores: true (ativado) ou false (desativado)

RADIUS

Define o raio em blocos da área de dominação a partir do ponto central definido.

Exemplo: Com raio 10, a área será uma esfera/cubo de 20x20x20 blocos (10 blocos em cada direção).

SPHERE-SHAPE

Define o formato da área de dominação.

Valores:

• true: Formato esférico (mais natural, área 3D redonda)
• false: Formato de cubo (área quadrada, mais fácil de visualizar limites)

START-ON-LOAD

Define se esta dominação específica deve iniciar automaticamente quando o servidor ligar.

Valores:

• true: Inicia automaticamente no boot do servidor
• false: Precisa ser iniciada manualmente com comando

Exemplo de uso prático

Cenário: Servidor de facções com 2 dominações - uma permanente e uma de evento.

Dominação Permanente (mina_central.yml):

DOMINATION-TIME: 120        # 2 minutos para começar a dominar
REWARD-INTERVAL: 600        # Recompensa a cada 10 minutos
MESSAGE-TIME: 180           # Anúncio a cada 3 minutos
PARTICLES: true
RADIUS: 15                   # Área grande
SPHERE-SHAPE: true          # Esférica
START-ON-LOAD: true         # Sempre ativa

Dominação de Evento (evento_especial.yml):

DOMINATION-TIME: 60         # 1 minuto para dominar (mais rápido)
REWARD-INTERVAL: 300        # Recompensa a cada 5 minutos
MESSAGE-TIME: 120           # Anúncio a cada 2 minutos
PARTICLES: true
RADIUS: 20                   # Área maior para evento
SPHERE-SHAPE: false         # Cubo (limites claros)
START-ON-LOAD: false        # Ativado manualmente