此特性为基岩版独有。
此条目仍需完善。
你可以帮助我们扩充关于该主题的更多信息。
原因：缺少历史段落
“
一般来说，附加包基本就是一捆让你更改Minecraft世界运行规则的文件。想要身长八尺的小鸡？当然可以！想招募一支身着褶裙、听命于你的僵尸猪人大军？怪是够怪的，不过也可以！若你还想了解更多有关于附加包功能的示例，来看看我们的附加包单独页面。它们真的太给力了！
”
——Michael Ott[1]
附加包（Add-on）是基岩版加入新内容或修改原有内容的一种手段，受Mojang官方支持。
概述[]
附加包允许玩家更改世界的纹理样貌、实体的模型、行为规则等，是实现Minecraft全版本自定义（即数据驱动）的坚实一步。
行为包是一种用于改变实体的行为、掉落物、生成规则、物品合成配方与村民交易表等的附加包。行为包不仅可以改变现有内容，还可以创建新的实体、方块及物品。为了实现版本控制，基岩版的部分新内容便是以附加包形式实现的，这些附加包在选项内被统一归类为“原版附加包”而无法移除。强制移除它们会导致游戏出现图形或者崩溃问题。
除了玩家社区自定义的玩法外，基岩版市场中的地图也常常会使用附加包。市场中的内容均由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
文档索引[]
教程[]
- 基岩版开发指南
- 制作行为包
- 制作资源包
- 自定义物品
- 自定义方块
- 自定义实体
- 自定义音效
- 修改实体模型
模板[]
资源包和行为包实例[]
脚本API实例[]
组件[]
组件（Component）是基岩版附加包中自定义一个对象的重要手段，大部分可自定义的对象都可以由一些组件在JSON文件中拼接而成，这些组件在游戏内部通过ECS（Entity-Component-System，实体-组件-系统）架构被添加至自定义的对象上，并成为其属性的一部分。有一些自定义对象的组件较为特殊，但他们仍然在形式上或本质上是一种组件。比如实体的生成规则中的条件（Condition），其本质是一种组件。组件被分为很多种，除了比较特殊的条件之外，组件一般有最一般的基础组件、触发器、属性（Property）、特性（Attribute）、AI意向等。有些分类是因为其在游戏内部的本质不同，比如属性（Property）和特性（Attribute），有些分类则单纯是因为其表现有异。
物品[]
- 基础组件
| 名称 | 可用性
|
实验性玩法
|
走出实验版本
|
描述
|
|---|---|---|---|---|
| minecraft:allow_off_hand | 可用 | 假日创作者功能 | 1.20.20 | 允许物品装备在副手槽。 |
| minecraft:animates_in_toolbar | 已移除 | 假日创作者功能 | 未走出 | 设置物品栏动画。 |
| minecraft:armor | 已弃用 | 假日创作者功能 | 未走出 | 决定护甲物品的防护等级。 |
| minecraft:block_placer | 可用 | 假日创作者功能 | 1.20.10 | 该物品在指定方块上可以放置出什么方块。 |
| minecraft:can_destroy_in_creative | 可用 | 假日创作者功能 | 1.20.10 | 设置挥舞此物品时是否能在创造模式下破坏方块。 |
| minecraft:chargeable | 可用 | 假日创作者功能 | 未走出 | 设置物品为可蓄力物品。 |
| minecraft:cooldown | 可用 | 假日创作者功能 | 1.20.10 | 设置物品的使用类型，并且设置使用后的冷却时间。 |
| minecraft:creative_category | 已弃用 | 假日创作者功能 | 未走出 | 注册物品到创造模式物品栏及其分组。 |
| minecraft:damage | 可用 | 假日创作者功能 | 1.20.20 | 设置物品的攻击伤害。 |
| minecraft:digger | 可用 | 假日创作者功能 | 1.20.20 | 设置物品的挖掘属性。 |
| minecraft:display_name | 可用 | 假日创作者功能 | 1.20.0 | 设置物品的本地化键名。 |
| minecraft:durability | 可用 | 假日创作者功能 | 1.20.0 | 设置物品的耐久度。 |
| minecraft:dye_powder | 可用 | 未知 | 未知 | 设置可作为染料使用。 |
| minecraft:enchantable | 可用 | 假日创作者功能 | 1.20.30 | 设置物品的附魔属性。 |
| minecraft:entity_placer | 可用 | 假日创作者功能 | 1.20.0 | 设置生成指定实体。 |
| minecraft:explodable | 已移除 | 假日创作者功能 | 未走出 | 设置物品的实体形式是否可以被爆炸摧毁。 |
| minecraft:food | 可用 | 假日创作者功能 | 1.20.30 | 设置物品为食物。 |
| minecraft:frame_count | 可用 | 未知 | 未知 | 设置物品的动画帧数。 |
| minecraft:fuel | 可用 | 假日创作者功能 | 1.20.0 | 设置物品为燃料。 |
| minecraft:glint | 可用 | 假日创作者功能 | 1.20.0 | 使物品拥有附魔光泽。 |
| minecraft:hand_equipped | 可用 | 假日创作者功能 | 1.20.20 | 设置物品是否以工具或武器的方式渲染（即手持时贴图竖直渲染）。 |
| minecraft:hover_text_color | 可用 | 假日创作者功能 | 1.20.10 | 设置物品悬浮文本的颜色。 |
| minecraft:icon | 可用 | 假日创作者功能 | 1.20.0 | 设置物品的图标纹理。 |
| minecraft:icon_variant | 可用 | 未知 | 未知 | |
| minecraft:icon_atlas | 可用 | 未知 | 未知 | |
| minecraft:ignores_permission | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:item_storage | 可用 | 假日创作者功能 | 未走出 | 设置物品为收纳袋。 |
| minecraft:interact_button | 可用 | 假日创作者功能 | 未走出 | 设置物品的移动端HUD交互按钮。 |
| minecraft:knockback_resistance | 已移除 | 假日创作者功能 | 未走出 | 物品的击退抗性。 |
| minecraft:liquid_clipped | 可用 | 假日创作者功能 | 1.20.20 | 设置物品是否可与流体互动。 |
| minecraft:max_stack_size | 可用 | 假日创作者功能 | 1.20.10 | 设置物品的最大堆叠数量。 |
| minecraft:mining_speed | 已弃用 | 假日创作者功能 | 未走出 | 设置物品挖掘速度。 |
| minecraft:mirrored_art | 已移除 | 假日创作者功能 | 未走出 | 设置物品的纹理是否镜像翻转。 |
| minecraft:portfolio | 可用 | 未知 | 未知 | 设置物品为公文包。 |
| minecraft:projectile | 可用 | 假日创作者功能 | 1.20.10 | 允许物品作为弹射物的物品形式。 |
| minecraft:record | 可用 | 假日创作者功能 | 1.20.10 | 设置物品为唱片。 |
| minecraft:render_offsets | 已弃用 | 假日创作者功能 | 未走出 | 设置物品的渲染偏移量。 |
| minecraft:repairable | 可用 | 假日创作者功能 | 1.20.10 | 允许物品被修复。 |
| minecraft:requires_interact | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:shooter | 可用 | 假日创作者功能 | 1.20.10 | 设置物品可被装填（即远程填装发射武器，例如弓）。 |
| minecraft:should_despawn | 可用 | 假日创作者功能 | 1.20.20 | 设置物品的实体形式是否可以超时消失。 |
| minecraft:stacked_by_data | 可用 | 假日创作者功能 | 1.20.20 | 是否根据数据值堆叠物品。 |
| minecraft:throwable | 可用 | 假日创作者功能 | 1.20.10 | 设置物品为投掷物。 |
| minecraft:use_animation | 可用 | 假日创作者功能 | 1.20.20 | 设置物品的使用动画。 |
| minecraft:use_duration | 可用 | 假日创作者功能 | 1.20.20 | 设置物品的使用时间。 |
| minecraft:weapon | 已弃用 | 假日创作者功能 | 未走出 | 设置物品为武器。这会自动添加伤害信息和攻击事件。 |
| minecraft:wearable | 可用 | 假日创作者功能 | 1.20.20 | 设置物品为装备。 |
- 触发器
| 名称 | 可用性
|
实验性玩法
|
走出实验版本
|
描述
|
|---|---|---|---|---|
| minecraft:on_use | 已弃用 | 假日创作者功能 | 未走出 | 物品使用后触发事件。 |
| minecraft:on_use_on | 已弃用 | 假日创作者功能 | 未走出 | 物品在方块上使用后触发事件。 |
方块[]
- 基础组件
| 名称 | 可用性
|
实验性玩法
|
走出实验版本 | 描述
|
|---|---|---|---|---|
| minecraft:breakonpush | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:breathability | 已移除 | 假日创作者功能 | 未走出 | 设置该方块的透气性，以及是否将其视为固体或空气的属性。 |
| minecraft:collision_box | 可用 | 假日创作者功能 | 1.19.50 | 设置方块的碰撞箱。 |
| minecraft:crafting_table | 可用 | 假日创作者功能 | 1.19.50 | 设置与方块互动时打开一个合成界面。 |
| minecraft:creative_category | 已弃用 | 假日创作者功能 | 未走出 | 注册方块到创造模式物品栏及其分组。 |
| minecraft:destructible_by_explosion | 可用 | N/A | N/A | 设置方块是否可被爆炸破坏以及防爆属性。 |
| minecraft:destructible_by_mining | 可用 | N/A | N/A | 设置方块是否可被挖掘破坏以及破坏时间。 |
| minecraft:display_name | 可用 | 假日创作者功能 | 1.19.60 | 设置方块物品显示的悬浮文本。 |
| minecraft:flammable | 可用 | N/A | N/A | 设置方块的可燃性。 |
| minecraft:friction | 可用 | N/A | N/A | 设置方块的摩擦力。 |
| minecraft:geometry | 可用 | 假日创作者功能 | 1.19.40 | 设置方块模型。 |
| minecraft:immovable | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:light_dampening | 可用 | N/A | N/A | 设置方块减弱的光照强度。（调整方块的透光强度，如果不设置，默认为不透光） |
| minecraft:light_emission | 可用 | N/A | N/A | 设置方块发出的光照强度。 |
| minecraft:loot | 可用 | N/A | N/A | 设置方块的掉落物。 |
| minecraft:map_color | 可用 | N/A | N/A | 设置方块在地图上显示的颜色。 |
| minecraft:material_instances | 可用 | 假日创作者功能 | 1.19.40 | 将模型文件中的面或渲染映射到实际的纹理。 |
| minecraft:onlypistonpush | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:part_visibility | 已弃用 | 即将到来的创作者功能 | 未走出 | 设置方块在指定条件下显示部分模型。 |
| minecraft:placement_filter | 可用 | 假日创作者功能 | 1.19.60 | 设置方块被放置时应满足的条件。 |
| minecraft:preventsjumping | 已移除 | 假日创作者功能 | 未走出 | |
| minecraft:queued_ticking | 可用 | 假日创作者功能 | 未走出 | 计划刻计时器。 |
| minecraft:random_ticking | 可用 | 假日创作者功能 | 未走出 | 随机刻计时器。 |
| minecraft:rotation | 可用 | 假日创作者功能 | 未走出 | 设置方块围绕方块中心的旋转角度。 |
| minecraft:selection_box | 可用 | 假日创作者功能 | 1.19.60 | 设置方块的击中箱。 |
| minecraft:unit_cube | 可用 | 假日创作者功能 | 未走出 | 设置方块为单位方块。 |
| minecraft:unwalkable | 可用 | 假日创作者功能 | 未走出 | 设置该方块是否不能被越过。 |
- 触发器
| 名称 | 可用性
|
实验性玩法
|
走出实验版本 | 描述
|
|---|---|---|---|---|
| minecraft:on_fall_on | 可用 | 假日创作者功能 | 未走出 | 设置活动对象摔落到该方块上时执行的事件。 |
| minecraft:on_interact | 可用 | 假日创作者功能 | 未走出 | 设置玩家与该方块互动（例如右键点击）时执行的事件。 |
| minecraft:on_placed | 可用 | 假日创作者功能 | 未走出 | 设置该方块被放置时执行的事件。 |
| minecraft:on_player_destroyed | 可用 | 假日创作者功能 | 未走出 | 设置玩家破坏该方块时执行的事件。 |
| minecraft:on_player_placing | 可用 | 假日创作者功能 | 未走出 | 设置玩家放置该方块时执行的事件。 |
| minecraft:on_step_off | 可用 | 假日创作者功能 | 未走出 | 当实体离开该方块时执行的事件。 |
| minecraft:on_step_on | 可用 | 假日创作者功能 | 未走出 | 当实体踩上该方块时执行的事件。 |
实体[]
与物品和方块组件不同，一些实体组件通过JSON文件定义后会在游戏内部被挂接在实体实例上，并随实体一同保存至存档中。一些实体组件在JSON文件中可以通过分组的形式打包在一起，被称为实体的组件组（Component Group）。一个实体在世界中活动时，会通过某些逻辑向自己添加或移除一些组件组，并通过该方式更新自己的组件，这些添加和移除操作也会作为一个实体的定义一并存储在实体的存档中。
参见[]
参考[]
外部链接[]
| 版本 |
| ||||||
|---|---|---|---|---|---|---|---|
| 开发 |
| ||||||
| 技术性 | |||||||
| 多人游戏 | |||||||
| 特色功能 | |||||||
| 官方Mod | |
|---|---|
| 基岩版附加包 |
|
| 外部网站 | |
语言