Advancements

From Minecraft Wiki
Jump to: navigation, search
Information icon.svg
This feature is exclusive to Java Edition.
Dinnerbone-twitter.png

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[1]
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[edit]

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 advancements are 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[edit]

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[2][3]):

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
Advancement-plain-raw.png Advancement-plain-worn.png Normal advancement.
Advancement-oval-raw.png Advancement-oval-worn.png Goal advancement.
Advancement-fancy-raw.png Advancement-fancy-worn.png Challenge advancement.

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

List of advancements[edit]

Minecraft[edit]

Advancement tree in the "Minecraft" tab
Grass Block Revision 6.png Minecraft
Icon Advancement In-game description Parent Actual requirements (if different) Namespaced ID

Advancement-plain-raw.png

MinecraftThe heart and story of the gameHave a crafting table in your inventory.story/root

Advancement-plain-raw.png

Stone AgeMine stone with your new pickaxeMinecraftHave cobblestone in your inventory.story/mine_stone

Advancement-plain-raw.png

Getting an UpgradeConstruct a better pickaxeStone AgeHave a stone pickaxe in your inventory.story/upgrade_tools

Advancement-plain-raw.png

Acquire HardwareSmelt an iron ingotGetting an UpgradeHave an iron ingot in your inventory.story/smelt_iron

Advancement-plain-raw.png

Suit UpProtect yourself with a piece of iron armorAcquire HardwareHave any type of iron armor in your inventory.story/obtain_armor

Advancement-plain-raw.png

Hot StuffFill a bucket with lavaAcquire HardwareHave a lava bucket in your inventory.story/lava_bucket

Advancement-plain-raw.png

Isn't It Iron PickUpgrade your pickaxeAcquire HardwareHave an iron pickaxe in your inventory.story/iron_tools

Advancement-plain-raw.png

Not Today, Thank YouDeflect an arrow with a shieldSuit UpDeflect any projectile with a shield.story/deflect_arrow

Advancement-plain-raw.png

Ice Bucket ChallengeForm and mine a block of ObsidianHot StuffHave a block of obsidian in your inventory.story/form_obsidian

Advancement-plain-raw.png

Diamonds!Acquire diamondsIsn't It Iron PickHave a diamond in your inventory.story/mine_diamond

Advancement-plain-raw.png

We Need to Go DeeperBuild, light and enter a Nether PortalIce Bucket ChallengeEnter the Nether dimension.story/enter_the_nether

Advancement-plain-raw.png

Cover Me With DiamondsDiamond armor saves livesDiamonds!Have any type of diamond armor in your inventory.story/shiny_gear

Advancement-plain-raw.png

EnchanterEnchant an item at an Enchanting TableDiamonds!story/enchant_item

Advancement-oval-raw.png

Zombie DoctorWeaken and then cure a Zombie VillagerWe Need to Go DeeperThrow 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

Advancement-plain-raw.png

Eye SpyFollow an Eye of EnderWe Need to Go DeeperEnter a stronghold.story/follow_ender_eye

Advancement-plain-raw.png

The End?Enter the End PortalEye SpyEnter the End dimension.story/enter_the_end

Nether[edit]

Advancement tree in the "Nether" tab
Red Nether Bricks JE3 BE2.png Nether
Icon Advancement In-game description Parent Actual requirements (if different) Namespaced ID Rewards

Advancement-plain-raw.png

NetherBring summer clothesEnter the Nether dimension.nether/root

Advancement-fancy-raw.png

Return to SenderDestroy a Ghast with a fireballNetherKill a ghast using a ghast fireball.nether/return_to_sender50 experience

Advancement-fancy-raw.png

Subspace BubbleUse the Nether to travel 7 km in the OverworldNetherUse 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_travel100 experience

Advancement-plain-raw.png

A Terrible FortressBreak your way into a Nether FortressNetherEnter a Nether fortress.nether/find_fortress

Advancement-fancy-raw.png

Uneasy AllianceRescue a Ghast from the Nether, bring it safely home to the Overworld... and then kill itReturn to SenderKill a Ghast while you are in the Overworld.nether/uneasy_alliance100 experience

Advancement-plain-raw.png

Spooky Scary SkeletonObtain a Wither Skeleton's skullA Terrible FortressHave a wither skeleton skull in your inventory.nether/get_wither_skull

