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 geral 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 das orbs 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: ''

general

Configurações gerais que controlam o comportamento das orbs no servidor.

general:
  # Raio de checagem de orb perto
  # em blocos
  radius: 10
  # Distância que irá mostrar a partícula pros jogadores
  # em blocos
  particle-distance: 20

radius

Define o raio mínimo em blocos entre orbs. Quando um jogador tentar colocar uma orb, o plugin verificará se existe outra orb dentro deste raio. Se houver, a colocação será bloqueada para evitar acúmulo de orbs no mesmo local.

Exemplo:

general:
  radius: 10

Como funciona:

• Jogador tenta colocar uma orb
• Plugin verifica se existe outra orb em um raio de 10 blocos
• Se existir, exibe a mensagem de erro e cancela a ação
• Se não existir, permite a colocação

particle-distance

Define a distância máxima em blocos que um jogador precisa estar de uma orb para visualizar suas partículas (tanto as partículas de borda quanto as de crescimento).

Exemplo:

general:
  particle-distance: 20

Impacto na performance:

• Valores altos (30+): Mais jogadores verão as partículas, mas pode afetar a performance
• Valores médios (15-25): Balanceado, recomendado para a maioria dos servidores
• Valores baixos (5-10): Melhor performance, mas partículas só aparecem de perto

Exemplo de configuração otimizada:

general:
  # Boa separação entre orbs
  radius: 15
  # Performance otimizada
  particle-distance: 15