Advancements

This article is about the advancements in Matcha Flavoured. For the fish catalog, see Angler's Almanac.

Advancements in Matcha Flavoured replace the whole vanilla advancement tree. They guide the player through the pack's progression, reward obols and crystal hearts, and, for seven milestones, lower the player's minimum health. The pack also uses several hundred hidden advancements internally, to trigger mechanics and unlock recipes.

When the pack loads, it tells players: "If you get lost or confused, check the advancements". The README gives the same advice to players stuck in the early game.

Overview

The datapack blocks the five vanilla advancement folders (story, nether, end, adventure and husbandry) through the filter in its pack.mcmeta, so none of the vanilla advancements exist. The pack's own advancements are in the matcha namespace, in four visible tabs:

Tab	Root	Background	Unlocked by	Advancements
Tutorial	From Earth	Dirt	Joining the world	61 (3 hidden)
Hell	Through Hell	Hellstone	Entering Hell	9 (1 hidden)
The End	To Dreams	Black Concrete	Entering the End	5
Angler's Almanac	Angler's AlmanacDiscover the fish that inhabit this world Angler's Almanac	Barrel	Obtaining the Angler's Almanac	102 (all hidden)

Rewards

Many advancements give a reward, and their descriptions show it as a symbol before the text:

• Each coin symbol is one obol, given as an item. Larger rewards are written as a number, such as "10 ".
• ❤ Each heart symbol is one crystal heart, given as an item. Only the four "Canto" advancements give hearts.
• The broken heart symbol marks a milestone that lowers the player's minimum hearts by 1. Each player's minimum starts at 10 hearts and is the lowest their maximum health can fall through death. Seven milestones carry this symbol, so completing all of them lowers the minimum to 3 hearts, the floor for Hard. On Peaceful and Easy maximum health never falls below 10 hearts, whatever the minimum. On Normal, a player whose minimum falls below 6 hearts, which happens at the fifth milestone, switches the world to Hard. Each step prints an ominous message in chat, such as "The Dead grow restless...".

The broken-heart milestones are Brazier (copper), The Stalwart Metal (iron), The Resilient Mineral (diamond), A Zealous Alloy (electrum), A Divine Alloy (adamant), Orpheus (entering Hell) and The End of Dreams (finding a stronghold). The system rewards slow progress: a player who rushes for iron and diamonds makes their deaths more costly sooner. See Death and Difficulty.

Revocation on update

When a player joins a world after it has been updated to a newer version of the pack, their recipe unlocks are reset, so that recipes that were added or changed can be unlocked again. Since 1.12.6-alpha nothing else is taken away: advancements that give rewards or affect the heart system are kept, and the player's minimum hearts are no longer reset to 10. Since 1.12.7-beta the update also sets the player's experience level to 10,000; see Anvil#Experience. From 1.12.1-alpha to 1.12.5 the update also revoked most of those advancements so that they could be earned again under the new rules (sparing "No More Fish in the Sea" and "Demonic Emissary"; since 1.12.3 a shorter, hand-picked list), and by 1.12.5 it also reset the minimum to 10 hearts. See Updating items.

Tutorial

See also: Progression, Guide for new players

The Tutorial tab, rooted in "From Earth", traces the pack's progression in several branches: the fire, kiln and metal line that ends with alloys and smithing; a cooking line; a warding and jewelry line; the four "Canto" gem hunts; and a trading and fishing line. "From Earth" is granted on the first tick a player is in the world and runs the pack's first-load setup. The requirements below are the actual criteria in the code, which are sometimes broader than the in-game description.

