How to Make an Advancement in Minecraft (Mod Maker guide)

Learn how to create a custom Advancement in 9Minecraft Mod Maker right in your web browser. This step-by-step guide makes it easy to reward players for doing tasks in your Minecraft mod.

  1. Open the Studio and your workspace

    Start by opening 9Minecraft Mod Maker in your web browser. You do not need to download or install anything to get started.

    Open an existing workspace or create a new one. Advancements are supported for NeoForge 26.1.2, NeoForge 1.21.1, Data pack 26.1, and Data pack 1.21.1.

  2. Add the Advancement element

    Click the green plus button to add a new mod element to your workspace.

    Look in the Data-driven content group and choose Advancement. An advancement is a text displayed when a user does something that is required to achieve.

  3. Set the name and description

    Fill in the Advancement GUI name field. This is the name of the advancement, and if it has no parent, it will also be the name of the path.

    Next, type into the Advancement description field. This is where you put information about how to achieve the task.

  4. Choose the icon and advancement type

    Pick an item in the Advancement icon field. This icon shows in the advancements tab, and if it is a root parent, it will be the advancement icon too. Remember that only items are supported here, and blocks without an item cannot be shown as an icon.

    Select your Advancement type. Task is a basic achievement type and is most common. Goal is a long term goal which you strive to achieve, while Challenge is to test a player or challenge them to something.

  5. Set the parent and background

    In the Advancement parent field, choose the advancement after which your achievement will be listed. You can use "No parent: root" to make a new path, which creates a new advancement tab.

    If your advancement is the first of a new path, use the Advancement background field to choose the background of the advancement tab.

  6. Configure notifications and visibility

    Check the Show toast when completed option if you want to show the advancement on the top right of the screen when the player completes it. You can also check Announce to chat when completed to write a message in the chat.

    If you want to keep it a secret, you can use Hide advancement display or Hide if not completed yet. Both of these parameters hide the advancement in the advancement tab until it is completed.

  7. Add player rewards

    You can give players nice prizes when they finish the task. Set the Reward XP field to decide how many experience the player will receive after completing the advancement.

    Use Reward loot tables so the player will receive some items from the selected loot table, or pick Reward recipes to choose recipes to unlock when the player completes the advancement. You can also set a Reward function to choose a function to execute.

  8. Test with Build & run and export

    Save your element and click Build & run to test your new advancement right away and make sure it displays and works as expected.

    When you are happy with how your advancement works, export your project from the studio to use it in Minecraft.

Tips

Try it in the Studio All advancement fields explained →