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 arenas. 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 arenas 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. Necessário quando usado em servidores de mina separados 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 usar:

• Redes BungeeCord/Velocity com múltiplos servidores
• Servidores com mina separada
• Problemas de sincronização ao logar

mohist-chat

Ativa compatibilidade com plugins de chat específicos no Mohist.

# Ativar a troca do sistema de chat quando estiver no mohist
# compatível apenas com: UltimateChat, nChat e Legendchat
mohist-chat: false

Compatível com: UltimateChat, nChat e LegendChat.

void-detect

Define a altura do void do seu servidor. Jogadores que caírem abaixo dessa altura serão teleportados para fora da arena.

# Altura do void do seu servidor
void-detect: 0

Configuração por tipo de servidor:

• Servidor normal: 0
• Servidor com void personalizado: ajuste conforme necessário
• Servidor skyblock: -64 ou conforme configurado

limit

Sistema de limite para recolher recompensas de uma só vez. Previne lag ao coletar muitas recompensas simultaneamente.

# 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

general

Configurações gerais do sistema de arenas.

general:
  # Sistema de anti-free-kill
  # Armazena por 3 minutos as últimas kills do jogador
  anti-free-kill: true
  # Deletar a recompensa ao clicar com botão direito
  right-delete-reward: true
  # Lista de comandos para sair da arena
  commands-exit:
    - '/sair'
    - '/spawn'
    - '/exit'

anti-free-kill

Previne que jogadores matem repetidamente o mesmo oponente para farmar pontos. O sistema armazena as últimas kills por 3 minutos.

Como funciona:

1. Jogador A mata Jogador B
2. Sistema registra a kill
3. Por 3 minutos, matar o Jogador B novamente não dará pontos/recompensas completas
4. Após 3 minutos, volta ao normal

anti-free-kill: true  # Recomendado: true

right-delete-reward

Permite que jogadores deletem recompensas do armazém clicando com botão direito.

right-delete-reward: true

• true - Botão direito deleta a recompensa
• false - Apenas botão esquerdo funciona (recolher)

commands-exit

Lista de comandos que automaticamente tiram o jogador da arena quando executados.

commands-exit:
  - '/sair'
  - '/spawn'
  - '/exit'

Exemplo personalizado:

commands-exit:
  - '/sair'
  - '/spawn'
  - '/exit'
  - '/warp'
  - '/home'
  - '/tpa'

Útil para garantir que jogadores não usem comandos de teleporte para fugir de combates.

Dicas de configuração

database:
  storage-type: SQLITE

login-delay: 20

limit:
  enabled: true
  max: 1000

general:
  anti-free-kill: true

database:
  storage-type: MYSQL
  # Configure os dados de conexão

login-delay: 20

limit:
  enabled: true
  max: 500

general:
  anti-free-kill: true

database:
  storage-type: HIKARI
  # Configure os dados de conexão

login-delay: 40

limit:
  enabled: true
  max: 250

general:
  anti-free-kill: true

database:
  storage-type: HIKARI
  # Use o mesmo banco de dados em todos os servidores

login-delay: 40

general:
  anti-free-kill: true
  commands-exit:
    - '/sair'
    - '/spawn'
    - '/lobby'
    - '/hub'