Shulker Box

Shulker Box

Renewable	No
Stackable	No
Tool
Blast resistance	6
Hardness	2
Luminant	No
Transparent	Yes
Flammable	No
Catches fire from lava	No

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.

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

Obtaining

Breaking

Shulker Boxes can be mined with any tool or by hand, but using a pickaxe is the most effective.

Block	Shulker Box
Hardness	2
Tool
Breaking time
Default	3
Wooden	1.5
Stone	0.75
Iron	0.5
Diamond	0.4
Netherite	0.35
Golden	0.25

Block loot

Shulker boxes will drop themselves when mined. Unlike other containers, the contents of shulker boxes are stored within the dropped item, and not dropped separately.

Namespaced ID	Source	Drops
		Default
blocks/shulker_box	Shulker Box	(100%)
blocks/white_shulker_box	White Shulker Box	(100%)
blocks/orange_shulker_box	Orange Shulker Box	(100%)
blocks/magenta_shulker_box	Magenta Shulker Box	(100%)
blocks/light_blue_shulker_box	Light Blue Shulker Box	(100%)
blocks/yellow_shulker_box	Yellow Shulker Box	(100%)
blocks/lime_shulker_box	Lime Shulker Box	(100%)
blocks/pink_shulker_box	Pink Shulker Box	(100%)
blocks/gray_shulker_box	Gray Shulker Box	(100%)
blocks/light_gray_shulker_box	Light Gray Shulker Box	(100%)
blocks/cyan_shulker_box	Cyan Shulker Box	(100%)
blocks/purple_shulker_box	Purple Shulker Box	(100%)
blocks/blue_shulker_box	Blue Shulker Box	(100%)
blocks/brown_shulker_box	Brown Shulker Box	(100%)
blocks/green_shulker_box	Green Shulker Box	(100%)
blocks/red_shulker_box	Red Shulker Box	(100%)
blocks/black_shulker_box	Black Shulker Box	(100%)

Crafting

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 name.

Ingredients	Crafting recipe	Description
Any Shulker Box + Bone Meal or Lapis Lazuli or Cocoa Beans or Ink Sac		‌[Bedrock and Education editions only]

Creative

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".

Usage

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.

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.

Shulker boxes, unlike chests, can be opened with a transparent block above them if the block's hitbox doesn't intersect the shulker box's when it is open. 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

Dyed shulker boxes can be undyed using a cauldron.‌^{[Java Edition only]}‌^{[upcoming: BE 1.16.0]} 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

‌In Java Edition 1.16 and Bedrock Edition 1.16.0‌^[upcoming], piglins will become hostile towards players who open or mine shulker boxes.

Sounds

Java Edition:

Sound	Subtitle	Source	Description	Namespaced ID	Translation key	Volume	Pitch	Attenuation distance
	Block broken	Blocks	Breaking the block	block.stone.break	subtitles.block.generic.break	1.0	0.8	16
	None	Blocks	Falling on the block with fall damage	block.stone.fall	None	0.5	0.75	16
	Block breaking	Blocks	Mining the block	block.stone.hit	subtitles.block.generic.hit	0.25	0.5	16
	Block placed	Blocks	Placing the block	block.stone.place	subtitles.block.generic.place	1.0	0.8	16
	Footsteps	Blocks	Walking on the block	block.stone.step	subtitles.block.generic.footsteps	0.15	1.0	16
	Shulker closes	?	?	block.shulker_box.close	subtitles.block.shulker_box.close	?	?	16
	Shulker opens	?	?	block.shulker_box.open	subtitles.block.shulker_box.open	?	?	16

Data values

ID

Java Edition:

