项目设置

本页面镜像自

BedrockWiki

根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。

com.mojang 文件夹

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

建议您在桌面或移动设备上创建com.mojang文件夹的快捷方式以便快速访问。该文件夹的具体位置因设备操作系统而异。

Windows

提示：在搜索栏输入%appdata%可直接跳转至'C:\Users\用户名\AppData'目录

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

Android

Android 11及更早版本：手机存储 > games > com.mojang

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

ChromeOS

在访问com.mojang文件夹前，需先在Minecraft设置中将文件存储位置更改为外部：

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

设置完成后可通过以下路径访问： 我的文件 > 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导入的包），开发时可暂时忽略这些目录。

您的工作区

TIP

Android平台的项目设置与其他平台有所不同，建议参考我们的Android专用指南。

Android指南

TIP

本指南中：

BP指在development_behavior_packs中创建的文件夹（行为包）
RP指在development_resource_packs中创建的文件夹（资源包）

首先需要在适当位置创建文件夹并建立工作区。本指南后续步骤默认使用VSCode，您也可以使用其他编辑器。

现在让我们在VSCode中创建第一个附加包工作区：

打开VSCode（Visual Studio Code代码编辑器）
在development_resource_packs中创建名为"your_pack_name_RP"的文件夹（以下简称RP）
在development_behavior_packs中创建名为"your_pack_name_BP"的文件夹（以下简称BP）
通过文件 > 将文件夹添加到工作区...依次添加BP和RP
使用文件 > 将工作区另存为...将工作区文件保存到桌面。后续开发时只需双击打开该工作区文件，即可快速访问BP和RP文件夹

BP清单文件

TIP

本指南中会频繁要求您在特定路径创建指定文件。如果目标文件夹不存在，请先创建！

WARNING

文件名/文件夹名错误是常见问题来源，请仔细核对示例。

清单文件（manifest）是Minecraft识别附加包的核心文件。每个包都必须包含一个格式正确的清单文件，这是附加包能被识别的最低要求。

清单文件使用json格式编写。如需了解json格式，请参考此文档。

在BP文件夹中右键新建文件，命名为manifest.json。初始内容可复制以下代码：

BP/manifest.json

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。您可以通过以下方式生成：

在线生成器
VSCode用户可安装此扩展
专业工具如_bridge._会自动生成

每个清单文件需要两个不同的UUID，分别填入header.uuid和modules[0].uuid。正确示例如下：

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

RP清单文件

资源包清单文件格式与行为包相似，主要区别在于type需设为resources：

RP/manifest.json

json

{
	"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分别创建语言文件，详见本地化系统。

RP/texts/en_US.lang

json

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

BP/texts/en_US.lang

json

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

RP/texts/languages.json

json

["en_US"]

BP/texts/languages.json

json

["en_US"]

验证成果

完成上述步骤后，您的附加包应已出现在游戏中！如果未显示，请参考问题排查指南。

启用内容日志

WARNING

内容日志是调试附加包最重要的工具，请务必启用。

内容日志是至关重要的调试工具，建议始终保持开启：

在设置 > 创作者中启用全部内容日志选项
应用附加包进入世界后，任何错误都会显示在日志中
游戏内按ctrl+h或通过创作者设置面板打开日志界面

了解更多内容日志信息请访问问题排查指南。

创建测试世界

现在让我们创建测试世界：

点击"创建新世界"
确保以下设置：
激活行为包和资源包（选中后点击'应用'）
点击"创建"！

当前进度

完成本页面后的项目结构：

后续指南中将使用简写：

com.mojang/development_behavior_packs/guide_RP/ 简写为 RP
com.mojang/development_behavior_packs/guide_BP/ 简写为 BP

📁com.mojang

📁development_resource_packs

📁guide_RP

📝manifest.json

🖼️pack_icon.png

📁texts

🈵en_US.lang

📝languages.json

📁development_behavior_packs

📁guide_BP

📝manifest.json

🖼️pack_icon.png

📁texts

🈵en_US.lang

📝languages.json

知识总结

已掌握内容：

com.mojang文件夹的作用与位置
工作区设置方法
manifest.json文件的作用
UUID的使用规范
附加包图标创建
.lang文件的作用

进度追踪

完成基础设置

创建自定义物品

创建自定义实体

配置实体战利品、生成规则与合成配方

项目设置 ​

com.mojang 文件夹 ​

Windows ​

Android ​

ChromeOS ​

iOS ​

开发包 ​

您的工作区 ​

BP清单文件 ​

清单文件解析 ​

UUID详解 ​

RP清单文件 ​

包图标 ​

语言文件 ​

验证成果 ​

启用内容日志 ​

创建测试世界 ​

当前进度 ​

知识总结 ​

进度追踪 ​

项目设置

com.mojang 文件夹

Windows

Android

ChromeOS

iOS

开发包

您的工作区

BP清单文件

清单文件解析

UUID详解

RP清单文件

包图标

语言文件

验证成果

启用内容日志

创建测试世界

当前进度

知识总结

进度追踪