categories.yml

categories.yml 管的是成就分类本身：分类名、图标、描述、排序，全都在这里。

成就文件里的 category: combat、category: exploration 这些引用的就是这里定义的分类 ID。

基本结构

categories:
  combat:
    name: "&c&l战斗成就"
    icon: "DIAMOND_SWORD"
    description: "&7在战斗中证明你的实力"
    order: 1

最关键的规则很简单：

• categories 下每个键就是分类 ID
• name 是玩家看到的显示名
• icon 是 GUI 里的图标
• description 用于分类说明
• order 决定排序

图标兼容

当前默认注释已经把兼容思路写得很明确：

• 1.13+ 和 1.12- 的材质名不同
• 头颅、砖块、钟、地图这些跨版本差异比较大
• 旧格式和新版格式插件会尽量自动适配

更稳的做法是：

• 能用全版本通用材质时，优先用通用材质
• 需要特殊图标时，再上模型数据

IA / CustomModelData 写法

当前分类图标也支持：

icon: "paper{model-data=20001}"

或者：

icon: "paper{cmd=20001}"

这类写法更适合：

• IA / 资源包服
• 分类需要明显区分
• 不想只靠原版材质做图标

排序规则

order 越小越靠前。

所以建议你一开始就把分类顺序规划好，不然后面分类越来越多时，玩家主界面会越来越乱。

一个常见排法是：

1. 战斗
2. 探索
3. 收集
4. 任务 / RPG
5. 社交
6. 建造

使用建议

• 分类 ID 一旦大量成就开始引用，就尽量不要随便改。
• 图标先以稳定识别为主，别为了炫图标把材质兼容性搞得太复杂。
• description 最好写成一句话说明，而不是塞很多 lore。
• order 最好预留间隔，例如 10、20、30，后面插分类更轻松。