Recompensas

Exemplo completo de configuração

Aqui está um exemplo de como configurar as recompensas do plugin:

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 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 recompensas

Cada recompensa possui três componentes principais: preview, collect e as recompensas em si (item e/ou command).

preview

Define como o item será exibido no menu de preview (quando aplicável).

Exemplo:

preview:
  material: 'STONE:0'
  name: '&8Pedra'
  amount: 64
  lore: [ '&aEsta pedra vale muito dinheiro!' ]
  enchants: []

Opções do preview

Opção	Descrição	Exemplo
`material`	Material do item	`'STONE:0'`
`name`	Nome do item	`'&8Pedra'`
`amount`	Quantidade do item	`64`
`lore`	Descrição do item	`[ '&aEsta pedra vale muito dinheiro!' ]`
`enchants`	Encantamentos do item	`['DURABILITY:1']`

collect

Define como o item será exibido no menu de recompensas quando o jogador for coletar.

Exemplo:

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

Placeholder disponível: {amount} - Retorna a quantidade de recompensas acumuladas do mesmo tipo.

Opções do collect

Opção	Descrição	Exemplo
`material`	Material do item	`'STONE:0'`
`name`	Nome do item	`'&8Pedra'`
`amount`	Quantidade do item	`64`
`lore`	Descrição do item	`[ '&7Quantidade: &f{amount}' ]`
`enchants`	Encantamentos do item	`['DURABILITY:1']`

item

Define se um item será dado ao jogador e suas propriedades.

Exemplo:

item:
  give: true
  material: 'STONE:0'
  name: '&8Pedra'
  amount: 64
  lore: [ '&aEu valho muito!' ]
  enchants: []

Opções do item

Opção	Descrição	Exemplo
`give`	Se o item será dado	`true`
`material`	Material do item	`'STONE:0'`
`name`	Nome do item	`'&8Pedra'`
`amount`	Quantidade do item	`64`
`lore`	Descrição do item	`[ '&aEu valho muito!' ]`
`enchants`	Encantamentos do item	`['DURABILITY:1']`

command

Define se comandos serão executados ao coletar a recompensa.

Exemplo:

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

Opções do command

Opção	Descrição	Exemplo
`give`	Se os comandos serão executados	`true`
`placeholder-amount`	Valor base da placeholder `{amount}`	`1`
`multiply-placeholder`	Multiplicar `{amount}` pela quantidade de recompensas	`true`
`list`	Lista de comandos a executar	`[ 'give {player} diamond {amount}' ]`

Placeholders disponíveis nos comandos: {player} - Nome do jogador, {amount} - Quantidade calculada.

Criando novas recompensas

Para criar uma nova recompensa, adicione uma nova entrada no arquivo rewards.yml:

rewards:
  reward1:
    # ... configuração da reward1
  
  reward2:
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 1
      lore: [ '&bQuem não adora uma pedra preciosa?!' ]
      enchants: []
    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: []
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list: [ 'give {player} diamond {amount}' ]

Exemplos de recompensas

Recompensa com item

rewards:
  emerald_reward:
    preview:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEsmeraldas valem muito?' ]
      enchants: []
    collect:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEsmeraldas valem muito?', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEu valho muito!' ]
      enchants: []

Recompensa com comando

rewards:
  money_reward:
    preview:
      material: 'GOLD_INGOT:0'
      name: '&6Dinheiro'
      amount: 1
      lore: [ '&eReceba dinheiro ao coletar!' ]
      enchants: []
    collect:
      material: 'GOLD_INGOT:0'
      name: '&6Dinheiro'
      amount: 1
      lore: [ '&eReceba dinheiro ao coletar!', '', ' &7> &fQuantidade: &7{amount}x $100', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: []
    command:
      give: true
      placeholder-amount: 100
      multiply-placeholder: true
      list: [ 'eco give {player} {amount}' ]

Recompensa mista (item + comando)

rewards:
  mixed_reward:
    preview:
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Premium'
      amount: 1
      lore: [ '&7Receba uma espada e XP!' ]
      enchants: ['DAMAGE_ALL:5']
    collect:
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Premium'
      amount: 1
      lore: [ '&7Receba uma espada e XP!', '', ' &7> &fQuantidade: &7{amount}', '', '&eClique esquerdo para receber', '&eClique direito para deletar' ]
      enchants: ['DAMAGE_ALL:5']
    item:
      give: true
      material: 'DIAMOND_SWORD:0'
      name: '&bEspada Premium'
      amount: 1
      lore: [ '&7Espada poderosa!' ]
      enchants: ['DAMAGE_ALL:5']
    command:
      give: true
      placeholder-amount: 100
      multiply-placeholder: true
      list: [ 'xp give {player} {amount}' ]

Usando recompensas nos grupos

Depois de configurar as recompensas, você pode referenciá-las nos arquivos de grupos:

blocks:
  stone:
    material: 'STONE:0'
    fortune: true
    exp: 1.0
    rewards:
      - '50.0,reward1'
      - '30.0,reward2'
      - '10.0,reward3'

O formato é: 'chance,id_da_recompensa' onde a chance é em porcentagem (50.0 = 50%).

O ID da recompensa usado nos grupos deve corresponder exatamente ao ID configurado em rewards.yml.

Nesta página