Minecraft Wiki
Advertisement

Template:BlockTileEntity

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>[[Sweet Berries|Sweet Berries]]<br/>{{Block
| title = Sweet Berries
| image = <gallery>
Sweet Berry Bush Age 0.png| Age 0
Sweet Berry Bush Age 1.png| Age 1
Sweet Berry Bush Age 2.png| Age 2
Sweet Berry Bush Age 3.png| Age 3
</gallery>
| image2 = Sweet Berries JE1 BE1.png
| transparent = Yes
| light = No
| tool = Any
| renewable = Yes
| stackable = Yes (64)
| heals = {{hunger|2}}
| flammable = Yes (60 java, 30 bedrock)
| lavasusceptible = No
}}

'''Sweet berries''' are a [[food]] [[item]] obtained from sweet berry bushes and are used to plant them.

'''Sweet berry bushes''' are quick-growing, [[Bone Meal|bonemealable]] [[Plant|plants]] that grow sweet berries, and damage and slow [[Player|players]] and most [[Mob|mobs]] moving through them. They can be found naturally in [[taiga]] and [[Snowy Taiga|snowy taiga]] biomes.

== Obtaining ==

=== Breaking ===
{{See also|Fortune#Discrete random}}
Sweet berry bushes can be mined instantly with any tool or by hand. A mature sweet berry bush yields 2–3 sweet berries. On its third growth stage, it yields 1–2 sweet berries. Each level of [[Fortune]] can increase the amount of drops by 1.

{{IN|ps4}}, the sweet berries drop into the player's inventory. In other editions, they drop on the ground.

=== Natural generation ===
Berry bushes commonly generate in [[taiga]] and [[snowy taiga]] biomes. Each [[chunk]] has {{frac|1|12}} chance to generate sweet berry bushes in [[random patch]]es. They also generate in both [[old growth pine taiga]] and [[old growth spruce taiga]].

=== Chest loot ===
{{LootChestItem|sweet-berries}}

=== Post-generation ===
Sweet berries can be collected from a sweet berry bush by {{control|using}} or {{control|breaking}} it, which yield 1–2 sweet berries in its third growth stage, and 2–3 sweet berries in its final growth stage.

== Usage ==
=== Placement ===
Placing [[sweet berries]] on a [[grass block]], [[dirt]], [[podzol]], [[coarse dirt]], [[farmland]]{{Only|Java}}, or [[moss block]] creates a small sweet berry bush that eventually becomes a fully grown sweet berry bush.

=== Growth ===
A sweet berry bush grows through four stages after it is planted. Its first growth stage is a small bush without any berries. It becomes a grown plant in its second stage, and produces berries in its third and fourth growth stage. The bush needs to be in light level 9 or greater to grow. {{control|Using}} [[bone meal]] on it increases its growth stage by one, and at full maturity, ejects the sweet berry item. The bush can be placed on a 1 block high space, but it cannot grow with a full, non-transparent block immediately above it.

=== Food ===

To eat sweet berries, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|2}} [[hunger]] and 0.4{{only|je|short=1}} / 1.2{{only|be|short=1}} hunger [[saturation]].

=== Composting ===
Placing sweet berries into a [[composter]] has a 30% chance of raising the compost level by 1.

=== Breeding ===
Sweet berries can be fed to [[fox]]es to [[breeding|breed]] them. Foxes are similar to cats when being fed as a wild animal; a sudden movement by the [[player]] may cause the fox to flee even if the player holds sweet berries. A baby fox bred by a [[player]] trusts the player and does not flee.

=== Trading ===
Master-level butcher [[villager]]s offer to [[trading|buy]] 10 sweet berries for an [[emerald]].

=== Entity movement ===

