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. 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 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: ''

general

Configurações gerais do sistema de crates.

general:
  # Dar as keys compactadas em 1 item só
  give-compact: true
  # Limite máximo de abertura de keys por click
  all-limit: 100
  # Lore para filtrar recompensas no preview
  lore-add-filter: [ '&aClique para adicionar ao filtro' ]
  lore-remove-filter: [ '&cClique para remover do filtro' ]
  # Lista de vidros aleatórios
  random-glasses:
    - 'STAINED_GLASS_PANE:1'
    - 'STAINED_GLASS_PANE:2'
    - 'STAINED_GLASS_PANE:3'
    - 'STAINED_GLASS_PANE:4'
    - 'STAINED_GLASS_PANE:5'
    - 'STAINED_GLASS_PANE:6'
    - 'STAINED_GLASS_PANE:9'
    - 'STAINED_GLASS_PANE:10'
    - 'STAINED_GLASS_PANE:11'
    - 'STAINED_GLASS_PANE:13'
    - 'STAINED_GLASS_PANE:14'

give-compact

Define se as keys serão entregues de forma compactada (múltiplas keys em um único item).

Exemplo prático:

• true - Ao dar 10 keys, o jogador recebe 1 item com quantidade 10
• false - Ao dar 10 keys, o jogador recebe 10 itens separados (ocupa 10 slots)

Recomendação: Manter true para economizar espaço no inventário dos jogadores.

all-limit

Limita a quantidade máxima de crates que podem ser abertas de uma vez ao segurar shift e clicar.

Exemplo de uso:

all-limit: 50  # Jogador pode abrir até 50 keys de uma vez

Útil para evitar lag ao abrir muitas crates simultaneamente.

lore-add-filter e lore-remove-filter

Textos exibidos no menu de preview para adicionar/remover filtros de recompensas.

Como funciona:

No menu /crate preview, jogadores podem clicar em recompensas para filtrar e ver apenas itens específicos. Essas configurações definem o texto que aparece quando uma recompensa está ou não no filtro.

random-glasses

Lista de vidros coloridos usados nas animações de abertura das crates. O plugin escolhe aleatoriamente entre essas opções para criar um efeito visual dinâmico.

Formato: MATERIAL:DATA (data é a cor do vidro colorido)

Cores disponíveis: