跳到主要内容

数据驱动物品组件

收录所有已开放（包括旧版本）或即将开放的命名空间为minecraft和netease的物品组件信息。

你可以使用Ctrl+F来查找你需要的条目。

本文更新时间

本文于 2025 年 9 月 3 日更新，中国版最新版本为 1.21.0，国际版最新版本为 1.21.100。

组件可用性提示

  1. 标签记号说明：

    • 标注了国际版 旧版的组件，代表其为旧版国际版组件，可应用于国际版物品定义（在行为包items 文件图标items和资源包items 文件图标items定义的物品）。format_version必须指定1.10.0~1.16.0以内时才可使用。

    • 标注了国际版 版本号+的组件，代表其为新版国际版组件，可应用于国际版物品定义（在行为包items 文件图标items定义的物品）。其中，（版本号）代表物品定义的format_version必须指定为该版本号或更高才可使用。

    • 标注了中国版的组件，代表其为中国版组件，可应用于中国版物品定义（在行为包netease_items_beh 文件图标netease_items_beh和资源包netease_items_res 文件图标netease_items_res定义的物品）。

    • 标注了国际版的组件，代表其为实验性玩法组件，可应用于国际版物品定义（在行为包items 文件图标items定义的物品）。本文档不记载已被移除的实验性玩法组件（尤其是假日创作者功能的组件）。开发者在使用这些组件的时候应当万分小心，因为它们随时可能会被移除，这会导致你的资源的关键功能失效。

    • 注意：中国版可以同时使用国际版物品定义和中国版物品定义，但是国际版只能使用国际版物品定义。

  2. 标注了国际版 旧版 RP或中国版 RP的组件，需要在其资源包定义中使用（即资源包items 文件图标items或资源包netease_items_res 文件图标netease_items_res），未特殊标注的组件为行为包组件。

  3. 如果官方文档中有记载，以上这些标签将会链接到官方文档，读者可点击以查看对应文档。

基础属性组件​

全体物品通用的组件。

minecraft:display_name​

国际版 1.20.0+

定义物品的显示名称。

  • minecraft:display_name 数据类型图标minecraft:display_name：根对象。
    • value 数据类型图标value：定义物品的显示名称。可以指定为特定名称，也可以指定为本地化键名。不指定时默认为本地化键名item.(命名空间):(ID)。

minecraft:durability​

国际版 1.20.0+

定义物品的耐久度。

Durability does not implicitly damage itself when mining blocks. It must be handled via ScriptAPI. It does however implicitly damage itself when damaging mobs. Each hit on a mob decreases durability by 2. This does not match vanilla property for weapons, but does match vanilla property for tools.
When used with minecraft:wearable, hitting a mob with the item does not decrease durability by 2. Instead, it implicitly decreases durability by 1 when equipped and hit by an entity. This matches vanilla property.

参考翻译：
耐久度在挖掘方块时不会降低耐久，必须通过 ScriptAPI 强制降低耐久度。但是，当攻击生物时，每次击中生物都会降低 2 点耐久度，这并不符合武器的运作方式，而是工具的。
当使用minecraft:wearable时，攻击生物不会降低这 2 点耐久度。在穿着该物品时，被其他实体攻击后会降低 1 点耐久度，这是符合原版的运作方式的。

—— Bedrock Wiki

  • minecraft:durability 数据类型图标minecraft:durability：根对象。
    • damage_chance 数据类型图标damage_chance：定义该物品有多大概率会在被使用后降低耐久度。不指定时默认为100%。
      • max 数据类型图标max*：最大有百分之多少的概率降低耐久度。
      • min 数据类型图标min*：最小有百分之多少的概率降低耐久度。
    • max_durability 数据类型图标max_durability*：定义物品的总耐久度。

minecraft:icon​

国际版 1.20.0+

定义物品的图标。

重要组件

对于任何自定义物品，都必须定义该组件。否则，物品将无法正确展示贴图。

多值写法：

  • minecraft:icon 数据类型图标minecraft:icon*：根对象
    • textures 数据类型图标textures：定义该物品的贴图。
      • default 数据类型图标default：该物品的默认贴图。Minecraft 将会试图找到在资源包中定义的textures/item_texture.json的短 ID。详见贴图文件格式。
      • dyed 数据类型图标dyed：该物品的染色后贴图，仅当指定minecraft:dyeable组件后有意义。Minecraft 将会试图找到在资源包中定义的textures/item_texture.json的短 ID。详见贴图文件格式。

单值写法（1.20.50+）：

  • minecraft:icon 数据类型图标minecraft:icon*：该物品的默认贴图。Minecraft 将会试图找到在资源包中定义的textures/item_texture.json的短 ID。详见贴图文件格式。

单值写法（1.20.0 - 1.20.40）：

  • minecraft:icon 数据类型图标minecraft:icon*：根对象
    • texture 数据类型图标texture：该物品的贴图Minecraft 将会试图找到在资源包中定义的textures/item_texture.json的短 ID。详见贴图文件格式。

minecraft:max_stack_size​

国际版 1.20.20+

定义物品的最大堆叠数。

对象型：

  • minecraft:max_stack_size 数据类型图标minecraft:max_stack_size：根对象。
    • value 数据类型图标value：物品的最大堆叠数，默认为64。

整型：

  • minecraft:max_stack_size 数据类型图标minecraft:max_stack_size：物品的最大堆叠数，默认为64。

minecraft:stacked_by_data​

国际版 1.20.20+

定义是否允许不同数据值的同种物品堆叠。

对象型：

  • minecraft:stacked_by_data 数据类型图标minecraft:stacked_by_data：根对象。
    • value 数据类型图标value：是否允许不同数据值的物品或掉落物堆叠，默认为false。

布尔型：

  • minecraft:stacked_by_data 数据类型图标minecraft:stacked_by_data：是否允许不同数据值的物品或掉落物堆叠，默认为false。

功能性组件​

特定类型物品可用的组件。

常见物品类型常用组件最低适用版本
剑minecraft:can_destroy_in_creative、minecraft:damage、minecraft:digger、minecraft:enchantable、minecraft:hand_equipped、minecraft:repairable1.20.30
工具minecraft:digger、minecraft:enchantable、minecraft:repairable1.20.30
盔甲minecraft:enchantable、minecraft:repairable、minecraft:wearable1.20.30
食物minecraft:food、minecraft:use_animation、minecraft:use_modifiers1.20.50
弹射物（如雪球）minecraft:cooldown、minecraft:projectile、minecraft:throwable1.20.10
弓类似物minecraft:shooter、minecraft:use_modifiers1.20.50
收纳袋minecraft:bundle_interaction、minecraft:storage_item、minecraft:storage_weight_limit、minecraft:storage_weight_modifier1.21.60

minecraft:allow_off_hand​

国际版 1.20.20+

允许玩家将物品放在副手。

对象型：

  • minecraft:allow_off_hand 数据类型图标minecraft:allow_off_hand：根对象。
    • value 数据类型图标value：是否能将物品放在副手，默认为false。

布尔型：

  • minecraft:allow_off_hand 数据类型图标minecraft:allow_off_hand：是否能将物品放在副手，默认为false。

minecraft:block_placer​

国际版 1.20.10+

可以在特定方块上放置特定方块。

  • minecraft:block_placer 数据类型图标minecraft:block_placer：根对象
    • block 数据类型图标block*：将放置为何种方块。
    • replace_block_item 数据类型图标replace_block_item：是否将此物品与对应方块绑定，若绑定则当方块被破坏后将掉落该物品。备注：物品 ID 必须与对应的方块 ID 保持一致。
    • use_on 数据类型图标use_on：可放置于的方块列表。如果留空，则默认为可放置于所有方块上。
      • undefined 数据类型图标：方块 ID。

该组件有更完整的语法描述方块，请查阅官方文档。

minecraft:bundle_interaction​

国际版 1.21.40+

为物品启用收纳袋的交互模式和物品提示。

注意

要使用该组件，必须先定义minecraft:storage_item组件。

  • minecraft:bundle_interaction 数据类型图标minecraft:bundle_interaction：根对象
    • num_viewable_slots 数据类型图标num_viewable_slots：定义从收纳袋顶部可访问的物品堆叠的最大数量。必须在1到64之间（含），默认值为12。

minecraft:can_destroy_in_creative​

国际版 1.20.10+

允许玩家在创造模式下手持该物品时可以破坏方块。如果设置为false，该物品就会像剑一样手持时无法破坏方块。

对象型：

  • minecraft:can_destroy_in_creative 数据类型图标minecraft:can_destroy_in_creative：根对象。
    • value 数据类型图标value：是否允许玩家在创造模式下手持该物品时破坏方块，默认为true。

布尔型：

  • minecraft:can_destroy_in_creative 数据类型图标minecraft:can_destroy_in_creative：是否允许玩家在创造模式下手持该物品时破坏方块，默认为true。

minecraft:compostable​

国际版 1.21.60+

定义物品可在堆肥桶中用于堆肥。

  • minecraft:compostable 数据类型图标minecraft:compostable：根对象。
    • composting_chance 数据类型图标composting_chance*：有百分之多少的概率会堆肥成功。

minecraft:cooldown​

国际版 1.20.10+

定义物品使用后的冷却。

注意

要使用该组件，必须同时定义下面的组件：

  • minecraft:cooldown 数据类型图标minecraft:cooldown：根对象。
    • category 数据类型图标category：冷却类型，共享同种冷却类型的物品将会一起进入冷却阶段。
    • duration 数据类型图标duration：冷却时间，单位为秒。

minecraft:custom_components​

国际版 1.21.20 - 1.21.90+

定义物品的自定义组件。自定义组件的行为需要在世界初始化前事件WorldInitializeBeforeEvent中定义。

注意
  1. 该组件必须配合 ScriptAPI 使用，因此该组件在现在或未来的中国版也是无效的。
  2. 该组件随着 1.21.90 的自定义组件 V2 的推出，已被弃用。在1.21.90或更高版本下的物品定义中不应再使用该组件。
  • minecraft:custom_components 数据类型图标minecraft:custom_components：根数组。
    • undefined 数据类型图标：自定义组件的名称。

minecraft:damage​

国际版 1.20.20+

定义物品的攻击伤害，类似剑。

对象型：

  • minecraft:damage 数据类型图标minecraft:damage：根对象。
    • value 数据类型图标value：物品的攻击伤害。

整型：

  • minecraft:damage 数据类型图标minecraft:damage：物品的攻击伤害。

minecraft:damage_absorption​

国际版 1.21.20+

定义该物品在穿戴时可吸收何种类型的伤害，类似狼铠。

注意

要使用该组件，必须先定义minecraft:durability和minecraft:wearable组件。

  • minecraft:damage_absorption 数据类型图标minecraft:damage_absorption：根对象。
    • absorbable_causes 数据类型图标absorbable_causes*：定义该物品将吸收的伤害类型列表。当实体在盔甲栏上穿戴该物品时，该物品会以降低耐久度为代价吸收列表中的伤害类型，使得实体免受这些类型的伤害。
      • undefined 数据类型图标：伤害类型。可见/damage命令的可用伤害类型。

minecraft:digger​

国际版 1.20.20+

定义物品破坏特定方块的速度。

  • minecraft:digger 数据类型图标minecraft:digger：根对象。
    • destroy_speeds 数据类型图标destroy_speeds*：定义列表中的方块的破坏速度。
      • block 数据类型图标block：方块 ID。
      • block 数据类型图标block（替代）：方块标签。
        • tags 数据类型图标tags：一个 Molang 表达式。通常使用query.any_tag()来代表拥有特定标签的方块。
      • speed 数据类型图标speed：破坏方块的速度。若为负数则代表无法破坏。
    • use_efficiency 数据类型图标use_efficiency：定义有效率附魔的物品是否影响挖掘速度。

minecraft:durability_sensor​

国际版 1.21.20+

定义物品在降低耐久度后触发的事件。

  • minecraft:durability 数据类型图标minecraft:durability：根对象。
    • durability_thresholds 数据类型图标durability_thresholds*：当物品耐久度降低到某个阈值时，触发事件。如果同时满足多个阈值，考虑所有阈值中最低的那个。至少指定 1 项。
      • undefined 数据类型图标：耐久度阈值
        • durability 数据类型图标durability：指定耐久度阈值，当物品耐久度低于此值时触发下面的事件。
        • particle_type 数据类型图标particle_type：低于耐久度阈值时释放的粒子。
        • sound_event 数据类型图标sound_event：低于耐久度阈值时播放的音效。

minecraft:dyeable​

国际版 1.21.30+

定义物品在炼药锅中可染色。

当该物品被染色前，使用minecraft:icon中规定的default贴图；而被染色后，使用minecraft:icon中规定的dyed贴图。

注意

要使用该组件，应同时在minecraft:icon组件中定义dyed的贴图。

  • minecraft:dyeable 数据类型图标minecraft:dyeable：根对象。
    • default_color 数据类型图标default_color：该物品染色前采用的默认颜色，应指定为有效的颜色代码（#xxxxxx）。

minecraft:enchantable​

国际版 1.20.30+

定义物品为可附魔。

  • minecraft:enchantable 数据类型图标minecraft:enchantable：根对象。
    • slot 数据类型图标slot*：该物品可以按照什么类型的物品附魔。只能填写为下列值中的一种：
      armor_feetarmor_torsoarmor_headarmor_legsaxe
      bowcosmetic_headcrossbowelytrafishing_rod
      flintsteelhoepickaxeshearsshield
      shovelswordall
    • value 数据类型图标value*：附魔能力。该值越高越容易附魔出更好的魔咒。应在0-255之间（含）。更多信息参见中文 Minecraft Wiki。

minecraft:entity_placer​

国际版 1.20.0+

定义物品可生成实体。

  • minecraft:entity_placer 数据类型图标minecraft:entity_placer：根对象。
    • entity 数据类型图标entity*：生成的实体的 ID。
    • dispense_on 数据类型图标dispense_on：可在何种方块上通过发射器使用该物品并生成实体。留空则默认允许全部方块。
      • undefined 数据类型图标：方块 ID。
    • use_on 数据类型图标use_on：可在何种方块上使用该物品并生成实体。留空则默认允许全部方块。
      • undefined 数据类型图标：方块 ID。

更完整的用法请查阅官方文档。

minecraft:fire_resistance​

国际版 1.21.110+

定义物品防火，类似于下界合金物品。1

对象型：

  • minecraft:fire_resistance 数据类型图标minecraft:fire_resistance：根对象。
    • value 数据类型图标value：物品是否防火，默认为false。

布尔型：

  • minecraft:fire_resistance 数据类型图标minecraft:fire_resistance：物品是否防火，默认为false。

minecraft:food​

国际版 1.20.30+

定义物品为食物。

编者注

新版的food组件相比旧版删去了大量功能，拆分到了其他组件或脚本功能中。以下为功能点差异，若读者有相关需求，请参考以下替代方案，若无法接受请使用旧版组件。

  • 提供状态效果（或解除状态效果）：使用脚本的物品使用后事件（ItemCompleteUseAfterEvent）监听并对使用实体提供药效。
  • 使用后随机传送：使用脚本的物品使用后事件（ItemCompleteUseAfterEvent）监听并传送实体（不要忘记加传送到地表的判定）。
  • 使用冷却：使用物品组件minecraft:cooldown代替。
注意

要使用该组件，必须同时定义下面的组件：

  • minecraft:food 数据类型图标minecraft:food：根对象。
    • nutrition 数据类型图标nutrition：食物回复的饥饿值。默认为0。
    • saturation_modifier 数据类型图标saturation_modifier：食物回复的饱和度等级。回复的饱和度将为饥饿值×饱和度系数×2。默认为0.6。
    • using_converts_to 数据类型图标using_converts_to：食物在食用完毕后将转化为的物品。应填写为物品 ID。
    • can_always_eat 数据类型图标can_always_eat：食物是否在任何情况下都可食用，否则仅当玩家的饥饿值不满时才可食用。

minecraft:fuel​

国际版 1.20.0+

定义该物品为燃料。

  • minecraft:fuel 数据类型图标minecraft:fuel：根对象。
    • duration 数据类型图标duration：定义燃料在熔炉中的燃烧时长，单位秒。

minecraft:glint​

国际版 1.20.20+

定义该物品会像附魔书一样产生附魔光泽。

对象型：

  • minecraft:glint 数据类型图标minecraft:glint：根对象。
    • value 数据类型图标value：物品是否有附魔光泽，默认为false。

布尔型：

  • minecraft:glint 数据类型图标minecraft:glint：物品是否有附魔光泽，默认为false。

minecraft:hand_equipped​

国际版 1.20.20+

定义该物品像工具一样直立展示在玩家手中。

对象型：

  • minecraft:hand_equipped 数据类型图标minecraft:hand_equipped：根对象
    • value 数据类型图标value：是否在手中像工具一样展示物品，默认为false。

布尔型：

  • minecraft:hand_equipped 数据类型图标minecraft:hand_equipped：是否在手中像工具一样展示物品，默认为false。

