📂 Category

Quick Start

Categories organize items in the /ce item browser. Define a category, list its members, and it shows up in the menu.

Step 1 — Create a category under categories:

categories:
  default:palm_tree:
    name: "<!i><green>Palm Tree</green>"
    icon: default:palm_log
    list:
      - default:palm_sapling
      - default:palm_leaves
      - default:palm_log
      - default:palm_planks

Step 2 — Open the browser in-game with /ce menu. The category appears as an icon; click it to browse its items.

Configuration

A category entry lives under the categories section. Each category has a unique ID in namespace:id form.

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

Field	Default	Description
`name`	The category ID	Display name of the category icon. Supports MiniMessage.
`lore`	empty	Lore lines shown on the icon. Supports MiniMessage.
`icon`	`minecraft:stone`	The item shown as the category icon. Must be a registered item.
`priority`	`0`	Display order on the main menu. Lower values appear first.
`hidden`	`false`	If `true`, the category doesn't appear on the main menu — useful for sub-categories.
`conditions`	none	Conditions that control whether the category is shown. See ⚖️ Conditions.
`list`	empty	Ordered list of item IDs and sub-category references.
`all_items`	`false`	If `true`, automatically includes all registered custom items.

tip

When two categories share the same priority, they're sorted alphabetically by ID.

Listing Members

The list field accepts two kinds of entries:

list:
  - default:palm_log           # An item — shows the item itself
  - "#default:palm_tree"       # A sub-category — prefixed with #

Item IDs (e.g., default:palm_log) — the item is displayed directly.
Sub-category references (e.g., #default:palm_tree) — prefixed with #, clicking opens that category's page.

caution

If a referenced sub-category or item doesn't exist, the slot displays a red barrier with the missing ID as its name.

Sub-Categories

To nest categories inside one another, combine hidden: true on the child with # references in the parent's list:

main_category

categories:
  # Parent — visible on the main menu
  default:default:
    priority: 1
    name: "<!i><white>All Items</white>"
    icon: default:topaz
    list:
      - "#default:palm_tree"
      - "#default:topaz"
      - "#default:misc"

  # Children — hidden, opened through the parent
  default:palm_tree:
    name: "<!i><green>Palm Tree</green>"
    hidden: true
    icon: default:palm_log
    list:
      - default:palm_sapling
      - default:palm_leaves
      - default:palm_log

  default:topaz:
    name: "<!i><#FF8C00>Topaz Gear</#FF8C00>"
    hidden: true
    icon: default:topaz
    list:
      - default:topaz
      - default:topaz_sword
      - default:topaz_pickaxe

  default:misc:
    name: "<!i><gray>Misc</gray>"
    hidden: true
    icon: default:chinese_lantern
    list:
      - default:chinese_lantern
      - default:fairy_flower

This pattern nests arbitrarily deep — a sub-category's list can itself reference further #-prefixed categories.

Assigning Items to Categories

Instead of (or in addition to) listing items in a category's list, you can declare the category on the item itself:

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

An item can belong to multiple categories:

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

caution

Items assigned this way are appended to the category — their order within the category is not guaranteed. For controlled ordering, use the category's list instead.

UI Tips

tip

Skip the recipe page — use these quick actions directly on any item icon:

Shift + Left-click — take a single item
Shift + Right-click — take a full stack
Middle-click — pick up a stack instantly

Quick Start​

Configuration​

Listing Members​

Sub-Categories​

Assigning Items to Categories​

UI Tips​