📂 Category

Categories organize items in the /ce item browser.

Basic Configuration

categories:
  default:palm_tree:
    name: "<!i><green>Palm Tree</green>"
    lore: []
    icon: default:palm_log
    priority: 1
    hidden: false
    conditions:
      - type: permission
        permission: category.default.palm_tree
    source:
      type: list
      list:
        - default:palm_sapling
        - default:palm_leaves
        - default:palm_log

Field	Default	Description
name	Category ID	Display name. Supports MiniMessage.
lore	empty	Lore shown on the category icon. Supports MiniMessage.
icon	minecraft:stone	Category icon.
priority	0	Lower values appear first.
hidden	false	Hides the category from the main page. Useful for nested categories.
conditions	none	Conditions controlling visibility. See Conditions.
source	none	One source or a list of sources providing category members.

Categories with the same priority are sorted by ID.

Sources

list

Adds literal item IDs or nested category references in order. Prefix a category ID with #.

source:
  type: list
  list:
    - default:palm_log
    - "#default:topaz"

regex

Matches complete item IDs, including vanilla items. regex accepts one expression or a list. Results follow the item order: vanilla registry order first, then custom item configuration order.

source:
  type: regex
  regex:
    - "minecraft:.*_sword"
    - "default:topaz_.*"

all_items

Adds all vanilla and custom items. Set ignore_vanilla to true to keep only custom items.

source:
  type: all_items
  ignore_vanilla: false

Combining Sources

source can be a list. Results are appended in declaration order without removing duplicates.

source:
  - type: list
    list:
      - "#default:topaz"
      - default:palm_log
  - type: regex
    regex: "minecraft:.*_sword"

Legacy Format

The old top level list remains supported:

categories:
  default:legacy:
    name: "<!i><gray>Legacy</gray>"
    icon: minecraft:stone
    list:
      - default:palm_log
      - "#default:topaz"

Assigning Categories from Items

Items can append themselves to one or more categories:

items:
  default:topaz_sword:
    material: golden_sword
    category:
      - default:swords
      - default:topaz

These items are appended after source results. Use a category source when exact ordering matters.