minecraft:hover_text_color​

国际版 1.20.10+

定义物品悬浮文本的颜色。

对象型：

  • minecraft:hover_text_color 数据类型图标minecraft:hover_text_color：根对象。
    • value 数据类型图标value：设置物品的悬浮文本颜色。可选值为格式化代码对应的名称，详见中文 Minecraft Wiki 对应的名称一列。

布尔型：

  • minecraft:hover_text_color 数据类型图标minecraft:hover_text_color：设置物品的悬浮文本颜色。可选值为格式化代码对应的名称，详见中文 Minecraft Wiki 对应的名称一列。

minecraft:interact_button​

国际版 1.20.30+

在触控设备中，为物品添加交互按钮。

  • undefined 数据类型图标minecraft:interact_button 数据类型图标minecraft:interact_button：在触控设备上，是否启用物品的交互按钮，以及该按钮上显示的文本。若指定为true，则默认显示为Use Item，否则显示为指定文本。允许指定为本地化键名。

minecraft:liquid_clipped​

国际版 1.20.20+

定义物品是否可与流体交互。

对象型：

  • minecraft:liquid_clipped 数据类型图标minecraft:liquid_clipped：根对象。
    • value 数据类型图标value：是否能与液体交互，默认为false。

布尔型：

  • minecraft:liquid_clipped 数据类型图标minecraft:liquid_clipped：是否能与液体交互，默认为false。

minecraft:projectile​

国际版 1.20.10+

定义物品为弹射物，例如箭。

  • minecraft:projectile 数据类型图标minecraft:projectile：根对象。
    • minimum_critical_power 数据类型图标minimum_critical_power：定义蓄力需要多久才能暴击。单位秒。
    • projectile_entity 数据类型图标projectile_entity*：定义掷出何种实体。若未指定命名空间，默认为minecraft。

minecraft:rarity​

国际版 1.21.30+

定义物品的稀有度。

注意：物品具有任何魔咒时稀有度会提升，由常见或少见变为稀有、或由稀有变为史诗。关于稀有度机制，详见稀有度 - 中文 Minecraft Wiki。

对象型：

  • minecraft:rarity 数据类型图标minecraft:rarity：根对象。
    • value 数据类型图标value：定义物品的基础稀有度。可选值为common（普通）、uncommon（少见）、rare（稀有）、epic（传奇）。

字符串型：

  • minecraft:rarity 数据类型图标minecraft:rarity：定义物品的基础稀有度。可选值为common（普通）、uncommon（少见）、rare（稀有）、epic（传奇）。

minecraft:record​

国际版 1.20.10+

定义物品为唱片。

  • minecraft:record 数据类型图标minecraft:record：根对象。
    • comparator_signal 数据类型图标comparator_signal：在唱片机中通过红石信号输出的信号，应在0-15之间。
    • duration 数据类型图标duration：音乐时长，单位秒。
    • sound_event 数据类型图标sound_event：要播放的音效。

minecraft:repairable​

国际版 1.20.10+

定义物品为可修复的。默认情况下，允许此物品和另一个同种类的物品在一起修复（例如两把损坏铁镐合成一把较新的铁镐），此时恢复的耐久度为二者相加。

  • minecraft:repairable 数据类型图标minecraft:repairable：根对象。
    • repair_items 数据类型图标repair_items：可用于修复的物品及其修复耐久度值的列表。
      • undefined 数据类型图标：可修复的物品项目
        • undefined 数据类型图标repair_amount 数据类型图标repair_amount：物品恢复的耐久度。当指定为整数时，恢复固定的耐久度值；指定为字符串时，可指定为一个 Molang，可使用context.other指定铁砧另一个槽位的物品。
        • items 数据类型图标items*：可用于修复的物品列表。
          • undefined 数据类型图标：可用于修复的物品 ID。

minecraft:shooter​

国际版 1.20.10+

定义物品为某种弹射物的发射物，类似于弓或弩。

提示

若通过minecraft:durability定义了发射物的耐久度，该物品将仅在发射子弹时降低耐久度。近战攻击时该物品的耐久度将不受影响。

注意

要使用该组件，必须同时定义下面的组件：

  • minecraft:shooter 数据类型图标minecraft:shooter：根对象。
    • ammunition 数据类型图标ammunition*：定义该发射物使用何种子弹。
      • undefined 数据类型图标
        • item 数据类型图标item*：子弹所对应的物品 ID。该物品 ID 对应的物品必须具有minecraft:projectile组件，否则将会报错。
        • use_offhand 数据类型图标use_offhand：是否允许使用副手上的子弹，像弩和烟花一样。默认值为false。
        • search_inventory 数据类型图标search_inventory：是否搜索物品栏中是否有子弹可用，创造模式下不会消耗子弹。默认值为false，但通常设置为true。
        • use_in_creative 数据类型图标use_in_creative：是否在创造模式下可用。若设置为false，则无法在物品栏中没有子弹时使用。默认值为false。
    • charge_on_draw 数据类型图标charge_on_draw：拉动时是否蓄力充能。默认值为false。
    • max_draw_duration 数据类型图标max_draw_duration：拉动最长时间。应小于等于minecraft:use_modifiers或minecraft:use_duration组件定义的使用时长，默认值为0。
    • scale_power_by_draw_duration 数据类型图标scale_power_by_draw_duration：是否随着拉动时间的增长而增加对应子弹（弹射物）发射时威力，默认值为false。

minecraft:should_despawn​

国际版 1.20.20+

定义该物品对应的掉落物是否会在一段时间后消失。

对象型：

  • minecraft:should_despawn 数据类型图标minecraft:should_despawn：根对象。
    • value 数据类型图标value：掉落物是否会在一段时间后消失，默认为true。

