物品组件写在行为包中物品文件的 components 对象里:它们决定自定义物品是什么、能做什么。这里列出了 Minecraft 1.26.50.4 中的全部 44 个。
44 / 44
组件
minecraft:allow_off_hand让玩家可以把这个物品拿在副手(左手栏位)。适合火把、盾牌或地图这类方便和工具一起携带的物品。minecraft:block_placer让玩家使用物品时在世界中放置一个方块,就像种子或告示牌物品那样。它还能把这个方块显示为物品图标,这样你可能就不需要单独的图标了。minecraft:bundle_interaction让物品拥有收纳袋的行为:特殊的打开/关闭操作,以及显示里面装了什么的提示框。物品还需要 minecraft:storage_item 才能装东西。实验minecraft:can_destroy_in_creative控制创造模式玩家拿着这个物品时能否破坏方块。对于剑或魔杖这类不应误破坏方块的物品,可以把它关掉。minecraft:compostable让物品可以放进堆肥桶,并有一定几率让堆肥等级提高一层。minecraft:cooldown在物品使用或挥动后加入一段冷却时间。同一类别的所有物品会一起进入冷却,就像所有末影珍珠会同时等待一样。minecraft:damage用物品攻击生物或玩家时增加额外攻击伤害。minecraft:damage_absorption让盔甲代替穿戴者承受某些类型的伤害。物品必须穿戴在盔甲栏位,并且需要 minecraft:durability,因为吸收的伤害会消耗物品耐久。minecraft:digger通过设置破坏指定方块的速度,让物品成为挖掘工具。适用于自定义镐、锹或钻头。minecraft:display_name设置玩家看到的物品名称,例如在提示框中和切换到该物品时。你可以使用翻译键,让名称随游戏语言变化。minecraft:durability给物品一个耐久条,使用时会逐渐减少,直到物品损坏。它还允许在铁砧或砂轮中修复物品,或合并两个磨损的物品。minecraft:durability_sensor当物品耐久降到设定值以下时播放粒子或声音,就像快要损坏的警告。需要 minecraft:durability。minecraft:dyeable让玩家可以用染料给物品上色,就像在炼药锅或合成格中给皮革盔甲染色一样。minecraft:enchantable允许物品被附魔,并选择它接受哪一组附魔。附魔只有在物品也具备相应行为时才会生效。minecraft:entity_placer让物品在使用时生成一个实体,就像刷怪蛋或船物品那样。minecraft:fire_resistant让掉落的物品在火或熔岩中不会被烧毁,就像下界合金一样。minecraft:food让物品可以食用,吃下后恢复饥饿值。还要加上带有 use_duration 的 minecraft:use_modifiers,否则物品无法正常食用。minecraft:fuel让物品可以在熔炉、烟熏炉或高炉中燃烧,为冶炼提供燃料。minecraft:glint给物品加上附魔物品那种闪亮的紫色光效,即使物品没有任何附魔。minecraft:hand_equipped让物品像工具和剑一样显示在手中:竖直握持,而不是像普通物品那样平放。minecraft:hover_text_color更改物品名称在提示框中的颜色。minecraft:icon选择物品在物品栏、快捷栏和其他菜单中显示的图片。minecraft:interact_button在触屏设备上手持该物品时显示一个操作按钮。设为 true 显示标准的“使用物品”文字,或者填入文本显示你自己的文字。minecraft:kinetic_weapon让物品像骑枪一样通过冲刺来伤害生物。使用物品期间,它每刻都会沿使用者视线方向的直线进行检测,使用者和目标相向移动得越快,伤害就越高。minecraft:liquid_clipped让物品使用时可以选中水面和熔岩表面,而不是穿过它们。适合睡莲或船这类放在水上的物品。minecraft:max_stack_size设置一个物品栏格子里最多能放多少个这种物品。minecraft:piercing_weapon让攻击像长矛突刺一样击中使用者前方直线上的所有生物。带有该组件的物品无法破坏方块,因为攻击总是优先。minecraft:projectile把物品标记为射击类物品(比如弓)可以发射的弹药,并指定飞出去的实体。minecraft:rarity设置物品的稀有度,同时决定名称的颜色。附魔会让它提升一级:普通和罕见变为稀有,稀有变为史诗。minecraft:record把物品变成唱片,放进唱片机后会播放一首曲子。minecraft:repairable列出哪些物品可以在铁砧中修复这个物品,以及每次修复恢复多少耐久。需要 minecraft:durability。minecraft:shooter让物品成为像弓或弩一样的发射器,从物品栏中发射弹药。搭配 minecraft:use_modifiers,玩家才能按住拉弓。minecraft:should_despawn控制物品掉在地上一段时间(约 5 分钟)后是否消失。minecraft:stacked_by_data决定 id 相同但数据值不同的物品是否被视为不同物品,从而不会堆叠或在地上合并。minecraft:storage_item让物品可以在里面装其他物品,就像收纳袋一样。minecraft:bundle_interaction 等其他组件会使用这个存储空间。实验minecraft:storage_weight_limit设置存储物品最多能承载的总重量。每个存放的物品按自身重量计算。minecraft:storage_weight_modifier设置这个物品放进收纳袋等存储物品时占用多少空间。minecraft:swing_duration更改用该物品挖掘或攻击时挥臂动画的时长。这只是视觉上的变化,攻击速度保持不变。minecraft:swing_sounds替换玩家挥动这个物品击打东西时播放的声音。minecraft:tags给物品添加标签,让配方、脚本和其他物品可以按分组找到它,例如 "minecraft:is_sword"。minecraft:throwable让玩家可以投掷这个物品,就像雪球或鸡蛋一样。加上 minecraft:projectile 才会真的有东西飞出去。minecraft:use_animation选择玩家使用物品时播放的动画,比如吃东西、喝东西或拉弓。minecraft:use_modifiers控制按住使用键时的表现:一次使用需要多长时间,以及期间玩家走得多慢。食物、药水和弓都需要它。minecraft:wearable让物品可以穿戴在装备栏位中,比如头盔或靴子。搭配资源包中的附着物(attachable),它才会显示在玩家身上。