🎁 Rewards

Rewards are granted when a player completes an advancement. Every reward type is optional and can be combined freely.

---

All Reward Types

rewards:
  # Run commands (as console)
  commands:
    - "give %player% diamond 1"
    - "say %player% completed an advancement!"

  # Give money (requires Vault)
  money: 100.0

  # Give experience points
  xp: 50

  # Give items
  items:
    - material: DIAMOND
      amount: 5
      name: "&bBonus Diamonds"
      lore:
        - "&7Reward for completing"
        - "&7an advancement!"

  # Apply potion effects
  effects:
    - type: SPEED
      duration: 200     # In ticks (200 = 10 seconds)
      amplifier: 1      # 0 = Level I, 1 = Level II

  # Play a sound
  sound: ENTITY_PLAYER_LEVELUP

  # Show a title
  title: "&6&lCongratulations!"
  subtitle: "&eAdvancement Complete!"

  # Show in the action bar
  actionbar: "&aNew reward received!"

  # Show a boss bar
  bossbar:
    text: "&6Achievement Complete!"
    color: GREEN          # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
    duration: 5           # Seconds

---

Reward Details

Commands

Commands are executed from the console. Use %player% as a placeholder for the player's name.

commands:
  - "give %player% diamond 5"
  - "eco give %player% 1000"
  - "broadcast &e%player% &ais a champion!"

Money

Requires the Vault plugin and an economy plugin (like EssentialsX).

money: 500.0

Experience Points

Gives vanilla XP to the player.

xp: 100

Items

Give items with custom names and lore.

items:
  - material: DIAMOND_SWORD
    amount: 1
    name: "&c&lLegendary Sword"
    lore:
      - "&7A reward for the brave"
      - "&7warriors of this realm."

Effects

Apply potion effects. Duration is in ticks (20 ticks = 1 second).

effects:
  - type: SPEED
    duration: 6000      # 5 minutes
    amplifier: 1        # Speed II
  - type: REGENERATION
    duration: 200       # 10 seconds
    amplifier: 0        # Regen I

Sound

Play a Minecraft sound. Use Sound names.

sound: UI_TOAST_CHALLENGE_COMPLETE

Title and Subtitle

Show a large title on screen.

title: "&6&lAdvancement Complete!"
subtitle: "&eYou are amazing!"

ActionBar

Show a message in the action bar.

actionbar: "&a+100 XP received!"

BossBar

Show a temporary boss bar.

bossbar:
  text: "&6Achievement Complete!"
  color: GREEN
  duration: 5

---

Per Advancement Toggles

Each advancement can override the global config settings for notifications. This allows you to disable specific features for individual advancements.

rewards:
  xp: 200
  # Override global settings
  sound-enabled: false        # No completion sound
  title-enabled: false        # No title display
  actionbar-enabled: false    # No action bar message
  bossbar-enabled: false      # No boss bar
  firework-enabled: false     # No firework
  particles-enabled: false    # No particles
  broadcast-enabled: false    # No broadcast to other players
  toast-enabled: false        # No vanilla toast notification
  chat-message-enabled: false # No chat completion message

Toggle Behavior

Value	Behavior
true	Always enabled (even if globally disabled)
false	Always disabled (even if globally enabled)
Not set	Uses global config setting

Example: Silent Advancement

stiller-held:
  name: "&8Silent Hero"
  description: "Kill 100 mobs (quietly)"
  icon: IRON_SWORD
  frame: TASK
  category: kampf
  trigger:
    type: KILL_ENTITY
    amount: 100
  rewards:
    xp: 200
    sound-enabled: false
    firework-enabled: false
    particles-enabled: false
    broadcast-enabled: false
    title-enabled: false

---

Per-Advancement Progress Display

You can customize the ActionBar text, BossBar text/color/duration, and progress sound for each advancement individually. This overrides the global settings only for progress updates of that specific advancement.

rewards:
  xp: 200
  money: 1000.0
  chat-message-enabled: false       # Disable chat spam for high-target advancements
  progress:
    actionbar-text: "&6🏃 Marathon: &e%progress%&7/&e%target% &7Blöcke (&e%percentage%%&7)"
    sound: BLOCK_NOTE_BLOCK_PLING   # Custom progress sound
    bossbar:
      text: "&6🏃 Marathon-Läufer &7- &e%percentage%%"
      color: YELLOW                 # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE
      duration: 8                   # Seconds

Available Placeholders

Placeholder	Description
%advancement%	Advancement display name
%progress%	Current progress value
%target%	Target value
%percentage%	Progress percentage (e.g. 75.0)

Example: Marathon Runner with Custom Progress Display

marathon-laeufer:
  name: "&6Marathon-Läufer"
  description: "Sprint 10,000 blocks"
  icon: GOLDEN_BOOTS
  frame: GOAL
  category: abenteuer
  trigger:
    type: SPRINT_DISTANCE
    amount: 10000
  rewards:
    xp: 200
    money: 1000.0
    chat-message-enabled: false
    progress:
      actionbar-text: "&6🏃 &e%progress%&7/&e%target% &7blocks (&e%percentage%%&7)"
      sound: BLOCK_NOTE_BLOCK_PLING
      bossbar:
        text: "&6🏃 Marathon &7- &e%percentage%%"
        color: YELLOW
        duration: 8

---