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.

Após alterar a configuração, é necessário reiniciar o servidor.

Estrutura de arquivos

Abaixo está um exemplo de como é a estrutura de arquivos do plugin. Clique em uma pasta para expandi-la.

default.yml

commands.yml

config.yml

limit.yml

menus.yml

messages.yml

rarities.yml

rewards.yml

Configuração do plugin (config.yml)

O arquivo config.yml é o núcleo do plugin, onde você controla o comportamento das LuckyBlocks, sistema de limites e recompensas. Abaixo estão todas as opções disponíveis com explicações detalhadas.

Este plugin requer a opção "packet-events" ativada no seu yPlugins!

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

Mantenha desativado em produção, pois pode gerar muitos logs e afetar a performance.

database

Define como e onde os dados das LuckyBlocks 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: ''

Se usar SQLITE, não precisa preencher os dados de conexão. O arquivo será criado automaticamente na pasta do plugin.

Define o tempo de espera após o login do jogador antes de carregar seus dados. Essencial para configurações com servidores separados (lobby + minas).

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

Por que usar?

Em redes com BungeeCord/Velocity, os dados podem não estar sincronizados imediatamente
Previne perda de dados ou conflitos ao trocar de servidor
Valor padrão de 20 ticks (1 segundo) é suficiente na maioria dos casos

general

Configurações gerais que controlam o comportamento das LuckyBlocks.

general:
  # Permitir colocar luckyblock apenas nos plots
  plot: false
  # Abridor gastar 1 uso por luckyblock (mesmo que esta tenha ex: 50 tentativas)
  opener-one-decrease: false
  # Abrir automaticamente a lucky-block (bloco) ao colocar no chão
  # permissão necessária: yluckyblock.open.bypass
  # deixe "false" para não usar
  open-automatic-bypass: false
  # Quantia máxima que irá abrir automaticamente
  open-automatic-amount: 1

Explicação dos parâmetros:

plot: Se true, LuckyBlocks só podem ser colocadas em plots (requer plugin de plots). Útil para evitar poluição visual no servidor.
opener-one-decrease: Define o consumo do abridor:
- false: Abridor consome 1 uso por tentativa da LuckyBlock (se tem 50 tentativas, consome 50 usos)
- true: Abridor consome apenas 1 uso por LuckyBlock inteira (independente das tentativas)
open-automatic-bypass: Permite que jogadores com permissão yluckyblock.open.bypass abram automaticamente ao colocar o bloco.
open-automatic-amount: Quantidade de LuckyBlocks que serão abertas automaticamente ao colocar (funciona com open-automatic-bypass).

Exemplo de uso:

# Configuração para servidor com sistema de VIP
general:
  plot: true  # Apenas em plots
  opener-one-decrease: true  # VIPs gastam menos
  open-automatic-bypass: true  # VIPs não precisam clicar
  open-automatic-amount: 5  # Abre 5 de uma vez

opener

Configuração visual do item usado para abrir LuckyBlocks.

opener:
  material: 'LEASH'
  name: '&6&lOPEN LUCKY BLOCK'
  lore:
    - '&fUsos restantes: &e{uses}'

Opções de customização:

material: Pode ser um material do Minecraft (ex: LEASH, TRIPWIRE_HOOK) ou uma textura customizada (head texture)
name: Nome do item com suporte a cores usando &
lore: Lista de linhas da descrição do item

Placeholders disponíveis:

{uses} - Quantidade de usos restantes do abridor

Exemplo com textura customizada:

opener:
  material: '667da379f51d85d74fdba39a164d3f5062ef2ffc0b3e04d339376773931a4e'
  name: '&e&l⭐ &6&lCHAVE DOURADA &e&l⭐'
  lore:
    - ''
    - '&7Use esta chave mágica para'
    - '&7abrir qualquer LuckyBlock!'
    - ''
    - '&fUsos disponíveis: &e{uses}'
    - ''

progress-bar

Configuração da barra de progresso visual exibida durante a abertura de LuckyBlocks.

progress-bar:
  # Quantidade de símbolos na barra
  amount: 10
  # Símbolo usado na barra
  symbol: ':'
  # Cor dos símbolos completos
  color-yes: '&a'
  # Cor dos símbolos vazios
  color-no: '&7'

Como funciona:

A barra de progresso mostra visualmente quantas tentativas já foram feitas. Com as configurações padrão:

10 símbolos no total
Símbolo : (dois pontos)
Verde (&a) para tentativas completas
Cinza (&7) para tentativas restantes

Exemplos de resultado:

Início (0/10): &7::::::::::
Meio (5/10): &a:::::&7:::::
Quase completo (8/10): &a::::::::&7::
Completo (10/10): &a::::::::::

Customização avançada:

progress-bar:
  amount: 20  # Barra mais detalhada
  symbol: '▪'  # Símbolo diferente
  color-yes: '&e'  # Amarelo para completo
  color-no: '&8'  # Cinza escuro para vazio

Nesta página