Advancement

For the command, see Commands/advancement. For the data pack format, see Advancement/JSON format.

Not to be confused with Achievements in Bedrock Edition or Challenges in Minecraft Earth.

File:AdvancementMade.png

The popup that appears when advancements are completed.

File:GoalReached.png

The popup that appears when goal advancements are completed.

File:ChallengeComplete.png

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 80 of them, 16 in the Minecraft tab, 23 in the Nether tab, 9 in the The End tab, 20 in the Adventure tab, and 12 in the Husbandry tab.

When advancements are obtained, a sliding Template:W 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, music plays and experience is rewarded when completing these kinds of advancements.

Interface

File:AdvancementsInterface.png

The advancement interface. The "Isn't It Iron Pick" advancement 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 from which several branches diverge. By clicking and dragging, the player can view different branches of an advancement tree. Each tree is categorized into different tabs (which are defined by the root advancements). Tabs are not visible if no advancements in the tab have been unlocked. There are currently five tabs in vanilla Minecraft:

• Minecraft: The heart and story of the game
• Nether: Bring summer clothes
• The End: Or the beginning?
• Adventure: Adventure, exploration, and combat
• 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 two advancements are displayed ahead of a completed one. As more advancements are completed, new ones become visible. Three advancements, "How Did We Get Here?", "Hero of the Village", and "Arbalistic" are hidden advancements, meaning that these cannot be viewed by the player until they have been completed.

If the player has not completed/unlocked 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
Uncompleted/Regular	Completed
52px	52px	Normal advancement
52px	52px	Goal advancement
52px	52px	Challenge advancement

Extra advancements and tabs can be added and customized with the use of JSON files and data packs.

List of advancements

Minecraft

File:Advancements Tree.png

Advancement tree in the "Minecraft" tab

Nether

File:Advancements Tree - Nether.png

Advancement tree in the "Nether" tab

The End

File:Advancements Tree - The End.png

Advancement tree in the "The End" tab

Adventure

File:Advancements Tree - Adventure.png

Advancement tree in the "Adventure" tab

Husbandry

File:Advancements Tree - Husbandry.png

Advancement tree in the "Husbandry" tab

JSON format

Main article: Advancement/JSON format

Sounds

Sound	Subtitle	Source	Description	Namespaced ID	Translation key	Volume	Pitch	Attenuation distance
File:In.ogg	None	?	Completing any advancement	ui.toast.in	None	0.4	1.0	16
File:Out.ogg	None	?	When an advancement Template:W finishes	ui.toast.out	None	0.4	1.0	16
File:Challenge complete.ogg	None	?	Completing a challenge advancement	ui.toast.challenge_complete	None	0.6	1.0	16

History

Java Edition
1.12		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.
		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 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 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 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 "A 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 been renamed.
		pre7			Added experience rewards to all "challenge" advancements.
		release			Added sounds to the toast notifications.
