跳到主要内容

📂 分类

快速入门​

分类用于在 /ce 物品浏览器中组织物品。定义一个分类、列出它的成员，它就会出现在菜单里。

第一步 — 在 categories 下创建分类：

categories:
  default:palm_tree:
    name: "<!i><green>棕榈树</green>"
    icon: default:palm_log
    list:
      - default:palm_sapling
      - default:palm_leaves
      - default:palm_log
      - default:palm_planks

第二步 — 在游戏内用 /ce menu 打开浏览器，分类会显示为一个图标，点击即可浏览其中的物品。

配置​

分类配置写在 categories 节点下，每个分类以 命名空间:id 作为唯一标识。

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
字段默认值说明
name分类 ID分类图标的显示名称。支持 MiniMessage。
lore空图标上显示的描述行。支持 MiniMessage。
iconminecraft:stone分类图标显示的物品，必须是已注册的物品。
priority0主菜单中的显示顺序，数值越小越靠前。
hiddenfalse为 true 时不显示在主菜单——用于子分类。
conditions无控制分类是否显示的条件。见 ⚖️ 条件。
list空有序的物品 ID 和子分类引用列表。
all_itemsfalse为 true 时自动包含所有已注册的自定义物品。
提示

当两个分类的 priority 相同时，按 ID 字母顺序排列。

列出成员​

list 字段接受两种条目：

list:
  - default:palm_log           # 物品——直接显示该物品
  - "#default:palm_tree"       # 子分类——以 # 为前缀
  • 物品 ID（如 default:palm_log）——直接显示该物品。
  • 子分类引用（如 #default:palm_tree）——以 # 为前缀，点击后打开该分类的页面。
警告

如果引用的子分类或物品不存在，该格子会显示一个红色屏障方块，并以缺失的 ID 作为名称。

子分类​

要实现分类的嵌套，在子分类上设置 hidden: true，再在父分类的 list 中用 # 引用：

main_category
main_category
categories:
  # 父分类——显示在主菜单
  default:default:
    priority: 1
    name: "<!i><white>所有物品</white>"
    icon: default:topaz
    list:
      - "#default:palm_tree"
      - "#default:topaz"
      - "#default:misc"

  # 子分类——隐藏，通过父分类打开
  default:palm_tree:
    name: "<!i><green>棕榈树</green>"
    hidden: true
    icon: default:palm_log
    list:
      - default:palm_sapling
      - default:palm_leaves
      - default:palm_log

  default:topaz:
    name: "<!i><#FF8C00>黄玉装备</#FF8C00>"
    hidden: true
    icon: default:topaz
    list:
      - default:topaz
      - default:topaz_sword
      - default:topaz_pickaxe

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

这种模式可以任意深度嵌套——子分类的 list 里同样可以继续用 # 引用更下层的分类。

在物品上指定分类​

除了在分类的 list 里列出物品，你也可以直接在物品配置上声明它所属的分类：

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

一个物品可以属于多个分类：

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

这种方式声明的物品会被追加到分类末尾——它们在分类内的显示顺序不保证。需要精确控制顺序时，请用分类的 list。

界面操作提示​

提示

跳过配方页面——直接在任意物品图标上使用这些快捷操作：

  • Shift + 左键——获取单个物品
  • Shift + 右键——获取一整组
  • 中键——立即拾取一组