Recompensas

As recompensas são os prêmios que os jogadores recebem ao abrir uma LuckyBlock. Você pode configurar itens, comandos ou ambos como recompensa.

Localização

As recompensas são configuradas no arquivo rewards.yml.

Exemplo completo de configuração

rewards:
  reward1:
    # Item que aparecerá no preview.
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', '&fChance: &6{chance}%' ]
      enchants: []
    # Item que aparecerá para coletar.
    collect:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    # Item que será dado ao player
    item:
      give: true
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEu valho muito!' ]
      enchants: []
    # Comandos que será dado ao player
    command:
      give: false
      # quantia padrão da placeholder {amount} no comando (valor base)
      placeholder-amount: 1
      # multiplicar a placeholder {amount} pela quantia de recompensas do mesmo tipo
      multiply-placeholder: true
      list: [ 'give {player} stone {amount}' ]
    # Mensagens enviadas ao player ao receber a recompensa
    # Placeholders: {player}, {reward}, {amount}, {stack}
    messages:
      chat: ''
      title: ''
      actionbar: ''

Estrutura de uma recompensa

Cada recompensa possui um ID único (ex: reward1, reward2) e várias seções:

preview

Configuração do item exibido no menu de preview (/lb preview <luckyblock>).

preview:
  material: 'DIAMOND:0'
  name: '&bDiamante'
  amount: 1
  lore: 
    - '&bQuem não adora uma pedra preciosa?!'
    - ''
    - '&fChance: &6{chance}%'
  enchants: []

Placeholders disponíveis:

{chance} - Chance percentual de obter esta recompensa

material

Material do item. Pode ser:

Nome do material com data value: 'DIAMOND:0'
Texture de cabeça (hash): '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'

name

Nome de exibição do item.

amount

Quantidade do item (1-64).

lore

Lista de linhas da descrição do item.

enchants

Lista de encantamentos do item. Formato: 'ENCANTAMENTO:NIVEL'

Exemplo:

enchants: 
  - 'SHARPNESS:5'
  - 'UNBREAKING:3'

collect

Configuração do item exibido no menu de coleta (quando o jogador pode pegar a recompensa).

collect:
  material: 'DIAMOND:0'
  name: '&bDiamante'
  amount: 1
  lore: 
    - '&bQuem não adora uma pedra preciosa?!'
    - ''
    - ' &7> &fQuantidade: &7{amount}'
    - ''
    - '&eClique esquerdo para receber'
    - '&eClique direito para deletar'
  enchants: []

Placeholders disponíveis:

{amount} - Quantidade da recompensa acumulada

Se o jogador receber múltiplas recompensas do mesmo tipo, elas são acumuladas e podem ser coletadas de uma vez!

item

Configuração do item que será efetivamente entregue ao jogador.

item:
  give: true
  material: 'DIAMOND:0'
  name: '&bDiamante'
  amount: 1
  lore: [ '&bItem precioso!' ]
  enchants: []

give

Define se um item será dado ao jogador (true ou false).

Se give: false, o item não será entregue. Útil quando você quer dar apenas comandos como recompensa.

command

Configuração dos comandos executados como recompensa.

command:
  give: true
  # quantia padrão da placeholder {amount} no comando (valor base)
  placeholder-amount: 1
  # multiplicar a placeholder {amount} pela quantia de recompensas do mesmo tipo
  multiply-placeholder: true
  list: 
    - 'give {player} diamond {amount}'
    - 'eco give {player} 1000'

give

Define se comandos serão executados (true ou false).

placeholder-amount

Valor base da placeholder {amount} nos comandos.

multiply-placeholder

Se true, a placeholder {amount} será multiplicada pela quantidade de recompensas do mesmo tipo recebidas.

Exemplo:

Jogador recebe 3x a mesma recompensa
placeholder-amount: 10
multiply-placeholder: true
{amount} será substituído por 30 (3 x 10)

list

Lista de comandos a serem executados.

Placeholders disponíveis nos comandos:

{player} - Nome do jogador
{amount} - Quantidade (afetada pelas configurações acima)

Os comandos são executados pelo console, sem a barra (/) no início!

Exemplos práticos

Recompensa de dinheiro (apenas comando)

rewards:
  money_reward:
    preview:
      material: 'GOLD_INGOT:0'
      name: '&6Dinheiro'
      amount: 1
      lore: 
        - '&7Receba dinheiro instantaneamente!'
        - ''
        - '&fChance: &6{chance}%'
      enchants: []
    collect:
      material: 'GOLD_INGOT:0'
      name: '&6Dinheiro'
      amount: 1
      lore: 
        - '&7Quantidade acumulada: &f{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: []
    item:
      give: false
    command:
      give: true
      placeholder-amount: 1000
      multiply-placeholder: true
      list: 
        - 'eco give {player} {amount}'

