minecraft:allow_off_hand | 布尔值或对象 | 控制物品是否可放入副手槽位。 | 对象形态使用value布尔值。 |
minecraft:block_placer | 对象 | 使物品使用时放置方块。 | 基础放置功能由block指定被放置方块，并可用use_on限制可使用方块；aligned_placement控制长按交互时是否对齐放置。Microsoft Learn说明，replace_block_item等默认方块物品联动能力在1.21.40及“Upcoming Creator Features”下可用；为真时该物品会注册为目标方块的默认物品，且物品标识符必须与方块标识符匹配。 |
minecraft:bundle_interaction | 对象 | 启用收纳袋式交互方案和提示。 | 要求format_version不低于1.21.40；需要同时定义minecraft:storage_item；num_viewable_slots为可见槽位数，范围为1到64，默认值为12。 |
minecraft:can_destroy_in_creative | 布尔值或对象 | 控制创造模式玩家是否能用该物品破坏方块。 | 对象形态使用value布尔值。 |
minecraft:compostable | 对象 | 使物品可用于堆肥桶。 | 要求format_version不低于1.21.60；composting_chance为产生一层堆肥的概率。 |
minecraft:cooldown | 对象 | 为物品动作添加冷却。 | category用于把多个物品归入同一冷却组；duration为冷却秒数；type为触发冷却的动作类型，默认值为use。 |
minecraft:damage | 整数或对象 | 增加物品攻击造成的额外伤害。 | 对象形态使用value整数。该值会加到基础徒手伤害之上。 |
minecraft:damage_absorption | 对象 | 使穿戴中的物品吸收本应作用于穿戴者的伤害。 | 物品需要装备在盔甲槽位，并需要minecraft:durability；absorbable_causes列出可吸收的伤害原因。 |
minecraft:digger | 对象 | 将物品配置为工具，使其更快破坏指定方块。 | destroy_speeds列出方块匹配项和开采速度；use_efficiency为真时效率魔咒会提高开采速度。 |
minecraft:display_name | 对象 | 设置物品显示名。 | value可写直接文本，也可写本地化键。 |
minecraft:durability | 对象 | 设置物品耐久，并允许在铁砧、砂轮或工作台中合并。 | max_durability为最大耐久；damage_chance为损耗耐久的概率范围，默认最小值与最大值均为100。 |
minecraft:durability_sensor | 对象 | 在物品受到耐久损耗并达到阈值时发出效果。 | 需要minecraft:durability；durability_thresholds至少包含1项；当多个阈值同时满足时，只考虑受损后耐久值最低的阈值；sound_event可设置阈值达成音效。 |
minecraft:dyeable | 对象 | 使物品可像皮革盔甲一样在合成网格中染色。 | 要求format_version不低于1.21.30；default_color为未染色时颜色，可写字符串或RGB数组。 |
minecraft:enchantable | 对象 | 定义物品可应用的魔咒槽位和附魔值。 | slot可使用none、all、sword、bow、spear、crossbow、axe、pickaxe、shovel、hoe、shears、shield、fishing_rod、elytra、armor_head、armor_torso、armor_legs、armor_feet等槽位；value为魔咒值，最小为0。 |
minecraft:entity_placer | 对象 | 使物品可在世界中放置实体。 | entity指定被放置实体；use_on限制玩家使用时可放置的方块；dispense_on限制发射器可放置的方块。use_on和dispense_on可以使用字符串或方块描述符对象。 |
minecraft:fire_resistant | 布尔值或对象 | 控制掉落物是否免疫火和熔岩燃烧。 | 对象形态使用value布尔值，默认值为true。 |
minecraft:food | 对象 | 使物品可被玩家食用。 | 需要配合minecraft:use_modifiers才能正常工作；nutrition增加饥饿值；saturation_modifier参与饱和度计算；can_always_eat允许满饥饿时食用；using_converts_to设置食用后转换为的物品；remove_effects已弃用且在较新版本中不再工作。 |
minecraft:fuel | 数值或对象 | 使物品可作为熔炉燃料。 | 对象形态使用duration，单位为秒，值必须不小于0.05。 |
minecraft:glint | 布尔值或对象 | 控制物品是否显示附魔光效。 | 对象形态使用value布尔值。 |
minecraft:hand_equipped | 布尔值或对象 | 控制物品在玩家手中是否按工具方式渲染。 | 对象形态使用value布尔值。官方还存在拼写错误的minecraft:hand_equippped页面，其语义与本组件相同，不应作为新组件名使用。 |
minecraft:hover_text_color | 字符串或对象 | 设置鼠标悬停时物品名的颜色。 | 对象形态使用value字符串。 |
minecraft:icon | 字符串或对象 | 设置物品在界面等位置使用的图标。 | 字符串形态直接写纹理键；对象形态优先使用textures.default等映射。旧字段texture仍可见于示例，但官方已标注为已弃用。minecraft:block_placer也可用目标方块渲染图标。 |
minecraft:interact_button | 布尔值或字符串 | 控制触摸控制中的交互按钮是否显示及其文本。 | 值为true时显示默认“使用物品”文本；字符串值可指定按钮文本。 |
minecraft:kinetic_weapon | 对象 | 使物品在使用期间沿使用者视线方向造成动能伤害和相关效果。 | delay为开始生效前的刻数；reach和creative_reach为命中距离范围；hitbox_margin为射线检测容差；damage_multiplier和damage_modifier参与伤害计算；damage_conditions、knockback_conditions和dismount_conditions分别控制伤害、击退和卸下骑手的条件。 |
minecraft:liquid_clipped | 布尔值或对象 | 控制物品使用时是否与液体方块交互。 | 对象形态使用value布尔值。若要允许方块放置在液体上，应同时关注方块的放置过滤相关组件。 |
minecraft:max_stack_size | 整数或对象 | 设置物品最大堆叠数量。 | 对象形态使用value整数，默认值为64。若可穿戴物品选择非手部槽位，最大堆叠通常会变为1。 |
minecraft:piercing_weapon | 对象 | 使物品沿使用者视线方向对直线上的实体造成伤害。 | 该攻击动作优先于破坏方块，因此带有此组件的物品不能破坏方块；reach和creative_reach控制距离范围；hitbox_margin控制检测容差。 |
minecraft:projectile | 对象 | 将物品定义为可被发射器射出或可作为弹药生成实体的弹射物。 | projectile_entity指定被发射的实体；minimum_critical_power控制暴击所需蓄力。与minecraft:throwable配合时，决定投掷后生成的实体。 |
minecraft:rarity | 字符串或对象 | 设置基础稀有度，并影响悬停名称颜色。 | 要求format_version不低于1.21.30；可选值为common、uncommon、rare和epic。附魔会自动提高显示稀有度：普通或罕见物品提高为稀有，稀有物品提高为史诗。 |
minecraft:record | 对象 | 使物品可作为唱片播放音乐。 | sound_event为播放的声音事件；duration为秒数；comparator_signal为唱片机比较器输出强度，范围通常为1到13。 |
minecraft:repairable | 对象 | 定义可用于修复该物品的物品及恢复耐久。 | repair_items为修复项列表；每项包含可用物品列表和可选的repair_amount。 |
minecraft:seed | 对象 | 使物品可作为种子种植并放置作物方块。 | 要求format_version不低于1.10.0；crop_result为种植后放置的方块；plant_at为可种植或可附着的方块。plant_at_any_solid_surface和plant_at_face已弃用。 |
minecraft:shooter | 对象 | 使物品像弓或弩一样发射弹射物。 | 需要minecraft:use_modifiers；弹药物品需要minecraft:projectile；ammunition列出可用弹药；charge_on_draw控制是否拉动即蓄力；max_draw_duration和scale_power_by_draw_duration控制蓄力时长与发射力度。 |
minecraft:should_despawn | 布尔值或对象 | 控制物品实体是否会自然消失。 | 对象形态使用value布尔值。 |
minecraft:stacked_by_data | 布尔值或对象 | 控制附加值不同的同类物品是否可堆叠，也影响世界中的物品实体是否可合并。 | 对象形态使用value布尔值。 |
minecraft:storage_item | 对象 | 使物品保存与其关联的动态容器数据。 | 要求format_version不低于1.21.40；若要与存储容器交互，需要minecraft:bundle_interaction；allow_nested_storage_items控制是否允许嵌套存储物品；allowed_items和banned_items限制可存入物品；max_slots最大为64。 |
minecraft:storage_weight_limit | 对象 | 设置存储物品可容纳的最大重量。 | max_weight_limit默认值为64，最大值为64。 |
minecraft:storage_weight_modifier | 对象 | 设置该物品放入其他存储物品时占用的重量。 | weight_in_storage_item默认值为4；值为0表示该物品在存储物品中不占重量。 |
minecraft:swing_duration | 数值或对象 | 设置开采或攻击时挥动动画的持续时间。 | 对象形态使用value秒数；只影响视觉表现，不改变攻击频率或其他玩法机制。 |
minecraft:swing_sounds | 对象 | 覆盖使用者挥动时发出的声音。 | attack_hit、attack_miss和attack_critical_hit分别设置命中、未命中和暴击命中声音事件。 |
minecraft:tags | 对象 | 为物品附加标签。 | tags为字符串数组。自定义标签应使用自己的命名空间；只有原版标签可使用minecraft:命名空间。 |
minecraft:throwable | 对象 | 使物品可像雪球或末影珍珠一样被玩家投掷。 | 常与minecraft:projectile配合；do_swing_animation控制投掷时是否挥手；min_draw_duration、max_draw_duration、scale_power_by_draw_duration、launch_power_scale和max_launch_power控制蓄力与发射力度。 |
minecraft:use_animation | 字符串或对象 | 指定玩家使用物品时播放的动画。 | 对象形态使用value字符串，例如食物常用eat。 |
minecraft:use_modifiers | 对象 | 设置物品使用时长、移动速度和开始使用行为。 | use_duration为使用时长秒数；movement_modifier为使用中移动速度倍率，必须不大于1；emit_vibrations控制开始或停止使用时是否发出振动；start_sound为开始使用声音；start_using可为if_first或always。 |
minecraft:wearable | 对象 | 使物品可被玩家穿戴到装备槽位。 | slot指定槽位；protection为保护值；hides_player_location控制是否在定位器地图和定位器栏中隐藏玩家位置；dispensable控制是否可由发射器装备。 |