Custom Goals

Custom Goals let you create additional Chronicle milestones beyond vanilla advancements.

TLDR

Define goals in server config chronicle.customGoals.
Supported goal types: break_block, kill_mob, get_item.
One line can define multiple thresholds with & (for example 1&100&1000).
Completion writes an advancement-like Chronicle event and can become world-first.

Goal Syntax

Raw format per line:

Fields:

type: break_block / kill_mob / get_item
target: registry id (for example minecraft:stone)
count: optional, defaults to 1; supports multi-count via & or ,
title: optional; supports {count} and {count_x} tokens
description: optional; supports {count} and {count_x} tokens
icon: optional item id used for Chronicle icon

Example list:

[
  "break_block|minecraft:stone|1&100&1000",
  "kill_mob|minecraft:zombie|25|Zombie Exterminator|Killed {count} zombies.|minecraft:iron_sword",
  "get_item|minecraft:diamond|5|Diamond Cache|Obtained {count_x} diamonds.|minecraft:diamond"
]

Progress Tracking

Timeline increments progress from server events:

block break event -> break_block
entity death by player -> kill_mob
item pickup/craft/smelt -> get_item

Each goal tracks progress per player UUID.

Chronicle Output

When a player reaches threshold:

Timeline emits an advancement-type Chronicle event
sourceId becomes custom:<goalId>
world-first logic runs the same as normal advancements

DEEP DIVE: live goal set filtering

Timeline only shows custom-goal events whose goal definitions are currently active. If you remove a goal definition later, related events are hidden from normal timeline/Hall calculations.

Custom Goals

Goal Syntax

Progress Tracking

Chronicle Output

Like this wiki and these mods?