Recompensa de item encantado

rewards:
  enchanted_sword:
    preview:
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Épica'
      amount: 1
      lore: 
        - '&7Uma espada poderosa!'
        - '&7Afiação V'
        - '&7Durabilidade III'
        - ''
        - '&fChance: &6{chance}%'
      enchants: 
        - 'SHARPNESS:5'
        - 'UNBREAKING:3'
    collect:
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Épica'
      amount: 1
      lore: 
        - '&7Uma espada poderosa!'
        - ''
        - '&eClique esquerdo para receber'
      enchants: 
        - 'SHARPNESS:5'
        - 'UNBREAKING:3'
    item:
      give: true
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Épica'
      amount: 1
      lore: 
        - '&7Uma espada lendária!'
        - '&cObtida de uma Lucky Block'
      enchants: 
        - 'SHARPNESS:5'
        - 'UNBREAKING:3'
        - 'FIRE_ASPECT:2'
    command:
      give: false

Recompensa mista (item + comando)

rewards:
  vip_reward:
    preview:
      material: 'EMERALD:0'
      name: '&aRecompensa VIP'
      amount: 1
      lore: 
        - '&7Ganhe items e dinheiro!'
        - ''
        - '&fChance: &6{chance}%'
      enchants: []
    collect:
      material: 'EMERALD:0'
      name: '&aRecompensa VIP'
      amount: 1
      lore: 
        - '&7Quantidade: &f{amount}'
        - ''
        - '&eClique esquerdo para receber'
      enchants: []
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda Especial'
      amount: 64
      lore: 
        - '&7Obtida de uma Lucky Block VIP!'
      enchants: []
    command:
      give: true
      placeholder-amount: 5000
      multiply-placeholder: true
      list: 
        - 'eco give {player} {amount}'
        - 'give {player} diamond 10'

Recompensa com cabeça customizada

rewards:
  custom_head:
    preview:
      material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
      name: '&6Cabeça Especial'
      amount: 1
      lore: 
        - '&7Uma cabeça decorativa rara!'
        - ''
        - '&fChance: &6{chance}%'
      enchants: []
    collect:
      material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
      name: '&6Cabeça Especial'
      amount: 1
      lore: 
        - '&7Quantidade: &f{amount}'
        - ''
        - '&eClique esquerdo para receber'
      enchants: []
    item:
      give: true
      material: '238c0d2f1ec26754dca3c7cdae31f1f164883d453e688643da047568e7fa5cc9'
      name: '&6Cabeça Especial'
      amount: 1
      lore: 
        - '&7Cabeça decorativa única!'
        - '&cObtida de uma Lucky Block'
      enchants: []
    command:
      give: false

Encantamentos disponíveis

Aqui estão alguns encantamentos comumente usados:

Armas

SHARPNESS - Afiação
SMITE - Julgamento
BANE_OF_ARTHROPODS - Ruína dos Artrópodes
KNOCKBACK - Repulsão
FIRE_ASPECT - Aspecto Flamejante
LOOTING - Saque

Armaduras

PROTECTION - Proteção
FIRE_PROTECTION - Proteção contra Fogo
BLAST_PROTECTION - Proteção contra Explosões
PROJECTILE_PROTECTION - Proteção contra Projéteis
THORNS - Espinhos
FEATHER_FALLING - Queda Suave
RESPIRATION - Respiração
AQUA_AFFINITY - Afinidade Aquática

Ferramentas

EFFICIENCY - Eficiência
SILK_TOUCH - Toque Suave
FORTUNE - Fortuna

Gerais

UNBREAKING - Durabilidade
MENDING - Remendo

Para uma lista completa de encantamentos, consulte a documentação oficial do Spigot.

Criando novas recompensas

Abra o arquivo rewards.yml

Localize o arquivo na pasta do plugin.

Adicione uma nova recompensa

Crie um novo ID único para a recompensa.

rewards:
  minha_nova_recompensa:

Configure preview, collect e item

Preencha as três seções com as informações do item.

Configure os comandos (opcional)

Se desejar executar comandos, configure a seção command.

Adicione às LuckyBlocks

Adicione a recompensa à lista de rewards nas LuckyBlocks desejadas.

# Em luckyblocks/default.yml
rewards:
  - '50.00,minha_nova_recompensa-none'

Teste no jogo

Use /lb reload e teste abrindo uma LuckyBlock.

Dicas importantes

O ID da recompensa deve ser único! Não use IDs duplicados.

Você pode ter recompensas que dão apenas itens (command.give: false) ou apenas comandos (item.give: false).

Use multiply-placeholder: true quando quiser que recompensas múltiplas do mesmo tipo acumulem o valor do comando.

Para mais informações sobre como vincular recompensas às LuckyBlocks, consulte a página de LuckyBlocks.

Nesta página