Bundle
Rarity tier |
Common |
---|---|
Renewable |
Yes |
Stackable |
No |
{ "title": "Bundle", "rows": [ { "field": "Common", "label": "(link to Rarity article, displayed as Rarity tier)" }, { "field": "Yes", "label": "(link to Renewable resource article, displayed as Renewable)" }, { "field": "No", "label": "Stackable" } ], "invimages": [ "Bundle", "White Bundle", "Light Gray Bundle", "Gray Bundle", "Black Bundle", "Brown Bundle", "Red Bundle", "Orange Bundle", "Yellow Bundle", "Lime Bundle", "Green Bundle", "Cyan Bundle", "Light Blue Bundle", "Blue Bundle", "Purple Bundle", "Magenta Bundle", "Pink Bundle" ], "images": [ "Bundle.png", "Bundle Open.png", "White Bundle.png", "White Bundle Open.png", "Light Gray Bundle.png", "Light Gray Bundle Open.png", "Gray Bundle.png", "Gray Bundle Open.png", "Black Bundle.png", "Black Bundle Open.png", "Brown Bundle.png", "Brown Bundle Open.png", "Red Bundle.png", "Red Bundle Open.png", "Orange Bundle.png", "Orange Bundle Open.png", "Yellow Bundle.png", "Yellow Bundle Open.png", "Lime Bundle.png", "Lime Bundle Open.png", "Green Bundle.png", "Green Bundle Open.png", "Cyan Bundle.png", "Cyan Bundle Open.png", "Light Blue Bundle.png", "Light Blue Bundle Open.png", "Blue Bundle.png", "Blue Bundle Open.png", "Purple Bundle.png", "Purple Bundle Open.png", "Magenta Bundle.png", "Magenta Bundle Open.png", "Pink Bundle.png", "Pink Bundle Open.png" ] }
A bundle is an item that can store up to a stack's worth of mixed item types within itself in a single inventory slot. Items that stack to less than 64 occupy more space within the bundle, and items that do not stack occupy the entire bundle without allowing space for any other items.
Dyed bundles are the dyed variants of bundles.
Obtaining[edit | edit source]
Crafting[edit | edit source]
Name | Ingredients | [hide]Crafting recipe |
---|---|---|
Bundle | String + Leather |
|
Dyed Bundle | Any Bundle + Matching Dye |
Generated loot[edit | edit source]
Item | Structure | Container | Quantity | [hide]Chance |
---|---|---|---|---|
Java Edition and Bedrock Edition | ||||
![]() |
![]() |
Desert house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Desert house chest" } |
Plains house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Plains house chest" } | ||
Snowy house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Snowy house chest" } | ||
Weaponsmith's chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Weaponsmith's chest" } | ||
Savanna house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Savanna house chest" } | ||
Cartographer's chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Cartographer's chest" } | ||
Taiga house chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Taiga house chest" } | ||
Tanner's chest | 1 | 33.3%{ "item": "Bundle", "stacksize": 1, "chance": 0.33333333333333337, "structure": "Village", "container": "Tanner's chest" } |
Usage[edit | edit source]
Bundles are used to store different item types in the same inventory slot. This does not, however, increase the total capacity of the slot, as bundles can only store what adds up to a single slot. Items that can normally stack up to 64 take up 1/64 of a bundle, items that can normally stack up to 16 (eg. eggs) take up 1/16 of a bundle, and items that can't stack take up the entirety of a bundle (with exception to bundles themselves). On Java Edition, space that an item takes up in a bundle is equal to the reciprocal of its max_stack_size component, even if it is different from the standard 1, 16, and 64.
Bundles are not stackable, but they are able to be placed (nested) inside another[1], and will always take up 1/16 of the space of a bundle, regardless of their max_stack_size component, plus the space occupied by the inner bundle's contents.
Shulker boxes cannot be placed inside of bundles. However, bundles can be placed inside of shulker boxes.
Inserting and retrieving[edit | edit source]
Items are inserted into bundles by left-clicking, and retrieved by right-clicking.
To place items inside a bundle, either (1) pick up the bundle in the inventory and left-click on the item(s) to be placed inside or (2) pick up the item(s) and left-click on the bundle. When placing a bundle inside another bundle, the interface uses the first method: picking up bundle A and right clicking on bundle B attempts to store bundle B inside A.
Items can be retrieved from bundles in one of five ways:
- Right-clicking on bundles in an inventory, without holding anything with the cursor, will cause the cursor to hold the item from the most recently added slot of the bundle.
- Scrolling on bundles in an inventory allows for scrolling through the bundle's slots, which starts off as the most recently added slot, and is displayed with a bright underlay behind that slot. During this process, the bundle's icon will appear open, and the selected slot's item icon will appear within the bundle's icon, though this is not shown in the player's hand. If the bundle is right-clicked while in this state, the currently selected item will move to the cursor and the bundle will close. If the cursor is moved off the bundle while it's still open, the bundle will close.
- Right-clicking on bundles in an inventory while they are held in the cursor and are hovering over an empty slot where can be placed will cause that item to be placed in that slot.
- Using a bundle while it is selected in the hotbar will cause the contents of the most recently added slot to be thrown out in the direction the player is facing.
- When a bundle item entity is destroyed, the contents of the bundle are dropped as items, similar to when a shulker box is destroyed.
GUI[edit | edit source]

