Advancements

This article is about advancements. For the similar mechanic in Bedrock Edition, see Achievements. For the similar feature in Minecraft Earth, see Challenges. For the command, see Commands/advancement. For the data pack format, see Advancements/JSON_format.

	“	The system as a whole is called "advancements", which is aimed at guiding & tracking player's progress through the game (in vanilla survival and any custom additions by mapmakers or mods). Most advancements are literally just that - an advancement through the game.	„
		— Dinnerbone on the advancements system

The popup that appears when an advancement is completed.

The popup that appears when a goal advancement is completed.

The popup that appears when special challenge advancements are completed.

Advancements are a way to gradually guide new players into Minecraft and give them challenges to complete, similar to the more simple system of achievements in Bedrock Edition.

Obtaining

Advancements can be completed in any game mode, and are obtained and saved per world. Advancements can also be granted (and revoked) using the /advancement command.

Although advancements guide players logically through the game, they are independent of each other; an advancement can be completed without having completed the advancements "before" it. There are currently 69 of them (70 with Java Edition 1.16), 16 in the Minecraft tab, 13 in the Nether tab, 9 in the The End tab, 19 (20 with Java Edition 1.16) in the Adventure tab, and 12 in the Husbandry tab.

When an advancement is obtained, a sliding toast notification displays in the top right corner and a message is displayed in chat. The color of the header text in the notification depends on the advancement; normal and goal advancements have yellow header text, while challenge advancements have pink header text. Completing a normal advancement causes the header text to display "Advancement Made!", completing a goal advancement results in a "Goal Reached!" header, and completing a challenge advancement shows "Challenge Complete!" In addition, experience can be earned by completing advancements (only by unlock challenge advancements, though).

Interface

The advancements interface. One advancement ("Isn't It Iron Pick") is selected.

The button to access the Advancements screen is found on the pause menu screen. The player can also open this screen by pressing L (this can be changed in the in-game options menu).

The advancement system involves several trees composed of advancements, each tree beginning with a root advancement and ending with goal or challenge advancements. By clicking and dragging, the player can view different branches of an advancement tree. Each tree is categorized into different tabs (which are themselves advancements). There are currently five tabs in vanilla Minecraft (although more may be added):

• Minecraft: The heart and story of the game
• Adventure: Adventure, exploration, and combat
• Nether: Bring summer clothes
• The End: Or the beginning?
• Husbandry: The world is full of friends and food

Each tab has a different background with a repeating texture.

Advancement icons display a header name and description when hovered over. The advancement descriptions are a separate color than the icons themselves, with normal and goal advancements having green descriptions and challenge advancements having purple ones. They appear in a tree only when the advancement before it is completed, although, as stated before, advancements can be completed in any order. Up to 2 advancements are displayed ahead of a completed one. As more advancements are completed, new ones become available. Also, two advancements ("How Did We Get Here?" and "Arbalistic") are "hidden advancements", meaning that they can be viewed by the player only after completing said advancement.

If the player has not completed any advancements, the interface shows a black background with white text reading "There doesn't seem to be anything here... :(".

The icon frames of advancements can vary in appearance based on difficulty, and whether or not it was completed. A legend is provided below:

Icon Frame		Description
Regular	Completed
		Normal advancement.
		Goal advancement.
		Challenge advancement.

Extra advancements and tabs can be added and customized with the use of JSON files, as detailed below.

List of advancements

Minecraft

Advancement tree in the "Minecraft" tab