Icon	Advancement	In-game description	Parent	Actual requirements	Type	Reward
	From Earth	—	—	Be in the world.	Task (root)	—
	Prometheus be Damned	Light Kindling using Tinder or a Flint Firestarter	From Earth	Use a fire starter or tinder on a kindling (campfire).	Task	—
	Harvester	Use a Hoe to harvest Grass and dry it on a Campfire	Prometheus be Damned	Have short dry grass or tall dry grass in the inventory.	Task	—
	Ancient Technology	Construct a Kiln made from Packed Mud and Mudbricks	Harvester	Have a mud kiln in the inventory.	Task	—
	Brazier	Use a Mud Kiln to Smelt Copper	Ancient Technology	Have a copper ingot in the inventory, from any source.	Task	Minimum hearts −1
	Mason	Kilns excel at processing Earthen Materials	Brazier	Have smooth stone in the inventory.	Task	—
	Burgeoning Metallurge	Blast Furnaces burn hotter than Kilns, able to melt more durable Metals	Mason	Have a blast furnace in the inventory.	Task	—
	The Stalwart Metal	Iron has no Intrinsic Properties and can only Host Steel	Burgeoning Metallurge	Have an iron ingot in the inventory.	Task	Minimum hearts −1
	A Brittle Alloy?	Craft Carbon-Rich Iron with Iron and a Coal Block	The Stalwart Metal	Have carbon-rich iron in the inventory.	Task	—
	A Tough Alloy	Made by blasting Carbon-Rich Iron, Steel grants Iron Equipment Knockback and greatly increased Durability	A Brittle Alloy?	Have steel alloy in the inventory.	Task	—
	Master Metallurge	Smithing Tables allow you to modify Base-Metal tools using Alloys	A Tough Alloy	Have a smithing table in the inventory.	Task	—
Smithing TemplateSmithing Upgrade Template	Upgrades	Smithing Upgrades are used to Modify and Upgrade Mattocks and Dolabras	Master Metallurge	Have a smithing template in the inventory.	Task	—
Steel Dolabra 7 6 0.9Repaired with:Iron Ingot	Three in One?	Smith a Mattock or Dolabra into its alloyed form	Upgrades	Smith a steel, shakudo or electrum mattock or dolabra. Hepatizon and adamant ones don't count.	Goal	2  Obol
Adamant Pickaxe 15 6 1.2Set Bonus: (00:30)Repaired with:Block of DiamondAdamant Scrap	Apocryphal Adamant	Smith a piece of Adamant Equipment from Diamond with Adamant Alloy	Master Metallurge	Smith any of 13 adamant items, including the claymore.	Challenge	4  Obol
Hepatizon Pickaxe 20 4.5 1.2 +0.005Repaired with:Block of Copper	Brilliant Bronze	Smith a piece of Hepatizon Equipment from Copper with Hepatizon Alloy	Master Metallurge	Smith any of 12 hepatizon items.	Goal	1  Obol
Electrum Pickaxe 12 5 1.2Repaired with:Block of Diamond	Evangelic Electrum	Smith a piece of Electrum Equipment from Diamond with Electrum Alloy	Master Metallurge	Smith any of 12 electrum items.	Challenge	4  Obol
Shakudo Pickaxe 9 4 1.2Repaired with:Block of Copper	Palatinate Perfection	Smith a piece of Shakudo Equipment from Copper with Shakudo Alloy	Master Metallurge	Smith any of 12 shakudo items.	Goal	1  Obol
Steel Pickaxe 8 4 1.2Repaired with:Iron Ingot	Sturdy Steel	Smith a piece of Steel Equipment from Iron with Steel Alloy	Master Metallurge	Smith any of 13 steel items (tools, weapons, armor or shears).	Goal	1  Obol
	Repair & Reuse	Anvils made from Steel can repair Any Equipment with its corresponding Base-Metal Ingot forever	A Tough Alloy	Have an anvil in the inventory.	Task	—
	The Generous Metal	Gold has Fortune and Looting Intrinsics	Burgeoning Metallurge	Have a gold ingot in the inventory.	Task	—
	A Divine Alloy	Adamant grants the wielder a Divine Constitution	The Generous Metal	Have adamant alloy in the inventory.	Goal	Minimum hearts −1
	A Gentle Alloy	Shakudo grants Copper Equipment Silk Touch and Cleansing Properties	The Generous Metal	Have shakudo alloy in the inventory.	Task	—
	The Resilient Mineral	Diamonds have no Intrinsics but are capable of Hosting Electrum and Adamant	Burgeoning Metallurge	Have a diamond in the inventory.	Task	Minimum hearts −1
