Advancements

This article is about the advancements in Matcha Flavoured. For the fish catalogue, 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	8
The End	End Portal Frame.png: Inventory sprite for End Portal Frame in Minecraft as shown in-game with description: End Portal Frame To Dreams	Black concrete	Entering the End	5
Angler's Almanac	Angler's Almanac	Barrel	Obtaining the Angler's Almanac	102 (all hidden until earned)

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 Easy the minimum is always 10 hearts. 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, along with most advancements that give rewards or affect the heart system, so that they can be earned again under the new rules. "No More Fish in the Sea" and "Demonic Emissary" are deliberately kept, and the player's minimum hearts reset to 10. 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)	—
Fire, kilns and metals
	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
	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
	Archeologist in Training	Craft a Brush	Brazier	Craft a brush.	Task	—
	A Miraculous Discovery!	Find a Clay Fetish by searching abandoned Sites	Archeologist in Training	Have either clay fetish in the inventory.	Goal	3  Obol
	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	—
	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	—
	Master Metallurge	Smithing Tables allow you to modify Base-Metal tools using Alloys	A Tough Alloy	Have a smithing table in the inventory.	Task	—
	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
	Brilliant Bronze	Smith a piece of Hepatizon Equipment from Copper with Hepatizon Alloy	Master Metallurge	Smith any of 12 hepatizon items.	Goal	1  Obol
	Palatinate Perfection	Smith a piece of Shakudo Equipment from Copper with Shakudo Alloy	Master Metallurge	Smith any of 12 shakudo items.	Goal	1  Obol
	Evangelic Electrum	Smith a piece of Electrum Equipment from Diamond with Electrum Alloy	Master Metallurge	Smith any of 12 electrum items.	Challenge	4  Obol
	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
	Upgrades	Smithing Upgrades are used to Modify and Upgrade Mattocks and Dolabras	Master Metallurge	Have a smithing template in the inventory.	Task	—
	Three in One?	Upgrade a Mattock or Dolabra	Upgrades	Smith a steel, shakudo or electrum mattock or dolabra.	Goal	1  Obol
	The Generous Metal	Gold has Fortune and Looting Intrinsics	Burgeoning Metallurge	Have a gold ingot in the inventory.	Task	—
	A Gentle Alloy	Shakudo grants Copper Equipment Silk Touch and Cleansing Properties	The Generous Metal	Have shakudo alloy 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
	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	—
	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
	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
	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
Cooking
	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	—
Golden Steamed Carrots.png: Inventory sprite for Golden Steamed Carrots in Minecraft as shown in-game with description: Golden Steamed Carrots	Hidden Flavors	Cook a secret Ingredient	Powerful Flavors	Have golden steamed carrots, a baked golden apple, braised crimson fungus or braised warped fungus in the inventory. See Secret recipes.	Task	1  Obol
	Wait, you can make that?	Cook a secret Meal	Hidden Flavors	Craft any of 11 secret meals.	Goal	2  Obol
	Now You're Cooking	Construct an Oven from Bricks and Iron	Powerful Flavors	Have an oven in the inventory.	Task	—
	Pickles & Jam	Preserve a food to boost its flavour profile	Now You're Cooking	Craft any of 15 preserves.	Task	—
	Doomsday Prepper	Preserve Everything!	Pickles & Jam	Craft all 15 preserves: canned apples, canned golden apples, glow jam, golden pickled carrots, mead, pickled carrots, pickled potatoes, sun-dried tomatoes, pumpkin jam, rind jam, sweet berry jam, pickled mushrooms, pickled toadstools, pickled warped fungus and pickled crimson fungus.	Challenge	4  Obol
	Manners First	Make a Ceramic Bowl from Bricks	Now You're Cooking	Have a bowl in the inventory.	Task	—
	Too Spicy!	Make Green Curry	Manners First	Cook green curry in an oven.	Task	1  Obol
	Hearty Curry	Make Japanese Curry	Manners First	Cook Japanese curry in an oven.	Task	1  Obol
	Sweet and Spicy!	Make Paneer Makhani. All Foods have viable Vegetarian Options	Manners First	Cook paneer makhani in an oven.	Task	1  Obol
	Fortified Goodness	Make Pumpkin Curry	Manners First	Cook pumpkin curry in an oven.	Task	1  Obol
	The Best Soup!	Make Ramen	Manners First	Cook tonkotsu ramen in an oven.	Task	1  Obol
