Recompensas

O arquivo rewards.yml contém o catálogo global de recompensas. Os dragões referenciam os IDs desse catálogo em seus grupos top1, top2, top3 e participation.

Exemplo completo de configuração

#   ____                            _
# |  _ \ _____      ____ _ _ __| |___
# | |_) / _ \ \ /\ / / _` | '__/ _` / __|
# |  _ <  __/\ V  V / (_| | | | (_| \__ \
# |_| \_\___| \_/\_/ \__,_|_|  \__,_|___/
#
# Catálogo global de recompensas
# Os dragões referenciam estas chaves em dragons/*.yml no formato chance,id
# Exemplo: '100,diamond'

rewards:
  diamond:
    # Item que aparece no preview do dragão.
    preview:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 16
      lore:
        - ' &7Recompensa do Ender Dragon.'
        - ' &7Chance: &f{chance}%'
        - ''
        - ' &7Quem ganha? &f{rank}'
      enchants: []
    # Item que aparece no armazém para coletar.
    collect:
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 16
      lore:
        - ' &7Recompensa do Ender Dragon.'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - ' &eClique esquerdo para receber'
        - ' &eClique direito para deletar'
      enchants: []
    # Item físico dado ao coletar / receber na hora.
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&bDiamante do Dragão'
      amount: 16
      lore:
        - ' &7Obtido no evento yDragon.'
      enchants: []
    command:
      give: false
      placeholder-amount: 1
      multiply-placeholder: true
      list: []
    money:
      give: false
      provider: money
      amount: 0
  money:
    preview:
      material: GOLD_INGOT
      name: '&6Dinheiro'
      amount: 1
      lore:
        - ' &7Recompensa em money (Vault).'
        - ' &7Chance: &f{chance}%'
        - ''
        - ' &7Quem ganha? &f{rank}'
      enchants: []
    collect:
      material: GOLD_INGOT
      name: '&6Dinheiro'
      amount: 1
      lore:
        - ' &7Recompensa em money (Vault).'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - ' &eClique esquerdo para receber'
        - ' &eClique direito para deletar'
      enchants: []
    item:
      give: false
      material: GOLD_INGOT
      name: '&6Dinheiro'
      amount: 1
      lore: []
      enchants: []
    command:
      give: false
      placeholder-amount: 1
      multiply-placeholder: true
      list: []
    # Economia via PointsManager. provider deve existir em economies.yml.
    money:
      give: true
      provider: money
      amount: 5000.0
  emerald:
    preview:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 8
      lore:
        - ' &7Recompensa intermediária.'
        - ' &7Chance: &f{chance}%'
        - ''
        - ' &7Quem ganha? &f{rank}'
      enchants: []
    collect:
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 8
      lore:
        - ' &7Recompensa intermediária.'
        - ''
        - ' &7> &fQuantidade: &7{amount}'
        - ''
        - ' &eClique esquerdo para receber'
        - ' &eClique direito para deletar'
      enchants: []
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 8
      lore: []
      enchants: []
    command:
      give: false
      placeholder-amount: 1
      multiply-placeholder: true
      list: []

Estrutura de uma recompensa

Cada ID, como diamond, money ou emerald, identifica uma recompensa que pode ter uma representação de preview, uma representação de coleta e entregas por item, comando ou moeda.

preview

Item exibido ao consultar as recompensas de um dragão. Os campos material, name, amount, lore e enchants definem a aparência.

No nome e na lore, {chance} mostra a chance configurada no grupo do dragão, sem o símbolo %. {rank} mostra o nome do grupo definido em config.yml → status.rank-*.

collect

Item exibido no armazém para recolher a recompensa. Também possui material, name, amount, lore e enchants.

{amount} no nome e na lore mostra a quantidade de unidades armazenadas.
{placeholder-amount} mostra a quantidade armazenada multiplicada por command.placeholder-amount.

O clique esquerdo recolhe a recompensa. O clique direito permite excluí-la quando general.right-delete-reward: true. O limite de coleta por clique é definido em config.yml → limit.

item

Define o item físico entregue ao jogador.

Opção	Descrição
`give`	Ativa ou desativa a entrega do item.
`material`	Material do item, como `DIAMOND:0` ou `GOLD_INGOT`.
`name`	Nome do item entregue, com suporte a cores.
`amount`	Quantidade de itens entregue por unidade de recompensa.
`lore`	Descrição do item. Aceita `{player}` para o nome do destinatário.
`enchants`	Lista de encantamentos do item. As recompensas fornecidas utilizam listas vazias.

Uma unidade da recompensa diamond entrega 16 diamantes; uma unidade de emerald entrega 8 esmeraldas. As quantidades visuais de preview e collect são configuradas separadamente do item físico.

command

Define a execução de comandos ao receber a recompensa.

Opção	Descrição
`give`	Ativa ou desativa a execução dos comandos.
`placeholder-amount`	Valor usado no cálculo da quantidade para comandos e no placeholder de mesmo nome do armazém.
`multiply-placeholder`	Ativa a substituição de `{amount}` nos comandos ao recolher pelo armazém.
`list`	Lista de comandos. Aceita `{player}` e `{amount}`.

Ao recolher pelo armazém com multiply-placeholder: true, {amount} recebe placeholder-amount × quantidade coletada. Por exemplo, com o valor padrão 1, a coleta de 10 unidades produz o valor 10 para {amount} nos comandos.

As três recompensas fornecidas têm command.give: false e list: [].

money

Define a entrega de moeda pelo sistema de economias.

Opção	Descrição
`give`	Ativa ou desativa a entrega da moeda.
`provider`	ID de uma economia definida em `economies.yml`.
`amount`	Valor entregue por unidade de recompensa.

A recompensa money entrega 5000.0 na economia money. O ID do catálogo e o ID da economia são referências distintas, mesmo que tenham o mesmo nome nesse exemplo.

Vinculando recompensas aos dragões

No arquivo do dragão, use o formato 'chance,id'. A chance é uma porcentagem e o ID deve existir em rewards.yml.

Este é o trecho de grupos do Ender Dragon:

# Trecho de dragons/ender.yml.
rewards:
  top1:
    - '100,diamond'
    - '100,money'
  top2:
    - '100,emerald'
    - '80,money'
  top3:
    - '100,emerald'
  participation:
    - '100,emerald'

reward-amount determina a quantidade de sorteios bem-sucedidos por jogador no grupo. O Ender Dragon usa 1 e o Nightmare Dragon usa 2.

O destino da entrega é definido por reward-ground e reward-player no arquivo de cada dragão. Nos dois dragões fornecidos, ambos estão em false, utilizando o armazém. Consulte Dragões para os detalhes dessas opções.

Nesta página