Recompensas

O arquivo rewards.yml configura todas as recompensas que os jogadores podem receber ao completar ações nas dungeons.

Triggers de Recompensas

O plugin suporta três tipos de triggers:

Trigger	Descrição
`MOB_KILL`	Recompensa ao matar um mob
`BOSS_KILL`	Recompensa ao matar um boss
`DUNGEON_COMPLETE`	Recompensa ao completar a dungeon

Estrutura de Recompensas

Cada recompensa tem duas formas de entrega:

Item físico - Entrega um item ao inventário do jogador
Comandos - Executa comandos personalizados

Exemplo Completo

rewards:
  mob_kill:
    display-name: '&7Recompensa de Mob'
    trigger: MOB_KILL
    give-item:
      enabled: true
      material: 'GOLD_NUGGET'
      name: '&6Pepita de Ouro'
      lore:
        - ''
        - ' &7Recompensa por matar um mob'
        - ' &7na dungeon.'
        - ''
      amount: 1
    give-commands:
      enabled: false
      commands: []
    preview-item:
      material: 'GOLD_NUGGET'
      name: '&6&lRecompensa de Mob &8x{count}'
      lore:
        - ''
        - ' &7Você tem &e{count}&7 recompensas'
        - ' &7de kills de mobs pendentes.'
        - ''
        - ' &aClique para coletar'
        - ''

Recompensas Configuradas

Recompensa de Mob

rewards:
  mob_kill:
    display-name: '&7Recompensa de Mob'
    trigger: MOB_KILL
    chance: 100.0
    give-item:
      enabled: true
      material: 'GOLD_NUGGET'
      name: '&6Pepita de Ouro'
      amount: 1
    give-commands:
      enabled: false

Recompensa de Boss

boss_kill:
  display-name: '&cRecompensa de Boss'
  trigger: BOSS_KILL
  chance: 100.0
  give-item:
    enabled: true
    material: 'DIAMOND'
    name: '&bDiamante'
    amount: 2
  give-commands:
    enabled: true
    commands:
      - 'eco give {player} 500'

Recompensa de Dungeon Completada

dungeon_complete:
  display-name: '&aDungeon Completada'
  trigger: DUNGEON_COMPLETE
  chance: 100.0
  give-item:
    enabled: true
    material: 'EMERALD'
    name: '&aEsmeralda'
    amount: 5
  give-commands:
    enabled: true
    commands:
      - 'eco give {player} 1000'
      - 'say {player} completou a Dungeon!'

Campos de Configuração

Campo	Descrição
`display-name`	Nome de exibição da recompensa
`trigger`	Quando a recompensa é dada
`give-item.enabled`	Se deve dar um item
`give-item.material`	Material do item
`give-item.name`	Nome customizado do item
`give-item.lore`	Lore do item
`give-item.amount`	Quantidade do item
`give-commands.enabled`	Se deve executar comandos
`give-commands.commands`	Lista de comandos a executar
`preview-item`	Item exibido no menu de recompensas pendentes

Placeholders para Comandos

Placeholder	Descrição
`{player}`	Nome do jogador
`{dungeon}`	Key da dungeon
`{round}`	Round atual
`{mobs}`	Mobs mortos

Sistema de Preview

O preview-item é exibido no menu de recompensas pendentes quando o jogador tem recompensas acumuladas mas ainda não coletou.

preview-item:
  material: 'DIAMOND'
  name: '&b&lRecompensa de Boss &8x{count}'
  lore:
    - ''
    - ' &7Você tem &e{count}&7 recompensas'
    - ' &7de kills de bosses pendentes.'
    - ''
    - ' &aClique para coletar'
    - ''

O placeholder {count} exibe quantas recompensas daquele tipo estão pendentes.

Sistema de Pools de Recompensas (Reward Pool)

O sistema de reward-pool permite mapear diferentes tipos de eventos (mob-kill, boss-kill, dungeon-complete) para recompensas específicas em cada dungeon. Isso permite maior flexibilidade nas recompensas oferecidas.

Estrutura Básica

reward-pool:
  mob-kill:
    - 'mob_kill'
  boss-kill:
    - 'boss_kill'
  dungeon-complete:
    - 'dungeon_complete'

Como Funciona

Quando um evento ocorre na dungeon:

O plugin verifica qual tipo de evento é (mob-kill, boss-kill, dungeon-complete)
Procura a chave correspondente em reward-pool
Seleciona aleatoriamente uma recompensa da lista
Aplica aquela recompensa ao jogador

Exemplo com Múltiplas Recompensas

Você pode ter múltiplas recompensas para cada tipo de evento. O plugin escolherá uma aleatoriamente:

reward-pool:
  mob-kill:
    - 'mob_kill'
    - 'mob_kill_bonus'
  boss-kill:
    - 'boss_kill'
    - 'boss_kill_epic'
    - 'boss_kill_rare'
  dungeon-complete:
    - 'dungeon_complete'
    - 'dungeon_complete_bonus'

Com esta configuração:

Ao matar um mob: pode receber mob_kill ou mob_kill_bonus (50% cada)
Ao matar um boss: pode receber boss_kill, boss_kill_epic ou boss_kill_rare (33% cada)
Ao completar: pode receber dungeon_complete ou dungeon_complete_bonus (50% cada)

Exemplo Prático Completo

Arquivo dungeons/exemplo.yml:

yplugins-id: 'yeventos-dungeon-exemplo'
display: 'Dungeon Exemplo'
type: 'DUNGEON'

# Mapeamento de recompensas por tipo de evento
reward-pool:
  mob-kill:
    - 'mob_kill'
  boss-kill:
    - 'boss_kill'
  dungeon-complete:
    - 'dungeon_complete'

Arquivo rewards.yml:

rewards:
  mob_kill:
    display-name: '&7Recompensa de Mob'
    trigger: MOB_KILL
    chance: 100.0
    give-item:
      enabled: true
      material: 'GOLD_NUGGET'
      amount: 1
  
  boss_kill:
    display-name: '&cRecompensa de Boss'
    trigger: BOSS_KILL
    chance: 100.0
    give-item:
      enabled: true
      material: 'DIAMOND'
      amount: 2
  
  dungeon_complete:
    display-name: '&aDungeon Completada'
    trigger: DUNGEON_COMPLETE
    chance: 100.0
    give-item:
      enabled: true
      material: 'EMERALD'
      amount: 5

Configuração de Chance

Cada recompensa em rewards.yml possui uma chance individual:

rewards:
  mob_kill:
    chance: 100.0  # Sempre concedida
  
  rare_drop:
    chance: 25.0   # 25% de chance

A chance é configurada em cada recompensa, não no reward-pool. Isso permite muito controle sobre a raridade de cada item.

Dicas de Uso

Use nomes descritivos

Nomeie suas recompensas de forma clara:

reward-pool:
  mob-kill:
    - 'common_mob_drop'
    - 'rare_mob_drop'

Balance as chances

Certifique-se de que as chances individuais das recompensas fazem sentido:

rewards:
  common_drop:
    chance: 75.0
  
  rare_drop:
    chance: 25.0

Teste em diferentes dungeons

Diferentes dungeons podem ter diferentes reward-pools:

# dungeon_facil.yml
reward-pool:
  mob-kill:
    - 'easy_mob_reward'

# dungeon_dificil.yml
reward-pool:
  mob-kill:
    - 'hard_mob_reward'
    - 'hard_rare_reward'

Use o reward-pool para criar progressão: dungeons fáceis dão itens comuns, dungeons difíceis dão itens raros.

Nesta página