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 dos fragmentos virtuais. 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 fragmentos 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: ''

Exemplo de configuração MySQL:

database:
  storage-type: HIKARI
  data:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: suasenha123

login-delay

Define o tempo de espera (em ticks) antes de carregar os dados do jogador após o login. Útil para sincronização em 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 ajustar:

• Servidor único: 20 ticks (1 segundo)
• Rede BungeeCord: 40-60 ticks (2-3 segundos)

load-delay

Define o tempo de espera (em ticks) antes de carregar os dados após o servidor iniciar.

# Delay para carregar os dados depois do servidor ligar
# Necessário para as crates em bloco
# Recomendado: 20 ticks
load-delay: 20

Útil para garantir que todos os sistemas do servidor estejam prontos antes de carregar os fragmentos.

q-max

Define a quantidade máxima de fragmentos que podem ser evoluídos/empilhados ao segurar a tecla Q.

# Máximo permitido para evoluir com Q
q-max: 0

Valores:

• 0 - Desativa a funcionalidade
• 64 - Permite empilhar até 64 unidades
• Qualquer número positivo para limitar

regioes-bloqueadas

Regiões do WorldGuard onde não é permitido ativar fragmentos. Requer yPlotCore.

# Regiões do WorldGuard onde não é permitido ativar fragmentos (requer yPlotCore)
regioes-bloqueadas: [ 'minapvp' ]

menu

Controla a aparência e comportamento dos menus de fragmentos.

menu:
  # Mostrar todas as chaves no menu (mesmo se o jogador não tiver)
  show-all: true
  # Mostrar os ícones de 0 a 64
  numerate: true

Opções:

show-all

• true - Exibe todos os fragmentos no menu, mesmo os que o jogador não possui
• false - Exibe apenas os fragmentos que o jogador possui

numerate

• true - Mostra a quantidade numérica (0-64) nos ícones dos fragmentos
• false - Não mostra a quantidade nos ícones

format

Define como os números grandes serão formatados nas mensagens e menus.

# Tipos disponíveis:
# yPlugins -> Usa a formatação do yPlugins
# LETRA -> Força usar a formatação em letra
# NUMERO -> Força usar a formatação em número
format: 'yPlugins'

Tipos de formatação:

Exemplos práticos:

# Para exibir números grandes de forma compacta
format: 'yPlugins'
# Resultado: "Você possui 15.5k fragmentos"

# Para exibir números por extenso
format: 'LETRA'
# Resultado: "Você possui 15,5 mil fragmentos"

# Para exibir números completos
format: 'NUMERO'
# Resultado: "Você possui 15500 fragmentos"