Bedrock Wiki
新手入门指南
JSON UI
Meta
NBT
世界生成
动画控制器
命令
实体
战利品、配方与交易
文档
方块
服务器
概念
物品
视觉效果
粒子效果
脚本编写
虚拟现实

方块物品化

intermediate
方块物品化

自动生成的方块物品 ​

当你手持一个方块时，实际上你持有的是一个用于放置该方块的物品。当自定义方块注册到游戏中时，Minecraft会自动注册一个新物品来在物品栏中代表该方块。

该物品会使用方块定义的菜单分类和显示名称，但自动生成的方块物品的其他组件无法修改。 若要应用其他组件（例如为方块设置2D图标），你需要用自定义物品替换该方块的默认物品。

替换方块物品 ​

玩家放置前注意事项

被替换的方块物品不会触发 beforeOnPlayerPlace 事件钩子。

要替换方块物品，你需要创建一个与方块具有相同标识符的新物品JSON文件。

新物品还需要包含方块放置器组件，该组件允许物品放置对应方块。 默认情况下，方块放置器组件会使物品呈现方块的3D外观，但可以通过图标组件覆盖此设置以显示2D精灵图。

自定义花卉示例 ​

花卉方块就是需要替换物品的典型案例，在物品形态下它们应该显示为2D图标而非3D模型。

BP/blocks/daffodil.json
json
{
    "format_version": "1.21.70",
    "minecraft:block": {
        "description": {
            "identifier": "wiki:daffodil"
        },
        "components": {
            "minecraft:geometry": "minecraft:geometry.cross",
            "minecraft:material_instances": {
                "*": {
                    "texture": "wiki:daffodil",
                    "render_method": "alpha_test"
                }
            }
        }
    }
}
BP/items/daffodil.json
json
{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:daffodil", // 与方块ID相同
            "menu_category": {
                "category": "nature",
                "group": "minecraft:itemGroup.name.flower"
            }
        },
        "components": {
            "minecraft:icon": "wiki:daffodil",
            "minecraft:block_placer": {
                "block": "wiki:daffodil",
                "replace_block_item": true
            }
        }
    }
}

贡献者

编辑 方块物品化

本页面上的文本和图像内容根据 知识共享署名 4.0 国际许可协议

本页中的代码示例根据 MIT 许可证