Stabilized Estus	Orpheus	Descend into Hell	The Resilient Mineral	Enter Hell.	Goal	Minimum hearts −1
	The End of Dreams	Their Time is Near	Orpheus	Enter a stronghold.	Goal	Minimum hearts −1
	The Warding Metal	Silver, a once-common Apotropaic Metal is found most commonly in Mountains. Most deposits are now harboured in Abbeys	Burgeoning Metallurge	Have raw silver or silver bullion in the inventory.	Goal	1  Obol
	A Keen Alloy	Hepatizon grants Copper Equipment unrivaled Speed	The Warding Metal	Have hepatizon alloy in the inventory.	Task	—
Electrum Alloy	A Zealous Alloy	Electrum enhances the Fortune and Looting Properties of Gold but only Diamond can host the Alloy	The Warding Metal	Have electrum alloy in the inventory.	Goal	Minimum hearts −1
	Archeologist in Training	Craft a Brush	Brazier	Craft a brush.	Task	—
Clay Fetish	A Miraculous Discovery!	Find a Clay Fetish by searching abandoned Sites	Archeologist in Training	Have either clay fetish in the inventory.	Goal	3  Obol
Copper Dolabra 5 5 0.8	Two in One	Mattocks and Dolabras work as two tools in one but mine slower than their base tools	Brazier	Craft a copper, iron or diamond mattock or dolabra.	Goal	1  Obol
Grilled Melon Fire Resistance (0:10)	Powerful Flavors	Reveal the hidden aspect of a Food by cooking it on a Campfire or an Oven	Prometheus be Damned	Have any of 11 cooked ingredients in the inventory, such as grilled melon, steamed carrots or baked apple.	Task	—
	Now You're Cooking	Construct an Oven from Bricks and Iron	Powerful Flavors	Have an oven in the inventory.	Task	—
	Manners First	Make a Ceramic Bowl from Bricks	Now You're Cooking	Have a bowl in the inventory.	Task	—
Pumpkin Curry Resistance (20:00)	Fortified Goodness	Make Pumpkin Curry	Manners First	Cook pumpkin curry in an oven.	Task	1  Obol
Japanese Curry Strength (30:00)	Hearty Curry	Make Japanese Curry	Manners First	Cook Japanese curry in an oven.	Task	1  Obol
Paneer Makhani Regen (10:00)	Sweet and Spicy!	Make Paneer Makhani. All Foods have viable Vegetarian Options	Manners First	Cook paneer makhani in an oven.	Task	1  Obol
Tonkotsu Ramen Haste II (30:00)	The Best Soup!	Make Ramen	Manners First	Cook tonkotsu ramen in an oven.	Task	1  Obol
Green Curry +40% (30:00)	Too Spicy!	Make Green Curry	Manners First	Cook green curry in an oven.	Task	1  Obol
Sweet Berry Jam (3:00)	Pickles & Jam	Preserve a food to boost its flavour profile	Now You're Cooking	Craft any of 15 preserves.	Task	—
Pickled Carrots Night Vision (5:00)	Doomsday Prepper	Preserve Everything!	Pickles & Jam	Craft all 15 preserves: canned apples, glow jam, mead, pickled carrots, pickled potatoes, sun-dried tomatoes, pumpkin jam, rind jam, sweet berry jam, pickled mushrooms, pickled toadstools and the four secret preserves.	Challenge	4  Obol
Steamed Golden Carrots Night Vision (1:00)	Hidden Flavors	Cook a secret Ingredient	Powerful Flavors	Have steamed golden carrots, a baked golden apple, braised crimson fungus or braised warped fungus in the inventory. See Secret recipes.	Task	1  Obol
Golden Carrot Cupcake Night Vision (20:00)	Wait, you can make that?	Cook a secret Meal	Hidden Flavors	Craft any of 11 secret meals.	Goal	2  Obol
	Hellish Powder	It Radiates Holy Power. It kind of smells like Curry... maybe Cinnamon?	From Earth	Have Estus ash in the inventory.	Task (hidden)	—
	Apotropaic Jewellery	Holding a Lapis Nazar will Ward the Dead. It can also be attached to some Equipment	Hellish Powder	Craft a nazar.	Task	1  Obol
