📁 Categories

Categories organize advancements into groups. They appear as tabs in the vanilla advancement GUI.

---

Defining Categories

Categories are defined at the top of advancements.yml:

categories:
  abenteuer:
    name: "&6Adventure"
    description: "Explore the world!"
    icon: COMPASS
    background: "minecraft:textures/gui/advancements/backgrounds/adventure.png"

  bergbau:
    name: "&7Mining"
    description: "Mine valuable resources!"
    icon: DIAMOND_PICKAXE
    background: "minecraft:textures/gui/advancements/backgrounds/stone.png"

---

Category Fields

Field	Description	Required
name	Display name (supports color codes)	✅
description	Short description	✅
icon	Material used as icon in the GUI	✅
background	Background texture for the vanilla advancement tab	❌

---

Background Textures

Vanilla Minecraft includes these background textures:

Background	Path
Adventure	minecraft:textures/gui/advancements/backgrounds/adventure.png
End	minecraft:textures/gui/advancements/backgrounds/end.png
Husbandry	minecraft:textures/gui/advancements/backgrounds/husbandry.png
Nether	minecraft:textures/gui/advancements/backgrounds/nether.png
Stone	minecraft:textures/gui/advancements/backgrounds/stone.png

You can also use custom resource pack textures.

---

Using Categories

When defining an advancement, reference the category by its key:

advancements:
  erster-stein:
    name: "&7First Stone"
    category: bergbau    # References the "bergbau" category
    # ...

---

Vanilla GUI Integration

Categories appear as tabs in the vanilla advancement GUI (press L). Each category has:

• Its own tab with the configured icon

• Its own background texture

• A tree structure of advancements within it

The tree structure is created through the parent field in advancements.

---