A sweet berry bush (at any stage) slows down all [[entity|entities]] (except [[Item (entity)|items]]) passing through it. At stage 1 and higher, it causes damage. [[Fox]]es are immune to both characteristics, however. Sweet berry bushes deal {{hp|1}} [[damage]] every 0.5 seconds, only if the entity is moving in the hitbox of the bush. Entities that move through sweet berry bushes slow down to about 34.05% of their normal speed, similar to how a [[cobweb]] slows down mobs to 15% of normal speed. This makes it impossible to jump a full [[block]] while inside the bush.

Mobs at standard block height in a [[minecart]] are not damaged when the minecart is pushed through sweet berries. Players in a sweet berry bush take no damage except from horizontal movement, but are unable to jump out of the bush, similar to a cobweb.

=== Bees ===
[[Bee]]s pollinate sweet berry bushes, and then increase the honey level in [[beehive]]s and bee nests by 1.{{only|java}}

== Sounds ==
=== Generic ===
==== Block ====
{{Sound table/Block/Sweet berry bush}}
==== Item ====
{{Sound table/Entity/Food}}
=== Unique ===
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|subtitle=Berries pop
|source=block
|description=When sweet berries are picked by a player
|id=block.sweet_berry_bush.pick_berries
|translationkey=subtitles.item.berries.pick
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|subtitle=Berries pop
|source=block
|description=When sweet berries are picked by a fox
|id=block.sweet_berry_bush.pick_berries
|translationkey=subtitles.item.berries.pick
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Player hurt sweet berry bush1.ogg
|sound2=Player hurt sweet berry bush2.ogg
|subtitle=Player hurts
|source=player
|description=When a player is damaged by touching a sweet berry bush
|id=entity.player.hurt_sweet_berry_bush
|translationkey=subtitles.entity.player.hurt
|volume=1.0
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|source=block
|description=When sweet berries are picked
|id=block.sweet_berry_bush.pick
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Player hurt sweet berry bush1.ogg
|sound2=Player hurt sweet berry bush2.ogg
|source=block
|description=When a player is damaged by touching a sweet berry bush
|id=block.sweet_berry_bush.hurt
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Sweet Berry Bush
|spritetype=block
|nameid=sweet_berry_bush
|blocktags=azalea_log_replaceable, bee_growables
|form=block}}
{{ID table
|displayname=Sweet Berries
|spritetype=item
|nameid=sweet_berries
|itemtags=fox_food
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Sweet Berry Bush
|spritetype=block
|nameid=sweet_berry_bush
|id=462
|form=block}}
{{ID table
|displayname=Sweet Berries
|spritetype=item
|nameid=sweet_berries
|id=287
|form=item
|foot=1}}

=== Block states ===
{{see also|Block states}}
{{/BS}}

==Advancements==
{{Load advancements|Husbandry;A Balanced Diet;The Parrots and the Bats;Two by Two}}

== History ==
{{History||September 26, 2018|link={{tweet|minecraft|1044587405779451906}}|Berries are announced to be part of the [[biome]] vote at [[MINECON Earth 2018]].}}
{{History||September 29, 2018|link={{tweet|minecraft|1046097775199498245}}|[[Taiga]] wins the [[biome]] vote, meaning berries are to be added to the game first.}}

