物品简介

Minecraft基岩版允许我们向世界中添加具有各种类似原版属性的自定义物品。

本教程将介绍如何为Minecraft的稳定版本创建基本物品。

注册物品¶

物品定义的结构与实体相似：它们包含描述和定义物品行为的组件列表。

以下是将自定义物品添加到创造模式物品栏的最低行为代码。

BP/items/custom_item.json

{
    "format_version": "1.21.40",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:custom_item",
            "menu_category": {
                "category": "construction"
            }
        },
        "components": {} // 必须在此处，即使为空！
    }
}

物品描述¶

定义物品的标识符 - 以命名空间:标识符格式的唯一ID。
配置物品放置到哪个menu_category中。
- 还可以使用可选参数group和is_hidden_in_commands。

添加组件¶

现在，我们的自定义物品正在使用默认组件值（可以在这里找到）。

让我们配置自己的功能吧！

BP/items/custom_item.json

{
    "format_version": "1.21.40",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:custom_item",
            "menu_category": {
                "category": "construction"
            }
        },
        "components": {
            "minecraft:damage": 10,
            "minecraft:durability": {
                "max_durability": 36
            },
            "minecraft:hand_equipped": true
        }
    }
}

更多物品组件请浏览这里!

应用纹理¶

我们需要创建一个纹理短名称，将其链接到RP/textures/item_texture.json中的图像。

RP/textures/item_texture.json

{
    "resource_pack_name": "wiki",
    "texture_name": "atlas.items",
    "texture_data": {
        "custom_item": {
            "textures": "textures/items/custom_item"
        }
    }
}

在我们的物品文件中，我们将添加minecraft:icon组件以应用纹理。

BP/items/custom_item.json

{
    "format_version": "1.21.40",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:custom_item",
            "menu_category": {
                "category": "construction"
            }
        },
        "components": {
            "minecraft:icon": "custom_item"
        }
    }
}

定义名称¶

最后，我们将为物品命名。此外，你可以使用显示名称组件。

RP/texts/en_US.lang

tile.wiki:custom_item.name=自定义物品

结果¶

在本页中，你已了解以下内容：

物品的基本特性
如何应用纹理
如何在item_textures.json中使用短名称链接纹理
如何在语言文件中定义名称