项目设置¶

介绍¶

本页面将指导你走完创建第一个“能用的”附加包并在游戏中查看它的所有步骤。如果你是在安卓设备上进行的，请遵循以下替代指南：

安卓指南

com.mojang文件夹¶

com.mojang文件夹是Minecraft存储数据的特殊文件夹（附加包、世界、玩家信息等）。Minecraft能够识别这个位置，我们访问或创建的所有文件都会放置在这个文件夹中的某个位置！

你应该在桌面或移动设备上创建一个指向com.mojang文件夹的快捷方式，以便随时轻松访问。com.mojang文件夹的确切位置将取决于你的设备操作系统。

Windows¶

在Windows上，com.mojang文件夹位于你的应用数据文件夹内。

提示：你可以在搜索栏中输入%appdata%直接跳转到C:\Users\<USERNAME>\AppData\文件夹。

C:\Users\<USERNAME>\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang

安卓¶

安卓11或更早版本：手机 > games > com.mojang

安卓12及更新版本：手机 > Android > data > com.mojang.minecraftpe > files > games > com.mojang

ChromeOS¶

在你能看到com.mojang文件夹之前，请确保在Minecraft设置中将文件存储位置更改为外部：

• 进入Minecraft设置。
• 导航到设置 > 常规 > 存储。
• 将文件存储位置更改为外部。

之后，你可以在安卓子系统中访问com.mojang文件夹：

我的文件 > Play文件 > Android > data > com.mojang.minecraftpe > files > games > com.mojang

iOS¶

我的设备 > Minecraft > games > com.mojang

开发状态下的包¶

我们将在development_behavior_packs和development_resource_packs中开发我们的附加包。当你在这些文件夹中进行更改时，可以退出并重新进入应用了这些包的世界，以自动重新加载内容。这使你能够快速测试你的附加包，而无需重新加载整个Minecraft。

另一方面，resource_packs和behavior_packs通常包含稳定版本的附加包，这包括通过.mcpack导入的附加包。我们现在可以忽略这些文件夹。

你的工作区¶

首先，你需要在合适的位置创建正确的文件夹并设置你的工作区。 本指南其余部分假设你使用的是VSCode。你也可以使用其他编辑器。

现在让我们在Visual Studio Code中创建你的第一个附加包工作区。

1. 打开VSCode（Visual Studio Code，代码编辑器）
2. 在development_resource_packs中创建一个名为your_pack_name_RP的文件夹。我将把这个文件夹称为RP
3. 在development_behavior_packs中创建一个名为your_pack_name_BP的文件夹。我将把这个文件夹称为BP。
4. 转到文件 > 将文件夹添加到工作区...并选择BP。对RP也执行相同操作。
5. 按文件 > 将工作区另存为...将工作区文件保存到桌面。每当你在附加包上工作时，只需双击打开工作区，即可快速访问BP和RP文件夹。

BP清单¶

清单是一个文件，用于识别你的包。每个包都有一个清单。具有正确格式的清单的文件夹将能够在Minecraft中显示，我们认为这是在添加其他内容之前的“最小”版本的包。

清单文件是用json编写的。如果你对此不熟悉，可以在这里了解更多关于json的信息。

首先，在你的BP文件夹中右键单击该文件夹并选择新建文件。将文件命名为manifest.json。最一开始，你可以将以下代码复制粘贴到文件中。

{
  "format_version": 2,
  "header": {
    "name": "pack.name",
    "description": "pack.description",
    "uuid": "...",
    "version": [1, 0, 0],
    "min_engine_version": [1, 16, 0]
  },
  "modules": [
    {
      "type": "data",
      "uuid": "...",
      "version": [1, 0, 0]
    }
  ]
}

清单解释¶

• format_version定义你使用的清单语法版本。版本2是最新的稳定版本；请使用它。

• name是你的行为包的名称。description将显示在游戏中名称的下方。我们以“代码形式”定义这些文件，以便稍后可以将其翻译成其他语言。有关本地化的更多信息，请查看这里。

• UUID字段是必需的，将在下面详细讨论。

• version定义你的附加包的版本。当你在安装了旧版本的设备上导入一个更新版本的附加包时，新版本将覆盖旧版本。如果你的附加包位于development_*_packs文件夹中并仅打算在私人世界中使用它们，则无需每次修改都更改版本。

• min_engine_version定义能够读取你的附加包的最低Minecraft客户端版本。这里指定的数字应与当前游戏的版本号匹配，除非你计划与旧版本进行向后兼容。

• 在modules中，type被定义为data。这使你的包成为一个行为包。

UUID解释¶

UUID（通用唯一标识符）用于识别你的包，以便其他程序（在此情况下是Minecraft）可以读取。它的格式类似于：5c830391-0937-44d6-9774-406de66b6984

绝不要重复使用相同的UUID。你可以在这里生成自己的UUID，或者如果你使用VSCode，可以安装这个扩展。许多其他工具如bridge.会自动生成UUID。每个清单文件都应使用不同的UUID。

为了确保你的附加包能够正常工作，你应该生成两个新的UUID，并将其粘贴到BP的manifest.json文件中的每个"..."位置。当你完成后，它应该看起来像这样：

"uuid": "5c830391-0937-44d6-9774-406de66b6984"

RP清单¶

下一步是为RP创建manifest.json。资源包清单的格式与BP清单几乎相同，唯一的区别是type为resources，这标记该包为资源包。

将以下代码复制到你新创建的RP/manifest.json中，并插入你自己的UUID。

{
  "format_version": 2,
  "header": {
    "name": "pack.name",
    "description": "pack.description",
    "uuid": "...",
    "version": [1, 0, 0],
    "min_engine_version": [1, 16, 0]
  },
  "modules": [
    {
      "type": "resources",
      "uuid": "...",
      "version": [1, 0, 0]
    }
  ]
}

包图标¶

包图标是一个图像文件，用于标识你的附加包在游戏中的外观。如果你有一个低分辨率的正方形图像，可以使用它。否则，请下载并使用这个示例图标：

下载图像

你应该将所需图像的副本放入RP和BP中。图像需要命名为pack_icon.png

语言文件¶

最后一步是为你的附加包设置语言支持。你需要为RP和BP创建一个语言文件。你可以在这里了解更多关于Minecraft如何处理本地化的信息。

pack.name=Wiki资源包
pack.description=一个幽灵指南

pack.name=Wiki行为包
pack.description=一个幽灵指南

["en_US"]

["en_US"]

检查你的工作¶

如果你做的一切正确，你的包现在应该在Minecraft中显示！如果你没有看到你的包，你应该遵循故障排除指南。

开启内容日志¶

内容日志是一个极其重要的调试工具，你应该始终保持开启。

在设置 > 创建者中打开两个内容日志设置。这将在你进入应用了该附加包的世界时显示任何错误。你可以通过按Ctrl＋H或在创建者设置面板中按内容日志历史打开内容日志GUI。了解更多关于内容日志的信息，请查看这里。

创建你的测试世界¶

现在我们创建一个世界来测试你的新附加包！

1. 点击“创建新世界”；

2. 确保以下设置已设置。

   

3. 现在激活你的行为包和资源包。你可以通过选择这些包并点击“应用”来做到这一点。

4. 现在点击“创建”！

概述¶

完成本页面后，你的项目应该如下所示：

请记住，在以后，我们将把com.mojang/development_behavior_packs/guide_RP/表示为RP，将com.mojang/development_behavior_packs/guide_BP/表示为BP。