Item Categories are the different tabs shown in the Creative Menu. This guide will give a basic introduction to creating your own categories and subcategories.

1. Creating the File

Firstly, create a file in AppData/Roaming/Hytale/UserData/Packs/YourPackName/Server/Item/Category/CreativeLibrary/MyItemCategory.json and copy the below text into this:

  "Icon": "Icons/ItemCategories/MyCategory.png",
  "Order": 6,
  "Children": [
    {
      "Id": "Example_Category",
      "Name": "ui.itemcategory.example_category",
      "Icon": "Icons/ItemCategories/My_Example_Category.png"
    },
  {
      "Id": "Example_Category_Two",
      "Name": "ui.itemcategory.example_category_two",
      "Icon": "Icons/ItemCategories/My_Example_Category_Two.png"
    }
  ]
}

You can modify the above to fit the purpose of your tab, using the following:

• Icon: the icons shown in the Creative Menu
• Order: the order of your category listed in the GUI
• Children: any subcategories
• Name: the text when you hover your mouse over the Item Category icon

2. Adding Translations

Next, we need to define translations. Head to the following file within your pack (and if this does not exist, create it) YourPackName/Server/Languages/en-US/ui.lang and add the below entries that match the ones defined in your categories JSON file:

itemcategory.example_category = Example Tab One
itemcategory.example_category_two = Example Tab Two

3. Adding Icons and Blocks

Now it’s time to add your icons to the directory, ensuring they match the path in the categories file (i.e. YourPackName/Common/Icons/ItemCategories/MyCategory.png).

You can then add blocks into your tab by editing the block’s JSON (i.e. YourPackName/Server/Item/Items/your_block.json) by including this inside the file:

  "Categories": [
   "MyCategory.Example_Category"
 ],

MyCategory is the main category, with Example_Category as the sub tab. For the Vanilla category names, look into Assets/Server/Item/Category/CreativeLibrary.

Thank you to Sketch Macaw for helping to create this tutorial.