布尔型：

  • minecraft:should_despawn 数据类型图标minecraft:should_despawn：掉落物是否会在一段时间后消失，默认为true。

minecraft:storage_item​

国际版 1.21.40+

定义该物品为可存储物品，可以存储其他物品，类似于收纳袋。

注意

要使用该组件，必须先定义minecraft:max_stack_size组件，并将其值设为1，否则该组件可能无法正常工作。

  • minecraft:storage_item 数据类型图标minecraft:storage_item：根对象。
    • allow_nested_storage_items 数据类型图标allow_nested_storage_items：是否允许该类物品嵌套存储，例如收纳袋存储收纳袋。
    • allowed_items 数据类型图标allowed_items：允许存储的物品，不在此列名单中的物品无法存储。若设置为空则允许存储一切物品。
      • undefined 数据类型图标：允许存储的物品 ID。
    • banned_items 数据类型图标banned_items：禁止存储的物品，在此列名单中的物品无法存储。
      • undefined 数据类型图标：允许存储的物品 ID。
    • max_slots 数据类型图标max_slots：该物品的最大容量。注：仅限格式版本1.21.40-1.21.50下可用，1.21.60或更高格式版本请使用minecraft:storage_weight_limit组件。
    • max_weight_limit 数据类型图标max_weight_limit：该物品在其他可存储物品中占用的容量。注：仅限格式版本1.21.40-1.21.50下可用，1.21.60或更高格式版本请使用minecraft:storage_weight_modifier组件。

minecraft:storage_weight_limit​

国际版 1.21.60+

定义该可存储物品最多可以存储多少物品。

注意

要使用该组件，必须先定义minecraft:storage_item组件。

  • minecraft:storage_weight_limit 数据类型图标minecraft:storage_weight_limit：根对象。
    • max_weight_limit 数据类型图标max_weight_limit：定义该可存储物品（类似于收纳袋）的最大空间。必须在0-64之间，默认为64。

minecraft:storage_weight_modifier​

国际版 1.21.60+

定义该物品在存储到一个可存储物品时需要占用多大空间。

  • minecraft:storage_weight_modifier 数据类型图标minecraft:storage_weight_modifier：根对象。
    • weight_in_storage_item 数据类型图标weight_in_storage_item：定义该物品在存储到一个可存储物品（类似于收纳袋）时需要占用多大空间。默认为4，若为0则代表该物品无法存储到其他可存储物品中。

minecraft:tags​

国际版 1.20.50+ 中国版

定义物品标签。

  • minecraft:tags 数据类型图标minecraft:tags：根对象。
    • tags 数据类型图标tags：物品的标签列表。
      • undefined 数据类型图标：物品标签。

一些原版使用的标签具有实质作用。下表为对这些标签的列举，原版还有大量正在使用的标签，读者可在Bedrock Wiki中查看更多相关信息。

标签功能
minecraft:bookshelf_books标记该物品可存储于雕纹书架内。
minecraft:decorated_pot_sherds标记该物品为饰纹陶罐的合成原材料。
minecraft:planks标记该物品为一种木板材料。
minecraft:stone_crafting_materials标记该物品为一种圆石材料，可用于合成熔炉等。
minecraft:stone_tool_materials标记该物品为一种圆石材料，可用于合成石制工具。
minecraft:trimmable_armors标记物品为一种盔甲纹饰。
minecraft:vibration_damper标记物品在使用时不发生振动。
minecraft:wool标记该物品为一种羊毛材料。

minecraft:throwable​

国际版 1.20.10+

定义该物品可掷出，类似于雪球或鸡蛋。

注意

要使用该组件，必须先定义minecraft:projectile组件。

  • minecraft:throwable 数据类型图标minecraft:throwable：根对象。
    • do_swing_animation 数据类型图标do_swing_animation：物品掷出后是否播放摆手动画。
    • launch_power_scale 数据类型图标launch_power_scale：随着蓄力时间增长而增加的弹射物威力比例。默认值为1.0（即蓄力时间增长，弹射物威力不增加）。设置负值将导致弹射物以反方向掷出。
    • max_draw_duration 数据类型图标max_draw_duration：最长蓄力时间，单位秒。默认为0.0。
    • min_draw_duration 数据类型图标min_draw_duration：最段蓄力时间，单位秒。默认为0.0。
    • max_launch_power 数据类型图标max_launch_power：弹射物的最大威力（以保证弹射物的威力不会无限增大）。
    • scale_power_by_draw_duration 数据类型图标scale_power_by_draw_duration：是否随着蓄力时间的增长而增加弹射物掷出时的威力，默认值为false。

minecraft:use_animation​

国际版 1.20.20+

定义物品的使用动画。

对象型：

  • minecraft:use_animation 数据类型图标minecraft:use_animation：根对象。
    • value 数据类型图标value：使用物品时播放的动画，可选值为eat、drink、bow、block、camera、crossbow、none、brush、spear、spyglass，不使用该组件时则不播放动画。

字符串型：

  • minecraft:use_animation 数据类型图标minecraft:use_animation：使用物品时播放的动画，可选值为eat、drink、bow、block、camera、crossbow、none、brush、spear、spyglass，不使用该组件时则不播放动画。

minecraft:use_duration​

国际版 1.20.20 - 1.20.40+

定义该物品的使用时长。

注意

要使用该组件，必须同时定义下列组件中的 1 个：

  • minecraft:use_duration 数据类型图标minecraft:use_duration：该物品的使用时长。单位为秒，默认值为1.6。

minecraft:use_modifiers​

国际版 1.20.50+

定义该物品的使用时长。

注意

要使用该组件，必须同时定义下列组件中的 1 个：

  • minecraft:use_modifiers 数据类型图标minecraft:use_modifiers：根对象。
    • use_duration 数据类型图标use_duration*：使用时长。例如苹果的该值为1.6。
    • movement_modifier 数据类型图标movement_modifier：定义玩家使用物品时的速度倍率，必须小于等于1。例如苹果的该值为0.35。

