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 é onde você controla o comportamento principal do plugin. 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 torneios 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: ''

redis

Configurações do servidor Redis para sincronização de dados entre múltiplos servidores. Necessário apenas em redes BungeeCord/Velocity para manter os dados sincronizados em tempo real.

redis:
  # Ativar a conexão com o redis
  enabled: false
  # Endereço de conexão. [EX: 127.0.0.1]
  host: 'localhost'
  # Porta de conexão. [EX: 6379]
  port: 6379
  # 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. Esta configuração é especialmente importante para servidores com lobby separado ou que usam sistemas de teleporte ao entrar.

# 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 este valor:

• Servidor único: 20 ticks (padrão) funciona bem
• Rede BungeeCord: Pode precisar de 40-60 ticks
• Sistema de teleporte ao login: Aumente para 40-80 ticks

limit

Sistema de limite para recolher recompensas. Esta configuração evita que o servidor sofra lag ao processar grandes quantidades de recompensas de uma só vez.

# 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 tenta coletar recompensas e possui mais do que o limite configurado, apenas as primeiras max recompensas serão processadas de uma vez. O jogador precisará coletar novamente para pegar o restante.

Valores recomendados:

• Servidor pequeno (até 50 players): max: 1000
• Servidor médio (50-200 players): max: 500
• Servidor grande (200+ players): max: 200