物品格式历史记录
版本化
变更文件的format_version字段必须更新才能使版本化变更生效。
experimental
变更必须在世界中启用实验性功能才能使实验性变更生效。
1.21.80
组件
experimental
自定义组件V2
版本化
移除了
minecraft:custom_components自定义组件现在应该像原版组件一样应用,作为
components对象中的条目:minecraft:blockjson"components": { "minecraft:glint": true, "wiki:custom_component": { "parameter": "value" } }
1.21.60
描述
版本化
- 更新了
menu_category- 更新了
group参数,现在需要命名空间,例如minecraft:itemGroup.name.concrete
- 更新了
组件
版本化
- 新增了
minecraft:storage_weight_limit- 决定存储物品容器中所有物品的最大允许总重量。
- 替代了
max_weight_limit存储物品参数。
- 新增了
minecraft:storage_weight_modifier- 决定物品在存储物品内时的额外重量。
- 值为0表示该物品不允许放入存储物品中。
- 替代了
weight_in_storage_item存储物品参数。
- 将
minecraft:compostable从实验性功能中正式发布 - 更新了
minecraft:block_placer- 将
replace_block_item参数从实验性功能中正式发布
- 将
- 更新了
minecraft:storage_item- 移除了
max_weight_limit参数 - 移除了
weight_in_storage_item参数
- 移除了
1.21.50
组件
experimental
即将推出的创作者功能
- 新增了
minecraft:compostable- 允许该物品用于堆肥桶。
- 包含
composting_chance,决定堆肥等级提升的概率(0-100%)。
1.21.40
版本化
- 数字不能再用于表示布尔值。
- 浮点数不能再用于表示整数值。
组件
版本化
- 将
minecraft:bundle_interaction从实验性功能中正式发布 - 将
minecraft:storage_item从实验性功能中正式发布
experimental
即将推出的创作者功能
- 更新了
minecraft:block_placer- 如果未应用
minecraft:icon组件,指定的block现在将用作物品的图标。 - 新增了
replace_block_item参数,用该物品替换指定block的默认物品。- 要使此功能生效,物品和方块的标识符必须相同。
- 了解更多关于替换方块物品的信息这里!
- 如果未应用
1.21.30
组件
版本化
- 新增了
minecraft:dyeable- 允许物品被炼药锅中的水染色。
- 包含
default_color,决定物品染色前的可选颜色。 - 染色后,物品将显示
minecraft:icon组件中定义的dyed纹理,而不是default。
- 新增了
minecraft:rarity- 定义物品的基础稀有度(通过物品名称的颜色显示)。
- 接受以下稀有度等级:
common(普通)、uncommon(罕见)、rare(稀有)和epic(史诗)。 - 当物品被附魔时,其稀有度将尽可能提升到下一等级。
- 此组件没有功能性效果,可以被
minecraft:hover_text_color覆盖。
experimental
收纳袋
- 新增了
minecraft:bundle_interaction- 在物品上启用收纳袋界面和功能。
- 包含
num_viewable_slots。 - 需要应用
minecraft:storage_item组件。
- 新增了
minecraft:storage_item- 允许该物品包含其他物品。
- 包含
allow_nesed_storage_items,决定是否可以将其他存储物品放入容器中。 - 包含
allowed_items,定义容器中允许的物品。- 如果为空,则所有物品都允许放入容器中。
- 包含
banned_items,定义容器中不允许的物品。 - 包含
max_slots,定义容器中的槽位数。 - 包含
max_weight_limit,定义容器中所有物品的最大允许总重量。 - 包含
weight_in_storage_item,定义物品在另一个存储物品内时的额外重量。- 值为0表示该物品不允许放入另一个存储物品中。
1.21.20
组件
版本化
- 新增了
minecraft:damage_absorption- 使物品吸收原本会对穿戴者造成的伤害。
- 包含
absorbable_causes,决定可以被物品吸收的伤害原因列表(如entity_attack和magma)。 - 需要
minecraft:durability和minecraft:wearable组件。
- 新增了
minecraft:durability_sensor- 使物品在受到伤害时发出效果。
- 包含
durability_thresholds,决定耐久度阈值以及达到每个阈值时发出的效果。
1.21.10
组件
版本化
- 将
minecraft:custom_components从实验性功能中正式发布
1.21.0
experimental
节日创作者功能
版本化
- 移除了
events
组件
experimental
Beta API
- 新增了
minecraft:custom_components- 列出应应用于此方块的所有自定义组件。
事件
experimental
节日创作者功能
版本化
- 移除了
add_mob_effect响应 - 移除了
damage响应 - 移除了
decrement_stack响应 - 移除了
remove_mob_effect响应 - 移除了
run_command响应 - 移除了
teleport响应 - 移除了
transform_item响应
1.20.60
组件
版本化
- 更新了
minecraft:icon- 移除了
texture参数 - 新增了
textures参数,列出物品图标可以使用的不同纹理,包括盔甲纹饰。- 包含
default,替代了texture参数。
- 包含
- 移除了
1.20.50
组件
版本化
- 新增了
minecraft:tags- 列出应用于此物品的标签。
- 替代了
tag:*组件。
- 新增了
minecraft:use_modifiers- 包含
use_duration,决定物品完整使用的时长(以秒为单位)。- 替代了
minecraft:use_duration组件。
- 替代了
- 包含
movement_modifier,在使用物品时对持有者的速度应用乘数。
- 包含
- 移除了
minecraft:use_duration - 移除了使用
tag:*应用标签的功能
experimental
节日创作者功能
版本化
- 移除了
minecraft:chargeable - 更新了
minecraft:digger- 移除了
on_dig触发器参数
- 移除了
1.20.40
组件
版本化
- 更新了
minecraft:icon- 现在可以再次使用单个字符串值,例如
"minecraft:icon": "stick"。
- 现在可以再次使用单个字符串值,例如
experimental
节日创作者功能
版本化
- 移除了
minecraft:on_use触发器 - 移除了
minecraft:on_use_on触发器 - 移除了
minecraft:weapon
1.20.30
组件
版本化
- 新增了
minecraft:interact_button- 启用并设置在使用触摸控制时显示的按钮文本。
- 如果设置为
true,按钮显示"使用物品"。
- 将
minecraft:allow_off_hand从实验性功能中正式发布 - 将
minecraft:damage从实验性功能中正式发布 - 将
minecraft:digger从实验性功能中正式发布 - 将
minecraft:enchantable从实验性功能中正式发布 - 将
minecraft:food从实验性功能中正式发布 - 将
minecraft:hand_equipped从实验性功能中正式发布 - 将
minecraft:liquid_clipped从实验性功能中正式发布 - 将
minecraft:should_despawn从实验性功能中正式发布 - 将
minecraft:stacked_by_data从实验性功能中正式发布 - 将
minecraft:use_animation从实验性功能中正式发布 - 将
minecraft:use_duration从实验性功能中正式发布
1.20.10
组件
版本化
- 将
minecraft:block_placer从实验性功能中正式发布 - 将
minecraft:can_destroy_in_creative从实验性功能中正式发布 - 将
minecraft:cooldown从实验性功能中正式发布 - 将
minecraft:hover_text_color从实验性功能中正式发布 - 将
minecraft:max_stack_size从实验性功能中正式发布 - 将
minecraft:projectile从实验性功能中正式发布 - 将
minecraft:record从实验性功能中正式发布 - 将
minecraft:repairable从实验性功能中正式发布 - 将
minecraft:shooter从实验性功能中正式发布 - 将
minecraft:throwable从实验性功能中正式发布
experimental
节日创作者功能
版本化
- 移除了
minecraft:render_offsets
1.20.0
组件
版本化
- 将
minecraft:display_name从实验性功能中正式发布 - 将
minecraft:durability从实验性功能中正式发布 - 将
minecraft:fuel从实验性功能中正式发布 - 将
minecraft:entity_placer从实验性功能中正式发布 - 将
minecraft:icon从实验性功能中正式发布
experimental
节日创作者功能
版本化
- 移除了
minecraft:dye_powder - 更新了
minecraft:repairable- 移除了
on_repaired触发器参数
- 移除了
未记录
1.20.0版本之前的格式变更尚未列出。
贡献者
编辑 物品格式历史记录本页面上的文本和图像内容根据 知识共享署名 4.0 国际许可协议
本页中的代码示例根据 MIT 许可证
