Shulker Box

From Minecraft Wiki
Jump to: navigation, search
This article is about the storage block. For the hostile End city mob, see Shulker. For the item that drops from the mob, see Shulker Shell.
Shulker Box
Shulker Box.gif
White Shulker Box.pngLight Gray Shulker Box.pngGray Shulker Box.pngBlack Shulker Box.pngBrown Shulker Box.pngRed Shulker Box.pngOrange Shulker Box.pngYellow Shulker Box.pngLime Shulker Box.pngGreen Shulker Box.pngCyan Shulker Box.pngLight Blue Shulker Box.pngBlue Shulker Box.pngPurple Shulker Box.pngMagenta Shulker Box.pngPink Shulker Box.png
Renewable

Yes

Stackable

No

Tool

Blast resistance

6

Hardness

2

Luminant

No

Transparent

Yes

Flammable

No

Catches fire from lava

No

A shulker box is a block that can store and transport items.

Obtaining[edit]

Breaking[edit]

Shulker boxes can be mined with any tool or by hand, but using a pickaxe is the most effective. Shulker boxes drop themselves when mined. Unlike other containers, the contents of shulker boxes are stored within the dropped item, and not dropped separately. When instantly mined in Creative mode, shulker boxes drop as an item if there are items stored within, unless /gamerule doTileDrops is set to "false".

Block Shulker Box
Hardness 2
Tool
Breaking time[A]
Default 3
Wooden 1.5
Stone 0.75
Iron 0.5
Diamond 0.4
Netherite 0.35
Golden 0.25
  1. Times are for unenchanted tools as wielded by players with no status effects, measured in seconds. For more information, see Breaking § Speed.

Crafting[edit]

Name Ingredients Crafting recipe Description
Shulker Box Shulker Shell +
Chest

Shulker Box Any Shulker Box +
Matching Dye


The shulker box retains its contents. If it is renamed on an anvil, it also retains its contents.
Ingredients Crafting recipe Description
Any Shulker Box +
Bone Meal or
Lapis Lazuli or
Cocoa Beans or
Ink Sac


[Bedrock and Education editions only]

Usage[edit]

A shulker box has 27 inventory slots, the same as a chest.

Shulker boxes are portable chests: they keep their items when broken, which can be retrieved when placed again. This is different from other containers, which drop their contained items as item entities when broken. A shulker box drops itself as an item if pushed by pistons or destroyed by an explosion. When a shulker box with items inside is held or in a container's inventory, the items are listed as properties.

Items inside the shulker box are listed below the block type properties.

A shulker box's items can be fed or removed by a hopper.

Shulker boxes can be stored in all containers except for other shulker boxes and bundles.

When placed on a wall or ceiling, shulker boxes face and open sideways or upside-down, respectively. Shulker boxes cannot be opened if a solid opaque block is on their top surface, similar to a chest. For example, if a shulker box is facing upside-down and a solid opaque block is below it, the shulker box cannot be opened. A shulker box can also be placed using dispensers.

Like a chest, a shulker box requires a transparent area above to be opened, and it opens only if the hitbox of the top of the open shulker box does not intersect with another hitbox. This way, a shulker box can be opened with an upside-down slab or an upper trapdoor on top of it. It is also unique in that when opened, its hitbox expands to 1.5 blocks high/wide, physically pushing entities where it is facing.

By default, the GUI of a shulker box is labeled "Shulker Box", which can be changed by naming it in an anvil or by changing the CustomName tag using the /data command‌[Java Edition only].

Undyeing[edit]

Dyed shulker boxes can be undyed using a cauldron. To do this, use a dyed shulker box on a cauldron that has water in it. This causes the cauldron's water level to decrease by 1, and the shulker box loses its dye color.

Piglins[edit]

Piglins become hostile toward players who open or mine shulker boxes.

Sounds[edit]

Generic[edit]

Java Edition:

