什么是附加包？

附加包是一组用来改变 Minecraft 基岩版的文件。它可以添加新的物品、方块、生物、配方和声音，也可以修改游戏里已有的内容。你不需要改动游戏本身：Minecraft 会读取你的文件，并把它们加载到原版游戏之上。

最棒的是，附加包只由简单的文本文件和图片组成。只要你会编辑文本文件、会画一张 16x16 的图片，就能做出附加包。

两种包

大多数附加包由两个包组成，它们像一个团队一样协同工作。

行为包（BP）

行为包控制事物如何运作。它运行在游戏的“服务端”，也就是说由它来决定规则：

• 一把剑能造成多少伤害
• 一种食物能恢复多少饥饿值
• 生物看到玩家时会做什么
• 一个合成配方需要哪些物品
• 方块被破坏时会掉落什么

行为包主要是 JSON 文件，另外还有用于命令的 .mcfunction 文件和用于脚本的 JavaScript 文件。

资源包（RP）

资源包控制事物的外观和声音。它运行在“客户端”，也就是每个玩家自己的设备上：

• 纹理（物品、方块和生物身上的图片）
• 3D 模型和动画
• 声音和音乐
• 游戏中显示的名称，支持各种语言
• 粒子和部分菜单

为什么要分成两个包？

把外观和规则分开，让包变得非常灵活。纹理包其实就是一个没有行为包的资源包。只改变生物行为的包可以只有一个行为包。当你添加全新的东西，比如一把自定义的剑时，通常两个都需要：行为包说明它存在以及它如何运作，资源包给它纹理和名称。

来看一个小例子。行为包里的这个文件创建了一个新物品：

{
  "format_version": "1.26.30",
  "minecraft:item": {
    "description": {
      "identifier": "demo:ruby",
      "menu_category": {
        "category": "items"
      }
    },
    "components": {
      "minecraft:icon": {
        "textures": {
          "default": "ruby"
        }
      },
      "minecraft:max_stack_size": 64
    }
  }
}

图标名 "ruby" 指向资源包中注册的一张图片。如果没有资源包，这个物品依然存在，但不会有纹理。你会在你的第一个自定义物品中一步步做出这个物品。

你能改变什么？

附加包能做的事情很多。下面是你会在这个 Wiki 里学到的主要内容：

每个新东西都由组件搭建而成。组件是一个小功能，比如“这个物品可以吃”或者“这个方块会发光”。你可以像搭积木一样把组件组合在一起。物品组件参考页列出了每一个组件，并附有示例。

你会遇到的文件类型

下载附加包时，它通常是下面这几种文件之一：

• .mcpack：单个包（一个行为包或一个资源包）。它其实就是改了名字的 .zip 文件。
• .mcaddon：包含多个包的合集，通常是一个行为包和它对应的资源包。它同样是改了名的 .zip。
• .mcworld 和 .mctemplate：完整的世界和世界模板，里面可以包含包。

打开这些文件时，Minecraft 会自动导入它们。你会在导出并游玩中学习如何制作这些文件。

全平台通用

基岩版可以在 Windows、Android、iPhone 和 iPad、Xbox、PlayStation 以及 Nintendo Switch 上运行。附加包在所有这些平台上使用相同的文件。你在手机上做的包可以在朋友的电脑上运行，在电脑上做的包也能在手机上运行。

有几个限制需要了解：

• 在主机上你不能直接导入自己的文件。不过你仍然可以通过 Realm、服务器或市场来游玩附加包。
• 有些功能被标记为实验性。只有在世界中开启了对应的实验性玩法时，它们才会生效。现在大多数物品、方块和生物已经不需要任何实验性玩法了。

制作附加包的两种方式

手工方式。 你自己创建文件夹，在文本编辑器里写 JSON，在图片编辑器里画纹理，最后把所有东西打包压缩。这个 Wiki 会教你每一步，而且了解这些文件如何运作是一项很棒的技能。

简单方式。 GodCraft 是一款适用于 iPhone 和 Android 的免费应用，不用写代码就能制作附加包。你打开工坊，添加物品、方块或生物等对象，然后填写简单的表单。它会帮你写好所有 JSON、清单文件和 UUID，并导出一个可以直接在 Minecraft 中打开的 .mcaddon。

两种方式可以混合使用。很多创作者先用 GodCraft 快速做出一个能用的包，然后再阅读这个 Wiki 来理解每个文件的作用。

接下来读什么

1. 你需要的工具：需要安装什么，或者如何全部在手机上完成。
2. 你的第一个包：搭建文件夹和清单文件。
3. 5 分钟学会 JSON：每个附加包都会用到的文件格式。
4. 导出并游玩：把你的包放进游戏。