Item Catalog

The crafting item catalog file is used to specify where items appear in the creative menu and recipe book.

First of all, you need to create a file named crafting_item_catalog.json in the item_catalog folder of your behavior pack. Below is the basic JSON format which you should include in the file:

{
    "format_version": "1.21.130",
    "minecraft:crafting_items_catalog": {
        "categories": []
    }
}

Adding Items ​

First, you need to decide which category your items should be placed into. This determines which tab the items are under in the creative menu and recipe book.

The four available categories are:

• "construction"
• "equipment"
• "items"
• "nature"

For example, if we were adding items to the "Nature" tab, a new entry would be created in the categories array specifying "nature" as the category_name:

{
    "format_version": "1.21.130",
    "minecraft:crafting_items_catalog": {
        "categories": [
            {
                "category_name": "nature",
                "groups": []
            }
        ]
    }
}

Items are added to each category of the item catalog in groups. To add a new group of items, you'll need to make a new entry in the category's groups array.

The following example adds two custom ore blocks to the "Nature" category. Note that custom groups in the item catalog will appear after vanilla groups.

{
    "category_name": "nature",
    "groups": [
        {
            "items": [
                "wiki:silver_ore",
                "wiki:steel_ore"
            ]
        }
    ]
}

Expandable Groups ​

For creative mode players, you have the option to make groups of items expandable and collapsible. This can be achieved by adding the group_identifier parameter to the group.

• icon determines the item to display as the group's icon.
• name is the localization key to use as the name of the group. It can also be used to reference the group in the menu_category parameter of items and blocks.

Let's use the group_identifier parameter to make our custom ore group take up less space in the creative menu!

{
    "category_name": "nature",
    "groups": [
        {
            "group_identifier": {
                "icon": "wiki:silver_ore",
                "name": "wiki:itemGroup.name.ore"
            },
            "items": [
                "wiki:silver_ore",
                "wiki:steel_ore"
            ]
        }
    ]
}

wiki:itemGroup.name.ore=Custom Ores

And that's it! You now know how to add a custom group for your items to the item catalog.