教程:制作附加包/包的构建

包的构建

系列教程

所属系列

制作附加包

难度

初级

适用版本

国际版

≥ 1.16.100.59

实践设备

◄◄ 开始之前

运行、调试与导出 ►►

引言

附加包主要包含行为包和资源包两部分。

行为包是附加包的一种，主要用于自定义实体、物品、方块、配方、战利品表、地物、生物群系等内容。同时行为包也是脚本引擎的载体，开发者编写的脚本引擎代码依托于行为包在游戏中发挥效用。

资源包同属于附加包的其中一类，主要用于自定义游戏资源相关的内容，例如：材质、模型、音乐、音效、语言文件、终末之诗、UI、闪烁标语的显示文本和字体等。

本教程主要讲解新建一个附加包的基本步骤。

基本架构

首先新建一个文件夹并命名为tutorial_behavior_pack 。

创建文件夹并命名为 tutorial_behavior_pack

此文件夹名称并未特殊要求与规定，在实际制作过程中，您可根据自己的需求命名，但由于通常会将行为包与资源包结合使用，故建议在命名时加上“behavior”、“Bev”或“BEV”等类似字样来表示行为包；加上“resource”、“Res”或“RES”等字样来表示资源包。然后在文件夹中新建一个名为manifest.json的JSON文件，同时向其中放入一张名称为pack_icon.png的PNG格式图片，该图片将作为您的包图标存在，这里建议使用 1 : 1 尺寸比例的图片，此时其文件结构如下：

•  tutorial_behavior_pack
  •  manifest.json
  •  pack_icon.png

清单文件

清单文件（文件名必须为manifest.json）包含了该附加包的所有基本信息。

接下来向清单文件中写入内容，下面是一段清单文件内容的示例：

{
    "format_version": 2,
    "header": {
      "description": "附加包教程示例-包的构建",
      "name": "Hello World!!!!",
      "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "version": [0, 0, 1],
      "min_engine_version": [1, 16, 200]
    },
    "modules": [
      {
        "description": "附加包教程示例-包的构建-启用行为包模块",
        "type": "data",
        "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "version": [0, 0, 1]
      }
    ]
  }

下表大致描述了其中各个属性的用法及意义：

属性名称	描述
format_version	定义了清单的当前版本。目前建议使用版本 2，除非有需要，否则请勿更改。
header	清单的头部信息 属性名称 数据类型 描述 description 字符串 关于附加包的简短说明。它会出现在游戏中附加包名称的下方，建议保持在 1 行以内。 name 字符串 定义您的附加包名称。这里作为第一个包，我们使用经典的 Hello World 作为包名。 uuid 字符串 一种特殊的标识符，游戏在加载过程中基于此区分不同的附加包。示例中并未给出，请使用 uuid 生成器来生成以保证其独特性。 version 数组 [a, b, c] 定义附加包的版本号，格式为 [主版本，副版本，修订版] (x.x.x) 导入同一个附加包时会用到，如果新的附加包版本更高，那么就替换为新版本；如果新的附加包版本低于旧版，则忽略。 min_engine_version 数组 [a, b, c] 定义能使用本附加包的 minecraft 的最低版本，可通过它确定附加包是否能向下兼容。
modules	描述了此附加包所拥有的模块，附加包的模块决定了该包的类型（如行为包与资源包就拥有不同类型的模块）。游戏在进行包验证时，会获取此包的模块，并验证其类型，通过其拥有模块的类型，确定此包的类型。 属性名称 数据类型 描述 type 字符串 模块的类型，此处填写 "data" 意味着此模块为一个行为包模块，即决定了此包将作为行为包在游戏中发挥效用。若您将值改为 "resources" ，则意味着此包带有一个资源模块，游戏在加载此包时，将会将其作为一个资源包进行加载。 description 字符串 关于此模块的简短说明，建议保持在 1 行以内。 uuid 字符串 一种特殊的标识符，用于区分不同的模块，格式同 header 中的 uuid 。注意，每个模块的的 uuid 都应该各不相同。 version 数组 [a, b, c] 此模块的版本号，格式同 header 中的 version。

打包与导入

接下来您只需要选中文件夹中所有文件，将其压缩为zip文件并修改后缀为mcpack即可。

在完成上述操作后，恭喜您，您已经成功制成了您的第一个包，正式成为了一名附加包开发者！！可喜可贺！（只不过这个包里还没有添加修改任何游戏内容）。

将您制作的包导入游戏，新建一个存档，在存档配置页面打开行为包栏，如果一切正常的话，您应该就可以看到您添加的包了。

< 开始之前 | 运行、调试与导出 >