Recompensas

Exemplo completo de configuração

Aqui está um exemplo de como configurar recompensas:

#   ____                            _
# |  _ \ _____      ____ _ _ __ __| |___
# | |_) / _ \ \ /\ / / _` | '__/ _` / __|
# |  _ <  __/\ V  V / (_| | | | (_| \__ \
# |_| \_\___| \_/\_/ \__,_|_|  \__,_|___/
#

rewards:
  reward1:
    # 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}' ]
  reward2:
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list: [ 'give {player} diamond {amount}' ]
  reward3:
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda'
      amount: 1
      lore: [ '&aEu valho muito!' ]
      enchants: []

Estrutura de recompensas

Cada recompensa possui um ID único e pode conter itens e/ou comandos.

Criando uma recompensa

As recompensas seguem esta estrutura básica:

rewards:
  ID_DA_RECOMPENSA:
    item:
      # Configurações do item
    command:
      # Configurações de comandos

Opções de item

give

Define se o item será dado ao jogador. Valores válidos: true ou false.

Exemplo:

item:
  give: true

material

Define o tipo de material do item. Aceita nome de material do Minecraft ou ID com data (ex: STONE, STONE:1).

Exemplo:

item:
  material: 'DIAMOND:0'

name

Define o nome do item. Pode ser estilizado com códigos de cor (&).

Exemplo:

item:
  name: '&bDiamante Especial'

amount

Define a quantidade do item. O valor padrão é 1 se não especificado.

Exemplo:

item:
  amount: 64

lore

Define a descrição do item. Pode ser estilizada com códigos de cor (&).

Exemplo:

item:
  lore:
    - '&7Um item muito raro!'
    - '&aGuarde com cuidado.'

enchants

Define os encantamentos do item. O formato é "NOME_ENCANTAMENTO:NÍVEL".

Exemplo:

item:
  enchants:
    - 'DAMAGE_ALL:5'
    - 'DURABILITY:3'

Opções de comando

give

Define se os comandos serão executados. Valores válidos: true ou false.

Exemplo:

command:
  give: true

placeholder-amount

Define a quantia padrão da placeholder {amount} no comando (valor base).

Exemplo:

command:
  placeholder-amount: 1

multiply-placeholder

Define se a placeholder {amount} será multiplicada pela quantia de recompensas do mesmo tipo. Valores válidos: true ou false.

Exemplo:

command:
  multiply-placeholder: true

Quando multiply-placeholder está ativo e o jogador recebe 3 recompensas do mesmo tipo com placeholder-amount: 10, o comando será executado com {amount} = 30 (3 x 10).

list

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

Exemplo:

command:
  list:
    - 'give {player} diamond 10'
    - 'eco give {player} 1000'
    - 'broadcast {player} completou uma missão!'

Placeholders disponíveis: {player} - Nome do jogador que receberá a recompensa, {amount} - Quantidade calculada (se multiply-placeholder estiver ativo)

Tipos de recompensas

Recompensa apenas com item

rewards:
  item_simples:
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&bDiamante'
      amount: 5
      lore: []
      enchants: []
    command:
      give: false

Recompensa apenas com comandos

rewards:
  comando_simples:
    command:
      give: true
      placeholder-amount: 1
      multiply-placeholder: true
      list:
        - 'give {player} diamond_sword 1'
        - 'eco give {player} 5000'

Recompensa mista (item + comandos)

rewards:
  recompensa_completa:
    item:
      give: true
      material: 'EMERALD:0'
      name: '&aEsmeralda Rara'
      amount: 10
      lore: [ '&7Moeda do evento!' ]
      enchants: []
    command:
      give: true
      placeholder-amount: 10000
      multiply-placeholder: false
      list:
        - 'eco give {player} {amount}'
        - 'broadcast &a{player} ganhou uma recompensa especial!'

Vinculando recompensas

Para usar uma recompensa, referencie seu ID nas missões ou no sistema de recompensas por matar o mito:

Em missões (missions.yml)

# No arquivo missions.yml
rewards:
  - '100.0,reward1'
  - '50.0,reward2'

No config.yml (recompensas por matar o mito)

# No arquivo config.yml
rewards:
  amount: 1
  list:
    - '100.0,give {player} diamond 1'

O formato é "CHANCE,ID_RECOMPENSA", onde:

CHANCE: Porcentagem de chance (0.0 a 100.0)
ID_RECOMPENSA: ID da recompensa configurada em rewards.yml

Uma chance de 100.0 significa que o jogador sempre receberá essa recompensa.

Exemplos práticos

Recompensa de carvão

rewards:
  coal_reward:
    item:
      give: true
      material: 'COAL:0'
      name: '&8Carvão Especial'
      amount: 10
      lore:
        - '&7Recompensa por ser mito!'
      enchants: []
    command:
      give: false

Recompensa de diamantes

rewards:
  diamond_reward:
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&bDiamante do Mito'
      amount: 64
      lore:
        - '&7Você foi um mito incrível!'
        - '&aParabéns!'
      enchants: []
    command:
      give: false

Recompensa de dinheiro

rewards:
  money_reward:
    command:
      give: true
      placeholder-amount: 10000
      multiply-placeholder: true
      list:
        - 'eco give {player} {amount}'
        - 'title {player} title &6&lRecompensa!'
        - 'title {player} subtitle &fVocê ganhou ${amount}!'

Recompensa VIP completa

rewards:
  vip_reward:
    item:
      give: true
      material: 'NETHER_STAR:0'
      name: '&6&lEstrela VIP'
      amount: 1
      lore:
        - '&7Recompensa exclusiva para VIPs!'
        - '&eVocê é especial!'
      enchants: []
    command:
      give: true
      placeholder-amount: 50000
      multiply-placeholder: false
      list:
        - 'eco give {player} {amount}'
        - 'give {player} diamond_block 32'
        - 'broadcast &6{player} completou a missão VIP!'

Recompensa com encantamentos

rewards:
  enchanted_sword:
    item:
      give: true
      material: 'DIAMOND_SWORD:0'
      name: '&c&lEspada do Mito'
      amount: 1
      lore:
        - '&7Uma espada lendária!'
        - '&cPoder absoluto!'
      enchants:
        - 'DAMAGE_ALL:10'
        - 'FIRE_ASPECT:3'
        - 'DURABILITY:5'
    command:
      give: false

Recompensa múltipla

rewards:
  multiple_rewards:
    command:
      give: true
      placeholder-amount: 5
      multiply-placeholder: true
      list:
        - 'give {player} golden_apple {amount}'
        - 'give {player} diamond {amount}'
        - 'give {player} emerald {amount}'
        - 'eco give {player} 1000'

Certifique-se de que o ID da recompensa usado nas missões ou no config.yml existe no arquivo rewards.yml.

Nesta página