Advancement-plain-raw.png

Into FireRelieve a Blaze of its rodA Terrible FortressHave a blaze rod in your inventory.nether/obtain_blaze_rod

Advancement-plain-raw.png

Withering HeightsSummon the WitherSpooky Scary SkeletonBe within a 100.9×100.9×103.5 cuboid centered on the Wither when it is spawned.nether/summon_wither

Advancement-plain-raw.png

Local BreweryBrew a potionInto FirePick 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

Advancement-plain-raw.png

Bring Home the BeaconConstruct and place a BeaconWithering HeightsBe within a 20×20×14 cuboid centered on a beacon block when it realizes it has become powered.nether/create_beacon

Advancement-fancy-raw.png

A Furious CocktailHave every potion effect applied at the same timeLocal BreweryHave all of these 13 potion effects applied to the player at the same time.nether/all_potions100 experience

Advancement-oval-raw.png

BeaconatorBring a beacon to full powerBring Home the BeaconBe 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

Advancement-fancy-raw.png

How Did We Get Here?Have every effect applied at the same timeA Furious CocktailHave 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_effects1,000 experience

The End[edit]

Advancement tree in the "The End" tab
End Stone JE3 BE2.png The End
Icon Advancement In-game description Parent Actual requirements (if different) Namespaced ID Rewards

Advancement-plain-raw.png

The EndOr the beginning?Enter the End dimension.end/root

Advancement-plain-raw.png

Free the EndGood luckThe EndKill the ender dragon.end/kill_dragon

Advancement-oval-raw.png

The Next GenerationHold the Dragon EggFree the EndHave a dragon egg in your inventory.end/dragon_egg

Advancement-plain-raw.png

Remote GetawayEscape the islandFree the EndThrow an ender pearl through or walk into an End gateway.end/enter_end_gateway

Advancement-oval-raw.png

The End... Again...Respawn the Ender DragonFree the EndSummon an ender dragon using ender crystals.end/respawn_dragon

Advancement-oval-raw.png

You Need a MintCollect dragon's breath in a glass bottleFree the EndHave a bottle of dragon's breath in your inventory.end/dragon_breath

Advancement-plain-raw.png

The City at the End of the GameGo on in, what could happen?Remote GetawayEnter an End city.end/find_end_city

Advancement-oval-raw.png

Sky's the LimitFind an ElytraThe City at the End of the GameHave a pair of elytra in your inventory.end/elytra

Advancement-fancy-raw.png

Great View From Up HereLevitate up 50 blocks from the attacks of a ShulkerThe City at the End of the GameMove a vertical distance of 50 blocks with the levitation effect applied.end/levitate50 experience

Adventure[edit]

Advancement tree in the "Adventure" tab[until JE 1.16]
Empty Map JE2 BE2.png Adventure
Icon Advancement In-game description Parent Actual requirements (if different) Namespaced ID Rewards

Advancement-plain-raw.png

AdventureAdventure, exploration, and combatKill any entity, or be killed by any entity.adventure/root

Advancement-plain-raw.png

Voluntary ExileKill a raid captain.
Maybe consider staying away from villages for the time being...
AdventureObtain an Ominous Banner, whether from a Pillager Outpost or from a Raid Captain.adventure/voluntary_exile

Advancement-plain-raw.png

Monster HunterKill any hostile monsterAdventureKill one of these 25 mobs. ‌In Java Edition 1.16, elder guardians, ender dragons, endermites, hoglins, piglins, vexes, withers, and zoglins can also be killed for this advancement. Other mobs may be killed, but are ignored for the advancement.adventure/kill_a_mob

Advancement-plain-raw.png

What a Deal!Successfully trade with a VillagerAdventureTake an item from a villager or wandering trader's trading output slot, and put it in your inventory.adventure/trade

Advancement-plain-raw.png

Sticky SituationJump into a Honey Block to break your fallAdventureCollide on a horizontal side of a honey block when in air.adventure/honey_block_slide

Advancement-plain-raw.png

Ol' BetsyShoot a crossbowAdventureadventure/ol_betsy

Advancement-plain-raw.png

Sweet DreamsChange your respawn point[until JE 1.16]
Sleep in a bed to change your respawn point‌[upcoming: JE 1.16]
AdventureLie 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

Advancement-fancy-raw.png