{{History|java}}
{{History||December 3, 2018|link={{tweet|cojomax99|1069586461173919745}}|[[Cojomax99]] tweets an image of some berries.}}
{{History||1.14|snap=18w49a|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes.|
[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries.}}
{{History|||snap=18w50a|Sweet berries can now be found within [[taiga]] [[village]] loot [[chest]]s.}}
{{History|||snap=19w03a|Placing a sweet berry into the new [[composter]] has a 10% chance of raising the compost level by 1.
|Added [[sound]]s for sweet berry bushes.}}
{{History|||snap=19w05a|Sweet berries now have a 30% chance of increasing the compost level in a composter by 1.
|The [[sound]] for planting sweet berries has been changed.}}
{{History|||snap=19w07a|Sweet berries can now be fed to [[fox]]es to [[breeding|breed]] them.}}
{{History|||snap=19w11a|Butcher [[villager]]s now [[trading|buy]] sweet berries.}}
{{History||1.15|snap=19w34a|[[Bee]]s can now pollinate sweet berry bushes.}}
{{History|||snap=Pre-Release 2|Sweet berries now generate in [[giant tree taiga]] biomes.}}
{{History||1.16|snap=Pre-release 1|Sweet berry bushes no longer prevent mob spawning inside them.}}
{{History||1.17|snap=21w20a|The sound event for picking berries has been changed as to align better with that of glow berries.<ref>{{bug|MC-220063}}</ref>}}
{{History||1.18|snap=1.18-pre5|Sweet berry bushes in taigas are about 4 times more common than in previous snapshots.}}

{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries, which are available only through Experimental Gameplay.|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes, available only through Experimental Gameplay.}}
{{History||1.11.0|snap=beta 1.11.0.1|Sweet berries can now be used to fill [[composter]]s.}}
{{History|||snap=beta 1.11.0.3|Sweet berries and sweet berry bushes have been fully implemented and are now separate from Experimental Gameplay.}}
{{History|||snap=beta 1.11.0.4|Sweet berries can now be [[trading|sold]] to butcher [[villager]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Sweet berries can now be fed to [[fox]]es to [[breeding|breed]] them.}}
{{History||1.14.0|snap=beta 1.14.0.1|[[Bee]]s can now pollinate sweet berry bushes.}}
{{History||1.16.100|snap=beta 1.16.100.54|Sweet berry bushes now properly damage entities.<ref>{{Bug|MCPE-56142}}</ref>}}
{{History||1.17.0|snap=beta 1.17.0.56|Bees no longer gather nectar from sweet berry bushes.}}

{{History|PS4}}
{{History||1.91|[[File:Sweet Berries JE1 BE1.png|32px]] Added sweet berries.|[[File:Sweet Berry Bush Age 0 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 1 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 2 JE1 BE1.png|32px]] [[File:Sweet Berry Bush Age 3 JE1 BE1.png|32px]] Added sweet berry bushes.}}
{{History|foot}}

=== Sweet berry bush "item" ===
{{:Technical blocks/Sweet Berry Bush}}

== Issues ==
{{issue list|berry|berries|sweet berry|sweet berries|berry bush|sweet berry bush}}

==Trivia==
* {{IN|java}}, sweet berry bushes absorb [[fall damage]] like [[water]].<ref>{{bug|MC-149990|||WAI}}</ref>
* Foxes harvest mature sweet berry bushes that have grown into their third or fourth stage. Unlike how carrots eaten by rabbits are destroyed and not dropped as items, sweet berry bushes harvested by foxes drop as items, although the fox may pick up one of the dropped berries. The bush remains intact, allowing for automatic sweet berry farms.

== Gallery ==
<gallery>
Berry Bush.png|A close-up look of a sweet berry bush.
Naturally generated berry bushes.png|A naturally generated sweet berry bush.
Multiplebushes.png|Multiple bushes of sweet berries in Taiga biome.
BerryBushCloseToRavine.png|A berry bush that is close to a ravine.
Cozy Cabin Berries.jpg|Berry bushes near a cozy cabin.
</gallery>

==References==
{{Reflist}}

{{Blocks|vegetation}}
{{Items}}

[[Category:Food]]
[[Category:Plants]]
[[Category:Non-solid blocks]]
[[Category:Natural blocks]]
[[Category:Flammable blocks]]

[[cs:Sladké bobule]]
[[es:Bayas dulces]]
[[de:Süßbeeren]]
[[fr:Baies sucrées]]
[[ja:スイートベリー]]
[[ko:달콤한 열매]]
[[pl:Słodkie jagody]]
[[pt:Bagas doces]]
[[ru:Сладкие ягоды]]
[[th:เบอร์รีหวาน]]
[[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.
  • When destroyed by a explosion, the block will always drop as an item.

Gallery

Advertisement