Minecraft
Icon	Advancement	In-game description	Parent	Actual requirements (if different)	Namespaced ID
	Minecraft	The heart and story of the game	—	Have a crafting table in your inventory.	story/root
	Stone Age	Mine stone with your new pickaxe	Minecraft	Have cobblestone in your inventory.	story/mine_stone
	Getting an Upgrade	Construct a better pickaxe	Stone Age	Have a stone pickaxe in your inventory.	story/upgrade_tools
	Acquire Hardware	Smelt an iron ingot	Getting an Upgrade	Have an iron ingot in your inventory.	story/smelt_iron
	Suit Up	Protect yourself with a piece of iron armor	Acquire Hardware	Have any type of iron armor in your inventory.	story/obtain_armor
	Hot Stuff	Fill a bucket with lava	Acquire Hardware	Have a lava bucket in your inventory.	story/lava_bucket
	Isn't It Iron Pick	Upgrade your pickaxe	Acquire Hardware	Have an iron pickaxe in your inventory.	story/iron_tools
	Not Today, Thank You	Deflect an arrow with a shield	Suit Up	Deflect any projectile with a shield.	story/deflect_arrow
	Ice Bucket Challenge	Form and mine a block of Obsidian	Hot Stuff	Have a block of obsidian in your inventory.	story/form_obsidian
	Diamonds!	Acquire diamonds	Isn't It Iron Pick	Have a diamond in your inventory.	story/mine_diamond
	We Need to Go Deeper	Build, light and enter a Nether Portal	Ice Bucket Challenge	Enter the Nether dimension.	story/enter_the_nether
	Cover Me With Diamonds	Diamond armor saves lives	Diamonds!	Have any type of diamond armor in your inventory.	story/shiny_gear
	Enchanter	Enchant an item at an Enchanting Table	Diamonds!	—	story/enchant_item
	Zombie Doctor	Weaken and then cure a Zombie Villager	We Need to Go Deeper	Throw a splash potion of weakness at a zombie villager and give it a golden apple (by facing the zombie and pressing the use key with a golden apple in your hand), then wait for the villager to be cured.	story/cure_zombie_villager
	Eye Spy	Follow an Eye of Ender	We Need to Go Deeper	Enter a stronghold.	story/follow_ender_eye
	The End?	Enter the End Portal	Eye Spy	Enter the End dimension.	story/enter_the_end

Nether

Advancement tree in the "Nether" tab

Nether
Icon	Advancement	In-game description	Parent	Actual requirements (if different)	Namespaced ID	Rewards
	Nether	Bring summer clothes	—	Enter the Nether dimension.	nether/root	—
	Return to Sender	Destroy a Ghast with a fireball	Nether	Kill a ghast using a ghast fireball.	nether/return_to_sender	50 experience
	Subspace Bubble	Use the Nether to travel 7 km in the Overworld	Nether	Use the Nether to travel between 2 points in the Overworld with a minimum horizontal distance of 7000 blocks between each other, about 875 blocks in the Nether.	nether/fast_travel	100 experience
	A Terrible Fortress	Break your way into a Nether Fortress	Nether	Enter a Nether fortress.	nether/find_fortress	—
	Uneasy Alliance	Rescue a Ghast from the Nether, bring it safely home to the Overworld... and then kill it	Return to Sender	Kill a Ghast in the Overworld.	nether/uneasy_alliance	100 experience
	Spooky Scary Skeleton	Obtain a Wither Skeleton's skull	A Terrible Fortress	Have a wither skeleton skull in your inventory.	nether/get_wither_skull	—
	Into Fire	Relieve a Blaze of its rod	A Terrible Fortress	Have a blaze rod in your inventory.	nether/obtain_blaze_rod	—
	Withering Heights	Summon the Wither	Spooky Scary Skeleton	Be within a 100.9×100.9×103.5 cuboid centered on the Wither when it is spawned.	nether/summon_wither	—
	Local Brewery	Brew a potion	Into Fire	Pick up an item from a brewing stand potion slot. This does not need to be a potion. Water bottles or even empty bottles also trigger this advancement.	nether/brew_potion	—
	Bring Home the Beacon	Construct and place a Beacon	Withering Heights	Be within a 20×20×14 cuboid centered on a beacon block when it realizes it has become powered.	nether/create_beacon	—
	A Furious Cocktail	Have every potion effect applied at the same time	Local Brewery	Have all of these 13 potion effects applied to the player at the same time.	nether/all_potions	100 experience
	Beaconator	Bring a beacon to full power	Bring Home the Beacon	Be within a 20×20×14 cuboid centered on a beacon block when it realizes it is being powered by a size 4 pyramid.	nether/create_full_beacon	—
	How Did We Get Here?	Have every effect applied at the same time	A Furious Cocktail	Have all of these 26 effects applied to the player at the same time. This is a hidden advancement, meaning that it can be viewed by the player only after completing it.	nether/all_effects	1,000 experience

The End

Advancement tree in the "The End" tab