Hovering over a bundle reveals its blue fullness bar. When the bundle is empty, the fullness bar says "Empty" and shows the description, "Can hold a mixed stack of items". If it's completely full, the fullness bar turns red and says "Full". When there is at least one item in a bundle, space will open up above the bar, which displays the items in the bundle's slots, sorted by how recently they were added, from right to left. The space where the slots are shown is only wide enough for four slots, so additional space opens up for new rows. When there are more than three rows, only the top three will be displayed, and the bottom-right slot will be replaced by text that says, +<number of slots hidden>, where the slot replaced by the text counts toward that number.
Bundles show an additional fullness bar on their icons, in a similar way to how items that take damage show their durability. Bundle fullness bars are blue, or red when full, and appear when the bundle contains at least one item.
Sounds[edit | edit source]
[hide] Sounds | ||||||||
---|---|---|---|---|---|---|---|---|
Sound | Subtitles | Source | Description | Resource location | Translation key | Volume | Pitch | Attenuation distance |
Bundle empties | Players | When a bundle's items are thrown onto the ground | item | subtitles | 0.8 | varies [sound 1] | 16 | |
Item packed | Players | When items are placed into a bundle | item | subtitles | 0.8 | varies [sound 2] | 16 | |
Bundle full | Players | When items cannot be placed into a bundle | item | subtitles | 1.0 | 1.0 | 16 | |
Item unpacked | Players | When items are removed from a bundle | item | subtitles | 0.8 | varies [sound 3] | 16 |
[hide] Sounds | |||||
---|---|---|---|---|---|
Sound | Source | Description | Resource location | Volume | Pitch |
Players | When a bundle's items are thrown onto the ground | bundle | 1.0 | varies | |
Players | When items are placed into a bundle | bundle | 1.0 | varies | |
Players | When items cannot be placed into a bundle | bundle | 1.0 | 1.0 | |
Players | When items are removed from a bundle | bundle | 1.0 | varies[sound 3] |
Data values[edit | edit source]
ID[edit | edit source]
Name | Identifier | Form | Item tags | [hide]Translation key |
---|---|---|---|---|
![]() | bundle | Item | bundles | item |
![]() | white_bundle | Item | bundles | item |
![]() | orange_bundle | Item | bundles | item |
![]() | magenta_bundle | Item | bundles | item |
![]() | light_blue_bundle | Item | bundles | item |
![]() | yellow_bundle | Item | bundles | item |
![]() | lime_bundle | Item | bundles | item |
![]() | pink_bundle | Item | bundles | item |
![]() | gray_bundle | Item | bundles | item |
![]() | light_gray_bundle | Item | bundles | item |
![]() | cyan_bundle | Item | bundles | item |
![]() | purple_bundle | Item | bundles | item |
![]() | blue_bundle | Item | bundles | item |
![]() | brown_bundle | Item | bundles | item |
![]() | green_bundle | Item | bundles | item |
![]() | red_bundle | Item | bundles | item |
![]() | black_bundle | Item | bundles | item |
Name | Identifier | Numeric ID | Form | [hide]Translation key |
---|---|---|---|---|
![]() | bundle | 260 | Item | item |
![]() | white_bundle | 272 | Item | item |
![]() | orange_bundle | 268 | Item | item |
![]() | magenta_bundle | 267 | Item | item |
![]() | light_blue_bundle | 264 | Item | item |
![]() | yellow_bundle | 273 | Item | item |
![]() | lime_bundle | 266 | Item | item |
![]() | pink_bundle | 269 | Item | item |
![]() | gray_bundle | 262 | Item | item |
![]() | light_gray_bundle | 265 | Item | item |
![]() | cyan_bundle | 261 | Item | item |
![]() | purple_bundle | 270 | Item | item |
![]() | blue_bundle | 258 | Item | item |
![]() | brown_bundle | 259 | Item | item |
![]() | green_bundle | 263 | Item | item |
![]() | red_bundle | 271 | Item | item |
![]() | black_bundle | 257 | Item | item |
Item data[edit | edit source]
- [NBT Compound / JSON Object] components: the item's components tag.
- [NBT List / JSON Array] minecraft:bundle_contents: The items stored inside this bundle.
- [NBT Compound / JSON Object]: A single item stack.
- Tags common to all items see Template:Nbt inherit/itemnoslot/template
- [NBT Compound / JSON Object]: A single item stack.
- [NBT List / JSON Array] minecraft:bundle_contents: The items stored inside this bundle.
Videos[edit | edit source]
History[edit | edit source]
October 3, 2020 | ![]() ![]() | ||||||||
---|---|---|---|---|---|---|---|---|---|
October 16, 2021 | Ulraf states that bundles are not included in Caves & Cliffs. | ||||||||
November 17, 2021 | Bundles are announced to be added after The Wild Update. | ||||||||
September 28, 2024 | Bundles are announced to be added in the Bundles of Bravery drop. | ||||||||
[hide]Java Edition | |||||||||
1.17 | 20w45a | ![]() ![]() | |||||||
The crafting recipe was originally 2 strings and 6 rabbit hides.
| |||||||||
20w46a | ![]() ![]() | ||||||||
Hovering over bundles now shows its contained items in special slots, similar to slots in the inventory. If the bundle is not full, it also has an empty slot with a plus on it. | |||||||||
20w48a | Bundles now show fullness as a number when advanced tooltips are enabled. | ||||||||
Using a bundle in the inventory now empties one item from the bundle instead of emptying all the contents out to the inventory. | |||||||||
Using a bundle now throws out its entire content into the world. | |||||||||
20w49a | Bundle fullness is now always shown. | ||||||||
Full bundles now show the blue bar instead of hiding it, to distinguish from empty bundles. | |||||||||
20w51a | Bundles now drop its contents when destroyed as an item entity. | ||||||||
Bundle fullness has been changed from Fullness: <fullness> / 64 to <fullness>/64
| |||||||||
The slots in the tooltip when hovering over bundles have changed to have a border, and rows of slot have a thicker edge between them. | |||||||||
When the bundle is not full, it instead shows empty slots instead of one slot with a plus. When it is full, those empty slots become greyed out with an X. | |||||||||
21w05a | The player now receives a tutorial when first having a bundle in the inventory. | ||||||||
21w19a | Bundles are now accessible only through commands. | ||||||||
1.18 | Experimental Snapshot 1 | Bundles are now available in the creative inventory and can be crafted once again. | |||||||
21w37a | Bundles are once again accessible only through commands. | ||||||||
1.19.3 Experiment | 22w42a | Bundles have been made available once again, and have been moved behind their own data pack. | |||||||
1.21.2 Experiment | 24w33a | Bundles are now crafted with one string and one leather instead of two string and six rabbit hide.
| |||||||
![]() ![]() ![]() | |||||||||
The closed texture is now used as the default instead of the open texture. | |||||||||
The tooltip has been updated to a sub-menu, wherein the player can now scroll to select an item to take out. | |||||||||
24w34a | The bundle's tooltip now fits 3 rows and can always show at least 8 item types. | ||||||||
24w35a | The number keys can no longer be used to select items in a bundle. | ||||||||
24w36a | When a bundle is used in the hotbar, one group of items is emptied at a time instead of everything being emptied at once. | ||||||||
24w38a | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | ||||||||
1.21.2 | 24w39a | Bundles are now available without toggling its respective data pack. | |||||||
1.21.4 | 24w46a | Items in the bundle tooltip now have a gray background. | |||||||
![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | |||||||||
1.21.5 | 25w07a | Bundles can now be found in some village chests. | |||||||
[hide]Bedrock Edition | |||||||||
June 29, 2024 | ![]() | ||||||||
1.21.30 Experiment | Preview 1.21.30.23 | ![]() ![]() ![]() ![]() | |||||||
Preview 1.21.30.24 | The bundle's tooltip now fits 3 rows and can always show at least 8 item types. | ||||||||
1.21.40 Experiment | Preview 1.21.40.20 | When a bundle is used in the hotbar, one group of items is emptied at a time instead of everything being emptied at once. | |||||||
Preview 1.21.40.22 | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | ||||||||
1.21.40 | Preview 1.21.40.23 | ![]() | |||||||
Bundles are now available without toggling its respective experimental toggle. | |||||||||
1.21.50 | Preview 1.21.50.28 | Items in the bundle tooltip now have a gray background. | |||||||
Preview 1.21.50.29 | Using the scroll wheel when hovering a bundle placed in hotbar with creative inventory search tab active now selects an item in the bundle. | ||||||||
1.21.60 | Preview 1.21.60.24 | ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() ![]() | |||||||
1.21.70 | Preview 1.21.70.23 | Bundles can now be found in some village chests. |
Issues[edit | edit source]
Issues relating to "Bundle" are maintained on the bug tracker. Issues should be reported and viewed there.
Trivia[edit | edit source]
- Bundles are inspired by the ancient Roman coin purse, which have been used for thousands of years.[2]
- The reason for why bundles can be dyed in 16 colors rather than a combination of multiple colors (like leather armor) is that Mojang considered it more important for players to be able to quickly identify the color of the bundle rather than being able to fully customize the color.[3]
- Bundles are the first non-block item that uses the 16 color dyes versus the 2^24 leather dye system.[4]
- Bundle is the last feature announced at Minecraft Live 2020 to be released. Minecraft Live 2020 took place on October 3, 2020 with the bundles announced for the Caves & Cliffs update while Bundles of Bravery was not released until 4 years and 19 days later on October 22, 2024.
Gallery[edit | edit source]
Mojang screenshots[edit | edit source]
-
The old bundle UI shown at Minecraft Live 2020.
-
The old bundle UI.
-
A bundle of bundles on the beach.
-
Some items being put into a bundle.
-
A bundle being used to store food.
-
Bundle in hand.
-
Some bundles floating next to a jungle.
-
A bundle hovering near a rabbit.
-
Makena holding a bundle.
-
Ari with a collection of dyed bundles.
-
A fox hanging out with dyed bundles.
-
A sheep and rows of dyed bundles.
-
Sunny in front of a collection of dyed bundles.
-
Several dyed bundles.
-
Several bundles in Kai's inventory.
In other media[edit | edit source]
-
Alex with bundles on head.
-
Ari using a bundle in the Bundles of Bravery - Official Trailer.
References[edit | edit source]
- ↑ MC-203567 — Bundles can be placed inside of bundles — resolved as "Works As Intended".
- ↑ "BUNDLES ARE FINALLY IN MINECRAFT!" – Minecraft on YouTube, October 23, 2024
- ↑ "Implementing Bundles has been quite the journey, and I'm extremely proud of the team for where they've gotten the feature at this point" – @Xilefian on X (formerly Twitter), September 29, 2024
"For leather armours the dye system is part of the self expression of wearing the armour (which is a primary feature of those items)
Bundles are closer to Shulker Boxes: It is more important a player can quickly see a colour and judge the contents of the container
(1/2)" – @Xilefian on X (formerly Twitter), September 29, 2024
"And to make sure players can quickly see and judge a colour it's best we have artists pick the ideal set of colours
We can tweak each of those 16 bundle textures, versus having artists trying to tweak the visibility of 16,777,216 colours that the leather dye system provides
(2/2)" – @Xilefian on X (formerly Twitter), September 29, 2024
"For context I asked the team the same question when I was reviewing the Bedrock code because - by chance - Bundles are the first non-block item that uses the 16 colour dyes versus the 2^24 leather dye system (which non-block items have used up until Bundles)" – @Xilefian on X (formerly Twitter), September 29, 2024 - ↑ "For context I asked the team the same question when I was reviewing the Bedrock code because - by chance - Bundles are the first non-block item that uses the 16 colour dyes versus the 2^24 leather dye system (which non-block items have used up until Bundles)" – @Xilefian on X (formerly Twitter), September 29, 2024