Info: Items are experimental and may change in the future.

物品文档
版本：1.18.10.4

索引

物品

要定义一个物品，物品定义必须定义在行为包中的一个JSON文件中。
所有的特性，包括物品名，都必须使用物品组件进行定义。

物品组件

以下是各种物品功能的组件。

名称	类型	描述
minecraft:armor	JSON对象	盔甲物品组件可以确定在你的盔甲物品中你可以具有保护值数量。需要实验性开关：假日创作者功能 protection 该盔甲物品具有多少保护值。最小值：0 类型：integer 回到顶部 texture_type 要为此盔甲应用的纹理类型。注意，若是马铠，其类型需要限制到leather、iron、gold或diamond上。接受的值：“none”、“leather”、“chain”、“iron”、“diamond”、“gold”、“elytra”、“turtle”、“netherite” 回到顶部
minecraft:block_placer	JSON对象	种植器物品组件。种植器物品是可以被种植的物品。需要实验性开关：假日创作者功能 block block：为种植器物品设置放置的方块名。类型：block 回到顶部 use_on 包含该物品可以使用在其上的方块的方块描述器列表。如果留空，则将允许所有方块。类型：use_on的数组回到顶部
minecraft:cooldown	JSON对象	一个冷却时间的组件。在你使用一个物品后，它将由在该组件中的‘冷却时间’设置所指定的时长内变为不可用状态。需要实验性开关：假日创作者功能 category The type of cool down for this item. 类型：category 回到顶部 duration 该物品在变回可用状态之前用于冷却所经历的时间的时长。类型：float 回到顶部
minecraft:digger	JSON对象	挖掘器物品。用于应用在具有挖掘作用的物品上的组件。需要实验性开关：假日创作者功能 destroy_speeds 每方块的破坏速度。类型：destroy_speeds的数组回到顶部 on_dig 当你破坏了一个没有在destroy_speeds中列出的方块时触发的触发器类型：on_dig 回到顶部 use_efficiency 是否可以附魔效率？默认设置为false。类型：boolean 回到顶部
minecraft:display_name	JSON对象	显示名称物品组件。显示名称用于设置一个物品使用中或指针悬停其上时所显示的名称。需要实验性开关：假日创作者功能 value The display name for an item. 类型：value 回到顶部
minecraft:durability	JSON对象	一个用于确定一个物品何时因使用而破碎的属性。一个物品的耐久可能会基于损坏机会在使用时被消耗。需要实验性开关：假日创作者功能 damage_chance 损坏机会是该物品失去耐久的百分率机会值。默认设置为100。定义为一个整型或者一个带有最小和最大值的整型范围。类型：damage_chance 回到顶部 max_durability 最大耐久是该物品在破碎之前所能承受的损坏的数量。最小值：0 类型：integer 回到顶部
minecraft:dye_powder	JSON对象	染料粉，总共存在16种染料。需要实验性开关：假日创作者功能 color 定义该染料是哪种颜色。接受的值：“black”、“red”、“green”、“brown”、“blue”、“purple”、“cyan”、“silver”、“gray”、“pink”、“lime”、“yellow”、“lightblue”、“magenta”、“orange”、“white” 回到顶部
minecraft:entity_placer	JSON对象	实体放置器物品组件。你可以指定该物品被限制到的所允许的方块。。需要实验性开关：假日创作者功能 dispense_on 包含该物品可以被发射器发射在其上的方块的方块描述器列表。如果留空，则将允许所有方块。类型：dispense_on的数组回到顶部 entity 要放置在世界中的实体。类型：entity 回到顶部 use_on 包含该物品可以使用在其上的方块的方块描述器列表。如果留空，则将允许所有方块。类型：use_on的数组回到顶部
minecraft:food	JSON对象	当一个物品具备一个食物组件时，它将对玩家而言变得可食用。需要实验性开关：假日创作者功能 can_always_eat 如果为true，你将使用可以食用该物品（甚至当你并不饥饿时）。默认设置为false。类型：boolean 回到顶部 nutrition 当该物品被使用时，添加到该活动对象的营养上的值。默认设置为0。类型：integer 回到顶部 on_consume 当该物品被消耗时触发的触发器。类型：on_consume 回到顶部 saturation_modifier 当应用饱和增益时，饱和度修饰符将遵循以下公式使用：(nutrition * saturation_modifier * 2)。默认设置为0.6。类型：saturation_modifier 回到顶部 using_converts_to 当被使用时，转换为该字段指定的物品。默认不转换物品。类型：using_converts_to 回到顶部
minecraft:fuel	JSON对象	燃料组件。允许该物品被当做燃料在一个熔炉中使用以‘烹饪’其他物品。需要实验性开关：假日创作者功能 duration 该燃料烹饪物品需要经历多长时间（以秒为单位）。最小值：0.05 类型：float 回到顶部
minecraft:icon	JSON对象	用于确定代表该物品的图标的图标物品组件。需要实验性开关：假日创作者功能 legacy_id 适用于较旧物品图标的旧版纹理字符串ID。旧版ID列表可以在这里的‘Namespaced ID’下找到：https://minecraft.fandom.com/wiki/Bedrock_Edition_data_values 类型：string 回到顶部 texture 包含来自于文件‘resource_pack/textures/item_texture.json’的期望纹理的对象的键名。类型：string 回到顶部
minecraft:item_storage	JSON对象	The Storage Item Component is used for storing Items within an Item's User Data Experimental toggles required: Holiday Creator Features or Caves and Cliffs internal (NON_LOC) capacity The max capacity of the item, default is 64 类型：integer 回到顶部
minecraft:knockback_resistance	JSON对象	击退抗性物品。应用在物品上用于提供击退抗性的的组件。需要实验性开关：假日创作者功能 protection 提供的击退抗性数量，其中全部的最大保护值为1.0。类型：float 回到顶部
minecraft:on_use	JSON对象	on_use物品组件允许你在该物品被使用时接收一个事件。需要实验性开关：假日创作者功能 on_use 当该物品被使用时触发的触发器。类型：on_use 回到顶部
minecraft:on_use_on	JSON对象	The on_use_on item component allows you to receive an event when the item is used on a block in the world. 需要实验性开关：假日创作者功能 on_use_on 当该物品被使用时触发的触发器。类型：on_use_on 回到顶部
minecraft:projectile	JSON对象	弹射物物品组件。弹射物物品可以发射出去，就像一根箭那样。需要实验性开关：假日创作者功能 minimum_critical_power 你必需蓄力一个弹射物多长时间才能使其打出暴击。类型：float 回到顶部 projectile_entity 要作为一个弹射物被发射的实体。类型：projectile_entity 回到顶部
minecraft:render_offsets	JSON对象	渲染偏移量组件：可以给予一个可选的值以偏移该物品的渲染位置。需要实验性开关：假日创作者功能 main_hand 主手变换数据。类型：main_hand 回到顶部 off_hand 副手变换数据。类型：off_hand 回到顶部
minecraft:repairable	JSON对象	可修复物品组件：该物品能够修复多少损坏，什么物品可以修复它。需要实验性开关：假日创作者功能 on_repaired 当该物品被修复时调用的事件。类型：on_repaired 回到顶部 repair_items 修复物品条目。类型：repair_items的数组回到顶部
minecraft:shooter	JSON对象	发射器物品组件。需要实验性开关：假日创作者功能 ammunition 弹药。类型：ammunition的数组回到顶部 charge_on_draw 在装填时是否蓄力？默认设置为false。类型：boolean 回到顶部 launch_power_scale 射出威力缩放值。默认设置为1.0。类型：float 回到顶部 max_draw_duration 装填时长。默认设置为0。类型：max_draw_duration 回到顶部 max_launch_power 射出威力。默认设置为1.0。类型：float 回到顶部 scale_power_by_draw_duration 根据装填时长缩放威力？默认设置为false。类型：boolean 回到顶部
minecraft:throwable	JSON对象	可投掷物品组件。可投掷物品，例如一个雪球。需要实验性开关：假日创作者功能 do_swing_animation 当被投掷出去时，该物品是否应使用挥摆动画。默认设置为false。类型：boolean 回到顶部 launch_power_scale 该投掷的威力将以该缩放值逐次增加。默认设置为1.0。类型：float 回到顶部 max_draw_duration 要装填一个可投掷物品的最大时长。默认设置为0.0。类型：float 回到顶部 max_launch_power 要射出该可投掷物品的最大威力。默认设置为1.0。类型：float 回到顶部 min_draw_duration 要装填该可投掷物品的最小时长。默认设置为0.0。类型：float 回到顶部 scale_power_by_draw_duration 该投掷的威力是否随着蓄力时长增加而增加。默认设置为false。类型：boolean 回到顶部
minecraft:weapon	JSON对象	武器物品组件。用于添加到每一个武器物品上，例如斧、剑、弓、弩。需要实验性开关：假日创作者功能 on_hit_block 用于使你得知何时该物品被用于击中一个方块时的触发器。类型：on_hit_block 回到顶部 on_hurt_entity 用于使你得知何时该物品被用于伤害另一个生物时的触发器。类型：on_hurt_entity 回到顶部 on_not_hurt_entity 用于使你得知何时该物品被用于击中另一个活动对象，但是没有造成伤害时的触发器。类型：on_not_hurt_entity 回到顶部
minecraft:wearable	JSON对象	可穿戴物品组件。需要实验性开关：假日创作者功能 slot equipment_slot：slot.weapon.mainhand、slot.weapon.offhand、slot.armor.head、slot.armor.chest、slot.armor.legs、slot.armor.feet、slot.hotbar、slot.inventory、slot.enderchest、slot.saddle、slot.armor、slot.chest、slot.equippable 接受的值：“none”、“slot.weapon.mainhand”、“slot.weapon.offhand”、“slot.armor.head”、“slot.armor.chest”、“slot.armor.legs”、“slot.armor.feet”、“slot.hotbar”、“slot.inventory”、“slot.enderchest”、“slot.saddle”、“slot.armor”、“slot.chest”、“slot.equippable” 回到顶部

