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.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

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

marte.yml

benefits.yml

commands.yml

config.yml

menus.yml

messages.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml controla o comportamento geral do plugin: banco de dados, partículas, BossBar, limites de recompensa e regras da captura.

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

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados do plugin 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: ''

Se usar SQLITE, não precisa preencher os dados de conexão.

Delay (em ticks) para carregar os dados do jogador após o login. Útil em redes com servidor de mina separado, onde o clan/facção pode demorar a sincronizar.

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

20 ticks = 1 segundo
Aumente se os benefícios não forem aplicados logo após o login

limit

Limita a quantidade de recompensas recolhidas de uma vez no armazém. Evita lag ao coletar muitas recompensas de uma só vez.

# Este limite serve para recolher recompensas
# Desativar ou aumentar o limite pode gerar lag
limit:
  enabled: true
  max: 1000

enabled: Ativa ou desativa o limite
max: Quantidade máxima de recompensas por coleta

update-period

Intervalo (em ticks) da task de atualização do planeta — partículas, status da zona e holograma.

# Task de atualização do planeta (partículas e status) em ticks
update-period: 3

Valores menores atualizam mais rápido, mas consomem mais recursos. 3 ticks é o padrão recomendado.

message-time

Intervalo (em segundos) entre as mensagens globais de dominância enquanto um clan está dominando a zona.

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

A mensagem enviada é a messageDominating configurada no arquivo de cada planeta.

first-battle

Define se a contagem de captura só começa depois de uma batalha entre 2 ou mais clans na zona.

# Começar a capturar apenas depois de uma batalha entre 2+ clans
first-battle: false

false — O primeiro clan sozinho na zona já começa a dominar
true — É necessário disputa entre 2+ clans antes da captura contar

particles

Ativa ou desativa as partículas na zona de captura durante o evento.

# Ativar as partículas na zona de captura
particles: true

Os tipos de partícula (vazia, batalhando, dominada) são definidos no arquivo de cada planeta.

bossbar

Ativa ou desativa a BossBar durante o evento de captura.

# BossBar durante o evento de captura
bossbar:
  enabled: true

Título, cor e estilo da BossBar são configurados no arquivo de cada planeta (bossBarTitle, bossBarColor, bossBarStyle).

Nesta página