Warding Sword 5 1.6Repaired with:NazarBlock of Lapis Lazuli	Fae-Slayer	Affix a Nazar to an Iron Sword in a Smithing Table	Apotropaic Jewellery	Smith a warding sword.	Task	—
Silver Sword 6 1.6Repaired with:NazarBlock of Lapis Lazuli	Sabbatarian	Affix a Nazar to an Iron Sword inlaid with Silver in a Smithing Table	Fae-Slayer	Smith a silver sword.	Task	1  Obol
Warding ShieldRepaired with:NazarBlock of Lapis Lazuli	Convoymaster	Affix a Nazar to an Shield inlaid with Silver in a Smithing Table	Sabbatarian	Smith a warding shield.	Task	1  Obol
Opal	Canto I	❤ Defeat the Sea God	Hellish Powder	Have an opal in the inventory. Opals drop from elder guardians.	Task	1  Crystal Heart
Ruby	Canto II	❤ Pillage the Remnants of Pandaemonium	Canto I	Have a ruby in the inventory. Rubies are found in bastion chests.	Task	1  Crystal Heart
Amber	Canto III	❤ Exhume the Pilgrim's Trails	Canto II	Have amber in the inventory. Amber comes from the rare archaeology loot of trail ruins.	Task	1  Crystal Heart
Topaz	Canto IV	❤❤ Raid Tartarus	Canto III	Have a topaz in the inventory. Topaz is found in ancient city chests.	Task	2  Crystal Heart
Pith	A Vestige of Divinity	A Relic only obtained by breaking Spawners or vanquishing powerful Forces	Hellish Powder	Have pith in the inventory.	Goal	2  Obol
Crystal Heart	Crystal Heart!	Crystal Hearts impart a piece of divinity onto Gods who devour them. Though mortals were only able to use their Undying properties.	A Vestige of Divinity	Have a crystal heart in the inventory.	Challenge	3  Obol
	You're Rich!	Obtain an Obol	From Earth	Have an obol in the inventory.	Task (hidden)	—
	Bonfire Lit	Use a Beacon Kindling to signal a Wandering Trader	You're Rich!	Use beacon kindling on a block.	Task	1  Obol
Asylum SeekerClick the ground to summon	A Good Samaritan	Cover the Relocation costs for an Asylum Seeker, and make a home for them here	Bonfire Lit	Buy an asylum seeker from a trader.	Task	1  Obol
Carp⭐⭐☆☆	Fishmonger	Sell caught fish to a Fisherman	A Good Samaritan	Receive an obol from a fisherman in a trade.	Task	1  Obol
	A True Community	5 Trade with (almost) every profession	Fishmonger	Trade with each of the 12 professions except the weaponsmith: engineer, cook, archaeologist, chemist, farmer, fisherman, fletcher, lumberjack, mouthpiece, mason, shepherd and jeweler.	Challenge	5  Obol
Carp⭐⭐☆☆	No More Fish in the Sea	10 Catch Everything!	Fishmonger	Catch all 47 fish with a fishing rod.	Challenge	10  Obol
Wooden Cross	God help you...	Commit great evil	A Good Samaritan	Kill a villager or a wandering trader.	Task (hidden)	—

Hell

The Hell tab appears when the player first enters Hell. Its main line follows the pack's magic: benzene, stabilized Estus, and then either a warding stone or the hell-bound book used to craft blessings.

Icon	Advancement	In-game description	Parent	Actual requirements	Type	Reward
	Through Hell	—	—	Enter Hell.	Task (root)	—
	Forbidden Chemistry	Synthesize Benzene: a Chemical Reagent Forbidden by the Old Laws	Through Hell	Have benzene in the inventory.	Task	1  Obol
Stabilized Estus	Hellish Bindings	Tether Raw Estus into a Stable Form	Forbidden Chemistry	Craft stabilized Estus.	Task	1  Obol
Hell-Bound Book	Unholy Knowledge	Craft a Hell-Bound Book	Hellish Bindings	Craft a hell-bound book. Since 1.12.9 it also unlocks every blessing recipe.	Task	1  Obol; 23 recipes
BlessingPrayer of Prometheus	Apocrypha	Steal Prayers from a long-dead God	Unholy Knowledge	Craft any of the 23 blessings.	Goal	2  Obol
BlessingPrayer of The Light	Demonic Emissary	10 Steal every prayer from every once-god	Apocrypha	Craft each of the 23 blessings. The hell-bound book itself has not counted since 1.12.8-beta.	Challenge	10  Obol
Warding Stone	Holy Turret	Construct a Warding Stone	Hellish Bindings	Craft a warding stone.	Goal	2  Obol
	Heartbreaker	Fail to clear the Wither effect before time runs out	Through Hell	Granted by a function when the Wither effect runs its course on Normal or Hard and costs the player a heart.	Task (hidden)	—
	Hidden in the Depths	Flesh from Long-Dead Gods	Through Hell	Have ancient debris or adamant scrap in the inventory.	Task	—

