LogoyStore
yLuckyBlockConfiguração

LuckyBlocks

Configure suas LuckyBlocks físicas e animadas.

O plugin suporta dois tipos de LuckyBlocks: físicas (blocos que podem ser colocados) e animadas (itens que ativam uma animação ao serem usados). Ambas têm suas próprias configurações e características.

LuckyBlocks Físicas

LuckyBlocks físicas são blocos que podem ser colocados no chão e abertos múltiplas vezes.

Localização

As LuckyBlocks físicas são configuradas em arquivos individuais dentro da pasta luckyblocks/.

Exemplo: plugins/yLuckyBlock/luckyblocks/default.yml

Exemplo completo de configuração

name: '&eLucky Block &7(Básica)'

# Permissão para poder por a luckyblock
permission: ''

# Cabeça dentro do vidro
head: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'

title: ''
chat: ''
actionbar: '&6&lLUCKY BLOCK &8{progressbar} &7({current_uses}/{total_uses})'

# Ativar a partícula de explosão ao abrir a luckyblock
particle-effect: true

# Precisa de um abridor para abrir
# Irá desativar a abertura ao quebrar
opener-need: false

animation:
  enabled: true
  # Velocidade padrão
  stage-default: 4
  # Tempo máximo que ficará subindo
  # em segundos
  y-max-time: 1.5

# Item da lucky block
# use apenas blocos
item:
  material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
  name: '&eLucky Block &7(Básica)'
  lore:
    - '&7Nível: &fBásica'
    - '&7* você irá ganhar itens comuns e raros'
    - ''
    - '&f Usos: &7{total_uses}'
    - ''
    - '&aColoque no chão para ativar'

# Sistema de bloco de vidro
glass:
  # O spawner vai gerar um vidro com uma cabeça dentro?
  enabled: true
  # material do vidro
  material: 'STAINED_GLASS'
  # Data da cor do vidro
  data: 11
  # Ajuste a cabeça dentro do vidro
  off-set: -1.2

# chance,recompensa-raridade
# a raridade, caso não tenha, deixe: none
rewards:
  - '50.00,reward1-none'
  - '50.00,reward2-rare'

Configurações principais

name

Nome da LuckyBlock exibido em comandos e menus.

Exemplo:

name: '&eLucky Block &7(Básica)'

permission

Permissão necessária para colocar esta LuckyBlock. Deixe vazio ('') para não exigir permissão.

Exemplo:

permission: 'yluckyblock.place.vip'

Texture da cabeça que aparece dentro do vidro. Use o hash da texture.

Exemplo:

head: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'

Você pode obter hashes de texturas em sites como minecraft-heads.com

Mensagens (title, chat, actionbar)

Configure as mensagens exibidas ao abrir a LuckyBlock.

Placeholders disponíveis:

  • {progressbar} - Barra de progresso visual
  • {current_uses} - Usos atuais
  • {total_uses} - Total de usos

Exemplo:

title: '&6&lLUCKY BLOCK'
chat: '&aVocê abriu uma Lucky Block!'
actionbar: '&6&lLUCKY BLOCK &8{progressbar} &7({current_uses}/{total_uses})'

particle-effect

Ativa a partícula de explosão ao abrir a luckyblock.

Exemplo:

particle-effect: true

opener-need

Define se é necessário um abridor para abrir a LuckyBlock. Se ativado, desativa a abertura ao quebrar.

Exemplo:

opener-need: true

animation

Configurações da animação ao abrir a LuckyBlock.

animation:
  enabled: true
  # Velocidade padrão da animação
  stage-default: 4
  # Tempo máximo que ficará subindo (em segundos)
  y-max-time: 1.5

enabled

Ativa ou desativa a animação.

stage-default

Velocidade padrão da animação (maior = mais rápido).

y-max-time

Tempo máximo que a recompensa ficará subindo antes de descer (em segundos).

item

Configurações do item da LuckyBlock no inventário.

item:
  material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
  name: '&eLucky Block &7(Básica)'
  lore:
    - '&7Nível: &fBásica'
    - '&7* você irá ganhar itens comuns e raros'
    - ''
    - '&f Usos: &7{total_uses}'
    - ''
    - '&aColoque no chão para ativar'

Placeholders disponíveis na lore:

  • {total_uses} - Total de usos da LuckyBlock

glass

Configurações do bloco de vidro que envolve a cabeça.

glass:
  enabled: true
  material: 'STAINED_GLASS'
  data: 11
  off-set: -1.2

enabled

Ativa ou desativa o vidro ao redor da cabeça.

material

Material do vidro.

data

Data value do vidro (cor). Valores de 0-15 para vidros coloridos.

off-set

Ajuste vertical da cabeça dentro do vidro.

rewards

Lista de recompensas que podem ser obtidas desta LuckyBlock.

Formato: 'chance,recompensa-raridade'

