Minecraft-Datapack数据包开发3-进度与成就：从入门到精通

1. 进度与成就：你的Minecraft数据包“任务系统”

如果你玩过Minecraft，肯定对按下L键后弹出的那个界面不陌生。里面那些“石器的时代”、“获得升级”的小图标，就是游戏自带的进度系统。它像一本冒险指南，记录着你在方块世界的每一个里程碑。而作为数据包开发者，这个系统就是我们能深度定制、为玩家创造独特体验的超级工具箱。

简单来说，进度（Advancement）就是Minecraft内置的、可编程的“任务与成就系统”。通过编写JSON格式的数据包，我们可以定义：在什么条件下（比如合成特定物品、击败某种生物、到达某个地点），玩家可以完成一个“进度”。完成时，不仅可以弹出酷炫的提示、播放音效，还能给玩家发放实实在在的奖励——经验、解锁新配方，甚至直接运行一段我们写好的命令（Function），送上一把神兵利器。

很多刚接触数据包的朋友容易混淆“进度”和“成就”。在Minecraft的语境里，它们本质上指的是同一个东西，都是advancement。通常，“成就”更偏向于描述那种一次性的、有纪念意义的里程碑（比如“驯服一只狼”），而“进度”则可能指代一系列有前后依赖关系的任务链。但在JSON文件里，它们没有区别。所以，接下来我会统一用“进度”来称呼它。

为什么我们要自己制作进度？想象一下，你制作了一个大型冒险地图，希望玩家在收集齐三把钥匙后获得最终宝藏的线索；或者你开发了一个科技模组风格的数据包，希望玩家在合成出内燃机后解锁更高级的配方。这些引导、奖励和阶段性的反馈，都可以通过进度系统优雅地实现。它让玩家的旅程更有目标感，也让你的数据包显得更加专业和完整。

2. 开发前的准备：工具与项目结构

在动手写代码之前，准备好趁手的工具能让你事半功倍。我强烈建议你不要硬啃JSON语法，尤其是刚开始的时候。有两个网站是我的左膀右臂，几乎每天都在用。

第一个是 Misode的进度生成器。你直接搜索“Misode advancement generator”就能找到。这个网站的神奇之处在于，它用可视化的界面涵盖了进度JSON几乎所有的参数。你只需要点点选选，右侧就会实时生成对应的JSON代码。对于学习每个字段的含义、快速搭建进度框架来说，它是最佳帮手。我经常用它来快速生成一个进度原型，然后再复制到编辑器里进行微调。

第二个是 DigMinecraft的指令生成器。当你的进度奖励需要给予玩家一件带有复杂NBT标签的物品（比如附了魔、改了名、有特定属性的武器）时，手动编写give命令很容易出错。这个网站可以让你通过表单选择物品、附魔、自定义名称等，然后直接生成可用的命令。这对于我们后面实现“完成任务送奖励”功能特别有用。

接下来，我们看看进度文件在数据包中应该放在哪里。这是一个非常固定的结构：

你的数据包文件夹/
├── pack.mcmeta
└── data/
    └── <命名空间>/
        └── advancement/
            └── <进度名>.json

关键点在于advancement这个文件夹。所有进度JSON文件都必须放在这里。你可以直接在advancement下创建文件，比如first.json，那么这个进度的ID就是<命名空间>:first。如果你想要更好的组织性，比如为你的“铁匠”系列进度单独建一个分类，你可以在advancement下再创建子文件夹：

data/
└── mypack/
    └── advancement/
        └── ironsmith/       # 这是一个进度分类/标签页
            ├── root.json    # 根进度
            ├── forge_block.json
            └── master.json

这样，ironsmith文件夹下的所有进度在游戏里会显示在同一个标签页下，非常整洁。此时，一个进度的ID就需要包含路径，比如mypack:ironsmith/root。

为了让你能跟着操作并立刻看到效果，我建议你先在数据包的data目录下，按照上面的结构创建好一个名为ironsmith的文件夹。我们接下来的所有例子都会基于这个“铁匠”主题展开。

3. 从根开始：创建你的第一个进度标签页

就像一棵树需要树根，一个进度标签页也需要一个起点，这个起点就是根进度。它是玩家在这个标签页里看到的第一个图标，通常也代表着这个系列任务的开始。一个标签页有且仅有一个根进度。

我们来创建第一个文件：data/<你的命名空间>/advancement/ironsmith/root.json。注意，根进度文件不能包含parent字段，因为它没有父进度。

打开你的编辑器，或者直接使用Misode生成器，我们来填充这个JSON文件。我会先给出完整代码，然后拆解每一个关键部分。

{
  "display": {
    "icon": {
      "id": "minecraft:iron_ingot",
      "count": 1
    },
    "title": "铁匠学徒"