Minecraft Wiki
Advertisement

Template:BlockTileEntity Template:Desktop

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[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

Name Ingredients Crafting recipe
Purple Shulker Box Shulker Shell +
Chest

Shulker Box Any Shulker Box +
Matching Dye


Creative

When instantly mined in creative mode, shulker boxes will drop as an item if there are items stored within.

Usage

Unlike other storage units, such as chests, shulker boxes keep their items when broken, which can be retrieved when placed again. Shulker boxes will drop as an item if pushed by pistons, and can be placed using dispensers. When holding a shulker box with items inside, the items will be listed as properties.

Item propertiesofficial

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

Shulker boxes can be stored in other containers, though they cannot be stored in other shulker boxes.

A shulker box can hold the same amount of items as a chest. (27 slots)

Data values

Block state

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 shulker box:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
color
(Deprecated)
0x1
0x2
0x4
0x8
white white0White Shulker Box
orange1Orange Shulker Box
magenta2Magenta Shulker Box
light_blue3Light Blue Shulker Box
yellow4Yellow Shulker Box
lime5Lime Shulker Box
pink6Pink Shulker Box
gray7Gray Shulker Box
silver8Light Gray Shulker Box
cyan9Cyan Shulker Box
purple10Purple Shulker Box
blue11Blue Shulker Box
brown12Brown Shulker Box
green13Green Shulker Box
red14Red Shulker Box
black15Black Shulker Box

Block entity

A shulker box has a block entity associated with it that identifies its contents. The block's block entity ID is shulker_box.

  • 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

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.

Chunk format/Items

            • : 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
          •  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 will use a random seed.[note 1]
  1. a b Both loot table tags will be removed once the items have been generated.

History

release
1.11
{{Extension DPL}}<ul><li>[[:Category:Armor|Category:Armor]]<br/>[[Category:Items]]</li><li>[[Firework Star|Firework Star]]<br/>{{Item
| image = Firework Star.png
| renewable = 
* '''Trail Effect''': No
* '''All Others''': Yes
| stackable = Yes (64)
}}
'''Firework stars''' are [[items]] used to determine the color, effect, and shape of [[firework rocket]]s.

== Obtaining ==

In [[Survival]] mode, firework stars are obtainable only through crafting. In [[Creative]] mode, they can be found in the creative inventory.

=== Crafting ===

{{Crafting
  |head=1
  |showname=0
  |showdescription=1
  |ingredients=[[Gunpowder]] +<br>Matching [[Dye]] +<br>Extra ingredients (optional)
  |Gunpowder
  |Matching Dye
  |Head; Gold Nugget; Feather;Fire Charge;
  |Glowstone Dust;
  |Diamond;
  |Output=Matching Firework Star
  |arggroups=1;2,Output;3;4;5
  |description=Up to eight dyes can be added.<br>One head, gold nugget, feather, or fire charge can be added.<br>Both the diamond and the glowstone dust can be added with any of the other ingredients.
  |type=Miscellaneous
}}
{{Crafting
  |ignoreusage=1
  |Matching Firework Star
  |Any Dye
  |Output=Matching Firework Star
  |type=Miscellaneous
  |description=Adds a "fade to color" effect to the firework star, overwriting any existing fades.<br>Up to eight dyes can be added.
  |foot=1
  |arggroups=1,Output
}}
<div style="display:none">
<!--
    This is so the pre-Village & Pillage dyes can have dye-related crafting recipes show on their respective pages.
    They don't need to be displayed on this page because they already intuitively list "Any Matching/Colored Dye".
-->
{{Crafting
  |head=1
  |showname=0
  |showdescription=1
  |Gunpowder
  |Bone Meal; Lapis Lazuli; Cocoa Beans; Ink Sac
  |Head; Gold Nugget; Feather;Fire Charge;
  |Glowstone Dust;
  |Diamond;
  |Output=White Firework Star; Blue Firework Star; Brown Firework Star; Black Firework Star
  |arggroups=1;2,Output;3;4;5
  |description={{only|bedrock|education}}<br>Up to eight dyes can be added.<br>One head, gold nugget, feather, or fire charge can be added.<br>Both the diamond and the glowstone dust can be added with any of the other ingredients.
  |type=Miscellaneous
}}
{{Crafting
 |showdescription=1
 |White Firework Star; Blue Firework Star; Brown Firework Star; Black Firework Star
 |Bone Meal; Lapis Lazuli; Cocoa Beans; Ink Sac
 |Output=White Firework Star; Blue Firework Star; Brown Firework Star; Black Firework Star
 |type=Decoration block
 |description={{only|bedrock|education}}<br>Adds a "fade to color" effect to the firework star, overwriting any existing fades.<br>Up to eight dyes can be added.
 |foot=1
}}
</div>

== Usage ==

The only usage of firework stars is to create [[firework rocket]]s.

=== Crafting ingredient ===

{{crafting usage|match=end}}

== Effects ==

=== Shape effects ===

A firework star can have only one shape effect.

{| class="wikitable"
|+ Shape Effects
! <abbr title="Type (Byte tag in NBT structure)">Type</abbr>
! Ingredient
! Effect
! Sample Animation
|-
| 0
| None
| Small Ball explosion (default)
| [[File:Firework Star (Small Sphere).gif|200px]]
|-
| 1
| {{ItemLink|Fire Charge}}
| Large Ball explosion and heavy sound.
| [[File:Firework Star (Large Sphere).gif|200px]]
|-
| 2
| {{ItemLink|Gold Nugget}}
| Star-shaped explosion
| [[File:Firework Star (Star Shape).gif|200px]]
|-
| 3
| {{BlockLink|id=Heads|Head}} (any)
| Creeper-shaped (Creeper Face) explosion
| [[File:Firework Star (Creeper Shape).gif|200px]]
|-
| 4
| {{ItemLink|Feather}}
| Burst explosion
| [[File:Firework Star (Burst).gif|200px]]
|}

=== Additional effects ===

In addition to the shape effects, any combination of these additional effects may be added to a firework star.

{| class="wikitable"
|+ Additional Effects
! Ingredient
! Effect
! Sample Animation
|-
| None
| Default
| [[File:Firework Star (Small Sphere).gif|200px]]
|-
| {{ItemLink|Glowstone Dust}}
| Twinkle (Crackle effect and sounds after the explosion)
| [[File:Firework Star (Twinkle effect).gif|200px]]
|-
| {{ItemLink|Diamond}}
| Trail effect after the explosion
| [[File:Firework Star (Trail effect).gif|200px]]
|-
| {{ItemLink|Glowstone Dust}} <br> {{ItemLink|Diamond}}
| Twinkle + Trail effect after the explosion
| [[File:Firework Star (Twinkle and Trail effect).gif|200px]]
|}

== Sounds ==
{{see also|Firework_Rocket#Sounds}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Firework Star
|spritetype=item
|nameid=firework_star
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Firework Star
|spritetype=item
|nameid=firework_star
|aliasid=fireworkscharge
|id=520
|form=item
|translationkey=item.fireworksCharge.name
|foot=1}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Firework Stars}}
</div>

