索引
| 物品 |
|---|
| 物品组件 |
| 物品定义属性 |
| 物品描述属性 |
物品
要定义一个物品，物品定义必须定义在行为包中的一个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 此物品的冷却类型。类型：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 物品的显示名称。类型：value返回顶部 |
|
| minecraft:durability | JSON 对象 | 一个用于确定一个物品何时因使用而破碎的属性。一个物品的耐久可能会基于损坏机会在使用时被消耗。需要实验性开关：假日创作者功能 damage_chance 损坏机会是该物品失去耐久的百分率机会值。默认设置为100。定义为一个整型或者一个带有最小和最大值的整型范围。类型：damage_chance返回顶部max_durability 最大耐久是该物品在破碎之前所能承受的损坏的数量。Minimum value: 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 包含该物品可以使用在其上的方块的方块描述器列表。如果留空，则将允许所有方块。类型：array of 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。最小值：0.00类型：float返回顶部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 对象 | 存储物品组件 用于存储物品的用户数据中的物品需要实验性开关：假日创作者功能或洞穴与悬崖 内部 （NON_LOC） capacity 物品的最大容量，默认为 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 对象 | on_use_on 物品组件允许您在世界中的方块上使用该物品时接收事件。需要实验性开关：假日创作者功能 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接受的值："slot.weapon.mainhand", "none", "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
指定制作该实体的游戏的版本。如果该版本比当前版本低，则任何对原版版本中的实体做出的变更都将应用到它身上。返回顶部物品描述属性
| 名称 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| category | 字符串 | 该物品的分类。分类可以用于控制该物品是如何被集成进基岩引擎中的一些高级别属性，例如它是否能够在斜杠命令中使用。 | |
| identifier | 字符串 | 该物品的标识符。该名称必须包含一个命名空间，而且除非想要覆写一个原版物品，否则不可以使用minecraft命名空间。 | |
| is_experimental | 布尔值 | false | 如果该物品是实验性的，则它只会在世界被标记为实验性时被引擎注册。 |