The End
Icon	Advancement	In-game description	Parent	Actual requirements (if different)	Namespaced ID	Rewards
	The End	Or the beginning?	—	Enter the End dimension.	end/root	—
	Free the End	Good luck	The End	Kill the ender dragon.	end/kill_dragon	—
	The Next Generation	Hold the Dragon Egg	Free the End	Have a dragon egg in your inventory.	end/dragon_egg	—
	Remote Getaway	Escape the island	Free the End	Throw an ender pearl through or walk into an End gateway.	end/enter_end_gateway	—
	The End... Again...	Respawn the Ender Dragon	Free the End	Summon an ender dragon using ender crystals.	end/respawn_dragon	—
	You Need a Mint	Collect dragon's breath in a glass bottle	Free the End	Have a bottle of dragon's breath in your inventory.	end/dragon_breath	—
	The City at the End of the Game	Go on in, what could happen?	Remote Getaway	Enter an End city.	end/find_end_city	—
	Sky's the Limit	Find an Elytra	The City at the End of the Game	Have a pair of elytra in your inventory.	end/elytra	—
	Great View From Up Here	Levitate up 50 blocks from the attacks of a Shulker	The City at the End of the Game	Move a vertical distance of 50 blocks with the levitation effect applied.	end/levitate	50 experience

Adventure

Advancement tree in the "Adventure" tab^{[until JE 1.16]}

Adventure
Icon	Advancement	In-game description	Parent	Actual requirements (if different)	Namespaced ID	Rewards
	Adventure	Adventure, exploration, and combat	—	Kill any entity, or be killed by any entity.	adventure/root	—
	Voluntary Exile	Kill a raid captain. Maybe consider staying away from villages for the time being...	Adventure	Obtain an Ominous Banner, whether from a Pillager Outpost or from a Raid Captain.	adventure/voluntary_exile	—
	Monster Hunter	Kill any hostile monster	Adventure	Kill one of these 25 mobs. In Java Edition 1.16,‌‌[upcoming] hoglins and piglins can also be killed for this advancement. Other mobs may be killed, but are ignored for the advancement.	adventure/kill_a_mob	—
	What a Deal!	Successfully trade with a Villager	Adventure	Take an item from a villager or wandering trader's trading output slot, and put it in your inventory.	adventure/trade	—
	Sticky Situation	Jump into a Honey Block to break your fall	Adventure	Collide on a horizontal side of a honey block when in air.	adventure/honey_block_slide	—
	Ol' Betsy	Shoot a crossbow	Adventure	—	adventure/ol_betsy	—
	Sweet Dreams	Change your respawn point	Adventure	Lie down in a bed. The advancement is granted as soon as the player is in the bed, even if the player does not successfully sleep.	adventure/sleep_in_bed	—
	Hero of the Village	Successfully defend a village from a raid	Voluntary Exile	—	adventure/hero_of_the_village	100 experience
	A Throwaway Joke	Throw a trident at something. Note: Throwing away your only weapon is not a good idea.	Monster Hunter	Hit something with a trident	adventure/throw_trident	—
	Take Aim	Shoot something with a bow and arrow	Monster Hunter	Using a bow, shoot an entity with an arrow, tipped arrow or spectral arrow.	adventure/shoot_arrow	—
	Monsters Hunted	Kill one of every hostile monster	Monster Hunter	Kill each of these 25 mobs. In Java Edition 1.16,‌‌[upcoming] hoglins and piglins are also required for the advancement. Other mobs may be killed, but are ignored for the advancement.	adventure/kill_all_mobs	100 experience
	Postmortal	Use a Totem of Undying to cheat death	Monster Hunter	—	adventure/totem_of_undying	—
	Hired Help	Summon an Iron Golem to help defend a village	What a Deal!	Summon an iron golem.	adventure/summon_iron_golem	—
	Two Birds, One Arrow	Kill two Phantoms with a piercing arrow	Ol' Betsy	—	adventure/two_birds_one_arrow	65 experience
	Who's the Pillager Now?	Give a Pillager a taste of their own medicine	Ol' Betsy	Kill a pillager with a crossbow.	adventure/whos_the_pillager_now	—
	Arbalistic	Kill five unique mobs with one crossbow shot	Ol' Betsy	This is a hidden advancement, meaning that it can be viewed by the player only after completing it.	adventure/arbalistic	85 experience
	Adventuring Time	Discover every biome	Sweet dreams	Visit all of these 42 biomes. Other biomes may also be visited, but are ignored for the advancement.	adventure/adventuring_time	500 experience
	Very Very Frightening	Strike a Villager with lightning	A Throwaway Joke	Hit a villager with lightning created by a trident with the Channeling enchantment.	adventure/very_very_frightening	—
	Sniper Duel	Kill a Skeleton from more than 50 meters away	Take Aim	Kill a skeleton with a projectile while being at least 50 blocks away horizontally.	adventure/sniper_duel	50 experience
	Bullseye‌[upcoming: JE 1.16]	Hit the bullseye of a Target block with an arrow	Take Aim	—	adventure/bullseye	—

