跳转至

物品组件(中国版)

本页列出中国版行为包物品定义中minecraft:item.components对象可用的中国版专有物品组件,组件键使用netease:命名空间。这些组件由网易维护,仅在中国版中生效;国际版客户端将忽略或对这些组件发出警告。物品定义的根结构见物品定义,国际版物品组件见物品组件

中国版自定义物品除本页所列组件外,还提供针对武器、盔甲、盾牌、桶、弹射物等特定物品类型的专用组件。这些专用组件需在description.custom_item_type中声明对应类型后方可使用,此处不作展开。

组件一览

组件 值形态 用途 主要字段与限制
netease:allow_offhand 对象 控制物品是否可放入副手槽位。 value为布尔值。副手槽位对部分组件(如minecraft:foilnetease:render_offsets)不生效,且基岩版原版副手功能较弱,主要用于装饰性展示或脚本逻辑判断。
netease:cooldown 对象 为物品使用添加冷却。 category为字符串,相同类别的物品共享同一冷却计时(默认值为"item");duration为冷却时间(整数,单位为刻)。自定义食品的冷却时间应定义在minecraft:food中,而非使用此组件。
netease:customtips 对象 为物品添加自定义描述信息。 value为字符串,支持格式化代码(如§8);描述显示于物品名称下方。与方块组件netease:custom_tips作用相同。
netease:enchant_material 对象 控制物品是否可作为附魔台的附魔材料。 value为布尔值,默认false。启用后,物品可在附魔台中作为消耗材料。
netease:fire_resistant 对象 控制物品掉落物是否免疫火焰和熔岩。 value为布尔值。效果与下界合金一致:掉落物不被火烧毁,掉入熔岩时弹出。
netease:fuel 对象 允许物品作为熔炉燃料。 duration为燃烧时长(浮点数,单位为秒);省略或设为0时无燃烧效果。
netease:show_in_hand 对象 控制物品手持时是否显示模型或纹理。 value为布尔值。设为false时,手持该物品不显示任何模型。