回到顶部

物品定义属性

这些属性是物品定义的一部分。这有助于系统确定如何解析和初始化该物品。

format_version

指定制作该实体的游戏的版本。如果该版本比当前版本低，则任何对原版版本中的实体做出的变更都将应用到它身上。
回到顶部

代码示例

示例

{
  "format_version": "1.16.1",
  "minecraft:item": {
    "description": {
      "identifier": "minecraft:blaze_rod"
    },
    "components": {
      "minecraft:fuel": {
        "duration": 120.0
      },
      "minecraft:max_stack_size": 64,
      "minecraft:icon": {
        "texture": "blaze_rod"
      },
      "minecraft:hand_equipped": true,
      "minecraft:display_name": {
        "value": "Blaze Rod"
      }
    }
  }
}

物品描述属性

名称	类型	默认值	描述
category	字符串		该物品的分类。分类可以用于控制该物品是如何被集成进基岩引擎中的一些高级别属性，例如它是否能够在斜杠命令中使用。
identifier	字符串		该物品的标识符。该名称必须包含一个命名空间，而且除非想要覆写一个原版物品，否则不可以使用minecraft命名空间。
is_experimental	布尔值	false	如果该物品是实验性的，则它只会在世界被标记为实验性时被引擎注册。

回到顶部

