Harbinger项目解析：Minecraft 1.12+进度系统深度指南

进度系统概述

Minecraft 1.12版本引入的进度系统(Advancement)是对旧版成就系统的全面升级。作为Harbinger项目的重要组成部分，这套系统不仅保留了成就的核心功能，还提供了更强大的自定义能力和更丰富的交互体验。

进度系统核心特性

进度系统相比旧版成就系统具有以下显著优势：

1. 灵活的回调机制：可以在进度达成时给予经验、执行指令或从战利品表中抽取奖励
2. 强大的判据系统：支持复杂的布尔逻辑组合条件
3. 可视化展示：自动生成树状结构展示进度关系
4. 多语言支持：支持使用JSON文本格式实现本地化

进度文件结构解析

进度文件采用JSON格式存储，主要包含三个核心部分：

1. 显示属性(display)

"display": {
    "icon": { "item": "...", "nbt": "..." },
    "title": "进度标题",
    "frame": "goal",
    "background": "modid:...",
    "description": "进度描述",
    "show_toast": false,
    "announce_to_chat": false,
    "hidden": false
}

• icon：定义进度图标，可使用物品ID和NBT数据
• title/description：支持纯文本或JSON文本格式
• frame：进度图标边框类型(task/challenge/goal)
• background：仅根进度需要，定义标签页背景
• show_toast：是否显示右上角弹窗
• announce_to_chat：是否在聊天栏公告
• hidden：是否隐藏进度直到完成

2. 触发条件(criteria)

"criteria": {
    "condition1": {
        "trigger": "...",
        "conditions": { "...": "..." }
    }
}

每个条件需要指定触发器(trigger)和具体条件(conditions)。Minecraft提供了丰富的内置触发器，如物品获取、生物击杀等。

3. 奖励系统(rewards)

"rewards": {
    "recipes": [ "..." ],
    "loot": [ "..." ],
    "experience": 100,
    "function": "..."
}

奖励系统支持四种类型：

• 解锁合成配方
• 给予经验值
• 从战利品表抽取奖励
• 执行函数

进度树构建技巧

构建进度树需要注意以下要点：

1. 父子关系：通过"parent"字段指定父进度
2. 根进度：必须包含background属性
3. 分支进度：不需要background属性

{
    "parent": "modid:parent_advancement",
    // 其他属性...
}

高级条件逻辑

进度系统支持复杂的布尔逻辑组合：

"requirements": [ 
    ["a", "b"], 
    "c" 
]

这表示 (a OR b) AND c 的逻辑关系。如果不指定requirements，默认为所有条件都必须满足(AND关系)。

自定义扩展能力

虽然原版进度系统功能已经很强大，但Harbinger项目还提供了额外的扩展能力：

1. 自定义触发器：可以创建全新的进度触发条件
2. 自定义物品谓词：对涉及物品判定的条件提供更灵活的匹配规则

最佳实践建议

1. 合理规划进度树结构，避免过于复杂
2. 善用hidden属性控制进度显示
3. 使用JSON文本实现多语言支持
4. 为重要进度添加适当的视觉反馈(toast/chat)
5. 平衡奖励设置，避免破坏游戏平衡

通过Harbinger项目提供的进度系统，开发者可以创建出比原版成就系统更丰富、更有趣的游戏进度体验。掌握这些技巧将帮助你为玩家设计出更具吸引力的游戏内容。