进度生成

前置条件

请确保你已经完成数据生成器设置章节。

设置

首先，我们需要创建 Provider。 创建一个继承 FabricAdvancementProvider 的类，并填入基本方法：

No lines matched.

接着在 DataGeneratorEntrypoint 入口点的 onInitializeDataGenerator 方法里注册这个类。

No lines matched.

进度结构

进度由几个不同的部分组成。 除了称为准则（criterion）的要求外，可能还有：

• DisplayInfo，告诉游戏如何向玩家显示进度。
• AdvancementRequirements 是一系列准则的列表，要求每个子列表中至少完成一项准则。
• AdvancementRewards 是玩家完成进度后获得的奖励。
• Strategy 告诉进度如何处理多个准则，以及
• 父级 Advancement，用于组织玩家在“进度”屏幕上看到的层次结构。

简单进度

这是一个获取泥土方块的简单进度：

No lines matched.

WARNING

当构建你的进度条目时，请记住函数接受 String 类型的进度的 Identifier！

JSON 输出

{
  "criteria": {
    "got_dirt": {
      "conditions": {
        "items": [
          {
            "items": "minecraft:dirt"
          }
        ]
      },
      "trigger": "minecraft:inventory_changed"
    }
  },
  "display": {
    "background": "minecraft:textures/gui/advancements/backgrounds/adventure.png",
    "description": "Now make a house from it",
    "icon": {
      "id": "minecraft:dirt"
    },
    "title": "Your First Dirt Block"
  },
  "requirements": [
    [
      "got_dirt"
    ]
  ],
  "sends_telemetry_event": true
}

另一个示例

为了掌握要领，我们再添加一项进度。 我们将练习添加奖励、使用多项准则以及指定父级：

No lines matched.

自定义准则

WARNING

虽然数据生成器可以放在客户端侧，但 准则（Criterion） 与 谓词（Predicates） 必须位于主源集（main source set）中（即同时存在于两侧），因为服务器需要触发并计算它们。

定义

准则（criterion/criteria）是指玩家可以做的事情（或可能发生在玩家身上的事情），这些事情可以被计入进度的达成。 游戏附带许多准则，可以在 net.minecraft.advancement.criterion 包中找到。 一般来说，仅当你在游戏中实现自定义机制时才需要新的准则。

条件是根据准则来评估的。 只有满足所有相关条件时，准则才会被计入。 条件通常用谓词来表达。

谓词是一种接受值并返回 boolean 的东西。 例如，如果物品是钻石，则 Predicate<Item> 可能返回 true，而如果实体与村民不敌对，则 Predicate<LivingEntity> 可能返回 true。

创建自定义准则

首先，我们需要实现一个新的机制。 让我们告诉玩家每次破坏方块时他们使用了什么工具。

No lines matched.

请注意，这个代码确实很烂。 HashMap 没有存储在任何持久位置，因此每次重新启动游戏时它都会被重置。 这只是为了展示 Criterion。 开始游戏并且试一下吧！

接下来，让我们创建自定义准则 UseToolCriterion。 它将需要自己的 Conditions 类来配合它，因此我们将同时创建它们：

No lines matched.

好多新名词！ 让我们慢慢分析它们：

• UseToolCriterion 是一个 SimpleCriterionTrigger，Conditions 可以应用于它。
• Conditions 有一个 playerPredicate 字段。 所有的 Conditions 都应有一个玩家谓词（技术上来讲是 LootContextPredicate`）。
• Conditions 也有一个 CODEC。 这个 Codec 只是其一个字段 playerPredicate 的 codec，带有在它们之间进行转换的额外指令（xmap）。

INFO

要了解有关 codec 的更多信息，请参阅 Codec 页面。

我们需要一种方法来检查条件是否满足。 因此我们得向 Conditions 添加辅助方法：

No lines matched.

现在我们已经有了准则及其条件，我们需要一种触发它的方式。 为 UseToolCriterion 添加一个触发方法：

No lines matched.

快完成了！ 接下来，我们需要一个可以使用的准则实例。 我们把它放入一个名为 ModCriteria 的新类中。

No lines matched.

为了确保我们的准则在正确的时间进行初始化，添加一个空白的 init 方法：

No lines matched.

并在模组的初始化器中调用它：

No lines matched.

最后，我们需要触发我们的准则。 将其添加到我们在主模组类中向玩家发送消息的地方。

No lines matched.

你的崭新准则现已可供使用！ 现在把它添加到我们的 Provider 中：

No lines matched.

再次运行数据生成器任务，你就可以获得新的进度了！

带参数的条件

现在实现的进度看起来很不错，但是如果我们只想在完成 5 次准则之后才授予进度该怎么办呢？ 或者类似的需要多次达成某种准则才能完成的成就呢？ 为此，我们需要为条件提供一个参数。 你可以继续使用 UseToolCriterion，也可以使用新的 ParameterizedUseToolCriterion。 实践中，你应该只使用参数化版本，但在本教程中我们将保留这两个版本。

让我们自下而上地开始。 我们需要检查要求是否满足，因此让我们编辑 Conditions#requirementsMet 方法：

No lines matched.

requiredTimes 不存在，因此将其作为 Conditions 的一个参数：

No lines matched.

现在我们的 codec 在报错。 让我们为这次变更编写一个新的 codec：

No lines matched.

接下来，我们需要修复我们的 trigger 方法：

No lines matched.

如果你制定了新准则，我们需要将其添加到 ModCriteria

No lines matched.

然后在主类中调用它，就在原来的位置：

No lines matched.

将进度添加到 Provider ：

No lines matched.

再次运行数据生成，就搞定了！