The End

The End tab appears when the player first enters the End.

Icon	Advancement	In-game description	Parent	Actual requirements	Type	Reward
	To Dreams	—	—	Enter the End.	Task (root)	—
Amalgamated Pith	Iconoclast	Defile the Dead God's Dream	To Dreams	Kill the Ender Dragon.	Challenge	3  Obol; a  Amalgamated Pith and a safe surface
Elytra	Wax Wings	Seize the work of Daedalus	Iconoclast	Have an elytra in the inventory.	Goal	2  Obol
Hepatizon Elytra 1 +0.02Repaired with:Honeycomb BlockBlock of Copper	Icarus' Folly	Smith Hepatizon Elytra	Wax Wings	Smith a hepatizon elytra.	Goal	4  Obol
Shakudo Elytra Max 1Elytra Bonus: -(00:10)Repaired with:Honeycomb Blockitem.minecraft.copper_block	Wings of Eros	Smith Shakudo Elytra	Wax Wings	Smith a shakudo elytra.	Goal	4  Obol

Angler's Almanac

Main article: Angler's Almanac

The Angler's Almanac tab is a catalog of catches, added by imtlx in 1.12.1-alpha. Its root can never be completed by play. Obtaining the Angler's Almanac item runs a function that unlocks it, and every entry requires the root. Each entry is hidden until the player hooks the matching item with a fishing rod, and its description gives the catch's rarity in stars. No entry gives a reward. The Hot Saltwater pufferfish entry checks for the vanilla pufferfish model, which is what a caught pufferfish has. The Fish Bones entry checks for a bone, which fish bones from both the junk table and Sulfur Caves are.

Category	Groups	Entries
Freshwater	Cold, cool, temperate, hot wet, hot dry	25 (5 each)
Saltwater	Cold, cool, temperate, warm, hot	25 (5 each)
Swamps	—	5
Deep dark	—	3
Pale garden	—	3
Sulfur caves	—	2
Junk	—	15
Treasure	—	7

The generated list of every entry is on the Angler's Almanac page.

Technical advancements

Most of the pack's advancement files have no display. They are invisible to players and act as event triggers, a common datapack technique. They are grouped by folder:

Folder	Files	Purpose
matcha_item:trigger	415	The automatic item updater, added in 1.12.4: one advancement per pack item, which brings an outdated copy up to date when the player's inventory changes. See Updating items#Automatic updates.
recipe_unlocks	183	Unlock recipes when the player obtains an item, for example logs unlock the kindling and chest recipes. The whole folder is revoked when the pack is updated.
mechanics	30	Trigger mechanics: using a crystal heart, eating an amnestic or giving one to a villager, asylum application, beacon kindling, bedrock buster, clay fetishes or the happy ghast horn; eating glow berry foods (aura); milking a mooshroom with a bowl; sleeping; summoning the Wither; hitting a copper eye; getting the Wither, Hunger or Regeneration effect; entering a village or fortress; handling Estus and intrinsic enchantments; using an anvil, which gives experience levels.
fishing_sounds	11	Play a distinct sound for each kind of catch. See Fishing sounds.
update_old_items	8	Replace old copies of the sacred texts and the "Golden" music disc with current ones. See Updating items.
cooking_recipes	4	Unlock secret recipes (chorus mochi, gnocchi, sweet berry toast and warped stroganoff) when their recipe item is obtained.
particle	2	Particles when boarding a boat, walking on sulfurous hellstone, or drinking from an Estus flask.
endless_repairs:inventory_changed	1	Reset the repair cost of items so anvil repairs never become "Too Expensive".
anglers_almanac	1	Unlock the Angler's Almanac tab when the player obtains the Angler's Almanac.
imm_revoke	1
item_contingencies	1	Turn unenchanted vanilla elytra into the pack's version.
update_vanilla_item	1	Turn vanilla water bottles into the pack's version.
Total	658	Of 835 advancement files; the other 177 are the visible advancements.

