Recompensas

Visão geral

O sistema de recompensas permite que você configure itens, comandos e mensagens especiais que os jogadores podem receber ao minerar. As recompensas são ativadas através do arquivo mine_rewards.yml.

Estrutura de arquivos

rewards.yml - Define as recompensas disponíveis
mine_rewards.yml - Vincula recompensas às minas com chances

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!']
      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 jogador
    item:
      give: true
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: ['&aEu valho muito!']
      enchants: []
    # Comandos que serão executados
    command:
      give: false
      # Quantia padrão do placeholder {amount}
      placeholder-amount: 1
      # Multiplicar {amount} pela quantidade de recompensas
      multiply-placeholder: true
      list: ['give {player} stone {amount}']
    # Mensagens ao receber a recompensa
    messages:
      # Quantia para o placeholder no chat
      amount-placeholder: 64
      title: '&a+64 Pedras'
      actionbar: ''
      chat: '&a+{amount} Pedras'
      # Mensagem ignorando sistema de agrupamento
      chat-ignore-timed: ''

Opções de configuração

preview

Item exibido no menu de preview das recompensas.

rewards:
  reward1:
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante Raro'
      amount: 1
      lore:
        - '&7Recompensa especial!'
        - '&aChance: 5%'
      enchants: []

collect

Item exibido no menu quando o jogador pode coletar a recompensa.

rewards:
  reward1:
    collect:
      material: 'DIAMOND:0'
      name: '&bDiamante Raro'
      amount: 1
      lore:
        - '&7Você ganhou um diamante!'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: []

Placeholders disponíveis:

{amount} - Quantidade de recompensas acumuladas

item

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

rewards:
  reward1:
    item:
      give: true  # Se deve dar o item
      material: 'DIAMOND:0'
      name: '&bDiamante Raro'
      amount: 1
      lore:
        - '&7Diamante especial da mina!'
      enchants: ['DAMAGE_ALL:5', 'DURABILITY:3']

Formato dos encantamentos:

enchants: ['ENCANTAMENTO:NIVEL', 'ENCANTAMENTO:NIVEL']

Se give: false, o item não será dado ao jogador, apenas comandos/mensagens serão executados.

command

Configuração de comandos que serão executados quando o jogador receber a recompensa.

rewards:
  reward1:
    command:
      give: true  # Se deve executar comandos
      placeholder-amount: 1
      multiply-placeholder: true
      list:
        - 'give {player} diamond {amount}'
        - 'eco give {player} 1000'
        - 'broadcast {player} ganhou um diamante!'

Placeholders nos comandos:

{player} - Nome do jogador
{amount} - Quantidade calculada

placeholder-amount

Valor base do placeholder {amount} nos comandos.

command:
  placeholder-amount: 1  # Valor base

multiply-placeholder

Multiplica o {amount} pela quantidade de recompensas acumuladas.

command:
  multiply-placeholder: true  # Ativado
  multiply-placeholder: false # Desativado

Exemplo:

Se o jogador ganhou 5 vezes a mesma recompensa:

multiply-placeholder: true → {amount} = 5
multiply-placeholder: false → {amount} = 1

messages

Mensagens exibidas quando o jogador recebe a recompensa.

rewards:
  reward1:
    messages:
      amount-placeholder: 1
      title: '&a+1 Diamante'
      actionbar: '&aVocê ganhou um diamante!'
      chat: '&a+{amount} Diamante(s)'
      chat-ignore-timed: '&b&lRECOMPENSA: &bDiamante!'

amount-placeholder

Valor que multiplica o placeholder {amount} nas mensagens.

messages:
  amount-placeholder: 64  # {amount} será 64 por recompensa

title

Mensagem exibida como título na tela.

messages:
  title: '&a+64 Pedras'
  title: '&6&lRECOMPENSA<nl>&eDiamante Raro'  # <nl> para quebra de linha

actionbar

Mensagem exibida na actionbar (barra de ação).

messages:
  actionbar: '&aVocê ganhou uma recompensa!'

chat

Mensagem exibida no chat (pode ser agrupada pelo sistema de timing).

messages:
  chat: '&a+{amount} Diamante(s)'

chat-ignore-timed

Mensagem exibida no chat que ignora o sistema de agrupamento de mensagens.

messages:
  chat-ignore-timed: '&b&lRECOMPENSA ESPECIAL: &bDiamante Raro!'

Use chat-ignore-timed para recompensas raras que devem sempre mostrar mensagem individual.

Vinculando recompensas às minas

Use o arquivo mine_rewards.yml para vincular recompensas às minas:

rewards:
  mine_reward1:
    mine: 'mina_1'
    chance: 20.0
    reward: 'reward1'
  
  mine_reward2:
    mine: 'mina_1'
    chance: 5.0
    reward: 'reward2'
  
  mine_reward3:
    mine: 'mina_2'
    chance: 10.0
    reward: 'reward3'

Opções:

mine - ID da mina (configurado no config.yml)
chance - Porcentagem de chance (0.0 a 100.0)
reward - ID da recompensa (definido em rewards.yml)

Exemplos práticos

Recompensa de item simples