SoundSubtitleSourceDescriptionNamespaced IDTranslation keyVolumePitchAttenuation
distance
Block brokenBlocksOnce the block has brokenblock.stone.breaksubtitles.block.generic.break1.00.816
None[sound 1]BlocksFalling on the block with fall damageblock.stone.fallNone[sound 1]0.50.7516
Block breakingBlocksWhile the block is in the process of being brokenblock.stone.hitsubtitles.block.generic.hit0.250.516
Block placedBlocksWhen the block is placedblock.stone.placesubtitles.block.generic.place1.00.816
FootstepsBlocksWalking on the blockblock.stone.stepsubtitles.block.generic.footsteps0.151.016
  1. a b MC-177082

Bedrock Edition:

SoundSourceDescriptionNamespaced IDVolumePitch
BlocksOnce the block has brokendig.stone1.00.8
BlocksFalling on the block with fall damagefall.stone0.41.0
BlocksWhile the block is in the process of being brokenhit.stone0.370.5
?BlocksJumping from the blockjump.stone0.121.0
?BlocksFalling on the block without fall damageland.stone0.221.0
BlocksWalking on the blockstep.stone0.31.0
BlocksWhen the block is placeduse.stone1.00.8

Unique[edit]

Java Edition:

SoundSubtitleSourceDescriptionNamespaced IDTranslation keyVolumePitchAttenuation
distance
Shulker closes??block.shulker_box.closesubtitles.block.shulker_box.close??16
Shulker opens??block.shulker_box.opensubtitles.block.shulker_box.open??16

Data values[edit]

ID[edit]

Java Edition:

NameNamespaced IDBlock tags (JE)FormTranslation key
Shulker Boxshulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.shulker_box
White Shulker Boxwhite_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.white_shulker_box
Orange Shulker Boxorange_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.orange_shulker_box
Magenta Shulker Boxmagenta_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.magenta_shulker_box
Light Blue Shulker Boxlight_blue_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.light_blue_shulker_box
Yellow Shulker Boxyellow_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.yellow_shulker_box
Lime Shulker Boxlime_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.lime_shulker_box
Pink Shulker Boxpink_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.pink_shulker_box
Gray Shulker Boxgray_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.gray_shulker_box
Light Gray Shulker Boxlight_gray_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.light_gray_shulker_box
Cyan Shulker Boxcyan_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.cyan_shulker_box
Purple Shulker Boxpurple_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.purple_shulker_box
Blue Shulker Boxblue_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.blue_shulker_box
Brown Shulker Boxbrown_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.brown_shulker_box
Green Shulker Boxgreen_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.green_shulker_box
Red Shulker Boxred_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.red_shulker_box
Black Shulker Boxblack_shulker_boxguarded_by_piglins
shulker_boxes
Block & Itemblock.minecraft.black_shulker_box
NameNamespaced ID
Block entityshulker_box

Bedrock Edition:

Shulker BoxNamespaced IDNumeric ID FormTranslation key
Undyedundyed_shulker_box205Block & Itemtile.shulkerBox.name
Dyedshulker_box218Block & Itemtile.shulkerBoxWhite.name
tile.shulkerBoxOrange.name
tile.shulkerBoxMagenta.name
tile.shulkerBoxLightBlue.name
tile.shulkerBoxYellow.name
tile.shulkerBoxLime.name
tile.shulkerBoxPink.name
tile.shulkerBoxGray.name
tile.shulkerBoxSilver.name
tile.shulkerBoxCyan.name
tile.shulkerBoxPurple.name
tile.shulkerBoxBlue.name
tile.shulkerBoxBrown.name
tile.shulkerBoxGreen.name
tile.shulkerBoxRed.name
tile.shulkerBoxBlack.name
NameSavegame ID
Block entityShulkerBox

Metadata[edit]

See also: Data values

In Bedrock Edition, dyed shulker boxes use the following data values:

