此特性為基岩版獨有。
此條目仍需完善。
你可以幫助我們擴充關於該主題的更多資訊。
原因：缺少歷史段落
“
一般來説，附加包基本就是一捆讓你變更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 | |
|---|---|
| 基岩版附加包 | |
| 外部網站 | |
語言