Legacy

Welcome

Your world remembers who was first

Legacy adds cosmetic progression to the Let's Do Collection: titles to wear, a personal journey diary and server-wide milestones.

There are no skills, levels, attributes or gameplay bonuses. You play the same as always, and Legacy remembers what you did.

Getting Started

What Legacy tracks and where to find it.

The Legacy Journal

Everything Legacy records lives in one journal, opened from your inventory.

Opening the journal

Open your inventory, in survival or creative, and click the Legacy button to open the journal. It is split into tabs, one for each part of the mod.

Titles: every title you have unlocked, and the ones still ahead
Journey: your personal diary of first times
Milestones: the world-firsts of your server
Server History: who claimed which milestone, and when
Options: your personal display settings

View

Purely Cosmetic

Nothing Legacy gives you changes how the game plays.

View

How It Works

Titles, journeys and milestones.

Titles

Wear one title above your name. Its colour shows how rare it is.

Wearing a title

You unlock titles simply by playing. Pick one in the Titles tab and it appears above your name for everyone on the server. Some titles go in front of your name, like Farmer Marco, others behind it, like Marco, Dragonslayer.

The rarity sets the colour of both the title and your name. Titles that belong together form a series: the journal only reveals the next step, so you climb from one stage to the next.

Common: white
Uncommon: green
Rare: aqua
Epic: light purple
Legendary: gold
Mythic: red
Hidden titles only appear once unlocked
Titles come in a masculine and a feminine form, chosen in the Options tab

View

Journeys

A private diary of your first times, like your first diamond armor or your first sunrise.

View

Server Milestones

Server-wide first times. Whoever gets there first is recorded forever.

Be the first

When the first player on the server reaches a milestone, like entering the Nether or defeating the Wither, Legacy records their name, the world day and the real date. Everyone gets a message, and that player earns a milestone title.

Some milestones are shared: when a group defeats a boss together, everyone who joins in within a short time is recorded as well. The Server History tab keeps the full chronicle of your world.

Each milestone can only be claimed once per world
Shared milestones allow co-op claims for a short grace period
Worlds that already had an achievement before Legacy was installed mark it as pre-existing, so nobody can claim it later

View

Options

Each player decides how Legacy looks for them.

Options tab

These settings live in the Options tab of the journal and only affect your own client.

Title Form: masculine or feminine form of your titles
Show my nametag: see your own name and title in third person
Show others' titles: show titles above other players
Milestone alerts: get notified when someone claims a milestone
Title unlock toasts: show a toast when you unlock a title
Title colors: rarity colours, or plain white when off

View

Commands

Look things up from chat, or manage titles as an operator.

View

Adding Your Own

Every title, journey and milestone is a data pack file.

Data Pack Basics

No code needed. Drop a JSON file into a data pack and Legacy picks it up.

Folder layout

Each definition is one JSON file, found the same way as advancements or loot tables. Any data pack, in any namespace, can add new files or override existing ones with the same path.

data/<namespace>/legacy/
  titles/
    my_title.json
  journeys/
    my_journey.json
  milestones/
    my_milestone.json

/legacy reload reloads titles live, a vanilla /reload refreshes all three. Every file is validated on load: a broken file logs a warning and is skipped, the rest keeps working.

View

Adding a Title

One JSON file and one language entry.

Example

data/mypack/legacy/titles/blaze_hunter.json:

{
  "translation_key": "title.mypack.blaze_hunter",
  "category": "combat",
  "icon": "minecraft:blaze_rod",
  "rarity": "rare",
  "placement": "suffix",
  "trigger": {
    "type": "statistic",
    "stat_type": "minecraft:killed",
    "stat": "minecraft:blaze",
    "value": 20
  }
}

Then add the name to assets/mypack/lang/en_us.json: "title.mypack.blaze_hunter": "Blaze Hunter". For a feminine form add the same key with .female at the end. If you do not need translations, use "title": "Blaze Hunter" instead of translation_key.

trigger (required): when the title unlocks
rarity: common, uncommon, rare, epic, legendary or mythic
placement: prefix or suffix (default)
series and stage: chain titles, the journal reveals one stage at a time
hidden: true keeps it secret until unlocked
icon, category, display_priority: how it is shown and sorted
id: defaults to the file name

View

Adding a Journey

A first time worth remembering, with its own text right in the file.

Example

data/mypack/legacy/journeys/first_elytra.json:

{
  "category": "equipment",
  "icon": "minecraft:elytra",
  "title": "First Elytra",
  "description": "Claim the elytra and take to the skies.",
  "trigger": { "type": "item", "id": "minecraft:elytra" }
}

No language file needed. To translate it, add a translation_key and put <key> and <key>.desc in your language files. The literal text stays as fallback.

Categories: equipment, exploration, survival, farming, villagers, combat, magic, misc
Any other category gets its own header

View

Adding a Milestone

A world-first for your server.

Example

data/mypack/legacy/milestones/first_wither.json:

{
  "icon": "minecraft:nether_star",
  "rarity": "legendary",
  "shared": true,
  "grace_period": 300,
  "trigger": { "type": "kill", "id": "minecraft:wither" },
  "retro_advancement": "minecraft:nether/summon_wither"
}

The name comes from milestone.<namespace>.<id> in your language files, unless you set a translation_key.

Milestones use kill, dimension or advancement triggers
shared: others can join in during grace_period seconds
retro_advancement: marks the milestone as taken on worlds that already had it

View

Trigger Types

All three systems share the same trigger block.

What can unlock something

Titles and journeys are checked every few seconds. Milestones react to the event itself.

advancement: the player has an advancement, e.g. minecraft:end/kill_dragon
statistic: a vanilla statistic reaches a value, retroactive
counter: a Legacy counter reaches a value, e.g. harvest:crops, biomes_distinct, place:saplings, bonemeal:used, mine:#minecraft:logs
item: the player holds an item anywhere in the inventory
custom: a predicate registered by another mod
kill / dimension: milestones only, first kill of an entity or first visit to a dimension
Legacy counters start at 0 when the mod is installed

View

For Mod Developers

Custom triggers in Java, when JSON is not enough.

LegacyAPI

LegacyAPI.registerCustomTrigger("mymod:fate",
        (serverPlayer, title) -> serverPlayer.getInventory().contains(new ItemStack(Items.NETHER_STAR)));

LegacyAPI.grant(player, id) and LegacyAPI.revoke(player, id) give and take titles directly.

View