DV Description
0 White Shulker Box
1 Orange Shulker Box
2 Magenta Shulker Box
3 Light Blue Shulker Box
4 Yellow Shulker Box
5 Lime Shulker Box
6 Pink Shulker Box
7 Gray Shulker Box
8 Light Gray Shulker Box
9 Cyan Shulker Box
10 Purple Shulker Box
11 Blue Shulker Box
12 Brown Shulker Box
13 Green Shulker Box
14 Red Shulker Box
15 Black Shulker Box

Block states[edit]

See also: Block states

Java Edition:

Name Default value Allowed values Description
facingupdown
east
north
south
up
west
The direction the shulker box is pointing.
The opposite from the direction the player faces while placing the shulker box.

Bedrock Edition:
Dyed

Name Default value Allowed values Description
colorwhitewhite
orange
magenta
light_blue
yellow
lime
pink
gray
silver
cyan
purple
blue
brown
green
red
black

Block data[edit]

A shulker box has a block entity associated with it that identifies its contents.

  • Block entity data
    • Tags common to all block entities
    •  CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
    •  Items: List of items in this container.
      • : An item, including the slot tag. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
        • Tags common to all items
    •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
    •  LootTable: Optional. Loot table to be used to fill the shulker box when it is next opened, or the items are otherwise interacted with.[note 1]
    •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.[note 1]
  1. a b Both loot table tags are removed once the items have been generated.

Item data[edit]

Shulker boxes, as items, use an NBT tag BlockEntityTag to indicate the contents and details of the box when it is placed.

The following NBT structure is provided to show how the BlockEntityTag tag is organized, and is not comprehensive above the tag tag. The full NBT for an item can be found here.

  • Entity data
    •  Item: The item
      •  tag: Additional information about the item. This tag is optional for most items.
        •  BlockEntityTag: The details of the shulker box.
          • All block data, except tags common to all block entities.

Achievements[edit]

Icon Achievement In-game description Actual requirements (if different) Gamerscore earned Trophy type (PS)
Organizational Wizard.pngOrganizational WizardName a Shulker Box with an Anvil30GBronze

History[edit]

