Recompensas

Exemplo completo de configuração

Aqui está um exemplo de como configurar recompensas:

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
      list: [ 'give {player} stone 1' ]
  reward2:
    command:
      give: true
      list: [ 'give {player} diamond 1' ]
  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

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 o evento!'

Placeholder disponível: {player} - Nome do jogador que receberá a recompensa

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
      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
      list:
        - 'eco give {player} 10000'
        - 'broadcast &a{player} ganhou uma recompensa especial!'

Vinculando recompensas aos eventos

Para usar uma recompensa em um evento, referencie seu ID no arquivo do Easter:

# No arquivo easters/halloween.yml
rewards:
  - '100.0,reward1'
  - '50.0,reward2'

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 ao completar o evento.

Exemplos práticos

Recompensa de evento de Natal

rewards:
  natal_completo:
    item:
      give: true
      material: 'DIAMOND:0'
      name: '&cPresente de Natal'
      amount: 1
      lore:
        - '&7Você completou o evento de Natal!'
        - '&aParabéns!'
      enchants: []
    command:
      give: true
      list:
        - 'eco give {player} 50000'
        - 'title {player} title &c&lParabéns!'
        - 'title {player} subtitle &fEvento completado!'

Recompensa aleatória

rewards:
  premio_comum:
    command:
      give: true
      list: [ 'give {player} iron_ingot 32' ]
  premio_raro:
    command:
      give: true
      list: [ 'give {player} diamond 16' ]
  premio_lendario:
    item:
      give: true
      material: 'NETHER_STAR:0'
      name: '&6Estrela Lendária'
      amount: 1
      lore: [ '&7Item raríssimo!' ]
      enchants: []

E no arquivo do Easter:

rewards:
  - '100.0,premio_comum'
  - '30.0,premio_raro'
  - '5.0,premio_lendario'

Certifique-se de que o ID da recompensa usado no arquivo do Easter existe no arquivo rewards.yml.

Nesta página