rewards:
  pedra_especial:
    preview:
      material: 'STONE:0'
      name: '&7Pedra Especial'
      amount: 64
      lore: ['&aUma pedra comum mas valiosa!']
      enchants: []
    collect:
      material: 'STONE:0'
      name: '&7Pedra Especial'
      amount: 64
      lore:
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique para receber'
      enchants: []
    item:
      give: true
      material: 'STONE:0'
      name: '&7Pedra Especial'
      amount: 64
      lore: ['&7Pode ser vendida por um bom preço!']
      enchants: []
    command:
      give: false
    messages:
      amount-placeholder: 64
      title: '&a+64 Pedras'
      actionbar: ''
      chat: '&a+{amount} Pedras Especiais'

Recompensa de dinheiro (comando)

rewards:
  bonus_money:
    preview:
      material: 'GOLD_INGOT:0'
      name: '&6Bônus de Dinheiro'
      amount: 1
      lore: ['&eGanhe dinheiro extra!']
      enchants: []
    collect:
      material: 'GOLD_INGOT:0'
      name: '&6Bônus de Dinheiro'
      amount: 1
      lore:
        - '&eVocê ganhou &6$1000&e!'
        - ''
        - '&eClique para receber'
      enchants: []
    item:
      give: false
    command:
      give: true
      placeholder-amount: 1000
      multiply-placeholder: true
      list:
        - 'eco give {player} {amount}'
    messages:
      amount-placeholder: 1
      title: '&6+$1000'
      actionbar: ''
      chat: '&a+&6${amount}'

Recompensa combinada (item + comando)

rewards:
  kit_vip:
    preview:
      material: 'DIAMOND_SWORD:0'
      name: '&b&lKit VIP'
      amount: 1
      lore:
        - '&7Kit especial com:'
        - '&7- Espada de Diamante'
        - '&7- $5000'
        - '&7- XP'
      enchants: []
    collect:
      material: 'DIAMOND_SWORD:0'
      name: '&b&lKit VIP'
      amount: 1
      lore:
        - '&7Kit especial!'
        - ''
        - '&eClique para receber'
      enchants: []
    item:
      give: true
      material: 'DIAMOND_SWORD:0'
      name: '&b&lEspada VIP'
      amount: 1
      lore: ['&7Espada poderosa!']
      enchants: ['DAMAGE_ALL:5', 'DURABILITY:3', 'FIRE_ASPECT:2']
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: false
      list:
        - 'eco give {player} 5000'
        - 'xp give {player} 100'
    messages:
      amount-placeholder: 1
      title: '&b&lKIT VIP'
      actionbar: ''
      chat: ''
      chat-ignore-timed: '<nl>&b&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬<nl>&b&lRECOMPENSA: &fKit VIP<nl>&b&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬<nl>'

Recompensa rara

rewards:
  lendario:
    preview:
      material: 'NETHER_STAR:0'
      name: '&6&l✦ ITEM LENDÁRIO ✦'
      amount: 1
      lore:
        - '&7Extremamente raro!'
        - '&6Chance: 0.1%'
      enchants: []
    collect:
      material: 'NETHER_STAR:0'
      name: '&6&l✦ ITEM LENDÁRIO ✦'
      amount: 1
      lore:
        - '&7Parabéns! Item raríssimo!'
        - ''
        - '&eClique para receber'
      enchants: []
    item:
      give: true
      material: 'NETHER_STAR:0'
      name: '&6&l✦ ESTRELA LENDÁRIA ✦'
      amount: 1
      lore:
        - '&7Item extremamente raro'
        - '&7que pode ser trocado'
        - '&7por recompensas especiais!'
      enchants: []
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: false
      list:
        - 'broadcast &6&l[!] &e{player} encontrou um ITEM LENDÁRIO!'
    messages:
      amount-placeholder: 1
      title: '&6&l✦ LENDÁRIO ✦<nl>&ePARABÉNS!'
      actionbar: ''
      chat: ''
      chat-ignore-timed: '<nl>&6&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬<nl>&6&l✦ ITEM LENDÁRIO ✦<nl>&eVocê encontrou um item raríssimo!<nl>&6&l▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬<nl>'

Coletando recompensas

Os jogadores podem ver e coletar suas recompensas através do comando:

/mina recompensas

Ou através do menu principal da picareta.

Configurando chances no mine_rewards.yml

rewards:
  # Recompensa comum (20% de chance)
  comum:
    mine: 'mina_1'
    chance: 20.0
    reward: 'pedra_especial'
  
  # Recompensa incomum (10% de chance)
  incomum:
    mine: 'mina_1'
    chance: 10.0
    reward: 'bonus_money'
  
  # Recompensa rara (5% de chance)
  rara:
    mine: 'mina_1'
    chance: 5.0
    reward: 'kit_vip'
  
  # Recompensa lendária (0.1% de chance)
  lendaria:
    mine: 'mina_1'
    chance: 0.1
    reward: 'lendario'

A chance é verificada a cada bloco quebrado. Valores entre 0.01 e 100.0 são válidos.

Permissões

Para receber recompensas:

yminaspackets.use

Para acessar menu de recompensas:

/mina recompensas

Após alterar as configurações, execute /minaadm reload para aplicar as mudanças.

Dicas importantes

Use o sistema de agrupamento de mensagens para não spammar o chat dos jogadores com recompensas comuns!

Recomendações:

Recompensas comuns → Use chat normal (agrupa mensagens)
Recompensas raras → Use chat-ignore-timed (sempre mostra)
Ajuste chances baseado na experiência do servidor
Teste as chances antes de aplicar em produção
Use broadcast para recompensas muito raras
Configure múltiplas minas com diferentes tabelas de recompensas

Nesta página