A shulker box disguised as a shulker in 20w45a.
This section is missing information about Jeb (or someone else) mentioned plans to add a specific undyed shulker box after the 1.12 change was reverted and before 1.13. 
Please expand the section to include this information. Further details may exist on the talk page.
Java Edition
1.1116w39aWhite Shulker Box Revision 1.png Orange Shulker Box Revision 1.png Magenta Shulker Box Revision 1.png Light Blue Shulker Box Revision 1.png Yellow Shulker Box Revision 1.png Lime Shulker Box Revision 1.png Pink Shulker Box Revision 1.png Gray Shulker Box Revision 1.png Light Gray Shulker Box Revision 1.png Cyan Shulker Box Revision 1.png Purple Shulker Box Revision 1.png Blue Shulker Box Revision 1.png Brown Shulker Box Revision 1.png Green Shulker Box Revision 1.png Red Shulker Box Revision 1.png Black Shulker Box Revision 1.png Added shulker boxes.
16w39c"Silver Shulker Boxes" have been now renamed to "Light Gray Shulker Boxes", in keeping with naming consistencies across dyed blocks.
1.1217w16aWhite Shulker Box.png Orange Shulker Box.png Magenta Shulker Box.png Light Blue Shulker Box.png Yellow Shulker Box.png Lime Shulker Box.png Pink Shulker Box.png Gray Shulker Box.png Light Gray Shulker Box.png Cyan Shulker Box.png Purple Shulker Box.png Blue Shulker Box.png Brown Shulker Box.png Green Shulker Box.png Red Shulker Box.png Black Shulker Box.png Shulker boxes have been recolored.
17w17aPurple Shulker Box Revision 1.png The color of purple shulker boxes has been reverted.
1.1317w47aThe ID has been changed from silver_shulker_box to light_gray_shulker_box.
Prior to The Flattening, these blocks' numeral IDs were 219 through 234.
18w10bShulker Box.png Added a default shulker box.
Purple Shulker Box.png The purple shulker box texture has been changed to the one used in 17w16a.
18w10dShulker boxes can now be undyed in a cauldron.
1.14.2Pre-Release 1Empty shulker boxes no longer drop themselves when destroyed in Creative mode.[1]
1.1720w45aDue to a bug,[2] when Shulkers run their "peeking" animation, shulker boxes make a "peeking" animation too, including the inventory item in the players hand, and in its dropped item form.
20w46aShulker boxes no longer have a "peeking" animation.
20w51aShulker boxes now drop their contents when destroyed as an item entity.
Pocket Edition
1.1.0alpha 1.1.0.0White Shulker Box Revision 1.png Orange Shulker Box Revision 1.png Magenta Shulker Box Revision 1.png Light Blue Shulker Box Revision 1.png Yellow Shulker Box Revision 1.png Lime Shulker Box Revision 1.png Pink Shulker Box Revision 1.png Gray Shulker Box Revision 1.png Light Gray Shulker Box Revision 1.png Cyan Shulker Box Revision 1.png Purple Shulker Box Revision 1.png Blue Shulker Box Revision 1.png Brown Shulker Box Revision 1.png Green Shulker Box Revision 1.png Red Shulker Box Revision 1.png Black Shulker Box Revision 1.png Added shulker boxes.
alpha 1.1.0.9White Shulker Box.png Orange Shulker Box.png Magenta Shulker Box.png Light Blue Shulker Box.png Yellow Shulker Box.png Lime Shulker Box.png Pink Shulker Box.png Gray Shulker Box.png Light Gray Shulker Box.png Cyan Shulker Box.png Blue Shulker Box.png Brown Shulker Box.png Green Shulker Box.png Red Shulker Box.png Black Shulker Box.png The color palette for shulker boxes has been updated.
Unknown
?Shulker boxes no longer use the wood sound.
Bedrock Edition
1.2.0beta 1.2.0.2Shulker Box.png Added a default shulker box.
Purple Shulker Box.png The purple shulker box color has been changed to the new palette.
1.8.0beta 1.8.0.13A recipe for undyed shulker boxes has been added.
1.16.0beta 1.16.0.51Shulker boxes can now be undyed in a cauldron.
Legacy Console Edition
TU53CU43 1.49 Patch 231.0.3White Shulker Box.png Orange Shulker Box.png Magenta Shulker Box.png Light Blue Shulker Box.png Yellow Shulker Box.png Lime Shulker Box.png Pink Shulker Box.png Gray Shulker Box.png Light Gray Shulker Box.png Cyan Shulker Box.png Purple Shulker Box Revision 1.png Blue Shulker Box.png Brown Shulker Box.png Green Shulker Box.png Red Shulker Box.png Black Shulker Box.png Added shulker boxes.[3]
New Nintendo 3DS Edition
1.9.19Shulker Box.png White Shulker Box.png Orange Shulker Box.png Magenta Shulker Box.png Light Blue Shulker Box.png Yellow Shulker Box.png Lime Shulker Box.png Pink Shulker Box.png Gray Shulker Box.png Light Gray Shulker Box.png Cyan Shulker Box.png Purple Shulker Box.png Blue Shulker Box.png Brown Shulker Box.png Green Shulker Box.png Red Shulker Box.png Black Shulker Box.png Added shulker boxes.

Issues[edit]

Issues relating to "Shulker Box" are maintained on the bug tracker. Report issues there.

Trivia[edit]

  • With 37 shulker boxes in a player's inventory, hotbar, and off-hand slot, 999 stacks of up to 64 items (up to 63,936 total items; 63,973 if counting shulker boxes themselves) can be held. With 37 shulker boxes and an ender chest with 27 shulker boxes in one of the shulker box slots, 1,727 stacks (up to 110,528 items; 1,728 stacks with up to 110,592 items if counting stacked ender chests) can be held.
    • With strength value 5 llamas, each caravan of 10 llamas with inventories full of shulker boxes can carry up to 4,050 stacks (up to 259,200 items).
  • When the camera is far enough from a shulker box, the shulker box is invisible, even though it is still within the render distance, this is because the shulker box is still considered a mob.

References[edit]