Name	Namespaced ID	Translation key
Shulker Box	shulker_box	block.minecraft.shulker_box
White Shulker Box	white_shulker_box	block.minecraft.white_shulker_box
Orange Shulker Box	orange_shulker_box	block.minecraft.orange_shulker_box
Magenta Shulker Box	magenta_shulker_box	block.minecraft.magenta_shulker_box
Light Blue Shulker Box	light_blue_shulker_box	block.minecraft.light_blue_shulker_box
Yellow Shulker Box	yellow_shulker_box	block.minecraft.yellow_shulker_box
Lime Shulker Box	lime_shulker_box	block.minecraft.lime_shulker_box
Pink Shulker Box	pink_shulker_box	block.minecraft.pink_shulker_box
Gray Shulker Box	gray_shulker_box	block.minecraft.gray_shulker_box
Light Gray Shulker Box	light_gray_shulker_box	block.minecraft.light_gray_shulker_box
Cyan Shulker Box	cyan_shulker_box	block.minecraft.cyan_shulker_box
Purple Shulker Box	purple_shulker_box	block.minecraft.purple_shulker_box
Blue Shulker Box	blue_shulker_box	block.minecraft.blue_shulker_box
Brown Shulker Box	brown_shulker_box	block.minecraft.brown_shulker_box
Green Shulker Box	green_shulker_box	block.minecraft.green_shulker_box
Red Shulker Box	red_shulker_box	block.minecraft.red_shulker_box
Black Shulker Box	black_shulker_box	block.minecraft.black_shulker_box

Name	Namespaced ID
Block entity	shulker_box

Bedrock Edition:

Shulker Box	Namespaced ID	Numeric ID	Translation key
Undyed	undyed_shulker_box	205	tile.undyed_shulker_box.name
Dyed	shulker_box	218	?

Name	Savegame ID
Block entity	ShulkerBox

Block data

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

See also: Block states

Java Edition:

Name	Default value	Allowed values	Description
facing	up	down 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
color	white	white
		orange
		magenta
		light_blue
		yellow
		lime
		pink
		gray
		silver
		cyan
		purple
		blue
		brown
		green
		red
		black

Block entity

See also: Block entity format

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

• Block entity data
  • Tags common to all block entities see Template:Nbt inherit/blockentity/template
  •  CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
  •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
  •  Items: List of items in the 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 see Template:Nbt inherit/item/template
  •  LootTable: Optional. Loot table to be used to fill the shulker box when it is next opened, or the items are otherwise interacted with.
  •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.

Item data

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
        •  CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
        •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
        •  Items: List of items in the 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 see Template:Nbt inherit/item/template
        •  LootTable: Optional. Loot table to be used to fill the shulker box when it is next opened, or the items are otherwise interacted with.
        •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.

Achievements

Main article: Achievement

Icon	Achievement	In-game description	Actual requirements (if different)	Gamerscore earned	Trophy type (PS)
	Organizational Wizard	Name a Shulker Box with an Anvil	—	30G	Bronze

History

Shulker box colors
before Java Edition 1.12.

Java Edition
1.11		16w39a			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.12		17w16a			Shulker boxes have been recolored.
		17w17a			The color of purple shulker boxes has been reverted.
1.13		17w47a			The 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.
		18w10b			Added a default shulker box.
					The purple shulker box texture has been changed to the one used in 17w16a.
		18w10d			Shulker boxes can now be undyed in a cauldron.
1.14.2		Pre-Release 1			Empty shulker boxes no longer drop themselves when destroyed in Creative mode.
Pocket Edition
1.1.0		alpha 1.1.0.0			Added shulker boxes.
		alpha 1.1.0.9			The color palette for shulker boxes has been updated.
Bedrock Edition
1.2.0		beta 1.2.0.2			Added a default shulker box.
					The purple shulker box color has been changed to the new palette.
1.8.0		beta 1.8.0.13			A recipe for undyed shulker boxes has been added.
Upcoming Bedrock Edition
1.16.0		beta 1.16.0.51			Shulker boxes can now be undyed in a cauldron.
Legacy Console Edition
TU53	CU43	1.49	Patch 23	1.0.3	Added shulker boxes.
New Nintendo 3DS Edition
1.9.19					Added shulker boxes.

Issues

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

Trivia

• One can exploit the expanding hitbox of an open shulker box to create secret passageways using a block above the entity on top.
• With 37 shulker boxes in a player's inventory, hotbar and off-hand slot, 999 stacks of up to 64 items (up to 63936 total items) can be held. With 36 shulker boxes and an ender chest with 27 shulker boxes in it, 1701 stacks (up to 108864 items) can be held.
  • With strength value 5 llamas, each caravan of 10 llamas with inventories full of shulker boxes can carry up to 4050 stacks (up to 259200 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.

References

Blocks

View at: Template:Blocks/content [edit]