A trigger advancement's reward function revokes the advancement again, so that it can fire the next time.

Since 1.12.6-alpha the trigger advancements in the mechanics, fishing_sounds, particle, update_old_items, item_contingencies and update_vanilla_item folders hang under matcha:imm_revoke, an advancement that can't be earned. All its children are revoked whenever the world loads or a player joins, a safety net in case a reward function fails to revoke one. The amnestic has two of them, for eating one and for using one on a villager, which replace the single one for using it on a block.

History

0.5-alpha	Fixed the dragon-killing advancement.
0.6-alpha	Added "Catch Everything!" (now "No More Fish in the Sea").
0.7-alpha	Updated the preserving and cooking advancements.
1.0	Many last-minute advancement fixes.
1.02	Reworded the campfire, food, warding weapon and steel advancements, added a fishing advancement, and rearranged the tree to make progression clearer.
1.03	Added "A Brittle Alloy?", "Hidden Flavors" and "Wait, you can make that?".
1.10	Added "Demonic Emissary", "A True Community", "Icarus' Folly", "A Miraculous Discovery!", "Archeologist in Training" and "Wings of Eros". Advancements became translatable. Removed the Estus flask advancement.
1.12.1-alpha	Advancements began rewarding obols and crystal hearts and lowering minimum hearts. Added "Bonfire Lit" and the Angler's Almanac tab. Reward advancements are revoked on update so they can be earned again.
1.12.2	"Bonfire Lit", "Icarus' Folly" and "Wings of Eros" can be earned; the two elytra advancements had named recipe IDs that didn't exist. The Warm Saltwater and axolotl entries of the Angler's Almanac can be unlocked.
1.12.3	Advancements were reworked again. The revocation on update now takes away only a hand-picked list instead of most of the tutorial. "Crystal Heart!" and the pufferfish Angler's Almanac entry can be earned. The elytra translation key now exists, and the mechanics advancements that detect the Wither effect and aura foods were rewritten.
1.12.4	Added the matcha_item:trigger advancements of the automatic item updater. The advancement that applies equipment intrinsics after smithing matches the items again, so intrinsics work (see Set bonus#Applying intrinsics after smithing). The junk Angler's Almanac entries other than Fish Bones can't be unlocked, because the junk loot table fails to load.
1.12.5	The junk loot table loads again, so the junk Angler's Almanac entries for its items can be unlocked, except Fish Bones by junk catches.
1.12.6-alpha	Added the hidden advancement Heartbreaker. "Three in One?" gives two obols, as its description says, instead of one, and the hepatizon criteria that could never be met are removed. Updating the pack no longer revokes any reward advancements or resets minimum hearts. Trigger advancements moved under matcha:imm_revoke, and the amnestic got new ones. Fish bones from junk catches complete the Angler's Almanac's Fish Bones entry, now that they are bones.
1.12.7-beta	The trigger advancement for anvils now fires when an anvil is used and sets the player's experience level to 10,000, instead of firing on every inventory change. Updating the pack sets the same level.
1.12.8-beta October 23, 2026	"Demonic Emissary" needs only the 17 blessings that count for "Apocrypha"; the Prayers of Apollo, Ares, Artemis, Cronus, Glaucus and Talos and the hell-bound book no longer count. The blessing recipes were renamed, and "Apocrypha" and the recipe unlocks follow the new names.
1.12.9 October 31, 2026	"Apocrypha" counts all 23 blessings and "Demonic Emissary" needs all 23 again, including the six that 1.12.8-beta skipped. "Unholy Knowledge" also unlocks the blessing recipes. A new trigger advancement detects eating a slice of cake.

Trivia

• The titles "Brilliant Bronze" and "Palatinate Perfection" keep the old names of hepatizon and shakudo. The internal IDs of the hepatizon advancements still say "bronze".
• The "Canto" titles follow The Divine Comedy, and the Hell tab's root is "Through Hell". "Orpheus" refers to the musician who descended into the underworld.
• The icon of "No More Fish in the Sea" uses a model called gay_fish, and "A True Community" uses a heart.
• A common criticism of the pack is that its advancements and systems are not explained enough. The developer disagreed and said they enjoyed watching players, who had no wiki at first, work the pack out "like a puzzle".