minecraft:wearable​

国际版 1.20.20+

定义该物品为可穿戴物品，例如盔甲。

  • minecraft:wearable 数据类型图标minecraft:wearable：根对象。
    • slot 数据类型图标slot*：定义可穿戴的位置。可选值：slot.weapon.offhand、slot.armor.head、slot.armor.chest、slot.armor.legs、slot.armor.feet。
    • protection 数据类型图标protection：物品可提供的护甲值。默认为0。
    • hides_player_location 数据类型图标hides_player_location：穿戴后是否在定位栏中隐藏玩家位置。仅限1.21.90或更高格式版本可用。

旧版本组件​

本部分为 1.16.X 或以前的物品格式版本可用的组件。其中，下述几乎所有物品组件都有新版本的平替。读者可以在这里的旧版文档中查看这些组件接受的参数。

备注：minecraft:food的新版本平替组件无法完全平替旧版功能，需要脚本补充其功能。

旧版本组件新版本可用的平替组件新版本组件需求的最低格式版本
minecraft:blockminecraft:block_placer1.20.10
minecraft:foilminecraft:glint1.20.20
minecraft:foodminecraft:food1.20.30
minecraft:hand_equippedminecraft:hand_equipped1.20.20
minecraft:hover_text_color（RP）minecraft:hover_text_color1.20.10
minecraft:icon（RP）minecraft:icon1.20.0
minecraft:max_damageminecraft:durability1.20.0
minecraft:max_stack_sizeminecraft:max_stack_size1.20.20
minecraft:seedminecraft:block_placer1.20.10
minecraft:stacked_by_dataminecraft:stacked_by_data1.20.20
minecraft:use_animation（RP）minecraft:use_animation1.20.20
minecraft:use_durationminecraft:use_modifiers1.20.50

minecraft:block​

国际版 旧版

定义物品可以放置为方块。

  • minecraft:block 数据类型图标minecraft:block：将放置为何种方块。

minecraft:foil​

国际版 旧版 中国版

定义该物品会像附魔书一样产生附魔光泽。

  • minecraft:foil 数据类型图标minecraft:foil：物品是否有附魔光泽，默认为false。

minecraft:food​

国际版 旧版 中国版

定义物品为食物。

注意

要使用该组件，必须同时定义minecraft:use_duration组件。

  • minecraft:food 数据类型图标minecraft:food：根对象。
    • nutrition 数据类型图标nutrition：食物回复的饥饿值。
    • saturation_modifier 数据类型图标saturation_modifier：食物回复的饱和度等级。回复的饱和度将为饥饿值×饱和度系数×2。可选值及其对应饱和度系数如下表：
      可选值poorlownormalgoodmaxsupernatural
      饱和度系数0.10.30.60.81.01.2
    • using_converts_to 数据类型图标using_converts_to：食物在食用完毕后将转化为的物品。应填写为物品 ID。
    • on_use_action 数据类型图标on_use_action：食物在食用完毕后的行为。可选值：chrous_teleport、suspicious_stew_effect、none，默认为none。
    • on_use_range 数据类型图标on_use_range：食物在食用完毕后的影响范围。仅在on_use_action指定为chrous_teleport时有意义，代表随机传送的范围。
      • undefined 数据类型图标0：X 轴偏移，默认值为0.0。
      • undefined 数据类型图标1：Y 轴偏移，默认值为0.0。
      • undefined 数据类型图标2：Z 轴偏移，默认值为0.0。
    • cooldown_type 数据类型图标cooldown_type：食物在使用后进入的冷却类型，共享同种冷却类型的物品将会一起进入冷却阶段。
    • cooldown_time 数据类型图标cooldown_time：食物在使用后进入的冷却时间，单位为游戏刻，共享同种冷却类型的物品将会一起进入冷却阶段。
    • can_always_eat 数据类型图标can_always_eat：食物是否在任何情况下都可食用，否则仅当玩家的饥饿值不满时才可食用。
    • effect 数据类型图标effect：食物在食用后提供的状态效果。
      • undefined 数据类型图标：状态效果信息。
        • name 数据类型图标name：提供的状态效果 ID。
        • chance 数据类型图标chance：有多大的几率提供这个状态效果。应在0.0-1.0之间（含）。不同状态效果间，该值是独立判断的。
        • duration 数据类型图标duration：提供的状态效果时长，单位秒（即使是瞬时状态效果）。
        • amplifier 数据类型图标amplifier：提供的状态效果放大倍数，提供的等级为放大倍数 + 1。
    • remove_effects 数据类型图标remove_effects：食物在食用后解除的状态效果。
      • undefined 数据类型图标：解除的状态效果 ID。

minecraft:hand_equipped​

国际版 旧版 中国版

定义该物品像工具一样直立展示在玩家手中。

  • minecraft:hand_equipped 数据类型图标minecraft:hand_equipped：是否在手中像工具一样展示物品，默认为false。

minecraft:hover_text_color​

国际版 旧版 RP 中国版 RP

定义物品悬浮文本的颜色。

  • minecraft:hover_text_color 数据类型图标minecraft:hover_text_color：设置物品的悬浮文本颜色。可选值为格式化代码对应的名称，详见中文 Minecraft Wiki 对应的名称一列。

minecraft:icon​

国际版 旧版 RP 中国版

定义物品的图标。

重要组件

对于任何自定义物品，都必须定义该组件。否则，物品将无法正确展示贴图。

  • minecraft:icon 数据类型图标minecraft:icon*：该物品的默认贴图。Minecraft 将会试图找到在资源包中定义的textures/item_texture.json的短 ID。详见贴图文件格式。

