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 cubos. 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 jogadores 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

Define o tempo de espera (em ticks) para carregar os dados do jogador após o login. Essencial quando você tem servidores de mina separados conectados via BungeeCord ou Velocity.

# Delay em ticks (20 ticks = 1 segundo)
# Recomendado: 20 ticks
login-delay: 20

Por que isso é importante?

Em redes com múltiplos servidores, os dados do jogador podem levar alguns instantes para sincronizar. Este delay garante que o plugin não tente acessar dados ainda não carregados.

limit

Sistema de limitação para coleta de recompensas. Previne sobrecarga do servidor quando jogadores coletam muitas recompensas de uma vez.

limit:
  # Ativa ou desativa o limitador
  enabled: true
  # Máximo de recompensas que podem ser coletadas por vez
  max: 1000

Como funciona:

Quando um jogador tem muitas recompensas acumuladas e tenta coletar todas de uma vez, o plugin processa apenas até o limite configurado. Isso evita:

• Lag ao processar comandos em massa
• Timeout de comandos
• Crashes em casos extremos

Recomendações:

• Servidores pequenos (até 50 players): 1000-2000
• Servidores médios (50-150 players): 500-1000
• Servidores grandes (150+ players): 300-500

reset-completed

Define se os cubos devem ser resetados automaticamente quando o jogador completa todos os menus disponíveis.

# Se true, jogadores podem recomeçar do primeiro menu após completar tudo
# Se false, jogadores param no último menu completado
reset-completed: false

Cenários de uso:

• false (padrão): Jogadores progridem uma vez através dos menus. Útil para progressão única.
• true: Jogadores podem repetir todo o ciclo infinitamente. Ideal para sistemas de farming contínuo.

Exemplo prático:

Imagine que você tem 3 menus de cubos (Básico → Avançado → Supremo):

• Com reset-completed: false: Jogador completa o Supremo e para ali
• Com reset-completed: true: Jogador volta para o Básico e pode recomeçar

fragment

Configuração do item físico de fragmento que os jogadores podem receber e ativar.

fragment:
  # Material do item (formato MATERIAL:DATA)
  material: 'QUARTZ'
  # Nome do item (suporta códigos de cor com &)
  name: '&eFragmento de Cubo &7[{amount}]'
  # Lore (descrição) do item
  lore:
    - '&7Teste a sua sorte e se'
    - '&7habilite a ganhar várias'
    - '&7recompensas incríveis!'
    - ''
    - '&eClique para ativar e acesse'
    - '&f/cubos &epara abrir!'

Personalização do item:

• material: Pode ser qualquer item válido do Minecraft (ex: QUARTZ, DIAMOND, EMERALD:0)
• name: Use & para cores. Placeholder {amount} mostra a quantidade de fragmentos
• lore: Cada linha é um elemento da lista. Use '' para linhas em branco

Placeholders disponíveis:

Como funciona:

Quando jogadores recebem fragmentos físicos (itens) no inventário, eles podem:

1. Clicar no item para ativar e converter em fragmentos na conta
2. Os fragmentos ativados aparecem no menu /cubos
3. Podem ser usados para abrir cubos