Recipes Menu

/ia command menu

Menu settings and "All" category

ia_gui.yml contains settings about the /ia command GUI. It also contains the "all" category which shows every ItemsAdder item.

Default ItemsAdder pack categories are inside categories.yml files on each namespace folder. For example: contents/iasurvival/configs/categories.yml

Creating a custom category

If you want to create your own category you have to create and add it to your own .yml file in your namespace. Do not add your categories into the ia_gui.yml file! This is an example:

info:
  namespace: my_items
categories:
  swords:
    enabled: true
    icon: "my_items:custom_item"
    name: 'Swords'
    permission: "ia.menu.seecategory.swords"
    # THIS IS OPTIONAL. Plugin will take the one in ia_gui.yml if not set.
    font_image:
      name: "mcguis:blank_menu"
      x_position_pixels: -16
    # THIS IS OPTIONAL. Plugin will take the one in ia_gui.yml if not set.
    title_position_pixels: 0
    items:
      - "my_items:custom_item"
      - "my_items:custom_item_2"
      - "my_items:custom_item_3"

Remember to give your users permission for each category if you want them to see the categories. This example category permission is: ia.menu.seecategory.swords

font_image and title_position_pixels are optional. Plugin will take the one in ia_gui.yml if not set.

This option is good if you want to have a different background for each category.

Categories with the same name and different namespace will be merged, this is helpful if you have two "swords" categories. This allows you to open /ia menu and see all swords organized in the same category instead of having 2 swords categories.

Add bulk items to categories

Wildcard

Matches any item which has example namespace.

categories:
  test:
    enabled: true
    skip_if_already: false
    icon: example:my_item
    name: TEST
    permission: ia.menu.seecategory.test
    items:
      - "example:*"

Matches any namespace which has some_item item.

categories:
  test:
    enabled: true
    skip_if_already: false
    icon: example:my_item
    name: TEST
    permission: ia.menu

Regex (advanced users)

Matches any armor item of the iasurvival namespace.

Use this website to test your regex.

  armors:
    enabled: true
    skip_if_already: false
    icon: iasurvival:ruby_helmet
    name: display-category-armors
    permission: ia.menu.seecategory.armors
    items:
      - "iasurvival\:(.*)_helmet"
      - "iasurvival\:(.*)_chestplate"
      - "iasurvival\:(.*)_leggings"
      - "iasurvival\:(.*)_boots"

Reorder categories

Requires ItemsAdder 4.0.15+

In ItemsAdder/ia_gui.yml you can set a custom order for the categories of your plugin. This is a global setting that applies to all the namespaces.

Automatic alphabetical order

Set alphabetical: true.

ItemsAdder/ia_gui.yml

order:
  alphabetical: true
  force_override:
    enabled: false

Force custom ordering

Set alphabetical: false and customize force_override.

Categories that are not in the list will be appended to the end of the listed categories, in alphabetical order (if alphabetical: true).

ItemsAdder/ia_gui.yml

order:
  alphabetical: true
  force_override:
    enabled: true
    list:
      - armors
      - swords
      - blocks
      - minerals

Customize all category position

You can make the all category the first category by just adding it to the list

ItemsAdder/ia_gui.yml

order:
  alphabetical: true
  force_override:
    enabled: true
    list:
      - all
      - armors
      - swords
      - blocks
      - minerals