数据驱动物品
上次更新：2026 年 4 月 21 日。
其中文档内容更新于 2026 年 1 月 2 日。此时中国版最新版本为 1.21.0，国际版最新版本为 1.21.130。
数据驱动物品（Data-Driven Items，简称数驱物品）是由开发者给定数据，由游戏引擎自行注册的物品。
数驱物品由行为包和资源包组成。国际版和中国版均可编写数驱物品。数驱物品分为国际版物品和中国版物品，两者的编写流程有所不同。
文件架构
- 国际版
- 国际版（旧版）
- 中国版
| 可用性 | 可用版本 | 组件可用性 | 物品格式版本 |
|---|---|---|---|
| 中国版和国际版均可用 | 1.20.0+ | 国际版 | 1.20.0或更高 |
-
behavior_packs
-
items
(物品 ID).item.json：定义物品的行为和渲染表现
-
item_catalog
- crafting_item_catalog.json：物品在创造模式物品栏和配方书中的分类信息（1.21.60+）
-
recipes
- (物品 ID).recipe.json：定义物品的配方表，亦可用于原版物品
-
-
resource_packs
-
texts
- en_US.lang：定义物品的英文译名
- zh_CN.lang：定义物品的中文译名
-
textures
-
items
(物品 ID).png：定义物品的贴图
- item_texture.json：物品贴图注册
-
-
| 可用性 | 可用版本 | 组件可用性 | 物品格式版本 |
|---|---|---|---|
| 中国版和国际版均可用 | 1.11.0+ | 国际版 旧版 | 1.10~1.16.0 |
-
behavior_packs
-
items
- (物品 ID).item.json：定义物品的行为
-
recipes
- (物品 ID).recipe.json：定义物品的配方表，亦可用于原版物品
-
-
resource_packs
-
items
- (物品 ID).json：定义物品的渲染表现
-
texts
- en_US.lang：定义物品的英文译名
- zh_CN.lang：定义物品的中文译名
-
textures
-
items
- (物品 ID).png：定义物品的贴图
- item_texture.json：物品贴图注册
-
-
| 可用性 | 可用版本 | 组件可用性 | 物品格式版本 |
|---|---|---|---|
| 中国版可用 | —— | 中国版 | 1.10 |
-
behavior_packs
-
netease_items_beh
- (物品 ID).json：定义物品的行为
-
netease_group
- *.json：定义物品组，名称可任意指定（例如 crafting_item_catalog.json 或 group_config.json）
-
netease_tab
- *.json：定义物品分类，名称可任意指定（例如 crafting_item_catalog.json 或 category_config.json）
-
netease_recipes
- (物品 ID).json：定义物品的配方表，亦可用于原版物品
-
-
resource_packs
-
netease_items_res
- (物品 ID).json：定义物品的渲染表现
-
texts
- en_US.lang：定义物品的英文译名
- zh_CN.lang：定义物品的中文译名
-
textures
-
items
- (物品 ID).png：定义物品的贴图
- item_texture.json：物品贴图注册
-
-
行为包配置
行为包定义格式
以下为 behavior_packs - items（或netease_items_beh） - (物品 ID).json 的结构。
- 国际版（1.20.30+）
- 国际版（1.20.0~1.20.30）
- 国际版（旧版）
- 中国版
：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.20.30或更高的版本。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。menu_category：定义物品的分类和组别。category：定义物品在创造模式物品栏中的分类。可填为construction（建筑）、equipment（装备）、items（物品）、nature（自然）、none（空）。group：定义物品在创造模式物品栏中置于何物品组中，详见物品组与物品分类。
在格式版本为1.21.50或更低时，不能添加命名空间；在格式版本为1.21.60或更高时，必须添加命名空间。
is_hidden_in_commands：定义物品是否隐藏在命令中。
components：物品组件，定义物品的功能。
minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件。
- ：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.20.0~1.20.30的版本。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。category：定义物品在创造模式物品栏中的分类。可填为construction（建筑）、equipment（装备）、items（物品）、nature（自然）。
components*：物品组件，定义物品的功能。minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件。
- ：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.10~1.16.0的版本。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。
components*：物品组件，定义物品的功能。minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件（旧版）。
- ：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.10。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。category：定义物品在创造模式物品栏中的分类。可填为construction（建筑）、equipment（装备）、items（物品）、nature（自然）、commands（只有命令和 API 可获取）、none（只有 API 可获取）。也可设置为自定义分类，详见物品组与物品分类。register_to_create_menu：是否注册到创造模式物品栏中。custom_item_type：自定义物品类别，可选值有weapon、armor、egg、ranged_weapon、bucket、projectile_item、shield。
components*：物品组件，定义物品的功能。minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件（中国版）。
资源包配置
资源包定义格式
以下为 resource_packs - items（或netease_items_res） - (物品 ID).json 的结构。
- 国际版（旧版）
- 中国版
- ：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.10~1.16.0的版本。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。category：定义物品在创造模式物品栏中的分类。可填为construction（建筑）、equipment（装备）、items（物品）、nature（自然）。
components*：物品组件，定义物品的功能。minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件（旧版）。
- ：根对象。
format_version*：格式版本，决定物品可用的功能。应填写为1.10。minecraft:item*：定义数驱物品。description*：物品描述，定义物品的基本属性。identifier*：定义物品的命名空间和物品 ID。
components*：物品组件，定义物品的功能。minecraft:(component)：物品组件，可用的物品组件见数据驱动物品组件（中国版）。
item_texture.json
以下为 resource_packs - textures - item_texture.json 的结构。
语言文件键名
- 对于国际版物品，键名一般为
item.(命名空间):(ID)，除非使用minecraft:display_name组件更改。例如doc:my_item使用item.doc:my_item的键名。 - 对于国际版旧版物品或中国版物品，键名一般为
item.(命名空间):(ID).name。例如doc:my_item使用item.doc:my_item.name的键名。
参考文档
本文主要参考文档如下，读者可以在这些文档获得更多信息。