Custom Advancements

This mod allows you to add custom advancements to Minecraft using standard vanilla advancement JSON files. If you know how to make advancements for a datapack, you already know how to use this mod - just drop your JSON files into the config folder and they will load as regular advancements.

The mod is primarily intended for mod and modpack authors who want to ship advancements without creating a full datapack or including them inside a mod jar.

Features

Custom advancements via config folder

Place your advancement JSON files into:

./config/cadvancements/advancements/<namespace>/<your_files>.json

• <namespace> — the namespace used in the advancement ID (for example mymod, custom, tutorial).
• <your_files>.json — an advancement file with exactly the same structure as vanilla (display, criteria, requirements, rewards, etc.).

Soft-reload

You can update the achievements using the standard /reload command.

Fully vanilla-compatible JSON format

Every field that works in a vanilla advancement works here. You can use vanilla triggers (minecraft:inventory_changed, minecraft:player_killed_entity, etc.), vanilla rewards (loot, experience, function), and vanilla display options (icon, title, description, frame, background, show_toast, announce_to_chat, hidden).

Example of a JSON advancement

{
  "display": {
    "icon": { "item": "minecraft:stone" },
    "title": "Stone Age",
    "description": "Mine your first stone",
    "frame": "task",
    "show_toast": true,
    "announce_to_chat": true
  },
  "criteria": {
    "get_stone": {
      "trigger": "minecraft:inventory_changed",
      "conditions": {
        "items": [ { "items": ["minecraft:stone"] } ]
      }
    }
  },
  "requirements": [ ["get_stone"] ]
}

BetterAdvancements compatibility

If BetterAdvancements is installed, you can extend your advancements with an optional better_display block that controls how the advancement is drawn in the advancement tree.

"better_display": {
  "pos_x": 0,
  "pos_y": 0,
  "completed_icon_color": "#FFFFFF",
  "uncompleted_icon_color": "#FFFFFF",
  "completed_title_color": "#FFFFFF",
  "uncompleted_title_color": "#FFFFFF",
  "draw_direct_lines": false,
  "hide_lines": false
}

The better_display block is ignored if BetterAdvancements is not installed.

Client and server friendly

Advancements loaded from the config folder behave like regular advancements — they sync to clients, work with the vanilla advancement GUI, grant rewards, and can be used in /advancement grant and /advancement revoke commands.