第四章小结

上次更新：2026 年 4 月 14 日

恭喜，我们已经翻越了数据驱动的第一座大山——数据驱动物品！在这一章，我们详细地介绍了有关数驱物品是什么、新旧版物品和中国版数驱物品的定义方法、配方表和自定义物品组物品分类。相信读者在这一章的收获一定很多！同样，这章起到承上启下的作用，因为数驱方块和数驱物品的逻辑也是类似的。让我们现在来总结一下吧！

数据驱动物品（Data-Driven Items） 是按照 Mojang 和微软为我们提供的接口，提供一些必要的数据，剩下的就可以让 Minecraft 自行处理这些数据并注册的物品。

数据驱动物品的定义要在特定文件夹下进行，并同时涉及行为包和资源包。目前，Minecraft 的物品一共分为三类：

• 高版本国际版物品，适用于 1.20+ 的国际版和中国版，定义要在行为包的items下进行。
  • 注意高版本国际版物品在中国版注册后无法在创造模式物品栏显示出来，但可以通过命令获取。
• 低版本国际版物品，适用于低版本的国际版和中国版，定义要在行为包的items和资源包的items下进行。
• 中国版物品，只适用于中国版，可使用中国版独有的组件，定义要在行为包的netease_items_beh和资源包的netease_items_res下进行。

无论是哪种数驱物品，格式都是类似的，即定义物品的格式版本、描述和组件。

• 格式版本决定物品定义如何解析，通常使用目标游戏版本，比如运行在 1.21.90 下就写为1.21.90，运行在 26.10 下就写为1.26.10。旧版物品和中国版物品写为1.16.0。
• 描述包含物品的基础信息，主要包括物品的 ID、分类、分组、显示在创造模式物品栏等信息。
• 组件则决定物品的功能，不同的组件包括不同的功能，通过组合不同的组件实现复杂的功能。

我们在物品文档中给出了许多详细的文档，读者在编写自定义物品时应当多参考文档编写。

Minecraft 一共有 7 种配方表，包括工作台有序配方、工作台无序配方、熔炉配方、酿造台换容配方、酿造台混合配方、锻造台升级配方、锻造台纹饰配方。常用的主要是工作台配方和熔炉配方，自由度相对较高。

以及，我们还可以定义物品组和物品分类。国际版可以定义物品组，而中国版可以定义物品组和物品分类，但仅限中国版物品可用。