网站作者： destruc7i0n

捐助

GitHub

本网站不隶属于Mojang Studios

物品文档 版本：1.18.10.4

索引#

物品#

物品组件#

protection#

texture_type#

block#

use_on#

category#

duration#

destroy_speeds#

on_dig#

use_efficiency#

value#

damage_chance#

max_durability#

color#

dispense_on#

entity#

use_on#

can_always_eat#

nutrition#

on_consume#

saturation_modifier#

using_converts_to#

duration#

legacy_id#

texture#

capacity#

protection#

on_use#

on_use_on#

minimum_critical_power#

projectile_entity#

main_hand#

off_hand#

on_repaired#

repair_items#

ammunition#

charge_on_draw#

launch_power_scale#

max_draw_duration#

max_launch_power#

scale_power_by_draw_duration#

do_swing_animation#

launch_power_scale#

max_draw_duration#

max_launch_power#

min_draw_duration#

scale_power_by_draw_duration#

on_hit_block#

on_hurt_entity#

on_not_hurt_entity#

slot#

物品定义属性#

format_version#

代码示例

物品描述属性#

物品文档
版本：1.18.10.4

索引

物品

物品组件

protection

texture_type

block

use_on

category

duration

destroy_speeds

on_dig

use_efficiency

value

damage_chance

max_durability

color

dispense_on

entity

use_on

can_always_eat

nutrition

on_consume

saturation_modifier

using_converts_to

duration

legacy_id

texture

capacity

protection

on_use

on_use_on

minimum_critical_power

projectile_entity

main_hand

off_hand

on_repaired

repair_items

ammunition

charge_on_draw

launch_power_scale

max_draw_duration

max_launch_power

scale_power_by_draw_duration

do_swing_animation

launch_power_scale

max_draw_duration

max_launch_power

min_draw_duration

scale_power_by_draw_duration

on_hit_block

on_hurt_entity

on_not_hurt_entity

slot

物品定义属性

format_version

物品描述属性