Warding and treasure
	Hellish Powder	It Radiates Holy Power. It kind of smells like Curry... maybe Cinnamon?	From Earth	Have Estus ash in the inventory. Hidden.	Task	—
	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
	Fae-Slayer	Affix a Nazar to an Iron Sword in a Smithing Table	Apotropaic Jewellery	Smith a warding sword.	Task	—
	Sabbatarian	Affix a Nazar to an Iron Sword inlaid with Silver in a Smithing Table	Fae-Slayer	Smith a silver sword.	Task	1  Obol
	Convoymaster	Affix a Nazar to an Shield inlaid with Silver in a Smithing Table	Sabbatarian	Smith a warding shield.	Task	1  Obol
	A Vestige of Divinity	A Relic only obtained by breaking Spawners or vanquishing powerful Forces	Hellish Powder	Have a divine fragment in the inventory.	Goal	2  Obol
	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
	Canto I	❤ Defeat the Sea God	Hellish Powder	Have an opal in the inventory. Opals drop from elder guardians.	Task	1  Crystal Heart
	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
	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
	Canto IV	❤❤ Raid Tartarus	Canto III	Have a topaz in the inventory. Topaz is found in ancient city chests.	Task	2  Crystal Heart
Trading and fishing
	You're Rich!	Obtain an Obol	From Earth	Have an obol in the inventory. Hidden.	Task	—
	Bonfire Lit	Use a Beacon Kindling to signal a Wandering Trader	You're Rich!	Use beacon kindling on a block.	Task	1  Obol
	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
	God help you...	Commit great evil	A Good Samaritan	Kill a villager or a wandering trader. Hidden.	Task	—
	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
	No More Fish in the Sea	10 Catch Everything!	Fishmonger	Catch all 47 fish with a fishing rod.	Challenge	10  Obol

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)	—
	Hidden in the Depths	Flesh from Long-Dead Gods	Through Hell	Have ancient debris or adamant scrap in the inventory.	Task	—
	Forbidden Chemistry	Synthesize Benzene: a Chemical Reagent Forbidden by the Old Laws	Through Hell	Have benzene in the inventory.	Task	1  Obol
	Hellish Bindings	Tether Raw Estus into a Stable Form	Forbidden Chemistry	Craft stabilized Estus.	Task	1  Obol
	Holy Turret	Construct a Warding Stone	Hellish Bindings	Craft a warding stone.	Goal	2  Obol
	Unholy Knowledge	Craft a Hell-Bound Book	Hellish Bindings	Craft a hell-bound book.	Task	1  Obol
	Apocrypha	Steal Prayers from a long-dead God	Unholy Knowledge	Craft any of 17 blessings.	Goal	2  Obol
	Demonic Emissary	10 Steal every prayer from every once-god	Apocrypha	Craft all 23 blessing recipes and the hell-bound book.	Challenge	10  Obol

The End

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

Icon	Advancement	In-game description	Parent	Actual requirements	Type	Reward
End Portal Frame.png: Inventory sprite for End Portal Frame in Minecraft as shown in-game with description: End Portal Frame	To Dreams	—	—	Enter the End.	Task (root)	—
	Iconoclast	Defile the Dead God's Dream	To Dreams	Kill the Ender Dragon.	Challenge	3  Obol; a divine favor and a safe surface
Elytra.png: Inventory sprite for Elytra in Minecraft as shown in-game with description: Elytra	Wax Wings	Seize the work of Daedalus	Iconoclast	Have an elytra in the inventory.	Goal	2  Obol
item.kleispack.hepatizon_elytra.png: Inventory sprite for item.kleispack.hepatizon_elytra in Minecraft as shown in-game with description: item.kleispack.hepatizon_elytra	Icarus' Folly	Smith Hepatizon Elytra	Wax Wings	Smith a hepatizon elytra.	Goal	4  Obol
	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 catalogue 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.

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 414 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
recipe_unlocks	180	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	25	Trigger mechanics: using a crystal heart, amnestic, asylum application, beacon kindling, bedrock buster, clay fetishes or the happy ghast horn; eating glow berry foods (soul sight); sleeping; summoning the Wither; hitting a copper eye; getting the Wither effect; entering a village or fortress; handling Estus and intrinsic enchantments.
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.
remove_vanilla_items	3	Convert vanilla apples, sweet berries and turtle scutes, for example from other mods, into the pack's versions.
particle	3	Particles when boarding a boat, walking on sulfurous hellstone, or drinking from an Estus flask.
item_contingencies, update_vanilla_item	2	Turn unenchanted vanilla elytra and water bottles into the pack's versions.
endless_repairs namespace	1	Reset the repair cost of items so anvil repairs never become "Too Expensive".

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" works. Fixed a fishing typo that made an advancement impossible. After release, fixes on main narrowed which tutorial advancements are revoked on update and fixed the crystal heart and pufferfish almanac entries.

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.
• The Hepatizon Elytra's name uses the translation key item.kleispack.hepatizon_elytra, which is missing from the language file (only item.kleispack.bronze_elytra exists), so the smithed item shows its raw key in game.
• 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".