rewards:
  - '50.00,reward1-none'
  - '25.00,reward2-rare'
  - '15.00,reward3-rare'
  - '10.00,reward4-epic'
  • chance: Porcentagem de chance (0-100)
  • recompensa: ID da recompensa (configurada em rewards.yml)
  • raridade: Raridade da recompensa (configurada em rarities.yml) ou none

A soma das chances não precisa ser exatamente 100%, o plugin normaliza automaticamente.

LuckyBlocks Animadas

LuckyBlocks animadas são itens que, ao serem usados, criam uma animação com hologramas e partículas.

Localização

As LuckyBlocks animadas são configuradas em arquivos individuais dentro da pasta luckyblocks_animated/.

Exemplo: plugins/yLuckyBlock/luckyblocks_animated/default.yml

Exemplo completo de configuração

name: '&eLucky Block &7(Básica)'

animation:
  icon: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
  # Tempo total de animação (em segundos)
  time: 5
  # Velocidade padrão
  stage-default: 4
  # Tempo (em segundos), velocidade da animação
  stages:
    - '2,20'
    - '3,40'
  # Tempo máximo que ficará subindo (em segundos)
  y-max-time: 2
  # Premiar após quanto tempo
  reward-time: 6
  # Remover o holograma após quanto tempo
  delete-time: 8
  # Configuração da partícula
  particle:
    # Tempo mínimo para aparecer partículas
    min-time: 3
    # Tipo da partícula
    type: 'happy_villager'
  # Configuração do holograma
  hologram:
    time:
      off-set: 3.0
      lines: ['&aSorteando em {time}...']
    reward:
      off-set: 3.0
      lines: ['{reward}', '[item]{reward_preview}']

# Item da lucky block
item:
  material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
  name: '&eLucky Block &7(Básica)'
  lore:
    - '&7Nível: &fBásica'
    - '&7* você irá ganhar itens comuns e raros'
    - ''
    - '&aColoque no chão para ativar'

# chance,recompensa-raridade
rewards:
  - '50.00,reward1-none'
  - '50.00,reward2-rare'

Configurações principais

animation

Configurações da animação completa.

icon

Texture da cabeça usada na animação.

icon: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
time

Tempo total de animação em segundos.

time: 5
stage-default

Velocidade padrão da animação.

stage-default: 4
stages

Estágios de velocidade durante a animação. Formato: 'tempo,velocidade'

stages:
  - '2,20'  # Aos 2 segundos, muda para velocidade 20
  - '3,40'  # Aos 3 segundos, muda para velocidade 40
y-max-time

Tempo que a animação ficará subindo verticalmente.

y-max-time: 2
reward-time

Tempo após o qual a recompensa será entregue.

reward-time: 6
delete-time

Tempo após o qual o holograma será removido.

delete-time: 8

particle

Configurações das partículas da animação.

particle:
  # Tempo mínimo para aparecer partículas
  min-time: 3
  # Tipo da partícula
  type: 'happy_villager'

Tipos de partículas comuns:

  • happy_villager - Estrelas verdes
  • flame - Chamas
  • heart - Corações
  • enchant - Símbolos de encantamento
  • firework - Fogos de artifício

Consulte a lista completa de partículas do Minecraft

hologram

Configurações dos hologramas exibidos durante a animação.

hologram:
  time:
    off-set: 3.0
    lines: ['&aSorteando em {time}...']
  reward:
    off-set: 3.0
    lines: ['{reward}', '[item]{reward_preview}']
time

Holograma exibido durante a contagem regressiva.

Placeholders disponíveis:

  • {time} - Tempo restante
reward

Holograma exibido quando a recompensa é revelada.

Placeholders disponíveis:

  • {reward} - Nome da recompensa
  • [item]{reward_preview} - Item visual da recompensa

O placeholder [item] cria um holograma com o item visual flutuante!

Criando novas LuckyBlocks

Escolha o tipo

Decida se será uma LuckyBlock física ou animada.

Crie o arquivo

Crie um novo arquivo .yml na pasta correspondente:

  • Física: luckyblocks/nome.yml
  • Animada: luckyblocks_animated/nome.yml

Configure as opções

Copie e adapte um dos exemplos acima.

Configure recompensas

Defina as recompensas na seção rewards.

Teste no jogo

Use /lb reload e teste com /lb give ou /lb giveanimated.

Exemplos práticos

LuckyBlock VIP (Física)

name: '&6Lucky Block &7(VIP)'
permission: 'yluckyblock.place.vip'
head: 'ewogICJ0aW1lc3RhbXAiIDogMTY3ODk4NjUwNjI3MiwKICAicHJvZmlsZUlkIiA6ICI3MmY5MTdjNWQyNDU0OTk0OGY2YTJmODctNzM3Zjk5ZTc3NGY2IiwKICAicHJvZmlsZU5hbWUiIDogIkZvZGV3IiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzZiYWQ4OGI3ZTY1ZGQ0MzJkYjhiODg2N2I2ZjVhMjI5NjdhNjYxYzM0NjE1MjM5ZWMxNGNkOWU5OTJkOWJjZDgiCiAgICB9CiAgfQp9'
actionbar: '&6&lVIP LUCKY BLOCK &8{progressbar} &7({current_uses}/{total_uses})'
particle-effect: true
opener-need: false
animation:
  enabled: true
  stage-default: 6
  y-max-time: 2.0
