Recompensas

Exemplo completo de configuração

O sistema de recompensas permite criar diferentes tipos de prêmios para os jogadores. Aqui está um exemplo:

rewards:
  reward1:
    # Item que aparecerá no preview.
    preview:
      material: 'STONE:0'
      name: '&8Pedra'
      amount: 64
      lore: [ '&aEsta pedra vale muito dinheiro!', '', '&6Chance: {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}' ]

Estrutura de uma recompensa

Cada recompensa deve ter um ID único e as seguintes seções:

preview

Item exibido no menu de preview da liga.

Opções:

material - Material do item
name - Nome do item
amount - Quantidade do item
lore - Lore do item (lista)
enchants - Encantamentos do item (lista)

Placeholders disponíveis:

{chance} - Chance de receber a recompensa

Exemplo:

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

collect

Item exibido no menu de coleta de recompensas.

Opções:

material - Material do item
name - Nome do item
amount - Quantidade do item
lore - Lore do item (lista)
enchants - Encantamentos do item (lista)

Placeholders disponíveis:

{amount} - Quantidade de recompensas acumuladas

Exemplo:

rewards:
  reward1:
    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: []

item

Item físico que será dado ao jogador.

Opções:

give - Se deve dar o item (true/false)
material - Material do item
name - Nome do item
amount - Quantidade do item
lore - Lore do item (lista)
enchants - Encantamentos do item (lista)

Exemplo:

rewards:
  reward1:
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEu valho muito!' ]
      enchants: []

Se give: false, o item não será dado ao jogador, apenas os comandos serão executados (se configurados).

command

Comandos que serão executados ao coletar a recompensa.

Opções:

give - Se deve executar os comandos (true/false)
placeholder-amount - Valor base da placeholder {amount}
multiply-placeholder - Se deve multiplicar {amount} pela quantidade de recompensas
list - Lista de comandos a executar

Placeholders disponíveis:

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

Exemplo:

rewards:
  reward1:
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list: [ 'give {player} diamond {amount}' ]

Tipos de recompensas

Recompensa com item físico

Recompensa que dá um item ao jogador:

rewards:
  diamond_reward:
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante Brilhante'
      amount: 5
      lore: 
        - '&7Uma linda pedra preciosa!'
        - ''
        - '&6Chance: {chance}%'
      enchants: []
    collect:
      material: 'DIAMOND:0'
      name: '&bDiamante Brilhante'
      amount: 5
      lore: 
        - '&7Uma linda pedra preciosa!'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: []
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&bDiamante da Liga'
      amount: 5
      lore: 
        - '&7Conquistado na liga de clans!'
        - '&7Use com sabedoria.'
      enchants: []
    command:
      give: false
      placeholder-amount: 1
      multiply-placeholder: true
      list: []

Recompensa com comandos

Recompensa que executa comandos (como dar dinheiro):

rewards:
  money_reward:
    preview:
      material: 'GOLD_INGOT:0'
      name: '&6$1.000 em dinheiro'
      amount: 1
      lore: 
        - '&7Receba dinheiro direto na conta!'
        - ''
        - '&6Chance: {chance}%'
      enchants: []
    collect:
      material: 'GOLD_INGOT:0'
      name: '&6$1.000 em dinheiro'
      amount: 1
      lore: 
        - '&7Receba dinheiro direto na conta!'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: []
    command:
      give: true
      placeholder-amount: 1000
      multiply-placeholder: true
      list: 
        - 'eco give {player} {amount}'
    item:
      give: false

Recompensa mista (item + comandos)

Recompensa que dá item e executa comandos:

rewards:
  premium_reward:
    preview:
      material: 'NETHER_STAR:0'
      name: '&e&lRecompensa Premium'
      amount: 1
      lore: 
        - '&7Receba um item especial'
        - '&7e dinheiro!'
        - ''
        - '&6Chance: {chance}%'
      enchants: []
    collect:
      material: 'NETHER_STAR:0'
      name: '&e&lRecompensa Premium'
      amount: 1
      lore: 
        - '&7Receba um item especial'
        - '&7e dinheiro!'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: []
    item:
      give: true
      material: 'NETHER_STAR:0'
      name: '&e&lEstrela da Vitória'
      amount: 1
      lore: 
        - '&7Uma estrela brilhante!'
        - '&7Símbolo de sua conquista.'
      enchants: 
        - 'DURABILITY:3'
    command:
      give: true
      placeholder-amount: 5000
      multiply-placeholder: true
      list: 
        - 'eco give {player} {amount}'
        - 'broadcast &a{player} recebeu uma recompensa premium!'