minecraft:max_damage​

国际版 旧版 中国版

定义物品的耐久度。

  • minecraft:max_damage 数据类型图标minecraft:max_damage：该物品的耐久度。应在0-32767之间（含）。

minecraft:max_stack_size​

国际版 旧版 中国版

定义物品的最大堆叠数。

  • minecraft:max_stack_size 数据类型图标minecraft:max_stack_size：物品的最大堆叠数，默认为64。

minecraft:seed​

国际版 旧版 中国版

定义物品为种子。

  • minecraft:seed 数据类型图标minecraft:seed：根对象。
    • crop_result 数据类型图标crop_result：种植后放置的方块。
    • plant_at 数据类型图标plant_at：可被种植的方块列表。
      • undefined 数据类型图标：方块 ID。

minecraft:stacked_by_data​

国际版 旧版 中国版

定义是否允许不同数据值的同种物品堆叠。

  • minecraft:stacked_by_data 数据类型图标minecraft:stacked_by_data：是否允许不同数据值的物品或掉落物堆叠，默认为false。

minecraft:use_animation​

国际版 旧版 RP 中国版 RP

定义物品的使用动画。

  • minecraft:use_animation 数据类型图标minecraft:use_animation：使用物品时播放的动画，可选值为eat、drink、bow、block、camera、crossbow、none、brush、spear、spyglass，不使用该组件时则不播放动画。

minecraft:use_duration​

国际版 旧版 中国版

定义该物品的使用时长。

注意

要使用该组件，必须同时定义minecraft:food组件。

  • minecraft:use_duration 数据类型图标minecraft:use_duration：该物品的使用时长。单位为游戏刻，默认值为32。

中国版组件​

仅中国版可用的组件。其中，下述部分物品组件有国际版组件的平替，或组件的部分功能有国际版组件的平替。

中国版组件国际版可用的平替组件国际版组件需求的最低格式版本
netease:allow_offhandminecraft:allow_off_hand1.20.20
netease:armorminecraft:wearable、minecraft:enchantable（可平替部分功能）1.20.30
netease:compostableminecraft:compostable1.21.60（中国版版本低）
netease:cooldownminecraft:cooldown1.20.10
netease:eggminecraft:entity_placer1.20.0
netease:fire_resistanceminecraft:fire_resistance1.21.110（中国版版本低）
netease:fuelminecraft:fuel1.20.0
netease:projectileminecraft:projectile1.20.10
netease:weaponminecraft:damage、minecraft:enchantable、minecraft:digger（可平替部分功能）1.20.30

netease:allow_offhand​

中国版

允许玩家将物品放在副手。

注意

使用该组件的物品，在放到副手后可能无法支持minecraft:foil、netease:render_offsets等组件。

  • netease:allow_offhand 数据类型图标netease:allow_offhand：根对象。
    • value 数据类型图标value*：是否能将物品放在副手。

netease:armor​

中国版

定义物品为盔甲。

  • netease:armor 数据类型图标netease:armor：根对象。
    • defense 数据类型图标defense：定义盔甲的防御值。默认值为0。
    • enchantment 数据类型图标enchantment：定义盔甲的附魔能力。默认值为0。
    • armor_slot 数据类型图标armor_slot*：定义盔甲槽位。可选值为0（头盔）、1（胸甲）、2（护腿）、3（靴子）。
    • toughness 数据类型图标toughness：定义盔甲韧性，应在0-20之间（含）。默认值为0。
    • knockback_resistance 数据类型图标knockback_resistance：定义盔甲的击退抗性，应在0-1之间（含）。默认值为0.0。

netease:bucket​

中国版

定义该物品为桶。

注意

要使用该组件，需在物品描述中将custom_item_type设置为bucket。

  • netease:bucket 数据类型图标netease:bucket：根对象。
    • fill_liquid 数据类型图标fill_liquid*：定义使用时倒出的流体方块 ID。默认值为flowing_water。

netease:compostable​

中国版

定义物品可在堆肥桶中用于堆肥。

  • netease:compostable 数据类型图标netease:compostable：有百分之多少的概率会堆肥成功。例如设置为 50 时则有 50% 的概率堆肥成功。

netease:cooldown​

中国版

定义物品使用后的冷却。

注意

定义了食物组件minecraft:food的物品，其冷却需在食物组件中定义。

  • netease:cooldown 数据类型图标netease:cooldown：根对象。
    • category 数据类型图标category：冷却类型，共享同种冷却类型的物品将会一起进入冷却阶段。默认值为item。
    • duration 数据类型图标duration：冷却时间，单位为游戏刻。

netease:customtips​

中国版

定义物品的描述信息。

  • netease:customtips 数据类型图标netease:customtips：根对象。
    • value 数据类型图标value*：物品的描述信息。

netease:egg​

中国版

定义物品可生成实体。

  • netease:egg 数据类型图标netease:egg：根对象。
    • entity 数据类型图标entity*：生成的实体的 ID。

netease:enchant_material​

中国版

定义物品为附魔材料，类似于青金石。

  • netease:enchantment_material 数据类型图标netease:enchantment_material：根对象。
    • value 数据类型图标value*：物品是否为附魔材料。

netease:fire_resistant​

中国版

定义物品防火，类似于下界合金物品。

  • netease:fire_resistant 数据类型图标netease:fire_resistant：根对象。
    • value 数据类型图标value*：物品是否防火。

netease:frame_anim_in_scene​

中国版 RP

定义物品的序列帧。

  • netease:weapon 数据类型图标netease:weapon：根对象。
    • flipbook_texture 数据类型图标flipbook_texture*：序列帧资源的路径。
    • atlas_tile 数据类型图标atlas_tile*：在图集中声明的名称。
    • ticks_per_frame 数据类型图标ticks_per_frame*：代表多少帧切换一次贴图，按 1 秒 20 帧算，设置 20 的话即为 1 秒切换一帧贴图。
    • blend_frames 数据类型图标blend_frames：切换贴图的时候是否混合上一帧。

