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 crates 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

general

general:
  # Dar as keys compactadas em 1 item só
  give-compact: false

reward-command

Fila dos comandos de recompensas. Controla o intervalo entre cada lote de comandos.

# Fila dos comandos de recompensas
reward-command:
  # Delay entre cada lote de comandos em ticks. Use 0 para executar tudo de uma vez.
  delay-ticks: 20

database

Define como e onde os dados das crates 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. Especialmente importante em servidores com múltiplos mundos ou sistemas de minas separadas.

# Delay para carregar os dados depois do login
# Necessário para usar em servidor de mina separado
# Recomendado: 20 ticks
login-delay: 20

Valores recomendados:

• Servidor único: 10-20 ticks
• Rede BungeeCord: 40-60 ticks
• Sistema de minas separadas: 20-40 ticks

load-delay

Delay para carregar os blocos de crates após o servidor iniciar. Necessário para que os chunks carreguem antes de tentar criar os hologramas.

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

limit

Sistema de limite para recolher recompensas por vez. Evita sobrecarga do servidor ao processar 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

Valores recomendados por servidor:

world-reward-collect-blacklist

Lista de mundos onde os jogadores não podem coletar recompensas. Útil para evitar abusos em mundos específicos.

# Mundos que não poderão coletar recompensas
world-reward-collect-blacklist: [ 'none' ]

Exemplo de uso:

world-reward-collect-blacklist: [ 'world_pvp', 'world_evento', 'world_arena' ]

Jogadores nestes mundos não poderão usar /crate armazem para coletar recompensas.

blocked-regions

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

# Regiões do WorldGuard onde não é permitido ativar crates (requer yPlotCore)
blocked-regions: [ 'minapvp' ]

automatic-open

Sistema de abertura automática de crates. Permite que jogadores abram múltiplas crates continuamente sem precisar clicar várias vezes.

# Sistema de abertura automatica
automatic-open:
  enabled: true
  # em ticks -> 20 ticks = 1 segundo
  time: 20

Configuração do tempo:

• 10 ticks = 0.5 segundos (muito rápido)
• 20 ticks = 1 segundo (recomendado)
• 40 ticks = 2 segundos (mais lento)

crate-block

Configurações dos blocos de crate físicos no mundo. Permite criar pontos de interação onde os jogadores podem abrir suas crates.

# Sistema de blocos
crate-block:
  # Ajustar a altura do holograma
  offset: 2.5
  hologram:
    - '&6&lCAIXAS'
    - '&7Abra as suas chaves aqui'
    - '&f(/crates)'
    - '[item]TRIPWIRE_HOOK'

Propriedades:

• offset: Altura do holograma acima do bloco (em blocos)
• hologram: Linhas do holograma exibidas

Formatação especial:

• Use [item]MATERIAL para exibir um item flutuante no holograma
• Cores Minecraft funcionam normalmente (&6, &l, etc)

Exemplo customizado:

crate-block:
  offset: 3.0
  hologram:
    - '&6&l━━━━━━━━━━━━━━━━━━━'
    - '&e&lCRATE CENTRAL'
    - '&6&l━━━━━━━━━━━━━━━━━━━'
    - ''
    - '&7Clique para abrir'
    - '&7suas chaves virtuais!'
    - ''
    - '[item]CHEST'
    - ''
    - '&f/crates'

menu

Configurações gerais de comportamento dos menus.

# Sistema de botões do menu
menu:
  # Mostrar todas as chaves no menu (mesmo se o jogador não tiver)
  show-all: true
  # Botão para abrir o menu de preview
  preview: 'RIGHT'
  # Botão para abrir o menu de gerenciamento
  management: 'LEFT'
  # Mostrar os ícones de 0 a 64
  numerate: true

Opções detalhadas:

• show-all:

  • true - Exibe todas as crates no menu (mostra "Você não possui essa chave")
  • false - Exibe apenas crates que o jogador possui