Husbandry

Advancement tree in the "Husbandry" tab

Husbandry
Icon	Advancement	In-game description	Parent	Actual requirements (if different)	Namespaced ID	Rewards
	Husbandry	The world is full of friends and food	—	Eat anything that can be eaten.	husbandry/root	—
	Bee Our Guest	Use a Campfire to collect Honey from a Beehive using a Bottle without aggravating the bees	Husbandry	-	husbandry/safely_harvest_honey	—
	The Parrots and the Bats	Breed two animals together	Husbandry	-	husbandry/breed_an_animal	—
	Best Friends Forever	Tame an animal	Husbandry	—	husbandry/tame_an_animal	—
	Fishy Business	Catch a fish	Husbandry	Use a fishing rod to catch a fish.	husbandry/fishy_business	—
	Total Beelocation	Move a Bee Nest, with 3 bees inside, using Silk Touch	Husbandry	—	husbandry/silk_touch_nest	—
	A Seedy Place	Plant a seed and watch it grow	Husbandry	Plant one of these 5 seeds. Crops and plants without seeds are ignored for the advancement.	husbandry/plant_seed	—
	Two by Two	Breed all the animals!	The Parrots and the Bats	Breed pairs of each of these 15 mobs. In Java Edition 1.16 ‌[upcoming], Hoglins are also required for this advancement. A trader llama does not count as a llama. Other breedable mobs, if any, are ignored for the advancement.	husbandry/bred_all_animals	100 experience
	A Complete Catalogue	Tame all cat variants!	Best Friends Forever	—	husbandry/complete_catalogue	50 experience
	Tactical Fishing	Catch a fish... without a fishing rod!	Fishy Business	Use a water bucket on a fish mob to get a bucket of fish.	husbandry/tactical_fishing	—
	A Balanced Diet	Eat everything that is edible, even if it's not good for you	A Seedy Place	Eat each of these 39 foods. Other foods are ignored for the advancement.	husbandry/balanced_diet	100 experience
	Serious Dedication	Completely use up a diamond hoe, and then reevaluate your life choices	A Seedy Place	Exhaust the durability of a diamond hoe, breaking it.	husbandry/break_diamond_hoe	100 experience

JSON Format

Main article: Advancements/JSON format

History