Hero of the VillageSuccessfully defend a village from a raidVoluntary Exileadventure/hero_of_the_village100 experience

Advancement-plain-raw.png

A Throwaway JokeThrow a trident at something.
Note: Throwing away your only weapon is not a good idea.
Monster HunterHit something with a tridentadventure/throw_trident

Advancement-plain-raw.png

Take AimShoot something with an arrowMonster HunterUsing a bow or a crossbow, shoot an entity with an arrow, tipped arrow or spectral arrow.adventure/shoot_arrow

Advancement-fancy-raw.png

Monsters HuntedKill one of every hostile monsterMonster HunterKill each of these 25 mobs. ‌In Java Edition 1.16, elder guardians, ender dragons, endermites, hoglins, piglins, vexes, withers and zoglins are also required for the advancement. Other mobs may be killed, but are ignored for the advancement.adventure/kill_all_mobs100 experience

Advancement-oval-raw.png

PostmortalUse a Totem of Undying to cheat deathMonster Hunteradventure/totem_of_undying

Advancement-oval-raw.png

Hired HelpSummon an Iron Golem to help defend a villageWhat a Deal!Summon an iron golem.adventure/summon_iron_golem

Advancement-fancy-raw.png

Two Birds, One ArrowKill two Phantoms with a piercing arrowOl' Betsyadventure/two_birds_one_arrow65 experience

Advancement-plain-raw.png

Who's the Pillager Now?Give a Pillager a taste of their own medicineOl' BetsyKill a pillager with a crossbow.adventure/whos_the_pillager_now

Advancement-fancy-raw.png

ArbalisticKill five unique mobs with one crossbow shotOl' BetsyThis is a hidden advancement, meaning that it can be viewed by the player only after completing it.adventure/arbalistic85 experience

Advancement-fancy-raw.png

Adventuring TimeDiscover every biomeSweet dreamsVisit all of these 42 biomes. Other biomes may also be visited, but are ignored for the advancement.adventure/adventuring_time500 experience

Advancement-plain-raw.png

Very Very FrighteningStrike a Villager with lightningA Throwaway JokeHit a villager with lightning created by a Trident with the Channeling enchantment.adventure/very_very_frightening

Advancement-fancy-raw.png

Sniper DuelKill a Skeleton from at least 50 meters awayTake AimKill a skeleton with a projectile while being at least 50 blocks away horizontally.adventure/sniper_duel50 experience

Advancement-plain-raw.png

Bullseye‌[upcoming: JE 1.16]Hit the bullseye of a Target block with an arrowTake AimShoot the center of a target with a projectile.adventure/bullseye

Husbandry[edit]

Advancement tree in the "Husbandry" tab
Hay Bale Axis Y JE2 BE2.png Husbandry
Icon Advancement In-game description Parent Actual requirements (if different) Namespaced ID Rewards

Advancement-plain-raw.png

HusbandryThe world is full of friends and foodEat anything that can be eaten.husbandry/root

Advancement-plain-raw.png

Bee Our GuestUse a Campfire to collect Honey from a Beehive using a Bottle without aggravating the beesHusbandryhusbandry/safely_harvest_honey

Advancement-plain-raw.png

The Parrots and the BatsBreed two animals togetherHusbandryhusbandry/breed_an_animal

Advancement-plain-raw.png

Best Friends ForeverTame an animalHusbandryhusbandry/tame_an_animal

Advancement-plain-raw.png

Fishy BusinessCatch a fishHusbandryUse a fishing rod to catch a fish.husbandry/fishy_business

Advancement-plain-raw.png

Total BeelocationMove a Bee Nest, with 3 bees inside, using Silk TouchHusbandryhusbandry/silk_touch_nest

Advancement-plain-raw.png

A Seedy PlacePlant a seed and watch it growHusbandryPlant one of these 5 seeds. Crops and plants without seeds are ignored for this advancement.husbandry/plant_seed

Advancement-fancy-raw.png

Two by TwoBreed all the animals!The Parrots and the BatsBreed pairs of each of these 15 mobs. ‌In Java Edition 1.16, 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_animals100 experience

Advancement-fancy-raw.png

A Complete CatalogueTame all cat variants!Best Friends Foreverhusbandry/complete_catalogue50 experience

Advancement-plain-raw.png