• preview: Botão para abrir o menu de visualização de recompensas

  • LEFT - Botão esquerdo do mouse
  • RIGHT - Botão direito do mouse
  • MIDDLE - Botão do meio

• management: Botão para abrir a crate diretamente

• numerate: Exibe a quantidade de itens no ícone (número no canto inferior direito do item)

lore

Sistema de lores dinâmicas adicionadas aos itens dos menus.

# Sistema de lores
lore:
  chance: ['', '&6Chance: &7[{chance_progressbar}&7] &f{chance}%', '']
  filter-add: ['&eClique para adicionar ao filtro']
  filter-remove: ['&cClique para remover do filtro']

Como funciona:

• chance: Adicionada automaticamente aos itens de recompensa no menu de preview
• filter-add: Adicionada a recompensas não filtradas no menu de filtro
• filter-remove: Adicionada a recompensas já filtradas

Exemplo de lore mais elaborada:

lore:
  chance: 
    - ''
    - '&8▪ &6Probabilidade: &f{chance}%'
    - '&8▪ &7Barra: &7[{chance_progressbar}&7]'
    - ''
  filter-add: 
    - ''
    - '&e➥ Clique para adicionar ao filtro'
    - '&7Esta recompensa será bloqueada'
  filter-remove: 
    - ''
    - '&c➥ Clique para remover do filtro'
    - '&7Esta recompensa voltará a dropar'

progress-bar

Configuração da barra de progresso visual que representa a chance das recompensas.

# Configuração da progressbar
progress-bar:
  amount: 10
  symbol: ':'
  color-yes: '&a'
  color-not: '&7'

Como funciona:

• amount: Quantidade total de símbolos na barra
• symbol: Caractere usado para desenhar a barra
• color-yes: Cor da parte preenchida
• color-not: Cor da parte vazia

Exemplos de resultado:

Com 50% de chance (amount: 10):

&a:&a:&a:&a:&a&7:&7:&7:&7:&7

Com 25% de chance (amount: 20, symbol: '|'):

&a|&a|&a|&a|&a|&7|&7|&7|&7|&7|&7|&7|&7|&7|&7|&7|&7|&7|&7|

Customizações criativas:

# Estilo moderno
progress-bar:
  amount: 20
  symbol: '█'
  color-yes: '&a'
  color-not: '&8'

# Estilo minimalista
progress-bar:
  amount: 10
  symbol: '▪'
  color-yes: '&e'
  color-not: '&7'

# Estilo tradicional
progress-bar:
  amount: 10
  symbol: '='
  color-yes: '&2'
  color-not: '&8'

format

Sistema de formatação de números grandes. Converte valores extensos em formatos legíveis.

# Sistema de formatos de money e quantia
format:
  type: 'LETTER' # Tipos: LETTER - NUMBER
  max-decimals: 4
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Q'
    - 'QQ'
    - 'S'
    - 'SS'
    - 'O'
    - 'N'
    - 'D'

Tipos de formatação:

• LETTER: Usa abreviações (K, M, B, etc)

  • 1000 → 1K
  • 1000000 → 1M
  • 1500000 → 1.5M

• NUMBER: Usa separadores de milhares

  • 1000 → 1,000
  • 1000000 → 1,000,000
  • 1500000 → 1,500,000

max-decimals: Quantidade máxima de casas decimais exibidas

• 2 → 1.55M
• 4 → 1.5523M

Ordem dos formatos:

Index 0: Unidades (1-999)
Index 1: Dezenas (não usado)
Index 2: Milhares (K) - 1,000+
Index 3: Milhões (M) - 1,000,000+
Index 4: Bilhões (B) - 1,000,000,000+
Index 5: Trilhões (T) - 1,000,000,000,000+

Exemplo de formato brasileiro:

format:
  type: 'LETTER'
  max-decimals: 2
  formats:
    - ''
    - ''
    - 'K'
    - 'M'
    - 'B'
    - 'T'
    - 'Qa'
    - 'Qi'
    - 'Sx'
    - 'Sp'
    - 'Oc'
    - 'No'
    - 'Dc'