Java Edition
1.12		February 16, 2017			Dinnerbone tweets that he had spent an entire day designing "a new thing" with Darngeek.
		February 20, 2017			The design on "this thing" is now done and can begin to be implemented; he later hints at the feature's name.
		February 22, 2017			He states that he is "advancing" on the feature; "So. Many. Json. Files." he adds.
					Later that day he states that the project is growing bigger, and that he may need a command "even more complicated than /scoreboard"
		March 6, 2017			The backend of the mysterious feature is finished, but the UI needs work, he tweets.
					"I made a tabthulhu today," he later adds, indicating this feature may use a large number of tabs.
		March 13, 2017			He again references the name of the feature in a tweet, stating that he is almost done with "this new feature advancement".
		March 14, 2017			He tweets that the UI is now working, and that the project took many days and a few research papers to accomplish.
		March 22, 2017			The feature now "awards players with things", he states while making another reference to the feature name.
		March 23, 2017			Dinnerbone states that the feature requires around 500 JSON files.
					He later tweets a teaser of what the feature holds, though it is hidden behind an encrypted .zip file disguised as a .png image, which he clarifies in later tweets. This .zip file contains custom recipe JSON files.
					He posts another encrypted .zip file soon afterward, containing a few more recipes.
		March 24, 2017			"A deafening metallic condor keeps distracting me", Dinnerbone states. Users quickly pinpointed this bizarre message to this Gfycat URL officially showcasing advancements for the first time.
					He reveals that the UI can have several tabs with advancement trees that are themselves advancements. He clarifies that that's what he meant by "tabthulhu."
					All of the UI is data-driven, including positioning and layout, with no hardcoded data or positions.
		17w13a			Advancements added, replacing Achievements.
		17w14a			Added new advancements, including a new "adventure" tab.
					Added new notifications for when players advance, which have a sliding effect, and come in two colors: yellow for normal advancements, and pink for special challenges.
		17w15a			Added advancement descriptions and changed several titles.
					Added the "Adventuring Time" advancement.
		17w16b			Added trigger item_durability_changed.
		17w17a			Added new advancements and two new tabs: "The End" and "Nether".
					Added trigger levitation.
					Added feature condition to the location trigger.
					Advancements can now execute commands when achieved.
					Advancement icons now allow data values.
					Added five modifiers to the /advancement grant and /advancement revoke commands: "everything", "from", "until", "through", and "only".
		17w17b			The default advancements now all receive their titles and descriptions from the localization files.
					Added a new number display to track progress while completing certain advancements.
					Added the changed_dimension trigger, which takes two optional conditions: to and from, both being strings that accept "overworld", "the_nether", or "the_end".
					The "location" shared object has a new dimension string (same values as above).
		17w18a			Re-introduced announcements to chat when someone earns an advancement.
					Added new Adventure advancements: "Best Friends Forever", "The Parrots and the Bats", and "Two by Two".
					Added new tick and tame_animal triggers.
					Added new show_toast and announce_to_chat display options.
					Added /gamerule announceAdvancements, which toggles announcing of advancements, replacing the old server.properties entry.
					"entity" objects and the levitation trigger now use a shared "distance" object. They check if the player is within or outside of the specified range on the x, y, or z axis. absolute and horizontal ranges check if the player is within range on all axes, though horizontal excludes the Y axis.
					The "Great View From Up Here" advancement now requires 50 vertical blocks, instead of levitating for 30 seconds.
					The "Sniper Duel" advancement has now been changed to horizontal distance.
					Advancement loading is now strict JSON.
		17w18b			Added a new "Husbandry" tab and several new advancements: "A Seedy Place", "Serious Dedication", "A Balanced Diet", and "Hired Help".
					The advancements added in the previous snapshot have now been moved to the new Husbandry tab.
					Added new advancement triggers: consume_item, placed_block, and arbitrary_player_tick.
					The "Monster Hunter" and "Monsters Hunted" advancements now use 22 mobs instead of 23, removing the illusioner from the list.
		pre1			Added new advancements: "A Furious Cocktail", "Postmortal", "Subspace Bubble", and "Uneasy Alliance".
					Added hidden field to advancement display info, which defaults to false.
					Added new effects_changed, used_totem, and nether_travel advancements triggers.
					Removed commands from advancement rewards, replaced with function.
					Advancement trees are now centered in the UI.
					Items and entities in advancements now have an extra NBT field.
					Entities in advancements now have an extra effects and location field.
					The arbitrary_player_tick advancement trigger has now been removed.
		pre2			Added new hidden advancement: "How Did We Get Here?", which rewards 100 experience.
		pre3			Advancement "How Did We Get Here?" now includes the Resistance status effect, and rewards 1000 experience.
					Advancement "Balanced Diet" now includes all fish types (raw and cooked if possible) and an enchanted golden apple.
					Advancements now remember the tab the player last selected.
		pre5			All recipe unlock advancements now have a parent of recipes/root.
					Several recipe unlock advancements have now been renamed.
		pre7			Added experience rewards to all "challenge" advancements.
		release			Added sounds to the toast notifications.
1.13		17w43a			Custom advancements have now been moved into data packs.
		17w45a			Added an advancement selector argument to test for obtained advancements.
		18w14a			Added new advancements: "Fishy Business", "Tactical Fishing", "A Throwaway Joke" and "Very, Very Frightening".
		18w14b			Advancements "A Furious Cocktail" and "How Did We Get Here?" now includes the Slow Falling status effect.
		18w19a			Advancement "How Did We Get Here?" now includes the Conduit Power status effect.
		18w22a			Advancement "Sniper Duel" description changed to not mention it has to be with an arrow (as it can be achieved with a trident too).
		pre6			Added a nbt field to the advancement icon section.
		pre7			Normal and goal advancements now have green descriptions, and challenge advancements have purple descriptions.
