项目设置

简介 ​

本页面将指导你完成创建首个"可运行"附加包并在游戏中查看所需的步骤。如果你是安卓用户，请参考以下替代指南：

com.mojang文件夹 ​

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

建议你在桌面或移动设备上创建com.mojang文件夹的快捷方式，以便随时访问。该文件夹的具体位置取决于你的设备操作系统。

Windows系统 ​

在Windows系统中，com.mojang文件夹位于应用数据目录内。

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

完整路径： C:\Users\<用户名>\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设置中将"文件存储位置"改为"外部"：

1. 进入Minecraft设置
2. 导航至设置 > 通用 > 存储
3. 将文件存储位置改为外部

之后可在安卓子系统中访问： 我的文件 > 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中创建名为"你的包名_RP"的文件夹（后文简称RP）
3. 在development_behavior_packs中创建"你的包名_BP"文件夹（后文简称BP）
4. 点击文件 > 将文件夹添加到工作区...选择BP，对RP执行相同操作
5. 点击文件 > 将工作区另存为...将工作区文件保存到桌面。以后只需双击打开该工作区文件，就能快速访问BP和RP文件夹

BP清单文件 ​

清单文件是向Minecraft标识你的包的文件。每个包都有一个清单。包含正确格式清单的文件夹会在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]
        }
    ],
    "metadata": {
        "product_type": "addon"
    }
}

清单文件解析 ​

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

• "name"是行为包名称，"description"将在游戏中显示在名称下方。我们以"代码形式"定义这些文件以便后续翻译成其他语言。关于本地化的更多信息请见此处。

• "UUID"字段至关重要，下文将详细讨论。

• "version"定义附加包版本。当你在已安装旧版本的设备上导入新版本附加包时，新版本将覆盖旧版本。如果你只在私有世界中使用development_*_packs文件夹中的附加包，则无需更改版本。

• "min_engine_version"定义能读取你附加包的Minecraft客户端最低版本。除非你计划兼容旧版本，否则此处数字应与游戏版本号匹配。

• 在"modules"中，"type"定义为"data"，这使你的包成为_行为包_。

• 在"metadata"中，"product_type"允许你的附加包在世界中启用成就，必须设为"addon"。

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。资源包清单格式与行为包几乎相同，只是"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]
        }
    ],
    "metadata": {
        "product_type": "addon"
    }
}

包图标 ​

包图标是标识附加包在游戏中显示样式的图像文件。如果有低分辨率方形图像可直接使用，否则可下载并使用此示例图标：

你需要将选定的图像副本放入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. 点击'创建'！

项目概览 ​

完成本页面后，你的项目结构应如下：

记住，后文中我们将用RP表示com.mojang/development_behavior_packs/guide_RP/，用BP表示com.mojang/development_behavior_packs/guide_BP/。

学习总结 ​

当前进度 ​