[BE教程]附加包教程：7.物品（二）

| 普通组件allow_off_hand 允许副手组件：使物品可以被放在副手。"minecraft:allow_off_hand": true复制代码字段功能描述类型minecraft:allow_off_hand是否允许物品被放在副手。布尔值block_placer 放置方块组件：使物品可以被放置为方块。需要格式版本：1.20.10+"minecraft:block_placer": { "block": "bedrock", "use_on": [ "dirt", //泥土 "grass" //草方块 ], "replace_block_item": false}复制代码字段功能描述类型block要放置的方块ID，不能是隐藏方块（如下界反应核），否则放置时游戏崩溃。可以填写方块描述符。字符串或方块描述符use_on仅允许在某些方块上放置，留空表示允许全部方块。字符串列表或方块描述符列表replace_block_item替换被放置方块的物品形态。设为true时，物品的ID必须与被放置方块的ID一致。布尔值旧名称：相同

版本：~1.16.100

旧语法：

"minecraft:block_placer": {

"block": "bedrock", //要放置的方块ID。

"use_on": [ //指定允许在哪些方块上放置。

"dirt", //泥土

"grass" //草方块

],

"use_block_description": true

}

旧名称：minecraft:seed

版本：≤1.10

旧语法：

"minecraft:seed": {

"crop_result": "cave_vines", //种植的作物ID（放置的方块ID）

"plant_at": [ //可以种植（放置）在...方块上

"cave_vines", //洞穴藤蔓

"cave_vines_head_with_berries" //带果实的洞穴藤蔓头

],

"plant_at_any_solid_surface": true, //可以种植（放置）在任何固体表面上

"plant_at_face": "DOWN" //种植（放置）的方块面，这里是方块的下方

}bundle_interaction 收纳交互组件：指定物品有收纳袋的 UI 和交互。需要格式版本：1.21.40+

必须与 minecraft:storage_item 一起用。"minecraft:bundle_interaction": { "num_viewable_slots": 64}复制代码字段功能描述类型num_viewable_slots物品太多时显示多少种物品，范围是 1 到 64。整数

注：收纳袋有分层纹理，让交互时的物品看起来真的在收纳袋里面。这个特性使用两个纹理，需要在物品的图标组件中通过 bundle_open_back 字段和 bundle_open_front 字段指定对应的纹理短名。can_destroy_in_creative 禁用破坏组件：指定拿着物品时是否允许在创造模式下破坏方块。"minecraft:can_destroy_in_creative": true复制代码字段功能描述类型minecraft:can_destroy_in_creative把这个物品拿在手上而且处于创造模式时，可不可以破坏方块。布尔值compostable 堆肥组件：使物品可以堆肥并指定堆肥概率。需要格式版本：1.21.60+"minecraft:compostable": { "composting_chance": 50}复制代码字段功能描述类型composting_chance物品转变为一层肥料的概率，范围是[1, 100]。50 表示 50% 的概率。整数cooldown 冷却组件：使物品使用后需要冷却一段时间才能继续使用。需要格式版本：1.20.10+"minecraft:cooldown": { "category": "custom_cooldown_type", "duration": 0.2}复制代码字段功能描述类型category冷却类型。尝试使用不存在的冷却类型时，会注册为新的冷却类型。冷却类型一致的物品共享冷却时间。字符串duration冷却时间，单位是秒。设为负数会让物品图标覆盖上冷却层。浮点数custom_components 自定义组件：使用由脚本定义的自定义物品组件。需要格式版本：1.21.10 - 1.21.70。

在 1.21.80 及以上的版本中，开启“自定义组件 V2”实验性玩法或功能正式实装后，由于自定义组件的扁平化，此组件被弃用。"minecraft:custom_components": [ "complementary:fish_effect", "complementary:apple_effect"]复制代码字段功能描述类型minecraft:custom_components一个或多个自定义组件的名称，自定义组件的触发器将按照顺序被触发。字符串列表damage 伤害组件：指定物品造成的额外伤害。"minecraft:damage": 6复制代码字段功能描述类型minecraft:damage武器造成的伤害，必须是正整数。由于溢出，有可能造成负值。整数damage_absorption 伤害吸收组件：使物品被穿戴时，将外界伤害转化为耐久度消耗。"minecraft:damage_absorption": { "absorbable_causes": [ "entity_attack", "lava" ]}复制代码字段功能描述类型absorbable_causes可吸收伤害的类型。字符串列表注：需要首先指定耐久度组件。digger 挖掘组件：使物品能加速挖掘方块。"minecraft:digger": { "use_efficiency": false, "destroy_speeds": [ "dirt", // 方块 ID { "block": "minecraft:nether_wart_block", "speed": 5 }, { "block": { "tags": "q.any_tag('wood', 'pumpkin', 'plant')" }, "speed": 4 } ]}复制代码字段功能描述类型use_efficiency是否使用效率魔咒。布尔值destroy_speeds加速挖掘的方块。字符串列表或对象列表destroy_speeds/*一个方块和它的挖掘速度。字符串列表或对象列表destroy_speeds/*/block加速挖掘的方块。字符串或方块描述符destroy_speeds/*/speed挖掘的速度。设为0或负值会使物品无法挖掘此方块。整数以下是原版工具的挖掘速度。值描述0无法挖掘2木工具挖掘速度3石工具挖掘速度4铁工具挖掘速度6钻石工具挖掘速度7下界合金工具挖掘速度8金工具挖掘速度display_name 名称组件：设置物品名称。需要格式版本：1.20.0+"minecraft:display_name": "名称"复制代码字段功能描述类型minecraft:display_name物品名称，可以指定本地化键名。字符串优先翻译提供的字符串，无法翻译时显示原始字符串。不指定此组件时，游戏将根据物品的格式版本生成一个本地化键名。旧版物品是 item.物品命名空间ID.name，1.16.100 及以上的新版物品是 item.物品命名空间 ID。

可以使用 % 进行部分本地化。从 % 开始，到这一行结束，都会被视为本地化键名（需要测试），而它前面的部分不会被处理。例如：

// 物品定义

"minecraft:display_name": "这里不会被翻译。%item.complementary:test.name\n§d带颜色的文本：%item.complementary:test.desc"

// 语言文件

item.complementary:test.name=物品名称

item.complementary:test.desc=物品描述将显示为

这里不会被翻译。物品名称

§d带颜色的文本：物品描述durability 耐久组件：让物品拥有耐久度，并允许这种物品在工作台和铁砧上合并。需要格式版本：1.20.0+"minecraft:durability": { "damage_chance": { "min": 15, "max": 100 }, "max_durability": 36}复制代码字段功能描述类型max_durability最大耐久值。整数damage_chance掉耐久的概率。对象damage_chance/min掉耐久的概率范围中的最小值，必须在0-100之间，不能大于最大值。整数damage_chance/max掉耐久的概率范围中的最大值，必须在0-100之间，不能小于最小值。整数原版耐久魔咒会影响物品被使用时掉耐久的概率，具体是 damage_chance 乘上下面的对应值。等级值无耐久魔咒1.0Ⅰ0.5Ⅱ0.33Ⅲ0.25旧名称：minecraft:damageable

版本：~1.16.100

旧语法：

"minecraft:damageable": {

"max_damage": 326 //耐久值

}durability_sensor 耐久检测组件：检测耐久值低于某值，并播放声音或显示粒子。"minecraft:durability_sensor": { "durability_thresholds": [ { "durability": 4000, "particle_type": "campfiresmoketall", "sound_event": "ambient" }, { "durability": 1000, "particle_type": "shriek", "sound_event": "add.chest" } ]}复制代码字段功能描述类型durability_thresholds检测阈值。同时触发时，最低阈值的优先级最高。对象列表durability_thresholds/*/durability耐久检测阈值。整数durability_thresholds/*/particle_type旧版粒子 ID。注意，不是 /particle 命令中的ID，而是旧版粒子的 ID。字符串durability_thresholds/*/sound_event声音ID。可填写的值可以参考 minecraft:record 组件的声音字段可用值。字符串dyeable 染色组件：使物品可在炼药锅中染色，并指定基色。"minecraft:dyeable":{ "default_color": "#17714A"}复制代码字段功能描述类型default_color默认染色颜色。可选，如果忽略这个字段，那么物品默认没有染色效果。在装染色水的炼药锅中染色后，纹理会变成 minecraft:icon 组件中 dyed 字段指定的纹理加上炼药锅中水的颜色。字符串注：此组件需要 1.21.30+ 的格式版本。enchantable 附魔组件：使物品可被附魔。"minecraft:enchantable": { "value": 59, "slot": "sword"}复制代码字段功能描述类型value附魔能力，值越高，出好附魔、高等级的概率就越大。实际使用的值在 [0, 255] 范围内。整数slot附魔槽位，也就是物品可附上哪些魔咒。可用值见下。字符串以下是附魔槽位的可用值。字段描述bow弓armor_feet靴子armor_torso胸甲armor_head头盔armor_legs护腿hoe锄axe斧pickaxe镐shovel锹sword剑elytra鞘翅fishing_rod钓鱼竿flintsteel打火石shears剪刀cosmetic_head生物头颅all全部，类似于书以下是原版物品的附魔能力。物品名称或类型能力值木质工具15皮革服装15石质工具5锁链护甲12铁质护甲9铁质工具14金质护甲25金质工具22钻石质装备10海龟壳9下界合金质装备15其他可在附魔台附魔的物品1注：工具指剑、镐、斧、锹和锄，服装指帽子、外套、裤子和靴子，护甲指头盔、胸甲、护腿和靴子，装备指剑、镐、斧、锹、锄、头盔、胸甲、护腿和靴子。entity_placer 放置实体组件：使物品可以放置为实体。需要格式版本：1.20.0+"minecraft:entity_placer": { "entity": "minecraft:cat", "dispense_on": [ { "tags": "q.any_tag('water')" } ], "use_on": [ "dirt" //方块 ID ]}复制代码字段功能描述类型entity要放置的实体ID。字符串use_on仅允许在某些方块上放置，留空表示允许全部方块。字符串列表或方块描述符列表dispense_on仅允许在某些方块上发射，留空表示允许全部方块。字符串列表或方块描述符列表物品格式版本为1.19.80及以上时，此组件会导致物品可设置刷怪笼刷出的实体。fire_resistant 免疫火焰组件：指定物品的掉落物免疫火焰和熔岩伤害。"minecraft:fire_resistant": true复制代码字段功能描述类型minecraft:fire_resistant是否免疫火焰和熔岩伤害，true 为免疫，false 为不免疫，默认值为 false。布尔值food 食物组件：使物品可以被食用。"minecraft:food": { "nutrition": 4, "saturation_modifier": 0.6, "can_always_eat": true, "using_converts_to": "bowl"}复制代码字段功能描述类型nutrition回复的饥饿值，可以是负数。负数即扣除饥饿值。范围是整型的范围。整数saturation_modifier回复的饱和度。必须是正数。计算公式：饥饿值 * 这里的值 * 2 = 饱和度。浮点数can_always_eat是否允许在饥饿值满时食用。布尔值using_converts_to食用后转化为物品的ID。忽略会导致物品直接消失。字符串以下是旧版饱和度字符串与新版本饱和度数值的对应关系。旧版新版poor0.1low0.3normal0.6good0.8max1.0supernatural1.2旧名称：相同

版本：≤1.10

旧语法：

"minecraft:food": {

"saturation_modifier": "normal", // 可以用特定的字符串代替饱和度数字，这个用法直到~1.19才移除。下方列出了所有可填的字符串和对应的饱和度值。

"is_meat": true, // 是否为肉类

"on_use_action": "chorus_teleport", // 食用后的特殊行为。可以填写：chorus_teleport（紫颂果传送效果）、suspicious_stew_effect（谜之炖菜效果）或none（无）。

"on_use_range": [ 8, 8, 8 ], // 用于紫颂果。指定传送的范围，单位是方块。

"cooldown_type": "chorusfruit", // 冷却类型。可以填写：chorusfruit（紫颂果）或 none（无）。

"cooldown_time": 20, // 冷却时间，以刻为单位。

"effects": [ // 食用的效果列表

{ // 一项效果

"name": "regeneration", // 效果的 ID

"chance": 1.0, // 获得这个效果的几率，数值必须在 0.0 和 1.0 之间。

"duration": 30, // 效果持续的时间，单位是秒

"amplifier": 4 // 效果的倍率（倍率 + 1 = 等级）

},

{ // 另一项效果，其中字段含义与上面相同

"name": "fire_resistance",

"chance": 1.0,

"duration": 300,

"amplifier": 0

}

]

}fuel 燃料组件：使物品可以在熔炉等方块里当燃料。需要格式版本：1.20.0+"minecraft:fuel":{ "duration": 3.0}复制代码字段功能描述类型duration燃烧的时间（秒），以0.05为分度值，必须≥0.05。浮点数glint 闪光组件：指定物品是否有带魔咒物品的光效。"minecraft:glint": true复制代码字段功能描述类型minecraft:glint物品是否有魔咒的闪光效果，忽略实际上是否有魔咒。布尔值旧名称：minecraft:foil

版本：≤~1.20

旧语法：

"minecraft:foil": true //物品是否有附魔的闪光。true是有，false是没有。hand_equipped 手持组件：指定物品是否有手持动画。"minecraft:hand_equipped": true复制代码字段功能描述类型minecraft:hand_equipped物品是否有装备在手上的效果（物品竖立，就像握在手中）。布尔值hover_text_color 文本颜色组件：指定物品的悬停文本的颜色。"minecraft:hover_text_color": "material_amethyst"复制代码字段功能描述类型minecraft:hover_text_color物品的悬停文本的颜色。选中这个物品时，它的名字会被这个组件改变颜色。可以填写颜色代码，这里有所有颜色代码。字符串注：此组件在很长一段时间内（~1.16-~1.19）曾不可用，在旧版物品中则需要在资源包文件中指定此组件。icon 图标组件：指定物品纹理。需要格式版本：1.20.10+"minecraft:icon": { "textures": { "default": "custom_chestplate_icon", "dyed": "custom_chestplate_gray_icon", "icon_trim": "test:custom_chestplate", "bundle_open_back": "custom_bundle_back", "bundle_open_front": "custom_bundle_front" }}复制代码字段功能描述类型textures图标纹理合集。对象textures/default默认纹理短名。字符串textures/dyed染色模板的纹理短名，需要一个灰度纹理。字符串textures/icon_trim带纹饰的物品的纹饰层纹理。只能填写物品的命名空间ID，否则似乎没有作用。字符串textures/bundle_open_back物品有收纳袋的功能时，打开的收纳袋的背景层纹理。字符串textures/bundle_open_front物品有收纳袋的功能时，打开的收纳袋的前景层纹理。字符串还可以这么写。"minecraft:icon": "test"复制代码字段功能描述类型minecraft:icon默认纹理短名。字符串旧名称：minecraft:icon

版本：≤约1.20

旧语法：

"minecraft:icon": {

"texture": "custom_chestplate" //指定纹理短名。

}interact_button 交互按钮组件：指定物品的交互按钮及文本。"minecraft:interact_button": "文本"复制代码字段功能描述类型minecraft:interact_button拿着物品时添加一个交互按钮，并设置按钮上的文字为“文本”，可以使用本地化键名。也可以为布尔值，如果设置为true则有默认的“使用物品”提示。字符串或布尔值liquid_clipped 接触水面组件：指定物品是否能接触水面。"minecraft:liquid_clipped": true复制代码字段功能描述类型minecraft:liquid_clipped拿着物品是否能接触水面。主要用于放置船或睡莲。布尔值max_stack_size 最大堆叠组件：指定物品的最大堆叠数。"minecraft:max_stack_size": 1复制代码字段功能描述类型minecraft:max_stack_size最大堆叠数量，正整数，范围是1-64。整数projectile 投掷物组件：定义物品为投掷物。需要格式版本：1.20.10+"minecraft:projectile": { "minimum_critical_power": 1.25, "projectile_entity": "arrow"}复制代码字段功能描述类型minimum_critical_power暴击需要的蓄力大小。浮点数projectile_entity发射的实体 ID，此实体必须有 minecraft:projectile 组件（同名）。字符串有此组件的物品可用于 minecraft:shooter 组件中的弹药，也可以放进发射器里发射。rarity 稀有度组件：指定物品的稀有度。"minecraft:rarity": "common"复制代码字段功能描述类型minecraft:rarity填写物品稀有度，优先级低于 minecraft:hover_text_color。可用的稀有度见下。字符串以下是所有可用的稀有度。值描述common常见uncommon罕见rare稀有epic史诗record 唱片组件：指定物品为唱片。"minecraft:record": { "comparator_signal": 1, "duration": 5, "sound_event": "ambient.tame"}复制代码字段功能描述类型comparator_signal在唱片机中播放时比较器输出的信号强度。默认是 1，可以填写任何数字，但会被钳制到 [1, 15] 的范围。整数duration唱片机持续生成粒子的时间长度，可以是 0。浮点数sound_event要播放的声音，必须填写声音事件 ID 而不是声音 ID，因此无法播放自定义音乐，只能播放原版的声音。如果填写原版唱片使用的声音事件 ID，那么这个物品会有原版唱片的描述（显示它的作者），播放时也会提示与原版唱片相同的内容。字符串这里有声音事件 ID 的列表。repairable 修复组件：使物品可以被修复。需要格式版本：1.20.10+"minecraft:repairable":{ "repair_items": [ "anvil", //可以是单个物品ID。 { //还可以是一个对象。 "items": [ "anvil" //物品ID ], "repair_amount": "math.min(q.remaining_durability + c.other->q.remaining_durability + math.floor(q.max_durability /20), c.other->q.max_durability)" } ]}复制代码字段功能描述类型repair_items可以用于修复的物品。字符串列表或对象列表repair_items/*/items可以用于修复的物品。字符串列表repair_items/*/repair_amount修复的耐久量，填写数值或者 Molang 表达式。c.other 用于访问用于修复的物品。可以使用会生成随机数的 Molang 表达式。整数或字符串shooter 射手组件：使物品可以射出弹射物。需要格式版本：1.20.10+"minecraft:shooter": { "ammunition": [ { "item": "minecraft:arrow", "use_offhand": true, "search_inventory": true, "use_in_creative": true } ], "charge_on_draw": false, "max_draw_duration": 0.0, "scale_power_by_draw_duration": true}复制代码字段功能描述类型scale_power_by_draw_duration是否按照长按的时间增加蓄力力度。布尔值charge_on_draw如果是 true，那么长按并松开后会装填弹药，已经装填弹药后再长按会发射，类似于弩。如果是 false，长按时会蓄力，松开后会发射，类似于弓。布尔值max_draw_duration最大长按蓄力时间。必须小于等于物品的使用时间。浮点数ammunition可用的弹药。对象列表ammunition/*/item弹药物品 ID。可以是自定义物品，但它必须含有 minecraft:projectile 组件。字符串ammunition/*/use_offhand是否可以使用副手的物品。布尔值ammunition/*/search_inventory是否搜索物品栏的物品。布尔值ammunition/*/use_in_creative在创造模式使用时是否消耗物品。布尔值should_despawn 防止刷新组件：指定物品的掉落物形式是否可以被刷新而消失。"minecraft:should_despawn": false复制代码字段功能描述类型minecraft:should_despawn物品的掉落物形式是否可以被刷新掉。布尔值stacked_by_data 数据值堆叠组件：指定物品是否根据数据值堆叠。"minecraft:stacked_by_data": true复制代码字段功能描述类型minecraft:stacked_by_data是否根据物品的数据值堆叠。如果是 true，则有不同数据值的同一物品不能堆叠，而且多个物品实体无法合为一个。如果是 false，则有不同数据值的同一物品可以堆叠，而且多个物品实体会自动合为一个，只要相互接近。布尔值storage_item 收纳组件：指定物品有收纳袋的功能。需要格式版本：1.21.40+

物品必须不可堆叠。"minecraft:storage_item": { "max_slots": 64, "allow_nested_storage_items": true, "banned_items": [ "minecraft:shulker_box", "minecraft:undyed_shulker_box" ], "allowed_items": []}复制代码字段功能描述类型max_slots能存物品的种类数，范围是 1 到 64。整数allow_nested_storage_items是否能嵌套收纳袋。布尔值banned_items禁止放进收纳袋的物品 ID。字符串列表allowed_items允许放进收纳袋的物品 ID，留空表示允许所有物品。字符串列表旧名称：minecraft:item_storage

版本：＜1.21.30.23

旧语法：

"minecraft:item_storage": {

"capacity": 64 //最大容量

}

一个物品占用的容量可用以下公式计算：物品数量 / 最大堆叠数 * 64 = 占用容量。如 53 个火把占用 53 / 64 * 64 = 53 的容量，7 个雪球占用 7 / 16 * 64 = 28 的容量，1 把钻石剑占用 1 / 1 * 64 = 64 的容量。但也有特殊情况，收纳袋占用 4 加上它自身被使用的容量，潜影盒不能放进收纳袋。

基岩版 1.19.70 以后，此组件就被移除了。在此之前，收纳袋的 UI 经过多次更改。请选择 1.19.60 的测试版（如 1.19.60.24）进行使用。

在开发者版本 1.19.80 中，此组件被直接赋值以决定容量（物品格式版本为 1.16.0），但在正式版本这么做会报错。

在开发者版本 1.20.0 中，未装东西的收纳袋纹理被更改了，但它仍然使用此组件，并且可以正常使用。

收纳袋已在 1.21.30.23 加入。storage_weight_limit 最大收纳容量：指定收纳袋类物品的最大收纳容量。物品必须不可堆叠，而且必须有 minecraft:storage_item 组件。"minecraft:storage_weight_limit": { "max_weight_limit": 64}复制代码字段功能描述类型max_weight_limit收纳袋的最大容量，填写正整数，不能超过 64。容量公式：物品数量 / 最大堆叠数 * 64整数storage_weight_modifier 占用容量修饰符：指定物品在收纳袋类容器中占用的容量。"minecraft:storage_weight_modifier": { "weight_in_storage_item": 4}复制代码字段功能描述类型weight_in_storage_item物品本身占用的容量，范围是 0 到 64。0 表示不能放进其他收纳袋里。整数tags 标签组件：指定物品的标签。这个组件取代了以前的 "tag:xxx": {} 。"minecraft:tags": { "tags": [ "minecraft:is_food" ]}复制代码字段功能描述类型tags物品拥有的标签，标签可以带命名空间，也可以不带。字符串列表

大部分标签没有现成的用途，但有些标签被游戏赋予了内置功能。下面我会列出这些功能。字段描述minecraft:is_sword剑minecraft:is_pickaxe镐minecraft:is_axe斧，可以给原木去皮minecraft:is_shovel锹，可以制造草径minecraft:is_hoe锄，可以制造耕地minecraft:is_shears剪刀minecraft:is_food食物minecraft:is_meat肉类食物minecraft:is_crop作物minecraft:transform_materials可以放进锻造台里升级装备的材料。实际上只有下界合金锭被允许，其他添加了这个标签的物品作为升级材料会导致内容错误。minecraft:transformable_items可以被放进锻造台里升级的装备。minecraft:transform_templates可以被放进锻造台里升级装备的模板。minecraft:trim_materials可以被放进锻造台里纹饰的材料。minecraft:trimmable_armors可以被放进锻造台里纹饰的盔甲。minecraft:trim_templates可以被放进锻造台里纹饰的模板。minecraft:bookshelf_books使物品可以被放进雕纹书架里。minecraft:decorated_pot_sherds可以被合成为饰纹陶罐，需要修改客户端实体文件来注册这个物品的陶罐纹理。minecraft:lectern_books使物品可以被放到讲台上，打开后显示一本空书的界面。minecraft:stone_tool_materials使物品合成石质工具时可以代替圆石使用。

此外，给物品添加标签可以让物品参与使用标签作为输入的配方。throwable 投掷组件：使物品可以被投掷。需要格式版本：1.20.10+

需要 minecraft:projectile 组件以指定要投掷的实体。"minecraft:throwable": { "do_swing_animation": false, "launch_power_scale": 1.0, "max_draw_duration": 0.0, "min_draw_duration": 0.0, "max_launch_power": 1.0, "scale_power_by_draw_duration": false}复制代码字段功能描述类型do_swing_animation投掷时是否有动画。布尔值launch_power_scale蓄力增加的程度。可以是任何数字，如果是负数，那么投掷物向反方向发射。浮点数max_draw_duration最大长按蓄力时间。设为小于等于 0 的值会导致立即发射。浮点数min_draw_duration最小长按蓄力时间，长按时间小于这个会导致投掷不出去。设为小于等于 0 的值会导致立即发射。浮点数max_launch_power能蓄的最大力量，可以是负数。浮点数scale_power_by_draw_duration是否按照长按的时间增加蓄力力度。布尔值旧名称：minecraft:throwable

版本：~1.21

旧语法：

"minecraft:throwable": {

"do_swing_animation": false,

"launch_power_scale": 1.0,

"max_draw_duration": 0.0,

"max_launch_power": 1.0,

"min_draw_duration": 0.0,

"scale_power_by_draw_duration": false,

"default_offset_scale": 0.8, //（风弹）偏移比例。

"inside_block_offset_scale": 0.05 //（风弹）方块内偏移比例。

}use_animation 使用动画组件：指定物品的使用动画和音效。"minecraft:use_animation": "eat"复制代码字段功能描述类型minecraft:use_animation使用时的动画和音效。所有可用值见下。字符串以下是所有可用值和它们的解释，带 * 表示需要特定附着物。值描述eat食用食物drink饮用液体bow拉弓*crossbow拉弩*camera相机拍照spyglass望远镜*spear三叉戟*brush刷扫block举盾*none无动画use_modifiers 使用修饰符组件：指定物品使用的效果。"minecraft:use_modifiers": { "use_duration": 1.6, "movement_modifier": 0.35}复制代码字段功能描述类型use_duration使用这个物品需要的时长。浮点数movement_modifier使用这个物品时的速度修饰符。可选，必须在 [0.0, 1.0] 之间。浮点数旧名称：minecraft:use_duration

版本：≤1.20.40

旧语法：

"minecraft:use_duration": 1.1 // 使用时间。物品格式版本为 1.16.100 前，单位是刻（1 刻等于 0.05 秒）。物品格式版本为 1.16.100 及以后，单位是秒。

旧名称：minecraft:chargeable

版本：≤1.20.40

旧语法：

"minecraft:chargeable":{

"movement_modifier": 0.0, // 使用这个物品时的速度修饰符，修改这个可以实现类似于拉弓时行走缓慢的效果。吃东西时的修饰符是 0.35。

"on_complete": { // 使用完触发的事件

"event": "test", // 事件名称

"target": "self"

}

}wearable 穿戴组件：让物品可以被穿戴，并提供护甲值。"minecraft:wearable":{ "protection": 5, "slot": "slot.armor.chest"}复制代码字段功能描述类型protection保护的程度。这个数值越高，盔甲的效果越好，必须是正整数或 0。整数slot可以穿戴在哪里。指定为盔甲槽时，物品的最大堆叠数会被设为 1。所有可用槽位见下。字符串以下是所有可用的槽位。槽位值描述slot.weapon.offhand副手slot.armor.head头盔slot.armor.chest胸甲slot.armor.legs护腿slot.armor.feet靴子旧名称：minecraft:armor

版本：≤1.20.20

旧语法：

"minecraft:armor": {

"protection": 5, // 保护的程度。这个数值越高，盔甲的效果越好，必须是正整数或 0。

"texture_type": "diamond" // 纹理类型，可以被 q.armor_texture_slot 查询到。

}| 未知状态组件

以下组件未被官方承认，也没有对应文档。它们的功能未知，也可能会被移除，非常不建议使用它们。这些组件的解释可能不准确。

之前有很多这样的组件，但在1.20.50.24版本后它们已经被移除，仅剩下面这两个组件。它并不被游戏认为已经移除，更新日志也没有提到它被移除。Frame Count | 纹理帧数

指定动态物品纹理中，纹理有多少帧。必须填写整数。"minecraft:frame_count": 16复制代码Block | 方块物品

指定物品为方块物品，也就是一个方块对应的物品形式。必须填写字符串，指定对应的方块ID。在1.21.40.23后，其功能可能由minecraft:block_placer中的replace_block_item字段取代。"minecraft:block": "minecraft:diamond_block"复制代码| 已废弃组件和已移除组件

以下组件已被废弃或移除，非常不建议使用已废弃组件，现已无法使用已移除组件。这些组件的解释可能不准确。指定物品为染料。"minecraft:dye_powder": { "color": "red" // 填写颜色字符串，或数字 ID。}或者这么写。"minecraft:dye_powder": 1 // 填写颜色字符串，或数字 ID。复制代码

指定物品的击退抗性。"minecraft:knockback_resistance": 0.5 // 击退抗性值，范围是 0.0 到 1.0。复制代码

忽略权限物品组件。"minecraft:ignores_permission": true // 使用物品时是否忽略权限，填布尔值。复制代码

翻转纹理物品组件。"minecraft:mirrored_art": true // 是否镜像翻转物品纹理，填布尔值。复制代码

快捷栏动画物品组件。"minecraft:animates_in_toolbar": true // 物品是否在快捷栏有动画，填布尔值。复制代码

可被爆炸破坏物品组件。"minecraft:explodable": false // 物品的掉落物形式是否会被爆炸破坏，填布尔值。复制代码

渲染偏移物品组件。"minecraft:render_offsets": false // 指定物品的渲染偏移，填布尔值或对象或字符串。false将禁用渲染偏移，字符串用于引用原版渲染偏移类型。或者这么写。"minecraft:render_offsets": "apple" //指定物品的渲染偏移，填布尔值或对象或字符串。这里引用了原版苹果物品的渲染偏移。或者这么写。"minecraft:render_offsets": { "main_hand": { //物品在主手的渲染偏移。 "first_person": { //第一人称时... "scale": [ //控制物品大小。 0.01, 0.01, 0.01 ] }, "third_person": { //第三人称时... "scale": [ 0.01, 0.01, 0.01 ] } }, "off_hand": { //物品在副手的渲染偏移，格式与上面相同。 "first_person": { "scale": [ 0.01, 0.01, 0.01 ] }, "third_person": { "scale": [ 0.01, 0.01, 0.01 ] } }}复制代码

需要交互物品组件。"minecraft:requires_interact": true // 物品是否需要交互，填布尔值。复制代码

挖掘速度物品组件。"minecraft:mining_speed": 5 // 指定挖掘速度，填正整数。复制代码

武器物品组件。"minecraft:weapon": { // 添加伤害值的提示，并添加一些触发器。 "on_hurt_entity": { // 攻击实体并使其受伤时触发。 "event": "aaa", // 事件名称。 "target": "self" // 触发效果作用的目标。 }, "on_not_hurt_entity": { // 攻击实体但未使其受伤时触发。 "event": "bbb", "target": "other" }, "on_hit_block": { // 挖掘方块时触发。 "event": "ccc", "target": "self" }}复制代码

使用物品触发器组件。"minecraft:on_use": { "on_use": { // 使用（右键或长按）时触发。 "event": "aaa", // 事件名称。 "target": "self" // 触发效果作用的目标。 }}复制代码

使用物品于方块触发器组件。"minecraft:on_use_on": { "on_use_on": { // 使用于方块（右键方块或点击方块）时触发。 "event": "aaa", // 事件名称。 "target": "self" // 触发效果作用的目标。 }}复制代码

肥料物品组件。"minecraft:fertilizer": { "type": "bonemeal" // 指定肥料类型，填 bonemeal（骨粉）或 rapid（超级肥料）。}复制代码

公文包物品组件。"minecraft:portfolio": {} // 指定物品为公文包。复制代码

地图物品组件。"minecraft:map": {} // 指定物品为地图。复制代码

剪刀物品组件。"minecraft:shears": {} // 指定物品为剪刀。复制代码

桶物品组件。"minecraft:bucket": {} // 指定物品为桶。复制代码

图标集物品组件。"minecraft:icon_atlas": {} // 指定物品图标集。复制代码

图标变种物品组件。"minecraft:icon_variant": {} // 指定物品图标变种。复制代码

相机物品组件。"minecraft:camera": { "black_bars_duration": 0.2, // 顶部和底部的黑条持续的时长，单位是秒。 "black_bars_screen_ratio": 0.08, // 黑条与屏幕的比值，也就是黑条的宽度比屏幕的宽度得到的相对值，用于决定黑条的宽度。 "shutter_duration": 0.2, // 快门时长，拍摄一张照片所用的时间间隔，单位是秒。 "picture_duration": 1.0, // 显示照片的时长，拍摄后照片会显示在屏幕上，持续这里指定的值，单位是秒。 "slide_away_duration": 0.2 // 照片移走的时间，显示完的照片要花这个时间从屏幕下方划走，单位是秒。} // 指定物品的相机动画参数。复制代码