categories.yml

The browse categories in /ah, and which items fall into each. Written to plugins/ProtonAuctions/categories.yml. For how they appear in game, see Categories.

categories is a list. Each entry is one category:

Key	What it does
id	A short unique id for the category.
displayName	The category name, MiniMessage formatted.
enabled	Set false to hide the category without deleting it. Default true.
icon	The menu icon for the category. See below.
matchers	One or more rules that decide which items belong. See below.

icon

Key	Default	What it does
material	CHEST	The icon material. Unknown names fall back to CHEST.
name	(empty)	The icon name, MiniMessage. Empty uses displayName.
lore	(empty)	Icon lore lines, MiniMessage.
amount	1	Stack size shown on the icon, 1 to 64.
glow	false	Give the icon an enchant glow.
customModelData	0	A resource-pack model id for the icon. 0 means none.

matchers

Each matcher has a type, plus the one field that type uses:

type	Field it uses	What it matches
MATERIAL	materials	A list of material names, such as DIAMOND_SWORD.
DISPLAY_NAME_CONTAINS	query	The item name contains this text.
DISPLAY_NAME_EQUALS	value	The item name is exactly this.
DISPLAY_NAME_REGEX	regex	The item name matches this pattern.
LORE_CONTAINS	query	Any lore line contains this text.
CUSTOM_MODEL_DATA	customModelData	The item's model id equals this value, which must not be 0.
ANY	none	Matches every item. Use it for a catch-all category.

The name and lore matchers also take ignoreCase, default true.

Items are tested against the categories in file order, and the first category that matches wins. Keep an ANY catch-all category last so it only picks up what nothing else claimed.

The file ships with nine categories: Combat, Armor, Tools, Resources, Potions, Enchanting, Food, Blocks, and an everything-else catch-all.

categories:  - id: spawners    displayName: '<light_purple>Spawners</light_purple>'    enabled: true    icon:      material: SPAWNER      name: '<light_purple>Spawners</light_purple>'      lore:        - '<gray>Mob spawners of every kind.</gray>'      glow: true    matchers:      - type: MATERIAL        materials:          - SPAWNER      - type: DISPLAY_NAME_CONTAINS        query: Spawner        ignoreCase: true

Copy