Shulker Box

Shulker Box

Type	Block Entity
Requirements	None
Physics	No
Transparency	No
Luminance	0
Blast resistance	30
Hardness	2
Tool
Renewable	No
Stackable	No
Flammable	No
Drops	Itself
Sounds	Open Close
Block Entity ID	See § Data values
Data values	See § Data values
Namespaced ID	See § Data values

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 quickest method.

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

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 was renamed on an anvil, it will also retain its name.

Creative

When instantly mined in Creative mode, shulker boxes will drop as an item if there are items stored within, unless /gamerule doTileDrops is set to "false". In Legacy Console Edition, this is only the case if it is renamed.

Usage

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

Shulker boxes 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. Shulker boxes will drop themselves as an item if pushed by pistons, and can be placed using dispensers. When a shulker box with items inside is held or in a container's inventory, the items will be listed as properties.

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

A shulker box's item 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 will face and open sideways/upside-down. 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.

Shulker boxes, unlike chests, cannot be opened with a transparent block above them.

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.

Undyeing

Dyed shulker boxes can be undyed using a cauldron.‌^{[Java and Legacy Console editions only]} To do this, use a dyed shulker box on a cauldron that has water in it. This will cause the cauldron's water level to decrease by 1, and the shulker box will turn into an undyed one.

Data values

ID

Java Edition:

Shulker Box	Namespaced ID
Undyed	shulker_box
White	white_shulker_box
Orange	orange_shulker_box
Magenta	magenta_shulker_box
Light blue	light_blue_shulker_box
Yellow	yellow_shulker_box
Lime	lime_shulker_box
Pink	pink_shulker_box
Gray	gray_shulker_box
Light gray	light_gray_shulker_box
Cyan	cyan_shulker_box
Purple	purple_shulker_box
Blue	blue_shulker_box
Brown	brown_shulker_box
Green	green_shulker_box
Red	red_shulker_box
Black	black_shulker_box
Block entity	shulker_box

Bedrock Edition:

Shulker Box	Namespaced ID	Numeric ID
Undyed	undyed_shulker_box	205
Dyed	shulker_box	218
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.

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 display 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 will use 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 display 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 will use a random seed.

Achievements

Main article: Achievements

Icon	Achievement	In-game description	Actual requirements (if different)	Availability				Xbox points earned	Trophy type (PS)
				Xbox	PS	Bedrock	Nintendo
	Organizational Wizard	Name a Shulker Box with an Anvil		No	PS4	Yes	No	30G	Bronze

History

Shulker box colors
before Java Edition 1.12.

Java Edition
1.11		16w39a			Shulker boxes added.
		16w39c			Silver shulker boxes are now called light gray, in keeping with naming consistencies across dyed blocks.
1.12		17w16a			Shulker boxes have now been recolored.
		17w17a			Reverted color of purple shulker boxes.
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 default shulker box.
					The purple shulker box texture has now been changed to the one used in 17w16a.
		18w10d			Shulker boxes can now be undyed in a cauldron.
1.14.2		?			Empty shulker boxes will 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 now been updated.
Bedrock Edition
1.2.0		beta 1.2.0.2			Added default shulker box.
					Changed the purple shulker box color to the new palette.
Legacy Console Edition
TU53	CU43	1.49	Patch 23	Patch s3	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

• When opened with an entity on top, they will rise up half a block. This stretch also occurs to the box's hitbox.
  • This can be done with a block above the entity on top to create secret passageways.
• When destroyed by an explosion, the block will always drop as an item.
• 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 will be invisible, even though it is still within the render distance.

Blocks

View at: Template:Blocks/content [edit]