创建自定义物品¶

在Minecraft中，我们可以创建自定义物品，这些物品可以像普通物品一样被掉落、交易、合成和使用。这个系统具有很大的灵活性，包括制作食物、燃料和工具的能力。

在本教程中，我们将学习如何创建一个简单的“灵异物质”物品，稍后我们将把它用作我们幽灵实体的掉落物。

从概念上讲，物品由两个部分组成：

• 视觉效果（纹理、名称）
• 行为（物品的行为方式）

首先，我们将学习如何创建一个新的简单物品并定义其行为。在下一部分中，我们将为该物品分配一个纹理，以便在游戏中查看。

物品行为¶

要制作一个物品，我们需要一种方法来识别它并定义我们希望它的行为。为此，我们将创建一个文件，告诉Minecraft将特定行为应用于我们选择的特定物品。

在本节结束时，我们将完全定义我们物品的行为。

组件¶

不同的物品有不同的行为；你可以吃猪排，附魔物品会发光，鸡蛋只能堆叠到16个。这些都是物品行为的例子。 我们可以通过使用行为组件来定义我们的自定义物品的行为。

"minecraft:food":
"minecraft:glint": true,
"minecraft:max_stack_size": 16

组件包含信息，告诉游戏我们的物品应该做什么。例如，组件minecraft:glint决定物品是否应该具有附魔光泽，因此将其设置为true将应用该效果。 所有组件都有一个附加的value，我们可以编辑它以获得所需的行为。

对于我们的灵异物质，我们将其堆叠大小设置为16，类似于鸡蛋。为此，我们使用组件minecraft:max_stack_size并将其值设置为16。

标识符¶

为了让游戏将正确的组件应用于正确的物品，我们需要能够告诉游戏哪个物品是我们的。我们通过为我们的物品定义一个标识符来做到这一点。

标识符是该物品的唯一名称。对于原版Minecraft的鸡蛋，其标识符为minecraft:egg。标识符由两个部分组成：

• 命名空间（minecraft）
• ID（egg）

命名空间是唯一的，你将在整个项目中使用它。这是为了减少如果有人向你的游戏添加两个包而都添加了灵异物质物品时可能出现的问题；命名空间减少了标识符相同的可能性。 Minecraft使用的命名空间是minecraft。你的命名空间应该是唯一的，例如作者的首字母缩写或包名称的缩写。在我们的示例中，我们将使用命名空间wiki；有关创建命名空间的更多信息，请查看我们的页面这里。

ID是物品的简短信息名称。在这里我们将使用ectoplasm。

因此，我们的自定义标识符变为wiki:ectoplasm。请注意，我们使用冒号:来分隔命名空间和ID。当我们想引用我们的物品时，我们将使用这个标识符，例如使用/give命令。

物品文件¶

现在我们有了组件和标识符，我们可以开始定义我们的物品。我们通过在行为包中创建一个物品定义文件来定义物品。这是我们将放置所有信息的地方。

所有物品定义都放在BP/items/中。文件的名称不会影响任何内容，但为了方便导航，建议将其命名为你的ID。 我们将创建一个文件BP/items/ectoplasm.json。以下是文件的基本布局：

{
  "format_version": "1.21.40",
  "minecraft:item": {
    "description": { ... },
    "components": { ... }
  }
}

你包中的大多数文件将有两个顶级定义，"format_version"和"minecraft:<file_type>"。 格式版本定义Minecraft将使用哪个版本的附加包系统来读取此文件。对于我们的物品，我们将使用1.21.40以允许我们使用最新的功能。有关格式版本的更多信息，请查看这里。

第二个定义定义了这是什么类型的文件。在我们的例子中，由于这是一个物品定义，因此它是minecraft:item。在这里我们将放置所有信息。这里将始终包含一个description键。

让我们更详细地看一下"description"：

"description": {
  "identifier": "wiki:ectoplasm",
  "menu_category": {
    "category": "items"
  }
},

