附加包

“

一般来说，附加包基本就是一捆让你更改Minecraft世界运行规则的文件。想要身长八尺的小鸡？当然可以！想招募一支身着褶裙、听命于你的僵尸猪人大军？怪是够怪的，不过也可以！若你还想了解更多有关于附加包功能的示例，来看看我们的附加包单独页面。它们真的太给力了！

”

——Michael Ott

附加包（Add-on）是基岩版加入新内容或修改原有内容的一种手段，由行为包和资源包两部分组成，且分为原版附加包和自定义附加包。

作用

附加包是实现Minecraft全版本自定义（或者说是实现数据驱动）的坚实一步，其由json格式所编写，受Mojang官方支持。目前，仅基岩版平台支持附加包（包括Windows 10、Gear VR与Fire TV）。这些版本现在允许玩家更改世界的纹理样貌、物品及生物的模型、生物的行为等，这些功能可以由资源包和行为包来实现。此处提供的文档受官方支持与核实，是由Minecraft开发团队提供籍以协助社区发布的。

行为包通常与资源包一同出现，它们能改变生物、方块、玩家的行为。在较新版本的游戏中，添加新内容（如新的方块、物品、生物群系、粒子和实体）可以不必再覆盖游戏中的原有内容。行为包有两种类型：一种是对旧内容的修改（修改部分已有生物、方块或玩法，而不改变游戏特质）；另一种是对新内容的添加（添加新的游戏玩法、地图、物品、生物、Boss或结构但保留原有内容）。

附加包也常配套出现在市场的地图中，因为它们可以添加新的物品及其他内容。购买地图后，其所需要的所有附加包会在下载时被自动下载并添加到世界中。这些附加包依然可以被用于其他地图，但这始终取决于它的开发者是否允许。需要注意的是，市场是唯一的官方附加包商店，但也有一些附加包网站包含由开发者社区的非Minecraft合作伙伴制作的附加包，它们并非是盗版自市场的，而是原创作品。

目前而言，基岩版的新内容都是通过加入附加包来实现的。这些附加包在选项内被统一归类为“原版附加包”而无法移除。强制移除它们会导致游戏出现图形或者崩溃问题。

结构层次

附加包包含资源包与行为包两种不同的形式，它们的结构层次也各不相同。要构成一个有效的附加包，这个文件夹的根目录必须包含一个有效的manifest.json文件。除此之外，其他文件或文件夹的存在与否与该附加包的功能相关。

资源包

资源包一般存储于com.mojang文件夹中的resource_packs文件夹。

• 资源包名称或其内部ID
  • animation_controllers
  • animations
  • attachables
  • cameras
  • entity
  • fogs
  • font
  • items
  • library
  • materials
  • models
  • particles
  • render_controllers
  • sounds
    • music_definitions.json
    • sound_definitions.json
  • texts
    • language_names.json
    • languages.json
  • textures
    • flipbook_textures.json
    • item_texture.json
    • terrain_texture.json
    • textures_list.json
  • ui
  • biomes_client.json
  • blocks.json
  • bug_pack_icon.png
  • contents.json
  • loading_messages.json
  • manifest.json
  • manifest_publish.json
  • pack_icon.png
  • sounds.json
  • splashes.json

行为包

行为包一般存储于com.mojang文件夹中的behavior_packs文件夹。

• 行为包名称或其内部ID
  • behavior_trees
  • entities
  • feature_rules
  • features
  • items
  • loot_tables
  • recipes
  • scripts
  • spawn_rules
  • structures
  • texts
    • language_names.json
    • languages.json
  • trading
  • contents.json
  • manifest.json
  • manifest_publish.json
  • pack_icon.png

文档索引

• 基岩版附加包文档
• 基岩版动画文档
• 基岩版生物群系文档
• 基岩版方块文档
• 基岩版物品文档
• 基岩版实体文档
• 基岩版Molang文档
• 基岩版粒子文档
• 基岩版配方文档
• 基岩版模式文档
• 基岩版地物文档

教程

• 基岩版开发指南
• 制作行为包
• 制作资源包
• 自定义物品
• 自定义方块
• 自定义实体
• 自定义音效
• 修改实体模型

模板

正式版（1.19.2）

• 原版资源包（1.19.2）
• 原版行为包（1.19.2）

测试版（1.19.10.24）

• 资源包文件（1.19.10.24）
• 行为包文件（1.19.10.24）

GameTest框架实例

• mojang-gametest样例
• mojang-minecraft样例

历史

自从Minecraft的原始Java版早期开发以来，已经计划为开发人员实现添加和更改游戏内容的官方方式。官方游戏定制的计划可以追溯到2010年7月5日的Alpha v1.0.1_01，在发布之后计划称为Mod API。 据说它在Beta 1.8中发布。然后将Mod API重新命名为插件API，最初声明计划用于1.3的版本，然后用于1.4版本，然后由Curse意外地声明它将在1.5中实现。

在MINECON 2012，Mojang分享了他们对插件API未来的愿景。该API将由Bukkit团队开发并旨在简化模型和下载过程，虽然包含稍微有限的功能集。最初发布开发者网站后 (http://dev.minecraft.net) 和GitHub页面，这些都在一年内被删除。

开发人员曾多次提到，游戏代码中的许多更改都在准备插件API，包括2014年7月29日的Dinnerbone、Grum于2015年7月5日在“The Minecraft Team - Behind the Scenes”小组讨论和2015年10月19日，在Java版1.9的战利品表上工作时再次和Dinnerbone。一位用户回复说“我认为官方回复‘我们正在努力’真的会有很多帮助”。Dinnerbone回答说：“我们正在努力。”

2016年8月12日，Searge发推文说：“MINECON 2016上将会有关于API的消息。我会谈谈我正在研究的事情以及我们的计划。但现在没有更多细节。“第二天，Grum证实了携带版上的这一点。Minecon上概述了附加包开发的计划和路线图。

参见

• 数据包
• 基岩版函数

外部链接

• 附加包反馈链接
• 在Minecraft.net上的附加包相关内容
• 在CurseForge上的附加包
• 有关于不同种类的包的Minecraft.net博文贴