Minecraft Wiki
Advertisement

This tutorial is intended to help players make an advancement.

Getting Started[]

We are going to start off by navigating into the .minecraft folder. Below is a table showing the default directory for .minecraft.

OS Location
Windows %APPDATA%\.minecraft
macOS ~/Library/Application Support/minecraft
Linux ~/.minecraft

Once you're inside the folder, go to the saves folder and then pick the world for which you want to create an advancement. Go to the data folder of the world and open the advancements folder. In this folder, create a new folder with any name you want. This folder will be the namespace of your advancement.

Advancements in Minecraft are written using JSON files. You can use any text editor to create a JSON file in your namespace, just make sure to save it as .json.

JSON format[]

An advancement JSON file is structured according to the following format:

  • The root tag.
    •  display: The optional display data.
      •  icon: The data for the icon.
        •  item: The item id.
        •  data: The damage value for the item.
      •  title: The title for this advancement.
      •  title: A JSON text component (containing text and formatting like used in /tellraw and various other commands. Also translate tag can be used here).
      •  frame: The optional type of frame for the icon. challenge for a tile with a more fancy spiked border, goal for a tile with a rounded border, task for a normal tile (default.)
      •  background: The optional directory for the background to use in this advancement tab (only for the root advancement).
      •  description: The description of the advancement.
      •  description: A JSON text component (containing text and formatting like used in /tellraw and various other commands. Also translate tag can be used here).
      •  show_toast: Can be true or false. Whether or not to show the toast pop up after completing this advancement. Defaults to true.
      •  announce_to_chat: Can be true or false. Whether or not to announce in the chat when this advancement has been completed. Defaults to true.
      •  hidden: Can be true or false. Whether or not to hide this advancement and all its children from the advancement screen until this advancement have been completed. Has no effect on root advancements them self but will still affect all their children. Defaults to false.
    •  parent: The optional parent advancement directory of this advancement (does not apply for the root advancement).
    •  criteria: The required criteria that have to be met.
      •  <criteriaName>: A name given to the criteria (can be any string, must be unique).
        •  trigger: The trigger for this advancement; specifies what the game should check for the advancement.
        •  conditions: All the conditions that need to be met when the trigger gets activated.
    •  requirements: An optional list of requirements (all the <criteriaName>). If all criteria are required, this may be omitted. With multiple criteria: requirements contains a list of lists with criteria (all criteria need to be mentioned). If all of the lists each have any criteria met, it will complete the advancement. (basically AND grouping of OR groups)
    •  rewards: An optional collection of the rewards provided when this advancement is obtained.
      •  recipes: A list of crafting recipes (strings).
      •  loot: A list of loot tables (strings).
      •  experience: An amount of experience.
      •  function: A function to run.

Criteria[]

Criteria are used to specify when an advancement is completed by a player, making them necessary for every advancement. Multiple criteria can be created, each with their own name. Each criteria needs a valid trigger but conditions are optional.

   {
       "criteria": {
           "example1": {
               "trigger":
               "conditions: {}
           },
           "example2": {
               "trigger":
               "conditions: {}
           },
       }
   }

Triggers[]

Conditions[]

Requirements[]

Display[]

Parent[]

Rewards[]

Advertisement