🏆 Advancements

Advancements are defined in advancements.yml. This page explains the full structure.

---

Basic Structure

advancements:
  advancement-key:
    name: "&7Display Name"
    description: "Description text"
    icon: COBBLESTONE
    frame: TASK
    category: bergbau
    parent: parent-key       # Optional
    hidden: false            # Optional
    trigger:
      type: BLOCK_BREAK
      amount: 100
      material: STONE
    rewards:
      xp: 50
      money: 200.0

---

Fields Explained

name

The display name of the advancement. Supports color codes.

description

A short description shown in the GUI and info command.

icon

The Minecraft material used as the icon. Must be a valid Material name.

frame

The frame type shown in the vanilla advancement GUI:

Frame	Description	Appearance
TASK	Normal task	Square frame
GOAL	Goal	Rounded frame
CHALLENGE	Challenge	Star shaped frame

category

The category key this advancement belongs to. Must match a category defined in the categories section.

parent

Optional. The key of the parent advancement. Creates a tree structure in the vanilla GUI. The parent must be completed before this advancement becomes available.

hidden

Optional. If true, this advancement is hidden in the GUI until its parent is completed.

---

Trigger Section

The trigger defines what action the player must perform. See Trigger Types for the full list.

trigger:
  type: KILL_ENTITY       # Required: trigger type
  amount: 50              # Required: how many times
  material: STONE         # Optional: specific material
  entity: ZOMBIE          # Optional: specific entity type
  dimension: NETHER       # Optional: required dimension
  biome: DESERT           # Optional: required biome
  description: "Custom"   # Optional: custom description

Extended Trigger Options

See Conditions System for:

• Location conditions (point, radius, region, height)

• State conditions (falling, sneaking, flying, equipment, etc.)

• World conditions (dimension, biome, weather)

• Chat filters (exact, contains, regex)

• Command filters

---

Rewards Section

See Rewards for the full rewards documentation.

rewards:
  commands:
    - "give %player% diamond 1"
  money: 100.0
  xp: 50
  items:
    - material: DIAMOND
      amount: 1
      name: "&bBonus Diamond"
  effects:
    - type: SPEED
      duration: 200
      amplifier: 1
  sound: ENTITY_PLAYER_LEVELUP
  title: "&6Congratulations!"
  subtitle: "&eAdvancement Complete!"
  actionbar: "&aNew reward received!"
  bossbar:
    text: "&6Achievement Complete!"
    color: GREEN
    duration: 5

---

Example: Complete Advancement

diamantjaeger:
  name: "&bDiamond Hunter"
  description: "Mine 10 diamond ores"
  icon: DIAMOND_ORE
  frame: GOAL
  category: bergbau
  parent: steinsammler
  trigger:
    type: BLOCK_BREAK
    amount: 10
    material: DIAMOND_ORE
  rewards:
    xp: 200
    money: 1000.0
    items:
      - material: DIAMOND
        amount: 5
        name: "&bBonus Diamonds"
    commands:
      - "say %player% completed Diamond Hunter!"
    sound: UI_TOAST_CHALLENGE_COMPLETE
    title: "&b&lDiamond Hunter!"
    subtitle: "&710 diamond ores mined!"

---

Example: Advancement with Conditions

fallschirm-snack:
  name: "&e&lParachute Snack"
  description: "Eat a golden apple while falling"
  icon: GOLDEN_APPLE
  frame: CHALLENGE
  category: abenteuer
  trigger:
    type: EAT_ITEM
    amount: 1
    material: GOLDEN_APPLE
    conditions:
      falling: true
  rewards:
    xp: 200
    money: 500.0
    firework-enabled: false

---