Skip to content
ItemsAdder
⌘ K

Recipes Menu

/ia command menu

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

Hide items in all category

You can hide particular items from the all category.

yaml
hide_items:
- _iainternal:icon_left_grey
- _iainternal:icon_left_blue
- _iainternal:icon_right_grey
- _iainternal:icon_right_blue
- _iainternal:icon_up_grey
- _iainternal:icon_up_blue

Hide matching in all category

You can hide all items whose ID starts with a specific string. For example, the following configuration hides every item whose ID starts with myitems:hidden_item_.

yaml
    hide_items:
    - "myitems:hidden_item_*"

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:

yaml
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

Add bulk items to categories

Wildcard

Matches any item which has example namespace.

yaml
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.

yaml
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.

yaml
  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

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
yaml
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
yaml
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
yaml
order:
  alphabetical: true
  force_override:
    enabled: true
    list:
      - all
      - armors
      - swords
      - blocks
      - minerals