1.14		18w43a			Added new advancements: "Ol' Betsy", "Who's the Pillager Now?", "Two Birds, One Arrow" and the hidden advancement "Arbalistic".
		18w44a			Added new advancement: "A Complete Catalogue".
					Advancements "The Parrots and the Bats" and "Best Friends Forever" now require cats, instead of ocelots.
					Advancement "Two by Two" now requires pandas.
		19w06a			A bug was causing the advancement Serious Dedication to not be granted to the player, it was fixed in this snapshot.
		19w11a			Advancement "A Balanced Diet" now requires suspicious stew and sweet berries.
					Advancement "How Did We Get Here?" now requires the Bad Omen status effect.
					Advancement "The Parrots and the Bats" can now be obtained by breeding foxes.
		19w12a			Advancement "Two by Two" now requires foxes.
		19w14a			Advancements "Monster Hunter" and "Monsters Hunted" no longer require polar bears to be killed.
		Pre-Release 2			Added 2 new advancements: "Voluntary Exile" and "Hero of the Village".
1.14.3		Pre-Release 2			Saturation is no longer required for the "How Did We Get Here?" advancement.
1.15		19w34a			Advancement "The Parrots and the Bats" can now be obtained by breeding bees.
		19w35a			Bees are now included in the "Two by Two" advancement.
					Honey bottles are now included in the "A Balanced Diet" advancement.
		19w45a			Spectral arrows can now be used to unlock the "Take Aim" advancement.
		19w46a			Added three bee-related advancements: "Sticky Situation", "Bee Our Guest", and "Total Beelocation".
					Added triggers bee_nest_destroyed, safely_harvest_honey, and slide_down_block
Upcoming Java Edition
1.16		20w09a			Added the "Bullseye" advancement.

Issues

Issues relating to "Advancements" are maintained on the bug tracker. Report issues there.

Trivia

• Fourteen of the old Java Edition achievements were re-implemented as advancements: Benchmarking (called Minecraft), Getting an Upgrade, Acquire Hardware, We Need to Go Deeper, The End?, Return to Sender, Into Fire, Local Brewery, The Beginning? (called Withering Heights), Beaconator, DIAMONDS! (called Diamonds!), Adventuring Time, Monster Hunter and Sniper Duel.
• Six achievements from other editions were re-implemented as advancements: Body Guard (called Hired Help), Cheating Death (called Postmortal), Zombie Doctor, You Need a Mint, The End... Again... and Great View From Up Here.
• Though bearing similar names, Voluntary Exile advancement does not use voluntary_exile criterion trigger, unlike most other advancements.

References to other media

• The Adventuring Time advancement is a reference to the Cartoon Network cartoon 'Adventure Time'.
• The Withering Heights advancement is a reference to the book 'Wuthering Heights' by Emily Brontë.
• The Isn't it Iron Pick advancement is a reference to Alanis Morissette's 'Ironic'.
• The Very Very Frightening advancement is a reference to Queen's 'Bohemian Rhapsody'.
• The Ol' Betsy advancement is possibly a reference to Disney's Robin Hood.
• The We Need To Go Deeper advancement is a reference to the film "Inception," often used as an innuendo.
• The Not Today, Thank You advancement is a reference to a quote by Bilbo Baggins in the novel The Hobbit.
• The Spooky Scary Skeleton advancement is a reference to the song of the same name by Andrew Gold.
• The The Next Generation advancement is a reference to the TV show, Star Trek: The Next Generation.
• The The Parrots and the Bats advancement is a reference to The birds and the bees.
• The Monster Hunter advancement is a reference to the videogame saga of the same name.
• The Bee Our Guest advancement is a reference to the song “Be Our Guest” from the Disney movie Beauty and the Beast (1991 film).
• The Ice Bucket Challenge is a reference to the the actual challenge.
• The Two by Two advancement is a reference to the story of Noah's Ark.

Gallery

• 

  First look at advancements; Dinnerbone showcasing usage of the interface. (Click to play.)

• 

  "Tabthulhu."

See also

• Tutorials/Advancement guide
• Data pack

References

Gameplay

View at: Template:Gameplay/content [edit]