Tactical FishingCatch a fish... without a fishing rod!Fishy BusinessUse a water bucket on a fish mob to get a bucket of fish.husbandry/tactical_fishing

Advancement-fancy-raw.png

A Balanced DietEat everything that is edible, even if it's not good for youA Seedy PlaceEat each of these 39 foods. Other foods are ignored for this advancement.husbandry/balanced_diet100 experience

Advancement-fancy-raw.png

Serious DedicationCompletely use up a diamond hoe and then reevaluate your life choicesA Seedy PlaceExhaust the durability of a diamond hoe, breaking it.husbandry/break_diamond_hoe100 experience

JSON Format[edit]

History[edit]

Java Edition
1.12March 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.
17w13aAdvancements added, replacing Achievements.
17w14aAdded 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.
17w15aAdded advancement descriptions and changed several titles.
Added the "Adventuring Time" advancement.
17w16bAdded trigger item_durability_changed.
17w17aAdded 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".
17w17bThe 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).
17w18aRe-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.
17w18bAdded 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.
pre1Added 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.
pre2Added new hidden advancement: "How Did We Get Here?", which rewards 100 experience.
pre3Advancement "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.
pre5All recipe unlock advancements now have a parent of recipes/root.
Several recipe unlock advancements have now been renamed.
pre7Added experience rewards to all "challenge" advancements.
releaseAdded sounds to the toast notifications.
1.1317w43aCustom advancements have now been moved into data packs.
17w45aAdded an advancement selector argument to test for obtained advancements.
18w14aAdded new advancements: "Fishy Business", "Tactical Fishing", "A Throwaway Joke" and "Very, Very Frightening".
18w14bAdvancements "A Furious Cocktail" and "How Did We Get Here?" now includes the Slow Falling status effect.
18w19aAdvancement "How Did We Get Here?" now includes the Conduit Power status effect.
18w22aAdvancement "Sniper Duel" description changed to not mention it has to be with an arrow (as it can be achieved with a trident too).
pre6Added a nbt field to the advancement icon section.
pre7Normal and goal advancements now have green descriptions, and challenge advancements have purple descriptions.
1.1418w43aAdded new advancements: "Ol' Betsy", "Who's the Pillager Now?", "Two Birds, One Arrow" and the hidden advancement "Arbalistic".
18w44aAdded 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.
19w06aA bug was causing the advancement Serious Dedication to not be granted to the player, it was fixed in this snapshot.
19w11aAdvancement "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.
19w12aAdvancement "Two by Two" now requires foxes.
19w14aAdvancements "Monster Hunter" and "Monsters Hunted" no longer require polar bears to be killed.
Pre-Release 2Added 2 new advancements: "Voluntary Exile" and "Hero of the Village".
1.14.3Pre-Release 2Saturation is no longer required for the "How Did We Get Here?" advancement.
1.1519w34aAdvancement "The Parrots and the Bats" can now be obtained by breeding bees.
19w35aBees are now included in the "Two by Two" advancement.[4]
Honey bottles are now included in the "A Balanced Diet" advancement.
19w45aSpectral arrows can now be used to unlock the "Take Aim" advancement.
19w46aAdded 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.1620w07aPiglins and hoglins are now required for the "Monsters Hunted" advancement, and they will now count towards the "Monster Hunter" advancement.
Hoglins can now breed, meaning they can be used for "The Parrots and the Bats" advancement.
20w09aAdded the "Bullseye" advancement.
20w12aHoglins 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.
20w14aThe advancements "Monster Hunter" and "Monsters Hunted" now use elder guardians, ender dragons, endermites, vexes, withers, and zoglins.

Issues[edit]

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

Trivia[edit]

  • 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.
  • As an April Fools' Joke, the snapshot Java Edition 20w14infinite added a new advancement called "Almost there", achieved after visiting one billion of the dimensions. The in-game description is "Visited over billion dimensions."
    • The advancement is found in the "Adventure" category, its parent is the advancement "Adventure," and it has a flint and steel icon.
    • The advancement can be given using /advancement grant @s only minecraft:adventure/almost_there

References to other media[edit]

Cleanup.svg
This section may need cleanup, possibly to comply with the style guide. Discuss
Please help the Minecraft Wiki clean up this page if you can.
The specific instructions are: Needs citations.

Gallery[edit]

See also[edit]

References[edit]