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.

**This feature is exclusive to  *Java Edition*.**

**Advancements** are a way to gradually guide new players into *Minecraft* and give them challenges to complete, similar to the basic 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 110 of them: 16 in the **Minecraft** tab, 24 in the **Nether** tab, 9 in the **The End** tab, 35 in the **Adventure** tab, and 26 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 if the game rule `announceAdvancements` is set to `true`.‌ 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

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. Tabs only appear when at least one advancement in that tab has been made. Tabs are ordered left to right, based on when the first advancement in each tab was made.

Advancement icons display a header name and description when hovered over. The advancement descriptions have a unique color depending on the type of advancement with normal and goal advancements having green descriptions and challenge advancements having purple ones. As more advancements are unlocked, new ones become visible, with up to two advancements being displayed ahead of an unlocked one. Unlocked advancements show all of its **direct** parents advancements (the advancements between the root advancement of the tab and it), even those that have not been unlocked (but only show up to 2 advancements downstream of advancements already unlocked). Nine advancements, "How Did We Get Here?", "Voluntary Exile", "Hero of the Village", "Arbalistic", "You've Got a Friend in Me", "Smells Interesting", "Birthday Song", "Little Sniffs", and "Planting the Past" are hidden advancements, meaning that they cannot be viewed by the player until they have been unlocked, regardless of if its child advancement(s) (any advancement after it, including all branches), if any have been unlocked, which would normally display its parent advancements (as advancements can be unlocked and completed in any order).

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:

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

## Issues

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

## Trivia

* As an April Fools' Joke, 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`.
* As another April Fools' Joke, the snapshot Java Edition 22w13oneBlockAtATime added a new advancement called "Ride The End", achieved when an Ender Dragon is mounted.
* As yet another April Fools' Joke, the snapshot Java Edition 23w13a or b added 2 new advancements called "I Voted!" and "Pro Voter", achieved when the player votes for the first time and for the 256th time, respectively.
* The theme for completing a challenge advancement is used as Steve's victory theme in *Super Smash Bros. Ultimate*.
* The advancement "Caves & Cliffs" refers to the Minecraft update of the same name.

## Gallery

* First look at advancements; Dinnerbone showcasing usage of the interface (click to play).
* First look at advancement descriptions.
* Advancements being announced in chat.
* "Tabthulhu".
* The advancements screen when no advancements have been completed or unlocked.
* Advancement "A Balanced Diet".
* Advancement "A Complete Catalogue".
* Advancement "Monsters Hunted".
* Advancement "Two by Two"
* Advancement "A Furious Cocktail".

## See also

* Tutorials/Advancement guide
* Achievement
* Data pack

## References

1. ↑ MC-115297 — resolved as "Works As Intended".
2. ↑ MC-183764
3. ↑ MC-116875
4. ↑ MC-199994 — Advancement "Free the End" is only granted to one player
5. ↑ MC-252401 — resolved as "Works As Intended".
6. ↑ "People wanted to see what the UI looks like for Advancements. I was going to show it but a deafening metallic condor keeps distracting me :(" – @Dinnerbone (Nathan Adams) on X, March 24, 2017
7. ↑ MC-136400
8. ↑ MC-159357
9. ↑ MC-187546
10. ↑ MC-249632
11. ↑ MC-250025
12. ↑ MC-226430
13. ↑ MC-231458
14. ↑ MC-237920
15. ↑ MC-237924
16. ↑ MC-249741
17. ↑ MC-249984
18. ↑ MC-262123
19. ↑ MC-262947
20. ↑ MC-261965
21. ↑ MC-253269
22. ↑ MC-265126