数据驱动物品
数据驱动物品（Data-Driven Items，简称数驱物品）是由开发者给定数据，由游戏引擎自行注册的物品。
数驱物品由行为包和资源包组成。国际版和中国版均可编写数驱物品。数驱物品分为国际版物品和中国版物品，两者的编写流程有所不同。
本文更新时间
本文于 2025 年 9 月 3 日更新，中国版最新版本为 1.21.0，国际版最新版本为 1.21.100。
文件架构
- 国际版
- 国际版（旧版）
- 中国版
| 可用性 | 可用版本 | 组件可用性 | 物品格式版本 |
|---|---|---|---|
| 中国版和国际版均可用 | 1.20.0+ | 国际版 | 1.20.0或更高 |
-
behavior_packs
-
items
(物品 ID).json：定义物品的行为和渲染表现
-
item_catalog
- crafting_item_catalog.json：物品在创造模式物品栏和配方书中的分类信息（仅限 1.21.60 或更高版本可用）
-
-
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).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）
-
-
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（自然）。group：定义物品在创造模式物品栏中置于何物品组中，详见物品分类与物品组。
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)：物品组件，可用的物品组件见数据驱动物品组件（中国版）。
物品分类与物品组
- 国际版
- 中国版
以下为 behavior_packs - item_catalog - crafting_item_catalog.json 的结构。
可用于新建物品组，但不能新建物品分类。
注意
该功能仅限 1.21.60 及更高版本可用。
- ：根对象。
format_version*：格式版本。应填写为1.21.60或更高版本。minecraft:crafting_item_catalog*：定义物品分类数据。
categories*：指定物品分类。-
category_name*：定义创造模式物品栏的分类。可填为construction（建筑）、equipment（装备）、items（物品）、nature（自然）。groups*：定义物品组。-
group_identifier：定义物品组。如果不指定该参数将直接指定下面items*中的物品为分散在物品栏中的物品。icon：定义物品组的图标使用何物品的图标。name：定义物品组的名称和 ID。可以指定为原版物品组（必须带minecraft:命名空间），详见原版使用的物品组，也可以自行新建（必须带命名空间）。
items*：定义哪些物品归类进该物品组。
-
-
中国版可以独立创建新的物品分类和新的物品组。
以下为 behavior_packs - netease_group - *.json 的结构，用于新建物品组。官方文档表达了更多需要注意的事项，见此。
- ：根对象。
groups：定义物品组。-
group_name：定义物品组的名称和 ID。可以指定为原版物品组，详见原版使用的物品组，也可以自行新建。icon：定义物品组的图标使用何物品的图标。list：定义哪些物品归类进该物品组。- ：物品 ID。
-
以下为 behavior_packs - netease_tab - *.json 的结构，用于新建物品组。官方文档表达了更多需要注意的事项，见此。
- ：根对象。
category：定义物品分类。-
name：定义物品分类的名称。在数驱物品中可在category字段中指定该值，以将该物品放入此分类中。labelText：定义物品分类的描述。在zh_CN.lang中定义译名（例如“自然”、“建筑”）。icon：定义物品分类的图标路径，从textures/开始，不带后缀。sort_by_identifier：定义物品分类中的物品是否进行排序，默认为false。分类规则为：
分类中全部为未分组物品时，则按照物品的 ID 排序；
分类中全部为具有分组的物品时，则按照分组中第一个物品的 ID 排序；
分类中既有分组物品和未分组物品时，则按照分组中第一个物品的 ID 和未分组物品的 ID 排序；
-
原版使用的物品组
备注：本处采用 Minecraft Wiki 提供的标准译名包的译名。使用最新国际正式版的数据。
展开
| 物品组 | 物品组名 |
|---|---|
itemGroup.name.planks | 木板 |
itemGroup.name.walls | 墙 |
itemGroup.name.fence | 栅栏 |
itemGroup.name.fenceGate | 栅栏门 |
itemGroup.name.stairs | 楼梯 |
itemGroup.name.door | 门 |
itemGroup.name.glass | 玻璃 |
itemGroup.name.glassPane | 玻璃板 |
itemGroup.name.permission | 权限方块 |
itemGroup.name.slab | 台阶 |
itemGroup.name.stoneBrick | 石砖 |
itemGroup.name.sandstone | 砂岩 |
itemGroup.name.wool | 羊毛 |
itemGroup.name.woolCarpet | 羊毛地毯 |
itemGroup.name.concretePowder | 混凝土粉末 |
itemGroup.name.concrete | 混凝土 |
itemGroup.name.stainedClay | 陶瓦 |
itemGroup.name.glazedTerracotta | 带釉陶瓦 |
itemGroup.name.dye | 染料 |
itemGroup.name.ore | 矿石 |
itemGroup.name.stone | 石头 |
itemGroup.name.log | 原木 |
itemGroup.name.leaves | 树叶 |
itemGroup.name.sapling | 树苗 |
itemGroup.name.seed | 种子 |
itemGroup.name.crop | 农作物 |
itemGroup.name.grass | 草 |
itemGroup.name.flower | 花 |
itemGroup.name.rawFood | 生食 |
itemGroup.name.cookedFood | 熟食 |
itemGroup.name.miscFood | 其他食物 |
itemGroup.name.mushroom | 蘑菇 |
itemGroup.name.monsterStoneEgg | 虫蚀石头 |
itemGroup.name.mobEgg | 刷怪蛋 |
itemGroup.name.helmet | 头盔 |
itemGroup.name.chestplate | 胸甲 |
itemGroup.name.leggings | 护腿 |
itemGroup.name.boots | 靴子 |
itemGroup.name.horseArmor | 马铠 |
itemGroup.name.sword | 剑 |
itemGroup.name.axe | 斧 |
itemGroup.name.pickaxe | 镐 |
itemGroup.name.shovel | 锹 |
itemGroup.name.hoe | 锄 |
itemGroup.name.arrow | 箭 |
itemGroup.name.potion | 药水 |
itemGroup.name.splashPotion | 喷溅药水 |
itemGroup.name.lingeringPotion | 滞留药水 |
itemGroup.name.ominousBottle | 不祥之瓶 |
itemGroup.name.bed | 床 |
itemGroup.name.chalkboard | 黑板 |
itemGroup.name.anvil | 铁砧 |
itemGroup.name.chest | 箱子 |
itemGroup.name.shulkerBox | 潜影盒 |
itemGroup.name.record | 唱片 |
itemGroup.name.skull | 生物头颅 |
itemGroup.name.boat | 船 |
itemGroup.name.chestboat | 运输船 |
itemGroup.name.rail | 铁轨 |
itemGroup.name.minecart | 矿车 |
itemGroup.name.pressurePlate | 压力板 |
itemGroup.name.trapdoor | 活板门 |
itemGroup.name.enchantedBook | 附魔书 |
itemGroup.name.banner | 旗帜 |
itemGroup.name.firework | 烟花火箭 |
itemGroup.name.fireworkStars | 烟火之星 |
itemGroup.name.coral | 珊瑚块 |
itemGroup.name.coral_decorations | 珊瑚装饰 |
itemGroup.name.buttons | 按钮 |
itemGroup.name.sign | 告示牌 |
itemGroup.name.wood | 木头 |
itemGroup.name.banner_pattern | 旗帜图案 |
itemGroup.name.netherWartBlock | 下界疣块 |
itemGroup.name.candles | 蜡烛 |
itemGroup.name.goatHorn | 山羊角 |
itemGroup.name.compounds | 化合物 |
itemGroup.name.products | 产物 |
itemGroup.name.bundles | 收纳袋 |
itemGroup.name.sculk | 幽匿 |
itemGroup.name.hanging_sign | 悬挂式告示牌 |
itemGroup.name.potterySherds | 纹样陶片 |
itemGroup.name.smithing_templates | 锻造模板 |
itemGroup.name.copper | 铜块 |
itemGroup.name.harnesses | 挽具 |
itemGroup.name.chemistrytable | 化学设备 |
itemGroup.name.element | 元素 |
资源包配置
资源包定义格式
以下为 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)：物品组件，可用的物品组件见数据驱动物品组件（中国版）。
贴图文件格式
以下为 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的键名。
参考文档
本文主要参考文档如下，读者可以在这些文档获得更多信息。
- 物品定义属性 | Microsoft Learn
- 自定义基础物品 | 我的世界开发者官网
- 物品文档 | 1.16.20.3 | bedrock.dev
- 物品目录 | Microsoft Learn
- 自定义物品分组 | 我的世界开发者官网
- 自定义物品分页 | 我的世界开发者官网