Recompensa com item encantado

Recompensa que dá um item com encantamentos:

rewards:
  enchanted_sword:
    preview:
      material: 'DIAMOND_SWORD:0'
      name: '&c&lEspada Lendária'
      amount: 1
      lore: 
        - '&7Uma espada poderosa!'
        - '&7Afiada V'
        - '&7Aspecto Flamejante II'
        - ''
        - '&6Chance: {chance}%'
      enchants: 
        - 'DAMAGE_ALL:5'
        - 'FIRE_ASPECT:2'
    collect:
      material: 'DIAMOND_SWORD:0'
      name: '&c&lEspada Lendária'
      amount: 1
      lore: 
        - '&7Uma espada poderosa!'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - '&eClique esquerdo para receber'
        - '&eClique direito para deletar'
      enchants: 
        - 'DAMAGE_ALL:5'
        - 'FIRE_ASPECT:2'
    item:
      give: true
      material: 'DIAMOND_SWORD:0'
      name: '&c&lEspada da Liga'
      amount: 1
      lore: 
        - '&7Forjada pelos melhores!'
        - '&7Conquistada com honra.'
        - ''
        - '&c+5 Dano'
        - '&6Fogo II'
      enchants: 
        - 'DAMAGE_ALL:5'
        - 'FIRE_ASPECT:2'
        - 'DURABILITY:3'
    command:
      give: false

Encantamentos

Lista de encantamentos que podem ser usados:

Encantamentos de espadas

DAMAGE_ALL - Afiação
DAMAGE_ARTHROPODS - Ruína dos Artrópodes
DAMAGE_UNDEAD - Julgamento
FIRE_ASPECT - Aspecto Flamejante
KNOCKBACK - Repulsão
LOOT_BONUS_MOBS - Pilhagem

Encantamentos de armaduras

PROTECTION_ENVIRONMENTAL - Proteção
PROTECTION_FIRE - Proteção contra Fogo
PROTECTION_EXPLOSIONS - Proteção contra Explosões
PROTECTION_PROJECTILE - Proteção contra Projéteis
THORNS - Espinhos

Encantamentos de ferramentas

DIG_SPEED - Eficiência
DURABILITY - Inquebrável
LOOT_BONUS_BLOCKS - Fortuna
SILK_TOUCH - Toque Suave

Encantamentos de arco

ARROW_DAMAGE - Força
ARROW_FIRE - Chama
ARROW_INFINITE - Infinidade
ARROW_KNOCKBACK - Impacto

Exemplo de uso:

enchants: 
  - 'DAMAGE_ALL:5'
  - 'FIRE_ASPECT:2'
  - 'DURABILITY:3'

Boas práticas

Organize suas recompensas por raridade

rewards:
  # Recompensas comuns
  common_reward1:
    # ...
  common_reward2:
    # ...
  
  # Recompensas raras
  rare_reward1:
    # ...
  rare_reward2:
    # ...
  
  # Recompensas épicas
  epic_reward1:
    # ...
  
  # Recompensas lendárias
  legendary_reward1:
    # ...

Use nomes descritivos

# ✅ BOM - IDs descritivos
rewards:
  diamond_pack_5:
    # ...
  money_1000:
    # ...
  enchanted_sword_legendary:
    # ...

# ❌ EVITE - IDs genéricos
rewards:
  reward1:
    # ...
  item2:
    # ...
  thing3:
    # ...

Balanceie item e comando

Se você quer dar apenas comandos, desative o item:

rewards:
  money_only:
    # ... preview e collect ...
    item:
      give: false  # Não dar item físico
    command:
      give: true   # Apenas executar comandos
      list: 
        - 'eco give {player} 5000'

Se tanto item.give quanto command.give forem false, a recompensa não dará nada ao jogador!

Use multiply-placeholder: true para que recompensas acumuladas sejam multiplicadas automaticamente. Por exemplo, se o jogador tem 3 recompensas de $1000, ele receberá $3000.

Nesta página