item:
  material: 'ewogICJ0aW1lc3RhbXAiIDogMTY3ODk4NjUwNjI3MiwKICAicHJvZmlsZUlkIiA6ICI3MmY5MTdjNWQyNDU0OTk0OGY2YTJmODctNzM3Zjk5ZTc3NGY2IiwKICAicHJvZmlsZU5hbWUiIDogIkZvZGV3IiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzZiYWQ4OGI3ZTY1ZGQ0MzJkYjhiODg2N2I2ZjVhMjI5NjdhNjYxYzM0NjE1MjM5ZWMxNGNkOWU5OTJkOWJjZDgiCiAgICB9CiAgfQp9'
  name: '&6Lucky Block &7(VIP)'
  lore:
    - '&7Nível: &6VIP'
    - '&7* você irá ganhar itens raros e épicos'
    - ''
    - '&f Usos: &7{total_uses}'
    - ''
    - '&aColoque no chão para ativar'
glass:
  enabled: true
  material: 'STAINED_GLASS'
  data: 4
  off-set: -1.2
rewards:
  - '40.00,reward2-rare'
  - '35.00,reward3-rare'
  - '25.00,reward4-epic'

LuckyBlock Épica (Animada)

name: '&5Lucky Block &7(Épica)'

animation:
  icon: 'ewogICJ0aW1lc3RhbXAiIDogMTY3ODk4NjUwNjI3MiwKICAicHJvZmlsZUlkIiA6ICI3MmY5MTdjNWQyNDU0OTk0OGY2YTJmODctNzM3Zjk5ZTc3NGY2IiwKICAicHJvZmlsZU5hbWUiIDogIkZvZGV3IiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzZiYWQ4OGI3ZTY1ZGQ0MzJkYjhiODg2N2I2ZjVhMjI5NjdhNjYxYzM0NjE1MjM5ZWMxNGNkOWU5OTJkOWJjZDgiCiAgICB9CiAgfQp9'
  time: 8
  stage-default: 6
  stages:
    - '3,30'
    - '5,50'
    - '7,70'
  y-max-time: 3
  reward-time: 9
  delete-time: 12
  particle:
    min-time: 4
    type: 'enchant'
  hologram:
    time:
      off-set: 3.5
      lines: ['&5&lLUCKY BLOCK ÉPICA', '&aSorteando em {time}...']
    reward:
      off-set: 3.5
      lines: ['&5&lRECOMPENSA', '{reward}', '[item]{reward_preview}']

item:
  material: 'ewogICJ0aW1lc3RhbXAiIDogMTY3ODk4NjUwNjI3MiwKICAicHJvZmlsZUlkIiA6ICI3MmY5MTdjNWQyNDU0OTk0OGY2YTJmODctNzM3Zjk5ZTc3NGY2IiwKICAicHJvZmlsZU5hbWUiIDogIkZvZGV3IiwKICAic2lnbmF0dXJlUmVxdWlyZWQiIDogdHJ1ZSwKICAidGV4dHVyZXMiIDogewogICAgIlNLSU4iIDogewogICAgICAidXJsIiA6ICJodHRwOi8vdGV4dHVyZXMubWluZWNyYWZ0Lm5ldC90ZXh0dXJlLzZiYWQ4OGI3ZTY1ZGQ0MzJkYjhiODg2N2I2ZjVhMjI5NjdhNjYxYzM0NjE1MjM5ZWMxNGNkOWU5OTJkOWJjZDgiCiAgICB9CiAgfQp9'
  name: '&5Lucky Block &7(Épica)'
  lore:
    - '&7Nível: &5Épica'
    - '&7* você irá ganhar itens lendários'
    - ''
    - '&aColoque no chão para ativar'

rewards:
  - '60.00,reward4-epic'
  - '40.00,reward5-legendary'

Para mais informações sobre como configurar recompensas, consulte a página de Recompensas.

Para mais informações sobre como configurar raridades, consulte a página de Raridades.

Configuração

Conheça as várias opções de configuração.

Recompensas

Configure as recompensas que os jogadores podem ganhar nas LuckyBlocks.

Nesta página

LuckyBlocks FísicasLocalizaçãoExemplo completo de configuraçãoConfigurações principaisnamepermissionheadMensagens (title, chat, actionbar)particle-effectopener-needanimationenabledstage-defaulty-max-timeitemglassenabledmaterialdataoff-setrewardsLuckyBlocks AnimadasLocalizaçãoExemplo completo de configuraçãoConfigurações principaisanimationicontimestage-defaultstagesy-max-timereward-timedelete-timeparticlehologramtimerewardCriando novas LuckyBlocksEscolha o tipoCrie o arquivoConfigure as opçõesConfigure recompensasTeste no jogoExemplos práticosLuckyBlock VIP (Física)LuckyBlock Épica (Animada)