1.13		17w43a			Custom advancements have 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 include 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 other projectiles 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
1.16		20w06a			The "Sky's the Limit" advancement's description has changed from "Find Elytra" to "Find elytra."
					The "Take Aim" advancement's description has changed from "Shoot something with a bow and arrow" to "Shoot something with an arrow."
		20w07a			Piglins and hoglins are now required for the "Monsters Hunted" advancement, and they count toward the "Monster Hunter" advancement.
					Hoglins can now breed, meaning they can be used for "The Parrots and the Bats" advancement.
		20w09a			Added the "Bullseye" advancement.
		20w12a			Hoglins are now required for the "Two by Two" advancement.
					The "Sweet Dreams" advancement's description has changed from "Change your respawn point" to "Sleep in a bed to change your respawn point."
		20w13a			"The Parrots and the Bats" advancement can now be obtained by breeding striders.
		20w14a			The advancements "Monster Hunter" and "Monsters Hunted" now use elder guardians, ender dragons, endermites, vexes, withers, and zoglins.
		20w20a			Added 10 new Nether advancements: "Those Were the Days," "Hidden in the Depths," "Who Is Cutting Onions?," "Oh Shiny," "This Boat Has Legs," "War Pigs," "Country Lode, Take Me Home," "Cover Me in Debris," "Not Quite "Nine" Lives," and "Hot Tourist Destinations."
					Striders are now required for the "Two by Two" advancement.
					Obtaining blackstone now counts for the "Stone Age" advancement.
					The advancement "Serious Dedication" is now rewarded for obtaining a netherite hoe. Previously, the player had to use all the durability on a diamond hoe. In addition to this, the description for this advancement has been changed from "Completely use up a diamond hoe, and then reevaluate your life choices" to "Use a Netherite ingot to upgrade a hoe, and then reevaluate your life choices." Also, the icon for this advancement has changed from a diamond hoe to a netherite hoe.
					The description of the advancement "Not Today, Thank You" has changed from "Deflect an arrow or trident with a shield" to "Deflect a projectile with a shield."
					The description of the advancement "Ice Bucket Challenge" has changed from "Form and mine a block of obsidian" to "Obtain a block of obsidian."
					The "Bullseye" advancement now requires the bullseye to be hit from at least 30 blocks away. It is now a challenge advancement, rewarding 50 experience. The description of this advancement has changed from "Hit the bullseye of a Target block with an arrow" to "Hit the bullseye of a Target block from at least 30 meters away."
					Added triggers thrown_item_picked_up_by_entity, player_generates_container_loot, and item_used_on_block.
					Removed trigger safely_harvest_honey as it was made redundant by item_used_on_block.
		20w22a			The advancement "Bee Our Guest" can now be unlocked with both beehives and bee nests, instead of only beehives.
		Pre-release 1			The advancement file "Serious Dedication" has been renamed to obtain_netherite_hoe.json. This means progress in this advancement is not kept when upgrading to this version.
					The "Two by Two" advancement now requires donkeys and mules.
					The "Oh Shiny" advancement now uses gold nuggets, since they were added to the piglin_loved item tag.
					The "Hot Tourist Destinations" advancement now rewards 500 experience, and the "Cover Me in Debris" advancement now also rewards 100 experience.
					The capitalization of the advancement "Who Is Cutting Onions?" has changed to "Who is Cutting Onions?"
		Pre-release 3			The "Oh Shiny" advancement does not unlock if the distracted piglin is a baby or if gold nuggets are used.
		Pre-release 6			The "Oh Shiny" advancement now unlocks when the piglin is used.
					Added trigger player_interacted_with_entity.
1.16.2		20w27a			Piglin brutes are required for the "Monsters Hunted" advancement and count toward the "Monster Hunter" advancement.
		20w30a			The ":(" (advancements.sad_label) under the description of the empty advancement screen can now be modified.
					The capitalization of the description of the advancement "Country Lode, Take Me Home" has changed from "Use a Compass on a Lodestone" to "Use a compass on a Lodestone."
					The capitalization of the description of the advancement "Bring Home the Beacon" has changed from "Construct and place a Beacon" to "Construct and place a beacon."
Upcoming Java Edition
1.17		21w05a			Glow berries are now included in the "A Balanced Diet" advancement.
		21w13a			Goats and axolotls are now required for "Two by Two" advancement.
					The advancement for obtaining diamond armor is now capitalized as "Cover Me with Diamonds", as opposed to "Cover Me With Diamonds".

Issues

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

Trivia

• Fourteen of the old Java Edition achievements were re-implemented as advancements: Benchmarking (now called Minecraft), Getting an Upgrade, Acquire Hardware, We Need to Go Deeper, The End?, Return to Sender, Into Fire, Local Brewery, The Beginning? (now called Withering Heights), Beaconator, DIAMONDS! (now 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.
• As an Template:W, the snapshot Java Edition 20w14∞ added a new advancement called "Almost there," achieved after going through any portal a billion times. The in-game description is "Visited over billion dimensions."
  • The advancement is found in the "Adventure" tab and its parent is the advancement "Adventure." The advancement also has a flint and steel icon.
  • The advancement can be granted using /advancement grant @s only minecraft:adventure/almost_there.
• The theme for completing a challenge advancement is used as Steve's victory theme in Super Smash Bros. Ultimate.

Gallery

• Advancements.gif

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

• Tabthulhu.png

  "Tabthulhu."

• NoAdvancements.png

  The advancements screen when no advancements have been completed or unlocked.

• A Balanced Diet.png

  Advancement "A Balanced Diet" for 1.17.

• A Complete Catalogue.png

  Advancement "A Complete Catalogue".

• Monsters Hunted.png

  Advancement "Monsters Hunted".

• Two by Two.png

  Advancement "Two by Two" for 1.17.

• Advancement Adventuring Time.png

  Advancement "Adventuring Time".

See also

• Tutorials/Advancement guide
• Achievement
• Data pack

References

Gameplay

View at: Template:Gameplay/content [edit]