netease:frame_animation​

中国版 RP

定义蓄力物品的序列帧。

  • netease:weapon 数据类型图标netease:weapon：根对象。
    • texture_name 数据类型图标texture_name*：item_texture.json中定义的序列帧数组。
    • frame_count 数据类型图标frame_count：定义序列帧帧数。默认值为1。
    • animate_in_toolbar 数据类型图标animate_in_toolbar：在物品栏中是否支持动画。默认值为true。

netease:fuel​

中国版

定义该物品为燃料。

  • netease:fuel 数据类型图标netease:fuel：根对象。
    • duration 数据类型图标duration：定义燃料在熔炉中的燃烧时长，单位秒。

netease:initial_user_data​

中国版

定义物品的初始属性。

  • netease:initial_user_data 数据类型图标netease:initial_user_data：根对象。
    • display 数据类型图标display：物品的显示信息。
      • Name 数据类型图标Name（注意大写）：物品的初始名称。
      • Lore 数据类型图标Lore（注意大写）：物品的描述信息。
        • undefined 数据类型图标：物品描述。第 i 个元素代表第 i 行描述。
      • ShowInHand 数据类型图标ShowInHand（注意大写）：手持是否显示物品。
    • ench 数据类型图标ench：物品的附魔信息列表。
      • undefined 数据类型图标：附魔信息。
        • id 数据类型图标id*：附魔 ID。
          • __type__ 数据类型图标__type__：下面的__value__值的类型，1代表字节型（Byte），2代表短整型（short）。
          • __value__ 数据类型图标__value__：附魔 ID 对应的数字 ID。若为自定义附魔，则需将该值设为255并设置modEnchant。
          • modEnchant 数据类型图标modEnchant：仅当__value__为255时有意义，指定设置的附魔 ID。
        • lvl 数据类型图标lvl*：附魔等级。
          • __type__ 数据类型图标__type__：下面的__value__值的类型，1代表字节型（Byte），2代表短整型（short）。
          • __value__ 数据类型图标__value__：附魔等级。
    • minecraft:keep_on_death 数据类型图标minecraft:keep_on_death：物品是否在玩家死亡后掉落。默认值为false。
    • minecraft:item_lock 数据类型图标minecraft:item_lock：指定物品锁定。可选值为0（不锁定）、1（无法移动）、2（无法丢弃），默认为0。
    • 其他可用键名及可用值请参考基岩版物品格式 - 中文 Minecraft Wiki。

netease:projectile​

中国版

定义物品为弹射物。

  • netease:projectile 数据类型图标netease:projectile：定义将掷出的弹射物。

netease:render_offsets​

中国版

定义该物品在右手时的渲染偏移。

  • netease:render_offsets 数据类型图标netease:render_offsets：根对象
    • controller_position_adjust 数据类型图标controller_position_adjust：物品位置偏移。
      • undefined 数据类型图标0：X 轴偏移，默认值为0.0。
      • undefined 数据类型图标1：Y 轴偏移，默认值为0.0。
      • undefined 数据类型图标2：Z 轴偏移，默认值为0.0。
    • controller_rotation_adjust 数据类型图标controller_rotation_adjust：物品旋转偏移。
      • undefined 数据类型图标0：X 轴偏移，默认值为0.0。
      • undefined 数据类型图标1：Y 轴偏移，默认值为0.0。
      • undefined 数据类型图标2：Z 轴偏移，默认值为0.0。
    • controller_scale 数据类型图标controller_scale：物品大小。默认值为1.0。

netease:shield​

中国版

定义该物品为盾。

注意

要使用该组件，需在物品描述中将custom_item_type设置为shield。

  • netease:shield 数据类型图标netease:shield：根对象
    • defence_damage_source_list 数据类型图标defence_damage_source_list：防御的伤害类型。为空时默认设置为原版的格挡伤害逻辑。
      • undefined 数据类型图标：伤害类型。可见/damage命令的可用伤害类型。
    • undefence_damage_source_list 数据类型图标undefence_damage_source_list：不防御的伤害类型。不宜和defence_damage_source_list存在相同元素。
      • undefined 数据类型图标：伤害类型。可见/damage命令的可用伤害类型。
    • is_consume_damage 数据类型图标is_consume_damage：是否消耗物品的耐久度。

netease:show_in_hand​

中国版

手持时是否显示该物品。

  • netease:show_in_hand 数据类型图标netease:show_in_hand：根对象
    • value 数据类型图标value*：手持时是否显示该物品。

netease:weapon​

中国版

定义该物品为武器。

注意

要使用该组件，需在物品描述中将custom_item_type设置为weapon。

  • netease:weapon 数据类型图标netease:weapon：根对象
    • type 数据类型图标type*：武器或工具类型，可选值："sword"、"shovel"、"pickaxe"、"hatchet"（斧头）、"hoe"。
    • level 数据类型图标level*：武器或工具的挖掘等级，可选值：0（木制或金制工具）、1（石制工具）、2（铁制工具）、3（钻制工具）。详见网易提供的官方文档。
    • speed 数据类型图标speed：武器或工具挖掘方块的基础速度。默认值为0。
    • attack_damage 数据类型图标attack_damage：武器或工具的攻击伤害。默认值为0。
    • enchantment 数据类型图标enchantment：武器或工具的附魔能力。默认值为0。

参考文档​

本文主要参考文档如下，读者可以在这些文档获得更多信息。

Footnotes​

  1. 该组件于 1.21.110.25 加入，然而更新日志中并未提到该组件的参数信息，需要验证。 ↩