描述键包含identifier和任何其他所需的信息。identifier允许文件知道将组件应用于哪个物品。 category键定义物品将在创造模式物品栏/配方书的哪个标签中显示。可以选择四个标签：“construction”、“equipment”、“items”和“nature”。如果这里未包含此键，则物品将不会显示在创造模式物品栏中，但你仍然可以通过使用/give获取该物品。

现在我们可以在components下实际定义我们物品的行为。在这里，我们简单地放置任何我们希望物品具有的组件。 这将是我们的"minecraft:max_stack_size"组件。有关其他可以使用的组件，请查看我们更深入的物品指南这里。

"components": {
  "minecraft:max_stack_size": 16
}

至此，我们已经完全定义了物品的行为。这是你当前文件的样子。

{
  "format_version": "1.21.40",
  "minecraft:item": {
    "description": {
      "identifier": "wiki:ectoplasm",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:max_stack_size": 16
    }
  }
}

如果你打开一个包含你的附加包的世界，你的物品应该在正确的菜单中，但是不可见的，并且有一个奇怪的名称。

这是因为我们还没有定义视觉效果。不过，你应该看到它的堆叠效果是正常的。在下一部分中，我们将定义物品的纹理并将其分配给我们的物品。

物品视觉效果¶

现在我们有了一个可以工作的物品，我们想为它添加纹理和名称。

纹理存储在资源包中的RP/textures目录下，作为图像。为了让Minecraft知道在何处使用哪个纹理，我们需要为其分配一个短名称，以便我们可以访问它。

纹理¶

首先，我们需要一个物品的纹理。对于我们的灵异物质，我们将使用这个图像。

在这里下载纹理

所有物品纹理存储在RP/textures/items/中。从这里，你可以创建任何你想要的子目录。 最好将纹理图像文件命名为物品的id，在我们的情况下，它将是ectoplasm.png。 建议将图像保存为.png格式，大小为16x16，尽管Minecraft也接受其他格式，如.jpg或.tga。

你的文件夹结构应该如下所示：

短名称¶

短名称本质上是分配给纹理文件夹路径的名称，因此每当我们想在某处使用纹理时，我们将使用其短名称，而不是其文件夹路径。

所有物品短名称存储在一个名为item_texture.json的文件中，该文件位于RP/textures中。它包含短名称及其分配的纹理的列表。

{
  "resource_pack_name": "Ghostly Guide",
  "texture_name": "atlas.items",
  "texture_data": { ... }
}

在这里，我们有三个顶级定义，texture_data是我们将定义短名称的地方，另外两个定义了这个文件的类型。 resource_pack_name只是我们资源包的名称，texture_name是这是什么类型的纹理文件。由于这是针对物品的，因此这将始终设置为atlas.items。

在texture_data下是我们的物品短名称定义列表。一个示例定义如下所示：

"wiki.ectoplasm": {
  "textures": "textures/items/ectoplasm"
}

在这里，wiki.ectoplasm是我们的短名称，而在textures下，我们有物品的路径。请注意，这是相对于资源包的，并且不包括文件扩展名。你的短名称应该简短且唯一。我们建议将其设置为分配给物品的命名空间和ID。

现在每当我们想引用我们的图像时，我们将使用短名称wiki.ectoplasm。

图标¶

要最终将纹理应用于我们的物品，我们将minecraft:icon组件添加到我们的物品定义中，并将其值设置为我们的短名称。

"components": {
  "minecraft:max_stack_size": 16,
  "minecraft:icon": "wiki.ectoplasm"
}

现在你的纹理应该出现在你的物品上。

物品名称¶

最后要添加的是物品的名称。目前它将显示为item.wiki:ectoplasm。这是物品名称的翻译键，用于实现本地化。要设置它，我们只需在语言文件中定义它。

我们在创建RP和BP时已经创建了这些文件，因此我们只需向其中添加内容。

item.wiki:ectoplasm=灵异物质

现在，当你进入你的世界时，你的物品应该有一个名称。

概述¶

现在你的第一个自定义物品，灵异物质，已经完成！如果一切顺利，物品现在应该可以通过游戏中的/give命令获得，并且出现在你的创造模式物品栏中。

你的文件夹结构应该如下所示：