{{el|bedrock}}:
: See [[Bedrock Edition level format/Item format]].

== Video ==
<div style="text-align:center">{{yt|fYL1W9aW0UU}}</div>

== History ==
{{History|java}}
{{History||1.4.6|snap=12w49a|[[File:Firework Star JE1 BE1.png|32px]] Added firework stars.
|Firework stars in the [[Creative inventory]] come in only one variation; they do not have any color.}}
{{History||1.13|snap=17w47a|The ID of firework stars has now been changed from <code>firework_charge</code> to <code>firework_star</code>.
|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 402.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Firework Star JE1 BE1.png|32px]] Added firework stars.
|Firework stars come in all 16 colors in the [[Creative]] [[inventory]].{{verify|type=update}}{{info needed}}}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of firework star has been changed from <code>fireworkscharge</code> to <code>firework_star</code>.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Firework Star JE1 BE1.png|32px]] Added firework stars.
|Firework stars cannot be obtained within the Creative inventory.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The [[crafting]] interface has now been updated to allow the crafting of firework stars and [[firework rocket]]s.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==

* There are 29,617,272,422,916,505,236 (29.6 quintillion) unique firework stars.
* Putting firework stars on rockets causes the player to take explosion damage when using them for flying with [[elytra]].

== Gallery ==
<gallery>
File:Firework Star (Tricolor Star shaped with Twinkle and Trail effect).gif|Tricolor (Magenta, Pink, White dye) + Star shaped with Twinkle and Trail effect.
</gallery>

{{Items}}

[[cs:Ohňostrojová hvězda]]
[[de:Feuerwerksstern]]
[[es:Estrella de fuegos artificiales]]
[[fr:Étoile de feu d'artifice]]
[[hu:Tűzijáték csillag]]
[[it:Stella pirotecnica]]
[[ja:花火の星]]
[[ko:폭죽 탄약]]
[[nl:Vuurwerkster]]
[[pl:Gwiazdka pirotechniczna]]
[[pt:Estrela de fogo de artifício]]
[[ru:Пиротехническая звезда]]
[[uk:Зірка феєрверку]]
[[zh:烟火之星]]</li></ul>
16w39aShulker box added.
16w39cSilver shulker boxes are now called light gray, in keeping with naming consistencies across dyed blocks.

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.

Gallery

Advertisement