GitLab

Categories are a simple way to group specific achievements, and each category will generate its own tab in the advancements window!

These are added/edited in the category.yml file in your MythicAchievements plugin folder.

Categories have their own tabs in the advancement menu, and also display as the first "node" in the category.

Table Of Contents:

• Adding New Category
• Category Breakdown
  • Display
  • Description
  • Background
  • Frame
  • Icon
• Example

Adding New Category

CATEGORY_KEY:
  Display: 'Name of your category'
  Description: 'Description of Category'
  Background: 'textures/block/polished_blackstone.png'
  Frame: TASK
  Icon:
    Material: IRON_SWORD
    Model: 0

Category Breakdown

Display

Display: 'Hunting Monsters'

Display the name of your category. This name is shown in the tab's icon and the starting node item.

Description

Description: 'Adventure awaits you in the wilderness'

Provide a short description of your category. This is only shown in the starting node item.

Background

Background: 'textures/block/black_concrete.png'

The background image of your category. This can be a path to any block texture inside of the player's loaded resource pack.

So if you want diamond ore as the background of your category, you would provide textures/block/diamond_ore.png as the value.

Frame

Frame: CHALLENGE

The frame shape of your starting node item. This can be a TASK, GOAL, or CHALLENGE.

Icon

Icon:
  Material: IRON_SWORD
  Model: 0

The icon is the item displayed in the tab button in the advancement menu, and in the starting node of the category.

You have to provide a valid material name, MAKE SURE IT IS UPPERCASE. Optionally, you have the choice to provide a model data value (CustomModelData).

Example

SPECIAL:
  Display: 'Special'
  Background: 'textures/block/quartz_pillar.png'
  Icon:
    Material: NETHER_STAR

This example only uses the required values to generate a valid category.

To learn how to add achievements to the category you created, see Creating Achievements