文件类型
本页面镜像自 BedrockWiki
根据原始项目协议授权。本文经过AI翻译处理,如有内容遗漏,可以提交PR进行补充。
Minecraft 存在多种文件类型,均用于导入内容。所有 Minecraft 文件本质上都是 ZIP 压缩包,通过重命名使用 mc...
扩展名。这些压缩包目前可分为三大类:
- 世界文件(
mcworld
与mcproject
):包含世界或项目的关卡数据及相关资源 - 资源文件(
mcpack
与mctemplate
):包含世界的装饰性素材或支持性资源 - 复合文件(
mcaddon
与mceditoraddon
):可同时包含最多一个世界/项目文件及任意数量的资源文件
所有 Minecraft 文件类型均可通过常规文件打开方式启动游戏并导入内容。当资源包被导入时,会自动解压到对应的文件目录结构中。若游戏未处于运行状态,多数文件类型会以普通模式启动游戏;而 mcproject
和 mceditoraddon
则会直接进入编辑器模式。
世界文件
世界文件代表普通世界与编辑器项目的存档数据及资源。所有世界文件无论模式,都会被导入到 com.mojang
目录下的 minecraftWorlds
文件夹中。
若导入与已有存档完全相同的世界文件,会生成重复存档。复合文件包中若包含多个世界文件(包括嵌套的复合文件),只会导入其中一个世界。
普通世界
mcworld
单个世界的压缩存档包
创建世界存档的几种方式:
- 将世界目录的全部内容打包为 ZIP 文件后,将扩展名改为
mcworld
- 在游戏设置界面点击"导出世界"按钮
- 在编辑器模式中,通过 文件 → 导出为 → 可游玩世界 菜单选项导出。存档将保存在
com.mojang
文件夹的projectbackups
目录中 - 在编辑器模式中运行
/project export world
命令。存档将保存在com.mojang
文件夹的projectbackups
目录中
在编辑器模式下导入世界文件会将其作为项目导入。此时该世界将无法在编辑器模式之外访问,需重新导出为普通世界才能游玩。世界文件中包含的编辑器扩展包在非编辑器模式导入时会被保留。
项目文件
mcproject
单个编辑器项目的压缩存档包
创建项目存档的两种方式:
- 将项目目录的全部内容打包为 ZIP 文件后,将扩展名改为
mcproject
- 在编辑器模式中运行
/project export project
命令。存档将保存在com.mojang
文件夹的projectbackups
目录中
若游戏未运行,打开 mcproject
文件会直接进入编辑器模式。若游戏已运行但未处于编辑器模式,导入 mcproject
文件会失败。
资源文件
资源文件代表各种非世界类内容的独立实例:
- 行为包
- 资源包
- 皮肤包
- 世界模板
所有资源文件都包含描述其内容的清单文件(manifest)。若资源清单的 UUID 和版本号与同类型现有资源完全一致,导入将会失败。注意行为包和资源包共享相同的 UUID/版本号命名空间。内置于世界、项目或模板中的行为包/资源包不会被视为重复资源。
虽然 mcpack
和 mctemplate
功能相同,但建议遵循以下规范:
- 使用
mcpack
作为行为包、资源包、皮肤包 - 使用
mctemplate
作为世界模板 以便用户更直观地识别内容类型。复合文件中可包含任意数量的资源文件。
资源包
mcpack
代表单个行为包、资源包、皮肤包或世界模板的压缩包。建议仅将 mctemplate
用于世界模板。
手动创建方式:
- 将行为包、资源包或皮肤包目录的全部内容打包为 ZIP 文件后,将扩展名改为
mcpack
行为包与资源包会全局安装,不会与世界/项目/模板中安装的同名资源冲突。
行为包
行为包用于修改或扩展游戏玩法,安装在 com.mojang
目录下的 behavior_packs
文件夹中。
开发中的行为包需手动放置到 com.mojang
下的 development_behavior_packs
目录。
资源包
资源包用于修改客户端音效、视觉效果等,安装在 com.mojang
目录下的 resource_packs
文件夹中。
开发中的资源包需手动放置到 com.mojang
下的 development_resource_packs
目录。
皮肤包
皮肤包是仅限客户端的自定义皮肤资源,安装在 com.mojang
目录下的 skin_packs
文件夹中。
开发中的皮肤包需手动放置到 com.mojang
下的 development_skin_packs
目录,但此功能目前似乎不可用。
世界模板
mctemplate
代表单个行为包、资源包、皮肤包或世界模板的压缩包。建议仅将 mctemplate
用于世界模板。
世界模板安装在 com.mojang
目录下的 world_templates
文件夹中。创建方式:
- 将世界目录的全部内容打包为 ZIP 文件,添加模板清单文件后,将扩展名改为
mctemplate
- 在编辑器模式中点击游戏设置界面的"导出模板"按钮
- 在编辑器模式中运行
/project export template
命令。存档将保存在com.mojang
文件夹的projectbackups
目录中
复合文件
复合文件用于在一次导入操作中同时导入最多一个世界文件及任意数量的资源文件。通常复合文件中的内容需要预先打包,但资源类型(行为包/资源包/皮肤包/世界模板)的原始目录也可直接放在复合文件顶层(不可使用嵌套子目录)。
复合文件的内容按常规方式处理。例如在编辑器模式导入包含 mcworld
的 mcaddon
时,世界文件会作为项目导入。
复合文件可包含任意数量或层级的其他复合文件(跨模式也可)。但嵌套复合文件不能突破单世界导入限制。
复合文件只能通过手动打包现有文件/目录创建。
附加包
mcaddon
通用复合内容存档
在编辑器模式导入 mcaddon
时,包含的世界文件会作为项目导入。此时该世界将无法在编辑器模式之外访问,需重新导出为普通世界才能游玩。其他资源类型会正常导入。
编辑器附加包
mceditoraddon
专用于编辑器模式的复合内容存档
若游戏未运行,打开 mcproject
文件会直接进入编辑器模式。若游戏已运行但未处于编辑器模式,导入 mcproject
文件会失败。