This article is about the game mode. For the game mode specific to Minecraft Earth, see Minecraft Earth:Adventure. For the update, see Adventure Update. For the advancements, see Advancements § Adventure.
Adventure mode is a game mode intended for player-created maps, limiting some of the gameplay in Minecraft. In this mode, the player cannot directly destroy any blocks with any tools or place any blocks, in order to avoid spoiling adventure maps or griefing servers. Adventure mode is accessible only with commands or the game mode selector.
Gameplay
Adventure mode is similar to Survival in that players receive damage from their environment, dying is possible, and players must manage hunger. However, it is different in many ways as well. In the Java Edition, blocks can be destroyed only with an item/tool that has the CanDestroy NBT tag, and cannot be destroyed by the player's fist. Likewise, blocks require the CanPlaceOn NBT tag to be placed. In Bedrock Edition, similarly, can_destroy and can_place_on NBT tags are required to destroy and place blocks.
However, players are able to make use of the environment in other ways - including interacting with mobs and other entities (for example, killing them), turning a redstone mechanism (such as a lever) on or off, and trading with villagers. Additionally, players are able to craft items as they normally would in any other game mode. Another feature is that players always spawn exactly on the world spawn point, no matter where it is - unlike Survival mode, where players can spawn anywhere within a certain grid.
Custom Minecraft maps make good use of Adventure Mode, and many custom maps are set to this game mode; players cannot break blocks or place them, therefore disallowing them to destroy the map, or add anything to it that would ruin the map. Also, it is often used to protect various multiplayer servers from griefers. Command blocks are usually used in conjunction with Adventure Mode, in servers and custom maps.
Players with the ability worldbuilder set to true can break and place blocks freely on Adventure Mode.[Bedrock Edition and Minecraft Education only]
A player can switch to Adventure mode from any other game mode by using the commands /gamemode adventure when cheats are enabled.
History
| alpha | |||||
|---|---|---|---|---|---|
| July 7, 2010 | Adventure mode, formerly Dungeons and Levers, was announced by Notch as a gamemode to be available when the game is finished. Notch hinted at four players to compete, permadeath like in Hardcore mode making it rogue-like in nature,[1] and a quest system with randomly generated maps/quests.[2] | ||||
| Java Edition | |||||
1.3.1{{Extension DPL}}<ul><li>[[End Crystal|End Crystal]]<br/>{{ItemEntity
|image=End Crystal.gif
|imagesize=150px
|invimage=End Crystal
|renewable=Yes
|stackable=Yes (64)
|rarity=Rare
|drops=None
|size=
Height: 2 Blocks<br>Width: 2 Blocks
}}
An '''end crystal''' is an [[entity]] that can be [[Crafting|crafted]] or found on [[the End]]'s main island, where it heals the [[Ender Dragon|ender dragon]]. It can only be placed on [[obsidian]] or [[bedrock]] and [[Explosion|explodes]] instantly when attacked or damaged in most ways.
== Spawning ==
=== Natural generation ===
An end crystal is found atop each [[obsidian pillar]] on the central island of the End, each on top of a piece of [[bedrock]]. There are 10 end crystals in total, of which two are protected in "cages" of [[iron bars]]. All end crystals respawn one after another as the respawning process of the [[ender dragon]] starts.
== Obtaining ==
=== Crafting ===
{{Crafting
|A1=Glass
|B1=Glass
|C1=Glass
|A2=Glass
|B2=Eye of Ender
|C2=Glass
|A3=Glass
|B3=Ghast Tear
|C3=Glass
|Output= End Crystal
|type= Decoration block
}}
== Usage ==
=== Healing the ender dragon ===
Their primary purpose is to recharge the health of the ender dragon, who gains a charge from the nearest crystal within a cuboid extending 32 blocks from the dragon in all directions. The dragon is healed {{hp|1}} each half-second. If multiple ender dragons are spawned, an end crystal can affect multiple dragons at the same time. The healing beam is neither obstructed nor is its power diminished by entities or blocks.
=== Respawning the ender dragon ===
[[File:End Crystals on the Exit portal.png|right|thumb|How to arrange end crystals on the exit portal to respawn the ender dragon.]]
As items, end crystals may be placed on bedrock and [[obsidian]], if the two blocks above the bedrock or obsidian block are air or replaceable blocks and no other entities intersect the area. When an end crystal is placed in [[the End]], a [[fire]] block is created at the end crystal location. If four are placed on the end [[exit portal]], one on each of the flat sides, the crystals respawn the original end crystals on the obsidian pillars, as well as resurrect the dragon itself, before exploding. The top of each pillar also explodes, destroying any player-placed blocks. This happens even if TNT explosions are turned off in settings.
If the exit portal is ever broken for any reason, end crystals can still be placed on obsidian blocks with the same location as the exit portal.
=== Explosions ===
End crystals explode when attacked or damaged in most ways, even by attacks that normally do zero damage. They are not affected by exploding fireworks, and if damaged by an explosion, they disappear instead of exploding.{{Only|Java}}<ref>{{bug|MC-118429||End crystals don't explode when destroyed by nearby explosions}}</ref> The end crystal's [[explosion]] has an [[Explosion#Explosion strength|explosion strength]] of 6, the same as a [[charged creeper]]. The end crystal's fire often remains after the crystal explodes. Any ender dragon charging from the crystal when it is destroyed takes {{hp|10}} damage.
{{IN|java}}, an end crystal's explosion can be [[blocking|blocked]] by a [[shield]].
Although an ender dragon damages most blocks and entities in its path, it cannot destroy end crystals simply by going near them.
Placing [[water]] on the end crystal will neutralize the blast effect, but not the [[damage]] or knockback.
End crystals with obsidian or bedrock below them will not damage blocks below them when they explode.
{{IN|bedrock}}, having the game rule {{cd|mobGriefing}} to {{cd|false}} will prevent the End Crystal from destroying any blocks. While {{in|java}} the same game rule will not prevent the End Crystal from destroying any blocks.
=== Beams ===
The end crystal naturally shoots a beam at the ender dragon and heals it when the dragon is within range. This beam can be manually created using the command {{cmd|data merge entity @e[type{{=}}end_crystal,limit{{=}}1] {BeamTarget:{X:0, Y:0, Z:0<nowiki>}}}}. The beam can be pointed in any direction, allowing it to mark locations or objects.
=== Properties ===
[[File:End Crystal (Slateless).gif|thumb|A base-less end crystal.]]
End crystals are of two kinds: the ones with a base beneath them are created either by game mechanism or by the {{cmd|summon}} command; while the base-less ones are created by players by manually placing the crystal items on top of [[obsidian]] or [[bedrock]].
The base appears to be made of bedrock, with a crystal hovering over it. While in the End, a crystal continually generates fire at its current position, one block above the base (directly on top of the block the base is embedded in), replacing any other block at that location. This fire is capable of spreading.
The end crystal entity is not solid and can be walked through freely. End crystals can be pushed by [[piston]]s, but they explode if moved while on fire. Because fire is checked only when an entity moves, end crystals do not normally take damage from their own fire unless moved.
== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Explosion1.ogg
|sound2=Explosion2.ogg
|sound3=Explosion3.ogg
|sound4=Explosion4.ogg
|subtitle=Explosion
|source=block
|description=When an end crystal explodes
|id=entity.generic.explode
|translationkey=subtitles.entity.generic.explode
|volume=4.0
|pitch=0.56-0.84
|distance=16
|foot=1}}
{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Explosion1.ogg
|sound2=Explosion2.ogg
|sound3=Explosion3.ogg
|sound4=Explosion4.ogg
|source=block
|description=When an end crystal explodes
|id=random.explode
|volume=4.0
|pitch=1.0
|foot=1}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=item
|nameid=end_crystal
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=entity
|nameid=end_crystal
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=item
|nameid=end_crystal
|id=637
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=entity
|nameid=ender_crystal
|id=71
|foot=1}}
=== Entity data ===
End crystals have entity data that define various properties of the entity.
{{el|java}}:
{{main|Entity format}}
{{/ED}}
{{el|bedrock}}:
: See [[Bedrock Edition level format/Entity format]].
== Achievements ==
{{load achievements|The End... Again...}}
== Advancements ==
{{load advancements|The End... Again...}}
== History ==
[[File:End Crystal 19w38a.gif|thumb|Java Edition 19w38a]]
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 6|[[File:End Crystal JE1 BE1.png|32px]] Added ender crystals.}}
{{History||1.2.1|snap=12w04a|Previously, ender crystals could be spawned using [[spawn egg]]s with ID 200 (in a [[server]], these were created using {{cmd|give 383 1 200}}). The spawned crystal would be positioned where a natural crystal would be if there was a bedrock block at the location. It was still possible until 1.9 to obtain an end crystal spawn egg, but it would not spawn anything.}}
{{History||1.7.2|snap=13w36a|Ender crystals can now be spawned with the {{cmd|summon}} command.}}
{{History||1.8|snap=14w06a|Ender crystals now generate one [[block]] lower. The fire they generate destroys the [[bedrock]] block that is supposed to be underneath (see {{bug|MC-47526}}).}}
{{History||1.9|snap=15w31a|Ender crystals generate at the correct Y-level again.}}
{{History|||snap=15w33c|Respawning the ender dragon now also respawns the ender crystals on the obsidian pillars.
|Ender crystals now have a compound BeamTarget tag that hold the X, Y, Z block location the beam points to.}}
{{History|||snap=15w44a|"Ender crystals" have been renamed to "end crystals".
|[[File:End Crystal (item) JE1 BE1.png|32px]] End crystals can now be obtained as an item.
|End crystals now drop from [[skeleton trap]] horses and can be placed only on [[obsidian]] or bedrock. Placing several of them atop the end exit portal respawns the ender dragon.}}
{{History|||snap=15w44b|End crystals are no longer dropped by [[skeleton horse]]s.
|Added crafting recipe for end crystals, making end crystals [[renewable]].}}
{{History|||snap=15w49a|End crystals now require [[air]]/replaceable [[block]]s and lack of [[entity|entities]] for placement.}}
{{History|||snap=15w51a|End crystals can no longer be placed in [[Adventure mode]].}}
{{History||1.11|snap=16w32a|The entity ID has been changed from <code>EnderCrystal</code> to <code>ender_crystal</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 426.}}
{{History|||snap=18w20b|Renamed to "End Crystal".}}
{{History|||snap=pre5|Entity ID has been changed to <code>end_crystal</code>.}}
{{History||1.14|snap=18w43a|[[File:End Crystal JE2.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal [[item]] have been changed.}}
{{History||1.19.3|snap=22w43a|End crystal explosions can now be [[blocking|blocked]] by [[shield]]s.<ref>{{bug|MC-188247|||Fixed}}</ref>}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:End Crystal JE1 BE1.png|32px]][[File:End Crystal (item) JE1 BE1.png|32px]] Added end crystals.}}
{{History|bedrock}}
{{History||1.6.0|snap=?|[[File:End Crystal BE2.png|32px]] [[File:End Crystal BE2.gif|32px]] The model of the end crystals has been changed. It has now two cubes instead of three.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:End Crystal BE3.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal item have been changed.}}
{{History||1.17.10|snap=beta 1.17.10.20|[[File:End Crystal JE2.png|32px]] The model of the end crystals has been changed to have three cubes again, and to match ''Java Edition''.}}
{{History||1.19.70|snap=beta 1.19.70.20|Increased end crystal collision box size to match ''Java Edition''.|End crystals with obsidian or bedrock below them now will not damage blocks below them when they explode.}}
{{History|console}}
{{History||xbox=TU9|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:End Crystal JE1 BE1.png|32px]] Added ender crystals.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Ender crystals now generate one block lower. The fire they generate destroys the [[bedrock]] block that is supposed to be underneath.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|"Ender crystals" have been renamed to "end crystals".
|[[File:End Crystal (item) JE1 BE1.png|32px]] End crystals can now be obtained as an [[item]].
|End crystals now drop from [[skeleton trap]] horses and can be placed only on [[obsidian]] or bedrock. Placing several of them atop the [[end portal|end exit portal]] respawns the ender dragon.
|Added a crafting recipe for end crystals.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:End Crystal JE2.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal item have been changed.}}
{{History|new 3ds}}
{{History||1.7.10|[[File:End Crystal JE1 BE1.png|32px]][[File:End Crystal (item) JE1 BE1.png|32px]] Added end crystals.}}
{{History|foot}}
== Issues ==
{{issue list}}
== Trivia ==
* According to [[Jens Bergensten|Jeb]], the reason behind the current crafting recipe using glass as opposed to [[Chorus Fruit|chorus fruit]] or any materials introduced in [[Java Edition 1.9|1.9]] is as a means for players to craft end crystals in older worlds that the dragon has already been killed in.<ref>{{tweet|jeb_|667000226524372992|The problem is that you need to be able to craft the crystals on worlds in which the dragon has been destroyed already|November 18, 2015}}</ref>
* A historical rendition of the [[beacon]] block featured an animated entity within it, which resembled a yellow miniaturized end crystal. The bedrock platform of the end crystal entity would also render below the beacon, though this would normally be hidden within the block below.
* Using a [[piston]] to push an end crystal's fire into an end portal block deletes the end portal block. However, natural portal blocks regenerate if the end crystal is moved.
== Gallery ==
<gallery>
End Crystal Usage.png|Using end crystals to respawn the ender dragon.
Crystal Link.png|An ender dragon being hit with the "healing beam" of an end crystal.
Ender Crystal.png|An end crystal.
EnderCrystalOverworld.png|An end crystal in the Overworld spawned using {{cmd|summon}} {{code|end_crystal}}.
Ender Dragon Revival.png|End crystals respawning the ender dragon.
CagedEnderCrystal.png|A caged end crystal.
Respawn ender dragon.png|A [[player]] trying to respawn the ender dragon.
End Crystal (item).gif|An animation of the item of the end crystal.
</gallery>
== References ==
{{reflist}}
{{Entities}}
{{Items}}
[[de:Enderkristall]]
[[el:Κρύσταλλος του Ender]]
[[es:Cristal del End]]
[[fr:Cristal de l'End]]
[[ja:エンドクリスタル]]
[[ko:엔드 수정]]
[[nl:Endkristal]]
[[pl:Kryształ Endu]]
[[pt:Cristal do End]]
[[ru:Кристалл Края]]
[[th:คริสตัลเอนด์]]
[[uk:Кристал Енду]]
[[zh:末影水晶]]</li><li>[[Photo|Photo]]<br/>{{exclusive|education}}
{{Item
| image = Photo EE2.png
| renewable = No (unless [[portfolio]] is available)
| stackable =
}}
A '''photo''' is an [[item]] containing a picture taken with a [[camera]].<ref>{{cite|url=https://web.archive.org/web/20210925044841mp_/https://educommunity.minecraft.net/hc/en-us/articles/4407489082644-Feature-Walkthrough-Minecraft-Education-Edition-GOAT-Beta-version-1-17-30-| title = Feature Walkthrough Minecraft: Education Edition GOAT Beta (version 1.17.30)|website=Minecraft: Education Edition Support|date=September 24, 2021}}</ref><ref>{{cite|url=https://education.minecraft.net/en-us/blog/new-update-and-anniversary-for-mee| title = The GOAT Update Celebrates a Minecraft Milestone!|website=Minecraft: Education Edition|date=November 2, 2021}}</ref><ref>{{ytl|2Wd0J-EIfws|GOAT Release Playthrough|Minecraft: Education Edition|December 2, 2021}}</ref>
== Obtaining ==
A photo in a [[portfolio]] can be saved as a photo item by selecting the "Save to Inventory" button underneath it.
== Usage ==
Photos display an image when held in the hand or when placed in an [[item frame]], similarly to [[map]]s. Photos can have captions added to them by renaming them in an [[anvil]] or by adding a caption while they are in a portfolio. Photos can be added to [[book and quill]]s and portfolios by selecting the "Add Photo" button in the book and quill or portfolio.
== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Photo
|spritetype=item
|nameid=photo_item
|id=?
|form=item
|foot=1}}
== History ==
{{History|education}}
{{History||1.17.30|snap=1.17.30.2|[[File:Photo EE1.png|32px]] Added photos.}}
{{History||1.17.30|snap=release|[[File:Photo EE2.png|32px]] Changed photo texture.}}
{{History|foot}}
== Gallery ==
<gallery>
Photo Item 1.png|A photo being placed in an item frame.
Photo Item 2.png|A photo being saved from a portfolio.
Photo Item 3.png|A photo being added to a book and quill.
</gallery>
== References ==
{{Reflist}}
{{Items}}
{{Education Edition}}
[[Category:Education Edition items]]
[[Category:Non-renewable resources]]
[[ja:写真]]
[[zh:相片]]</li></ul></nowiki> | 12w22a | Added Adventure mode, accessible through commands. It is still possible to craft in Adventure mode both with the 2×2 crafting grid in the player's inventory and with the full sized 3×3 crafting table. The player can still interact with blocks with an interface, such as chests, dispensers, crafting tables, furnaces and brewing stands. The player can also go through portals, but cannot activate one by using flint and steel; flint and steel can be used to activate TNT. | |||
1.4.2{{Extension DPL}}<ul><li>[[Ender Pearl|Ender Pearl]]<br/>{{Update|[[game rule]] <code>enderPearlsVanishOnDeath</code>}}
{{ItemEntity
|image=Ender Pearl.png
|renewable=Yes
|stackable=Yes (16)
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
}}
An '''ender pearl''' is an [[item]] that can be thrown to [[teleport]] to where it lands, or used to craft [[eye of ender|eyes of ender]] which are required to access [[the End]].
== Obtaining ==
=== Mob loot ===
An [[enderman]] has a 50% chance to drop 1 ender pearl when killed. The drop is increased by 1 per level of [[Looting]], with a maximum of 4 with Looting III.
=== Chest loot ===
{{LootChestItem|ender-pearl}}
A [[trapped chest]] always containing 2 ender pearls can be found in the "fake end portal" room of [[woodland mansion]]s.
=== Trading ===
{{IN|java}}, expert-level [[Trading#Cleric|cleric villagers]] have a {{frac|2|3}} chance to sell an ender pearl for 5 [[emerald]]s.
{{IN|bedrock}}, expert-level cleric villagers sell one ender pearl for 5 emeralds.
=== Bartering ===
[[Piglin]]s have a {{frac|10|459}} (2.18%) chance to [[barter]] 2–4 ender pearls when given a [[gold ingot]].
== Usage ==
Ender pearls can be thrown by pressing {{control|use}}. After it is thrown, the ender pearl is consumed, and the player teleports to where it lands, taking {{hp|5}} [[fall damage]]. Wearing armor enchanted with [[Protection]] and/or [[Feather Falling]] reduces the damage taken from the ender pearl.
Ender pearls have a small cone of travel; they do not all follow the same path when thrown in the same direction. The direction and velocity of ender pearl throws is slightly randomized. They can travel about 30 blocks{{Only|java}}/45 blocks{{Only|bedrock}} when thrown straight up, and up to 54 blocks forward when thrown at an optimum launch angle of ~35° (on even ground).
The thrower's vertical velocity influences the throw. Hence timing a throw with a jump can increase the throwing range to 42 blocks when thrown straight up and 64 blocks forward at a 35° angle. Throwing while falling significantly decreases the range. Ender pearls collide with all [[minecart]] types, [[boat]]s, [[end crystal]]s and [[nether portal]]s, and travel through [[end portal]]s. Ender pearls that fall into the [[void]] disappear, and do not trigger the player to teleport. However, ender pearl entities (instead of dropped items) are ''not'' destroyed by lava and will teleport the player to the bottom of lava pools/lava oceans.
Ender pearls have a cooldown of one second before they can be used again. The cooldown is shown in the hotbar by a white overlay on the ender pearl that shrinks and must disappear before the player can use it again. If there are other inventory or hotbar slots containing ender pearls, they are covered with the white overlay as well.<ref>{{bug|MC-88236|||WAI}}</ref>
Ender pearls can be thrown into [[end gateway]]s to reach the outer islands of the End. They can also be thrown into the [[exit portal]] to reach the player's spawn point.
Ender pearl teleportation makes no sound ''itself''{{only|java}}, but does emit a "small fall" sound at the destination when applying teleportation damage to the player.
=== Stasis chamber ===
Ender pearls are affected by [[bubble column]]s. An ender pearl can remain afloat on top of an upward bubble column, allowing it to be stored indefinitely. A mechanism can then be triggered to make the ender pearl hit a solid surface (e.g. by closing a [[trapdoor]]), teleporting the thrower back to the setup wherever they are.
=== Spawning endermites ===
An ender pearl has a 5% chance to spawn an [[endermite]] when it lands. This is the only way through which endermites can spawn, without using cheats. The endermite spawns at ''the player's position'' when the pearl lands{{only|je}}, or at the pearl's landing site{{only|be}}.
=== Crafting ingredient ===
{{crafting usage}}
== Sounds ==
{{edition|java}}:<br>
Thrown ender pearls use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Ender Pearl flies
|source=neutral
|description=When an ender pearl is thrown
|id=entity.ender_pearl.throw
|translationkey=subtitles.entity.ender_pearl.throw
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16
|foot=1}}
{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Bow shoot.ogg
|source=player
|description=When an ender pearl is thrown
|id=random.bow
|volume=0.5
|pitch=0.33-0.5
|foot=1}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Thrown Ender Pearl
|spritetype=entity
|spritename=Ender Pearl
|nameid=ender_pearl
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|id=422
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=entity
|nameid=ender_pearl
|id=87
|foot=1}}
===Entity Data===
Thrown ender pearls have entity data that define various properties of the entity.
{{el|java}}:
{{main|Entity format}}
{{/ED}}
{{el|bedrock}}:
: See [[Bedrock Edition level format/Entity format]].
== Achievements ==
{{Load achievements|Beam Me Up}}
== Advancements ==
{{load advancements|Remote Getaway;Bullseye}}
== History ==
{{History|java beta}}
{{History||1.8|snap=Pre-release|[[File:Ender Pearl JE1.png|32px]] Added ender pearls along with [[endermen]].
|Ender pearls have no use, but can stack up to 64.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Ender pearls are now less commonly found near bodies of [[water]] since [[endermen]] now teleport away when in contact with water. Before this version, endermen didn't attempt to teleport and were [[damage]]d/killed from water much more frequently, causing numerous ender pearls to occur around bodies of water.
|Later, on a suggestion from [[wikipedia:Reddit|Reddit]] user isJesus, [[Notch]] implemented the teleporting feature for ender pearls.<ref>http://www.reddit.com/r/Minecraft/comments/kpsay/eggsnowballender_pearl_suggestiongif/c2mabfj</ref><ref>{{Tweet|notch|118614580539826176}}</ref><ref>http://www.reddit.com/r/Minecraft/comments/kss7n/twitter_ender_pearls_have_a_unique_ability_now/c2mwldd</ref>}}
{{History|||snap=Beta 1.9 Prerelease 2|Added teleporting feature to ender pearls.
|Using an ender pearl to teleport resulted in being kicked from servers for "hacking". This is due to a check triggering that was supposed to prevent modified clients from moving too quickly.
|Ender pearls now only stack up to 16.}}
{{History|||snap=Beta 1.9 Prerelease 3|Ender pearls are now used to craft [[eyes of ender]].
|Ender pearls can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History||1.3.1|snap=12w24a|[[File:Ender Pearl JE2 BE1.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.8|snap=14w02a|As part of the revamp of the trading system, cleric [[villager]]s now [[trading|buy]] ender pearls.}}
{{History|||snap=14w03a|Villager clerics no longer buy ender pearls.}}
{{History|||snap=14w11b|Ender pearls have a 5% chance to spawn [[endermite]]s when used.}}
{{History||1.9|snap=15w31a|Ender pearls can now be thrown in [[Creative]] mode.}}
{{History|||snap=15w34c|Ender pearls now have a cooldown after using them.}}
{{History|||snap=15w41a|[[Villager]] clerics now [[trading|sell]] ender pearls for 4–7 [[emerald]]s, as one of their tier III trades.}}
{{History|||snap=15w49a|Thrown ender pearls now take the user's motion into account. For example, an ender pearl thrown forward will land closer if the player is falling, and land farther if the player is ascending.}}
{{History||1.10|snap=16w21a|Ender pearls can now teleport riders off their mounts.}}
{{History||1.11|snap=16w32a|The entity ID of ender pearls has been changed from <code>ThrownEnderpearl</code> to <code>ender_pearl</code>.}}
{{History|||snap=16w39a|Ender pearls can now be found in [[woodland mansion]]s' fake portal room [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 368.}}
{{History||1.14|snap=18w43a|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.16|snap=20w07a|Ender pearls have a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 2–4.}}
{{History|||snap=20w09a|Ender pearls now have a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w10a|Ender pearls now have a {{frac|20|411}} (~4.87%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History|||snap=20w20a|Ender pearls now have a {{frac|20|423}} (~4.73%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History||1.16.2|snap=20w28a|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}
{{History|||snap=Pre-Release 1|Ender pearls are now affected by [[bubble column]]s.<ref>{{bug|MC-125758|||Fixed}}</ref>
|Ender pearls no longer get destroyed at contact with non-solid blocks.<ref>{{bug|MC-73884|||Fixed}}</ref>}}
{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.
|While fully implemented, ender pearls currently have no assigned ID and are currently unobtainable in-game.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Ender pearls are now obtainable in-game.
|Ender pearls can now be used to craft [[eyes of ender]].}}
{{History|||snap=alpha 1.0.0.0|Ender pearls now require a 1-second cooldown.}}
{{History|||snap=alpha 1.0.0.1|Ender pearl cooldown now has an animation.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Ender pearls can now be [[trading|bought]] from cleric [[villager]]s for 4-7 [[emerald]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Ender pearls can now be found in [[woodland mansion]]s' [[chest]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has been changed, expert-level cleric [[villager]]s now [[trading|sell]] an ender pearl for 5 [[emerald]]s as part of their trade.}}
{{History||1.16.0|snap=beta 1.16.0.57|Ender pearls can now be obtained from [[bartering]] with [[piglin]]s.}}
{{History||1.16.100|snap=beta 1.16.100.54|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}
{{History|console}}
{{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History||xbox=TU7|A teleporting feature has been added to ender pearls.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History|new 3ds}}
{{History||1.7.10|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History|foot}}
== Issues ==
{{issue list}}
== Trivia ==
*Ender pearls can be used to teleport/move through non-[[solid block]]s without suffocation and solid blocks by pressing against the blocks and using the ender pearl at the player's feet until the player goes through.<ref>{{bug|MC-2164}}</ref><ref>{{ytl|KA1UmxraeUg}}</ref>
*In ''Java Edition'', it is possible to spawn a thrown ender pearl using commands, but it does not teleport, unless it is assigned an owner.
*If the player throws an ender pearl and then dies before impact while the pearl is in a loaded chunk, the pearl disappears and the player is not teleported. Pearls in unloaded chunks do not disappear if their owner dies.
*If the player throws an ender pearl in Survival mode and changes to Creative mode before the pearl lands, the player is still teleported.
*The player is still teleported by throwing an ender pearl and entering [[the Nether]] before it lands. The pearl is not lost if an ender pearl is thrown into a [[nether portal]] and the player travels through the portal; the pearl lands and teleports the player as usual.
*If multiple ender pearls are thrown in succession, the player can be hurt only once from fall damage within about a one-second span.
*If a [[player]] dies from ender pearl teleportation, the [[death message]] says: "<player> hit the ground too hard".
*A thrown ender pearl faces toward the player in first-person view, while it appears rotated horizontal in [[third-person view]]. This is the case for all throwable items (ender pearl, [[egg]], [[snowball]], and all throwable [[potion]]s).
*Ender pearls and [[snowball]]s have the exact same range when fired. Therefore, snowballs can be used to predict the trajectory of ender pearls, or simply for practicing ender pearl throwing. This can be very helpful when the player has to throw ender pearls in dangerous environments, such as the Nether or the End.
*Despite the fact that ender pearls deal no damage to anything they're thrown at, provokable mobs (such as iron golems and piglins) will be provoked by the player if one is thrown at them.
== Gallery ==
<gallery>
Ender Pearl Suggestion.gif|The original suggestion image for teleporting with ender pearls.
Enderlake.png|Ender pearls were formerly found in [[water]], however endermen now teleport out to prevent damage.
</gallery>
== References ==
{{reflist}}
== See also ==
*[[The End]]
*[[Ender Dragon]]
*[[End Portal]]
*[[Enderman]]
{{Items}}
{{entities}}
[[cs:Endová perla]]
[[de:Enderperle]]
[[es:Perla de ender]]
[[fr:Perle de l'Ender]]
[[hu:Véggyöngy]]
[[ja:エンダーパール]]
[[ko:엔더 진주]]
[[nl:Enderparel]]
[[pl:Enderperła]]
[[pt:Pérola de ender]]
[[ru:Жемчуг Края]]
[[th:ไข่มุกเอนเดอร์]]
[[tr:Ender İncisi]]
[[uk:Перлина Краю]]
[[zh:末影珍珠]]</li><li>[[Dye|Dye]]<br/>{{Item
| title = Dyes
| image = White Dye.png
| extratext = View [[#Gallery|all renders]]
| renewable = Yes
| stackable = Yes (64)
}}
'''Dyes''' are a set of sixteen items used to change the color of [[wool]], [[carpet]]s, [[terracotta]], [[concrete powder]], [[glass]], [[shulker box]]es, [[bed]]s, [[candle]]s, the patterns on [[banner]]s, [[firework star]]s, certain mobs, and text on [[sign]]s and [[hanging sign]]s. {{IN|bedrock}} they can also be used to dye water in a [[cauldron]] (which is thereafter used to dye leather [[armor]]); {{in|java}} leather armor can be dyed directly. {{IN|education}} dyes can also be used to dye [[balloon]]s and [[glow stick]]s.
{{IN|bedrock|education}}, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa bean]]s can generally substitute for [[white dye]], [[black dye]], [[blue dye]], and [[brown dye]], respectively, in crafting recipes and for use in dyeing items or mobs. However, they have other important uses that aren't related to color, and are therefore not considered true dyes. They are mentioned in this article only in regard to their use as dyeing agents; see their individual articles for complete information about them.
== Obtaining ==
<!--[[File:Dye Chart.png|350px|thumb|A guide to crafting all the dyes.{{until|java 1.14}}]]-->
Dyes can be produced by crafting them from plants (mainly flowers), by crafting dyes of different colors together, by smelting plants, or by trading with a [[wandering trader]].
{{loadPage|Crafting/Dye|Crafting|h3}}
=== Smelting ===
{{smelting|head=1|Sea Pickle|Lime Dye|0,2}}
{{smelting|foot=1|Cactus|Green Dye|1|}}
=== Trading ===
[[Wandering trader]]s can sell 3 dyes for an [[emerald]]. {{IN|bedrock}}, they can also sell 3 lapis lazuli, bone meal, cocoa beans, or ink sacs for one emerald.
Apprentice-level cleric [[villager]]s sell one lapis lazuli per emerald.
=== Chest loot ===
{{#invoke:LootChest|base3|blue-dye,green-dye,orange-dye,light-blue-dye,yellow-dye,white-dye}}
=== Other ===
Ink sacs can also be created using 1 iron, 1 sulfur, and 4 oxygen in the [[compound creator]]. {{only|bedrock|education}}
== Usage ==
Similar to their use in crafting, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa beans]] can be substituted for the corresponding dye in any of the following usages unless otherwise specified.{{only|bedrock}} <!--- sections are ordered by craftable dyeable blocks, dyeable items, version exclusive sections, and non-crafting miscellaneous uses--->
=== Dyeing wool and mobs ===
Players can dye wool by placing [[wool]] and any dye in a crafting grid.
{{Crafting
|nocat=1
|Any Wool
|Matching Dye
|Output=Any Wool
}}
Dyes can be {{control|use|text=used}} on sheep to change the color of the wool. Shearing a colored sheep drops the corresponding color of the wool, and the sheep retains the color when the wool regenerates. [[Breeding]] colored sheep produces a lamb colored as one of the parent sheep, or a color resulting from the combination of both parents' color. The color combining follows the same rules that dyes use – red and yellow sheep produce an orange lamb, but a blue and yellow sheep cannot create a green lamb. The unlimited reproduction of colored sheep makes dyeing and shearing sheep infinitely more efficient than just dyeing wool directly.
Dye can also be used on a tamed [[wolf]] or [[cat]] to change the color of its collar from the default red to the color of the dye.
=== Dyeing carpets ===
Carpets can be dyed.
{{Crafting
|Any Carpet
|Matching Dye
|Output= Matching Carpet
|type= Building block
}}
=== Dyeing terracotta ===
[[Terracotta]] can be dyed by placing 8 blocks around a dye on a crafting table.
{{Crafting
|nocat=1
|A1=Terracotta |B1=Terracotta |C1=Terracotta
|A2=Terracotta |B2=Matching Dye |C2=Terracotta
|A3=Terracotta |B3=Terracotta |C3=Terracotta
|Output=Matching Dyed Terracotta,8
}}
=== Creating concrete powder ===
Dyes can also be used to craft [[concrete powder]], which can then be set into their respective [[concrete]] blocks (they cannot be dyed directly).
{{Crafting
|nocat=1
|Sand |Gravel |Sand
|Gravel |Matching Dye |Gravel
|Sand |Gravel |Sand
|Output=Matching Concrete Powder,8
}}
=== Staining glass ===
[[Stained glass]] can be stained by placing 8 blocks of glass around a dye on a [[crafting table]]. Just like regular glass, stained glass can be crafted into stained glass panes. The recipe for this is the same as with regular glass.
{{Crafting
|nocat=1
|A1=Glass |B1=Glass |C1=Glass
|A2=Glass |B2=Matching Dye |C2=Glass
|A3=Glass |B3=Glass |C3=Glass
|Output=Matching Stained Glass,8
|head=1
}}
{{Crafting
|nocat=1
|A1= Glass Pane
|B1= Glass Pane
|C1= Glass Pane
|A2= Glass Pane
|B2= Matching Dye
|C2= Glass Pane
|A3= Glass Pane
|B3= Glass Pane
|C3= Glass Pane
|Output= Matching Stained Glass Pane,8
|type= Decoration block
|foot=1
}}
=== Dyeing shulker boxes ===
[[Shulker box]]es are generated in a light shade of purple (like the [[purpur block]]), but can be dyed any color. They can also be re-dyed as often as desired.
{{Crafting
|ignoreusage=1
|showname=1
|Any Shulker Box
|Matching Dye
|Output=Matching Shulker Box
}}
=== Dyeing beds ===
Players can dye beds by placing a [[bed]] and any color dye in a crafting grid.
{{Crafting
|nocat=1
|Any Bed
|Matching Dye
|Output=Matching Bed
}}
=== Dyeing candles ===
Players can dye [[candles]] by placing an undyed candle and any color dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Candle
|Matching Dye
|Output=Matching Dyed Candle
}}
=== Banner patterns ===
{{main|Banner#Patterns}}
Dyes are used in most banner patterns to determine the pattern and color displayed.
=== Dyeing armor ===
[[File:DyeGraph2.png|200px|thumb|A graph showing all combinations of two dyes on a [[tunic]].]]
Leather [[armor]] can be dyed by:
* Crafting dyes with a piece of leather armor or leather [[horse armor]].{{Only|java}}
* Dousing the leather armor or leather [[horse armor]] in a [[cauldron]] to which dyes have been added.{{Only|bedrock}}
There are 5,713,438<ref>https://anrar4.github.io/DyeLeatherArmor/</ref> (34.1% of sRGB) colors leather armor can be, as it is possible to put more than one dye on the crafting bench alongside the leather armor. Armor can be dyed multiple times with previous colors affecting the final outcome. Colored armor can be reverted to their original color using a [[cauldron]] with undyed water.
The game has a specific formula for calculating the color of dyed armor: each color, in the RGB color model, has a red value, green value, and blue value. For each dye in the crafting grid, and the armor itself (if it is already dyed), the red, green, and blue values are added to running totals. In addition, a running total of the highest value (be it red, green, or blue) is also kept. After this, each total is divided by the number of colors used. This effectively produces the average red, green, blue, and maximum values. The maximum value of the average RGB values is also calculated. Finally, each average RGB value is multiplied by the average maximum value and divided by the maximum of the average RGB values. The modified average RGB values are then used as the final color. This procedure can be summed up with the following equations:
for each color (all "total" variables start at 0 before counting):
totalRed = totalRed + redValue
totalGreen = totalGreen + greenValue
totalBlue = totalBlue + blueValue
totalMaximum = totalMaximum + max(redValue, greenValue, blueValue)
numberOfColors = numberOfColors + 1
averageRed = totalRed / numberOfColors
averageGreen = totalGreen / numberOfColors
averageBlue = totalBlue / numberOfColors
averageMaximum = totalMaximum / numberOfColors
maximumOfAverage = max(averageRed, averageGreen, averageBlue)
gainFactor = averageMaximum / maximumOfAverage
resultRed = averageRed * gainFactor
resultGreen = averageGreen * gainFactor
resultBlue = averageBlue * gainFactor
Due to the way this formula works, the resulting color can never be darker than the average of the input colors and is often lighter and more saturated. Of course, the resulting color can never be lighter or more saturated than the lightest or most saturated input color. In addition, this formula never creates an RGB value higher than 255 (which would be invalid in the 8-bit RGB color model).
If leather armor is renamed on an [[anvil]], it retains its name when dyed or undyed.
;Mixing Samples
: {{ItemSprite|Yellow Dye}} + {{ItemSprite|Yellow Dye}} = {{Tint|leather-chestplate| #{{CalcDye| yellow=2 }} | code=1}}
: {{ItemSprite|Red Dye}} + {{ItemSprite|Blue Dye}} + {{ItemSprite|White Dye}} = {{Tint|leather-chestplate| #{{CalcDye| red=1 | blue=1 | white=1}} | code=1}}
: {{ItemSprite|Green Dye}} + {{ItemSprite|Red Dye}} + {{ItemSprite|Pink Dye}} = {{Tint|leather-chestplate| #{{CalcDye| green=1 | red=1 | pink=1}} | code=1}}
=== Dyeing firework stars ===
A [[firework star]] can have a single color or a combination of up to eight colors when crafted with dyes. Adding one or more dyes to a crafted firework star adds a "fade to color" effect to it, overwriting any existing fade colors.
{{Crafting
|head=1
|ignoreusage=1
|ingredients=[[Gunpowder]] +<br>Any Dye (1–8) +<br>Extra ingredient (optional)
|Gunpowder
|Matching Dye
|Diamond;Glowstone Dust;Head;Gold Nugget;Feather;Fire Charge;
|Output=Matching Firework Star
}}
{{Crafting
|ignoreusage=1
|Matching Firework Star
|Any Dye
|Output=Matching Firework Star
|foot=1
}}
=== Creating balloons ===
Dye can be used to craft balloons.{{only|education}}
{{Crafting
|nocat=1
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
}}
=== Creating glow sticks ===
Dye can also be used to craft glow sticks.{{only|education}}
{{Crafting
|nocat=1
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= Matching Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
}}
=== Dyeing water inside cauldrons ===
Water can be dyed in a cauldron by holding any dye in the hand and pressing {{Ctrl|use}} on a cauldron filled with water.{{only|bedrock}}
=== Signs ===
Dye can be {{control|used}} on a [[sign]] or a [[hanging sign]] to change the text color. {{IN|bedrock}}, [[ink sac]]s cannot be used for this purpose; black dye must be used to change the text to black.
=== Trading ===
Apprentice, journeyman and expert-level shepherd [[villager]]s buy any of the 12 dyes for an [[emerald]].
== Color values ==
The "color codes" are used to determine the color imparted on sheep, wolf and cat collars, firework stars, [[beacon]] beams, and dyed leather armor. The hex value is shown in the extended tooltips of dyed leather armor; however, to set the color using an NBT data tag in a [[command]], the decimal value must be used instead. The color values for firework stars are slightly different from the ones listed below, and use [[Item colors#Firework stars|these values]] instead.
{| class="wikitable" style="margin:2px; border: 1px solid silver; text-align: left;" data-description="Data values"
! rowspan=2 | Description
! colspan=2 style="text-align:center" | Color Code
|-
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
|-
| style="text-align:center" | White || 16383998 || {{color|#F9FFFE}}
|-
| style="text-align:center" | Light gray || 10329495 || {{color|#9D9D97}}
|-
| style="text-align:center" | Gray || 4673362 || {{color|#474F52}}
|-
| style="text-align:center" | Black || 1908001|| {{color|#1D1D21}}
|-
| style="text-align:center" | Brown || 8606770 || {{color|#835432}}
|-
| style="text-align:center" | Red || 11546150 || {{color|#B02E26}}
|-
| style="text-align:center" | Orange || 16351261 || {{color|#F9801D}}
|-
| style="text-align:center" | Yellow || 16701501 || {{color|#FED83D}}
|-
| style="text-align:center" | Lime || 8439583 || {{color|#80C71F}}
|-
| style="text-align:center" | Green || 6192150 || {{color|#5E7C16}}
|-
| style="text-align:center" | Cyan || 1481884|| {{color|#169C9C}}
|-
| style="text-align:center" | Light blue || 3847130 || {{color|#3AB3DA}}
|-
| style="text-align:center" | Blue || 3949738 || {{color|#3C44AA}}
|-
| style="text-align:center" | Purple || 8991416 || {{color|#8932B8}}
|-
| style="text-align:center" | Magenta || 13061821 || {{color|#C74EBD}}
|-
| style="text-align:center" | Pink || 15961002 || {{color|#F38BAA}}
|}
== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Dye.ogg
|subtitle=Dye stains
|source=block
|description=When dye is used on a [[sign]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16}}
{{Sound table
|subtitle=Dye stains
|source=player
|description=When dye is used on a [[sheep]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16
|foot=1}}
{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Dye.ogg
|source=sound
|description=When dye is used on a sign
|id=sign.dye.use
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=3
|sound=Water Splash Old.ogg
|source=block
|description=When dye is added to a cauldron
|id=cauldron.adddye
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When armor is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When dye is removed from armor using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0
|foot=1}}
== Achievements ==
{{load achievements|Rainbow Collection;Tie dye outfit}}
== Video ==
{{Video note|These videos are outdated, as it does not include details of the [[Java Edition 1.7.2|1.7.2]] update's changes to the dyeing system/production chain.}}
<div style="text-align:center">
<span style="display:inline-block">{{yt|8YD7oauNZHE}}</span>
<span style="display:inline-block">{{yt|7tETaRt7STM}}</span>
</div>
== History ==
{{History|java beta}}
{{History||January 3, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/2582321901/2011-here-we-go|Notch mentions adding a "paint" feature if he can figure out how.}}
{{History||January 10, 2011<ref group="n">Supposed time when fragment was filmed. Based on modified date of client.jar/gui/trap.png in [[Beta 1.2]].</ref>|link=https://www.youtube.com/watch?v=cBF2ugTzXqQ&t=181s|[[File:Red Dye (pre-release).png|32px]] Shown rose red in development as part of [[Minecraft: The Story of Mojang]].}}
{{History||1.2|[[File:Ink Sac JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Bone Meal JE1 BE1.png|32px]] Added dyes.
|[[File:Black Dye (Recreated).png|32px]] [[File:Red Dye (pre-release).png|32px]] [[File:Green Dye (Recreated).png|32px]] [[File:Brown Dye (Recreated).png|32px]] [[File:Blue Dye (Recreated).png|32px]] [[File:Purple Dye (Recreated).png|32px]] [[File:Cyan Dye (Recreated).png|32px]] [[File:Light Gray Dye (Recreated).png|32px]] [[File:Gray Dye (Recreated).png|32px]] [[File:Pink Dye (Recreated).png|32px]] [[File:Lime Dye (Recreated).png|32px]] [[File:Yellow Dye (Recreated).png|32px]] [[File:Light Blue Dye (Recreated).png|32px]] [[File:Magenta Dye (Recreated).png|32px]] [[File:Orange Dye (Recreated).png|32px]] [[File:White Dye (Recreated).png|32px]] Leftovers of old textures can be seen in [[items.png]] with 100% opacity. The white dye texture was reused for [[Sugar]].
| The colors were as follows:{{verify|Did the color codes remain the same between Beta 1.2 and Java 1.11.2?}}
{{:Color/Java Edition dye colors before 17w06a}}
}}
{{History|java}}
{{History||1.1|snap=11w49a|[[Sheep]] can now regrow their [[wool]] by eating [[grass block|grass]]. Dyed sheep regrow wool in their new color.}}
{{History||1.3.1|snap=12w19a|[[File:Cocoa Beans JE2.png|32px]] The texture of [[cocoa beans]] has been changed.}}
{{History|||snap=1.3|[[File:bone meal changes.gif|32px]] The textures of [[bone meal]], [[cactus green]], cocoa beans and [[rose red]] have been changed. The textures have been lowered one pixel.}}
{{History||1.4.2|snap=12w34a|Added the ability to dye leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.4|snap=1.4.3|Color codes have been changed. The colors of red, brown, blue, purple, cyan, pink, light blue, magenta and orange were adjusted a little vividly.}}
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted using dyes.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary dyes.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted using dyes.}}
{{History||1.8|snap=14w02a|As cleric [[villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
{{History|||snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.9|snap=15w34a|Added [[shield]]s, which can be dyed indirectly by applying a matching [[banner]].}}
{{History||1.11|snap=16w39b|Dyes are now used to change the color of [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Dyes are now used to craft [[concrete powder]].
|Color codes have been changed. All colors are adjusted more vividly. The changes were as follows:
{{:Color/Java Edition dye color changes in 17w06a}}
|Light blue dye, stained glass, and stained glass panes, did not change colors in this update. This means that they still use old colors.<ref name="unchanged dyes">{{Bug|MC-214643}}<br>{{Bug|MC-214641}}</ref>
}}
{{History|||snap=17w15a|Dyes can now apply color to white [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.}}
{{History||1.14|snap=18w43a|[[Bone meal]], [[ink sac]]s, [[cocoa beans]] and [[lapis lazuli]] are no longer considered dyes.
|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]] and [[blue dye]]s.
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.
|[[Glass pane]]s and [[carpet]]s can now be dyed.
|[[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of light gray, gray, red, orange, yellow, lime, green, cyan, light blue, purple, magenta, and pink dyes, have been changed. The color texture for light blue dye was not changed to reflect the updated colors from 1.12.<ref name="unchanged dyes"></ref>}}
{{History|||snap=18w44a|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=18w49a|Yellow dyes can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=18w50a|Green dyes can now be found in [[chest]]s in [[desert]] [[village]] houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which can sell any type of dye.}}
{{History|||snap=19w11a|All 16 types of dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.16.2|snap=Pre-release 2|Reversed the order of dyes to match other colored items in the [[Creative inventory]].<ref name="reverse dye">{{Bug|MC-136553}}</ref>
|Regrouped dyes in the Creative inventory such that white, blue, brown, and black dyes are within and not [[cocoa beans]], [[ink sacs]], [[lapis lazuli]], and [[bone meal]].<ref name="regroup dye">{{Bug|MC-177684}}</ref>}}
{{History||1.17|snap=20w45a|Added [[candle]]s, which can be dyed.}}
{{History|||snap=21w03a|Added a sound for applying dyes.}}
{{History|||snap=21w19a|Candles can no longer be dyed.}}
{{History|||snap=Pre-release 1|Candles can now once again be dyed.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|The color of the text on [[hanging sign]]s can now be changed with dye.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[Torchflower]]s can now be crafted into orange dye.|[[Pink petals]] can now be crafted into pink dye.}}
{{History||1.20|snap=23w12a|[[Pitcher plant]]s can now be crafted into cyan dye.|Blue, light blue, orange, white, and yellow dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w14a|Pitcher plants can now craft two [[cyan dye]] instead of one.}}
{{History|||snap=23w16a|Blue, light blue, orange, white, and yellow dye no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; blue, light blue, orange, white, and yellow dye now are in the common loot.}}
{{History|pocket alpha}}
{{History||v0.3.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes. Only [[dandelion yellow]] and [[lapis lazuli]] are currently obtainable and have functionality.}}
{{History||v0.3.2|[[Cactus green]] is now obtainable by smelting [[cacti]].}}
{{History||v0.3.3|[[Bone meal]] is now obtainable via [[crafting]].}}
{{History||v0.4.0|[[Cyan dye]], [[light blue dye]], [[lime dye]], [[magenta dye]], [[orange dye]], [[pink dye]], and [[purple dye]] are now obtainable via crafting.
|[[Rose red]] is now obtainable by smelting red [[mushroom]]s.
|All available dyes, excluding bone meal, can now be used to craft their respective [[wool]] color.}}
{{History||v0.8.0|snap=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History|||snap=build 3|[[Ink sac]]s, [[cocoa bean]]s, [[gray dye]], and [[light gray dye]] are now available in the [[creative]] [[inventory]].
|Rose red can now be obtained from [[beetroot]]s.}}
{{History||v0.9.0|snap=build 1|Cocoa beans can now be obtained from [[cocoa pod]]s.
|The [[rose]] has been removed and replaced with a new poppy [[flower]] that can be crafted into rose red.}}
{{History|||snap=build 3|All new [[flower]]s can now be [[crafting|crafted]] into dyes. Because of this, many secondary and tertiary dyes are now primary dyes.
|[[Gray dye]] and [[light gray dye]] can now be obtained in [[survival]].}}
{{History|||snap=build 11|[[Terracotta|Stained clay]] can now be crafted using dyes.}}
{{History||v0.11.0|snap=build 1|[[Ink sac]]s can now be obtained from [[squid]].
|Added the ability to dye [[wolf]] collars.}}
{{History||v0.12.1|snap=build 1|Red [[mushroom]]s can no longer be smelted to obtain [[rose red]].}}
{{History||v0.14.0|snap=build 1|[[Cauldron]]s now used for leather dyeing, by applying a dye to a [[water]]-filled cauldron.}}
{{History||v0.16.0|snap=build 1|[[Cocoa bean]]s can no longer be crafted.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added a ''Dye'' button for [[sheep]].
|Added [[shulker]]s, which can be dyed.
|Added [[stained glass]]. Stain glass cannot be [[crafting|crafted]], but purple glass generates in [[end city|end cities]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Dyes can now apply color to a white [[bed]]s.
|Dyes are now used to craft [[concrete powder]].
|The color palette has been changed.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Dyes can now be used for [[banner]] crafting.
|Dyes can now be used to craft [[firework star]]s.
|[[Stained glass]] is now [[crafting|craftable]], using dyes.}}
{{History||1.4.0|snap=beta 1.2.20.1|[[Lime dye]] can now be obtained from smelting [[sea pickle]]s.
|Dyes can now used to craft [[glow stick]]s and [[balloon]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Dyes can now be used to dye [[cat]] collars.}}
{{History|||snap=beta 1.8.0.10|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[brown dye|brown]], [[black dye|black]] and [[blue dye]]s, which can be crafted from [[lapis lazuli]], [[bone meal]], [[cocoa beans]] and [[ink sac]]s. This, however, the later four still use as dyes.<ref>{{Bug|MCPE-42473}}</ref>
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||1.9.0|snap=beta 1.9.0.0|Blue and white dye can now be obtained from [[cornflower]]s and [[lily of the valley]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Glass pane]]s and [[carpet]]s can now be dyed.
|Only a single dye is now required to apply a banner pattern in a [[loom]].
|Various dyes except black dye, white dye, brown dye and blue dye are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE3 BE3.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.210|snap=beta 1.16.210.59|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=beta 1.16.210.60|The ability to dye the color of the text on [[sign]]s was temporarily removed.}}
{{History||1.16.220|snap=beta 1.16.220.50|The color of the text on [[sign]]s can now be changed with dye again.}}
{{History||1.17.10|snap=beta 1.17.10.22|Added [[candles]], which can be dyed.}}
{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes.}}
{{History||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]], and [[blue dye|blue]] dyes, which can crafted from [[bone meal]], [[ink sac]], [[cocoa beans]], and [[lapis lazuli]].
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||ps=1.90|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History|3ds}}
{{History||0.1.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE3 BE2.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes from [[Pocket Edition v0.15.4 alpha]].}}
{{History|foot}}
<gallery>
Pre-release dyes.png|Pre-release dye textures hidden within [[Items.png]].
</gallery>
;Notes
{{reflist|group=n}}
== Gallery ==
<gallery>
White Dye.png|White Dye
Light Gray Dye.png|Light Gray Dye
Gray Dye.png|Gray Dye
Black Dye.png|Black Dye
Brown Dye.png|Brown Dye
Red Dye.png|Red Dye
Orange Dye.png|Orange Dye
Yellow Dye.png|Yellow Dye
Lime Dye.png|Lime Dye
Green Dye.png|Green Dye
Cyan Dye.png|Cyan Dye
Light Blue Dye.png|Light Blue Dye
Blue Dye.png|Blue Dye
Purple Dye.png|Purple Dye
Magenta Dye.png|Magenta Dye
Pink Dye.png|Pink Dye
</gallery>
==Issues==
{{issue list}}
== Trivia ==
* Players can obtain each one of every color with 1 cocoa bean, 2 yellow dye, 2 ink sac, 3 green dye, 4 lapis lazuli, 4 red dye, and 6 bone meal (2 bones).
* The dyed sheep breeding behavior mirrors [[wikipedia:Lamarckism|Lamarck's theory]], in which the organisms evolve inheriting the external changes and adaptations of the previous generation, transmitting them to their offspring.
* In ''Bedrock Edition'', tertiary colors, along with their regular crafting recipes, can be crafted with primary colors. E.g.: Magenta can be crafted with one rose red and two bone meals.
* The colors of the dyes match the chat colors in [[color codes]] except for brown (dye only), light aqua, and gold (color codes only).
* The texture for light blue dye still uses the color from prior to the 1.12 World of Color update.<ref name="unchanged dyes"></ref>
== References ==
{{reflist}}
== External Links ==
* Tools for calculating leather dye combination: [https://minecraft.tools/en/armor.php minecraft.tools] (webapp); [https://github.com/pudquick/pyMCdyes/ pyMCDyes] (open-source Python script, outdated); [https://anrar4.github.io/DyeLeatherArmor/ DyeLeatherArmor]: a tool for calculating an exact crafting recipe for any sRGB color
{{Items}}
[[Category:Dyes]]
[[Category:Renewable resources]]
[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li></ul> | 12w34a | Certain blocks can now be removed with the correct tools and all blocks can be placed.[3] | |||
1.8{{Extension DPL}}<ul><li>[[Gray Dye|Gray Dye]]<br/>{{Item
| image = Gray Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Gray dye'''{{fn|Known as '''Grey Dye''' in British, Canadian, Australian, and New Zealand English variants.}} is a [[Dyeing#Secondary colors|secondary color]] dye.
== Obtaining ==
=== Crafting ===
{{Crafting
|Black Dye
|White Dye
|Output=Gray Dye,2
|type=Material
|head=1
|showdescription=1
|showname=0
}}
{{Crafting
|Ink Sac;Black Dye;Ink Sac
|Bone Meal;Bone Meal;White Dye
|Output=Gray Dye,2
|type=Material
|description={{only|bedrock|education}}
|foot=1
}}
=== Trading ===
[[Wandering trader]]s sell 3 gray dye for an [[emerald]].{{only|bedrock}}
== Usage ==
{{dye usage}}
=== Crafting ingredient ===
{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}
=== Loom ingredient ===
{{Banner loom usage|Gray Dye}}
=== Trading ===
Journeyman-level villagers have a 20% chance to buy 12 gray dye for an emerald.
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|form=item
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gray Dye
|spritetype=item
|nameid=gray_dye
|aliasid=dye / 8
|id=403
|form=item
|translationkey=item.dye.gray.name
|foot=1}}
== Video ==
{{yt|wGalHy0_fj0}}
== History ==
{{History|java beta}}
{{History||1.2|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Gray dye can be now [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}}
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary [[dye]]s.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|Gray dye is now [[crafting|crafted]] using [[black dye|black]] and [[white dye]]s, instead of [[ink sac]] and [[bone meal]].
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History|||snap=18w44a|Gray dye can now change the text color on the [[sign]]s to gray.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell gray dyes.}}
{{History|||snap=19w11a|Gray dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Gray dye can now used to craft [[gray candle]]s.}}
{{History|||snap=21w19a|Gray dye can no longer be used to craft gray candles.}}
{{History|||snap=Pre-release 1|Gray dye can once again be used to craft gray candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Gray dye can now change the text color on [[hanging sign]]s to gray.}}
{{History|pocket alpha}}
{{History||v0.3.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.8.0|snap=build 1|Gray dye can be [[craft]]ed with [[bone meal]] and an [[ink sac]], despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Gray dye is now available in [[creative]] mode.}}
{{History||v0.9.0|snap=build 3|Gray dye can now be obtained in [[survival]] mode.}}
{{History|||snap=build 11|Gray dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Gray dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Gray dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gray dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gray dye can now be used to craft [[concrete powder]], colored [[bed]]s and dyed [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gray dye can now be used to craft [[firework star]]s, [[stained glass]] and patterns on [[banner]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Gray dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Gray dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Gray dye is now [[trading|sold]] by [[wandering trader]]s.
|Gray dye can now be used to dye white [[carpet]]s and undyed [[glass pane]]s.
|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of gray dye has been changed from <code>dye/8</code> to <code>gray_dye</code>.}}
{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|PS4}}
{{History||1.90|[[File:Gray Dye JE2 BE2.png|32px]] The texture of gray dye has now been changed.}}
{{History|new 3ds}}
{{History||0.1.0|[[File:Gray Dye JE1 BE1.png|32px]] Added gray dye.}}
{{History|foot}}
== Issues ==
{{Issue list}}
== Notes ==
{{fnlist}}
== References ==
{{Reflist}}
{{Items}}
[[Category:Dyes]]
[[Category:Renewable resources]]
[[cs:Šedé barvivo]]
[[de:Grauer Farbstoff]]
[[es:Tinte gris]]
[[fr:Teinture grise]]
[[hu:Szürke festék]]
[[ja:灰色の染料]]
[[ko:회색 염료]]
[[nl:Grijze kleurstof]]
[[pl:Szary barwnik]]
[[pt:Corante cinza]]
[[ru:Серый краситель]]
[[zh:灰色染料]]</li><li>[[Netherite Scrap|Netherite Scrap]]<br/>{{About|the unrefined material|the refined item|Netherite Ingot|other uses|Netherite}}
{{Item
| title = Netherite Scrap
| image = Netherite Scrap.png
| rarity = Common
| renewable = No
| stackable = Yes (64)
}}
'''Netherite scrap''' is a material [[smelt]]ed from [[ancient debris]], which is found in [[the Nether]]. It is used solely for crafting [[Netherite Ingot|netherite ingots]]. Like all netherite-related items, it is not flammable.
== Obtaining ==
=== Smelting ===
{{Smelting
|Ancient Debris
|Netherite Scrap
|2
}}
=== Chest loot ===
{{LootChestItem|netherite-scrap}}
== Usage ==
=== Crafting ingredient ===
{{Crafting usage}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Netherite Scrap
|spritetype=item
|nameid=netherite_scrap
|form=item
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Netherite Scrap
|spritetype=item
|nameid=netherite_scrap
|id=613
|form=item
|foot=1}}
== History ==
{{History|java}}
{{History||1.16|snap=20w06a|[[File:Netherite Scrap JE1.png|32px]] Added netherite scrap.}}
{{History|||snap=20w10a|[[File:Netherite Scrap JE2 BE1.png|32px]] The texture of netherite scrap has been changed.}}
{{History|||snap=20w16a|Netherite scraps now generate in [[bastion remnant]] chests.}}
{{History||1.16.2|snap=20w30a|The chance of finding netherite scraps in bastion remnant chests has been increased.}}
{{History|bedrock}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Scrap JE2 BE1.png|32px]] Added netherite scrap.}}
{{History|||snap=beta 1.16.0.57|Netherite scraps now generate in [[bastion remnants]] chests.}}
{{History|foot}}
== Issues ==
{{Issue list}}
== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--netherite-scrap Taking Inventory: Netherite Scrap] – Minecraft.net on March 25, 2021
{{Items}}
[[Category:Non-renewable resources]]
[[de:Netheritplatten]]
[[fr:Fragments de Netherite]]
[[it:Frammento di netherite]]
[[ja:ネザライトの欠片]]
[[ko:네더라이트 파편]]
[[pl:Odłamek netherytu]]
[[pt:Fragmentos de netherita]]
[[ru:Незеритовый скрап]]
[[th:เศษเนเธอไรต์]]
[[uk:Незеритовий уламок]]
[[zh:下界合金碎片]]</li></ul> | 14w02a | Block hitboxes no longer appear in Adventure mode if interaction with the block is impossible. | |||
| Block destroying is now impossible by default. See here for the correct tools before this version. | |||||
| The CanDestroy NBT tag can be used to determine which blocks can be allowed to be broken. | |||||
| 14w06a | The CanPlaceOn NBT tag can be used to determine which blocks a block can be placed on.[4] | ||||
| Pocket Edition | |||||
1.1.0{{Extension DPL}}<ul><li>[[End Crystal|End Crystal]]<br/>{{ItemEntity
|image=End Crystal.gif
|imagesize=150px
|invimage=End Crystal
|renewable=Yes
|stackable=Yes (64)
|rarity=Rare
|drops=None
|size=
Height: 2 Blocks<br>Width: 2 Blocks
}}
An '''end crystal''' is an [[entity]] that can be [[Crafting|crafted]] or found on [[the End]]'s main island, where it heals the [[Ender Dragon|ender dragon]]. It can only be placed on [[obsidian]] or [[bedrock]] and [[Explosion|explodes]] instantly when attacked or damaged in most ways.
== Spawning ==
=== Natural generation ===
An end crystal is found atop each [[obsidian pillar]] on the central island of the End, each on top of a piece of [[bedrock]]. There are 10 end crystals in total, of which two are protected in "cages" of [[iron bars]]. All end crystals respawn one after another as the respawning process of the [[ender dragon]] starts.
== Obtaining ==
=== Crafting ===
{{Crafting
|A1=Glass
|B1=Glass
|C1=Glass
|A2=Glass
|B2=Eye of Ender
|C2=Glass
|A3=Glass
|B3=Ghast Tear
|C3=Glass
|Output= End Crystal
|type= Decoration block
}}
== Usage ==
=== Healing the ender dragon ===
Their primary purpose is to recharge the health of the ender dragon, who gains a charge from the nearest crystal within a cuboid extending 32 blocks from the dragon in all directions. The dragon is healed {{hp|1}} each half-second. If multiple ender dragons are spawned, an end crystal can affect multiple dragons at the same time. The healing beam is neither obstructed nor is its power diminished by entities or blocks.
=== Respawning the ender dragon ===
[[File:End Crystals on the Exit portal.png|right|thumb|How to arrange end crystals on the exit portal to respawn the ender dragon.]]
As items, end crystals may be placed on bedrock and [[obsidian]], if the two blocks above the bedrock or obsidian block are air or replaceable blocks and no other entities intersect the area. When an end crystal is placed in [[the End]], a [[fire]] block is created at the end crystal location. If four are placed on the end [[exit portal]], one on each of the flat sides, the crystals respawn the original end crystals on the obsidian pillars, as well as resurrect the dragon itself, before exploding. The top of each pillar also explodes, destroying any player-placed blocks. This happens even if TNT explosions are turned off in settings.
If the exit portal is ever broken for any reason, end crystals can still be placed on obsidian blocks with the same location as the exit portal.
=== Explosions ===
End crystals explode when attacked or damaged in most ways, even by attacks that normally do zero damage. They are not affected by exploding fireworks, and if damaged by an explosion, they disappear instead of exploding.{{Only|Java}}<ref>{{bug|MC-118429||End crystals don't explode when destroyed by nearby explosions}}</ref> The end crystal's [[explosion]] has an [[Explosion#Explosion strength|explosion strength]] of 6, the same as a [[charged creeper]]. The end crystal's fire often remains after the crystal explodes. Any ender dragon charging from the crystal when it is destroyed takes {{hp|10}} damage.
{{IN|java}}, an end crystal's explosion can be [[blocking|blocked]] by a [[shield]].
Although an ender dragon damages most blocks and entities in its path, it cannot destroy end crystals simply by going near them.
Placing [[water]] on the end crystal will neutralize the blast effect, but not the [[damage]] or knockback.
End crystals with obsidian or bedrock below them will not damage blocks below them when they explode.
{{IN|bedrock}}, having the game rule {{cd|mobGriefing}} to {{cd|false}} will prevent the End Crystal from destroying any blocks. While {{in|java}} the same game rule will not prevent the End Crystal from destroying any blocks.
=== Beams ===
The end crystal naturally shoots a beam at the ender dragon and heals it when the dragon is within range. This beam can be manually created using the command {{cmd|data merge entity @e[type{{=}}end_crystal,limit{{=}}1] {BeamTarget:{X:0, Y:0, Z:0<nowiki>}}}}. The beam can be pointed in any direction, allowing it to mark locations or objects.
=== Properties ===
[[File:End Crystal (Slateless).gif|thumb|A base-less end crystal.]]
End crystals are of two kinds: the ones with a base beneath them are created either by game mechanism or by the {{cmd|summon}} command; while the base-less ones are created by players by manually placing the crystal items on top of [[obsidian]] or [[bedrock]].
The base appears to be made of bedrock, with a crystal hovering over it. While in the End, a crystal continually generates fire at its current position, one block above the base (directly on top of the block the base is embedded in), replacing any other block at that location. This fire is capable of spreading.
The end crystal entity is not solid and can be walked through freely. End crystals can be pushed by [[piston]]s, but they explode if moved while on fire. Because fire is checked only when an entity moves, end crystals do not normally take damage from their own fire unless moved.
== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Explosion1.ogg
|sound2=Explosion2.ogg
|sound3=Explosion3.ogg
|sound4=Explosion4.ogg
|subtitle=Explosion
|source=block
|description=When an end crystal explodes
|id=entity.generic.explode
|translationkey=subtitles.entity.generic.explode
|volume=4.0
|pitch=0.56-0.84
|distance=16
|foot=1}}
{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Explosion1.ogg
|sound2=Explosion2.ogg
|sound3=Explosion3.ogg
|sound4=Explosion4.ogg
|source=block
|description=When an end crystal explodes
|id=random.explode
|volume=4.0
|pitch=1.0
|foot=1}}
== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=item
|nameid=end_crystal
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=entity
|nameid=end_crystal
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=item
|nameid=end_crystal
|id=637
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=End Crystal
|spritetype=entity
|nameid=ender_crystal
|id=71
|foot=1}}
=== Entity data ===
End crystals have entity data that define various properties of the entity.
{{el|java}}:
{{main|Entity format}}
{{/ED}}
{{el|bedrock}}:
: See [[Bedrock Edition level format/Entity format]].
== Achievements ==
{{load achievements|The End... Again...}}
== Advancements ==
{{load advancements|The End... Again...}}
== History ==
[[File:End Crystal 19w38a.gif|thumb|Java Edition 19w38a]]
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 6|[[File:End Crystal JE1 BE1.png|32px]] Added ender crystals.}}
{{History||1.2.1|snap=12w04a|Previously, ender crystals could be spawned using [[spawn egg]]s with ID 200 (in a [[server]], these were created using {{cmd|give 383 1 200}}). The spawned crystal would be positioned where a natural crystal would be if there was a bedrock block at the location. It was still possible until 1.9 to obtain an end crystal spawn egg, but it would not spawn anything.}}
{{History||1.7.2|snap=13w36a|Ender crystals can now be spawned with the {{cmd|summon}} command.}}
{{History||1.8|snap=14w06a|Ender crystals now generate one [[block]] lower. The fire they generate destroys the [[bedrock]] block that is supposed to be underneath (see {{bug|MC-47526}}).}}
{{History||1.9|snap=15w31a|Ender crystals generate at the correct Y-level again.}}
{{History|||snap=15w33c|Respawning the ender dragon now also respawns the ender crystals on the obsidian pillars.
|Ender crystals now have a compound BeamTarget tag that hold the X, Y, Z block location the beam points to.}}
{{History|||snap=15w44a|"Ender crystals" have been renamed to "end crystals".
|[[File:End Crystal (item) JE1 BE1.png|32px]] End crystals can now be obtained as an item.
|End crystals now drop from [[skeleton trap]] horses and can be placed only on [[obsidian]] or bedrock. Placing several of them atop the end exit portal respawns the ender dragon.}}
{{History|||snap=15w44b|End crystals are no longer dropped by [[skeleton horse]]s.
|Added crafting recipe for end crystals, making end crystals [[renewable]].}}
{{History|||snap=15w49a|End crystals now require [[air]]/replaceable [[block]]s and lack of [[entity|entities]] for placement.}}
{{History|||snap=15w51a|End crystals can no longer be placed in [[Adventure mode]].}}
{{History||1.11|snap=16w32a|The entity ID has been changed from <code>EnderCrystal</code> to <code>ender_crystal</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 426.}}
{{History|||snap=18w20b|Renamed to "End Crystal".}}
{{History|||snap=pre5|Entity ID has been changed to <code>end_crystal</code>.}}
{{History||1.14|snap=18w43a|[[File:End Crystal JE2.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal [[item]] have been changed.}}
{{History||1.19.3|snap=22w43a|End crystal explosions can now be [[blocking|blocked]] by [[shield]]s.<ref>{{bug|MC-188247|||Fixed}}</ref>}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:End Crystal JE1 BE1.png|32px]][[File:End Crystal (item) JE1 BE1.png|32px]] Added end crystals.}}
{{History|bedrock}}
{{History||1.6.0|snap=?|[[File:End Crystal BE2.png|32px]] [[File:End Crystal BE2.gif|32px]] The model of the end crystals has been changed. It has now two cubes instead of three.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:End Crystal BE3.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal item have been changed.}}
{{History||1.17.10|snap=beta 1.17.10.20|[[File:End Crystal JE2.png|32px]] The model of the end crystals has been changed to have three cubes again, and to match ''Java Edition''.}}
{{History||1.19.70|snap=beta 1.19.70.20|Increased end crystal collision box size to match ''Java Edition''.|End crystals with obsidian or bedrock below them now will not damage blocks below them when they explode.}}
{{History|console}}
{{History||xbox=TU9|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:End Crystal JE1 BE1.png|32px]] Added ender crystals.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Ender crystals now generate one block lower. The fire they generate destroys the [[bedrock]] block that is supposed to be underneath.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|"Ender crystals" have been renamed to "end crystals".
|[[File:End Crystal (item) JE1 BE1.png|32px]] End crystals can now be obtained as an [[item]].
|End crystals now drop from [[skeleton trap]] horses and can be placed only on [[obsidian]] or bedrock. Placing several of them atop the [[end portal|end exit portal]] respawns the ender dragon.
|Added a crafting recipe for end crystals.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:End Crystal JE2.png|32px]][[File:End Crystal (item) JE2 BE2.png|32px]] The textures of end crystals and the end crystal item have been changed.}}
{{History|new 3ds}}
{{History||1.7.10|[[File:End Crystal JE1 BE1.png|32px]][[File:End Crystal (item) JE1 BE1.png|32px]] Added end crystals.}}
{{History|foot}}
== Issues ==
{{issue list}}
== Trivia ==
* According to [[Jens Bergensten|Jeb]], the reason behind the current crafting recipe using glass as opposed to [[Chorus Fruit|chorus fruit]] or any materials introduced in [[Java Edition 1.9|1.9]] is as a means for players to craft end crystals in older worlds that the dragon has already been killed in.<ref>{{tweet|jeb_|667000226524372992|The problem is that you need to be able to craft the crystals on worlds in which the dragon has been destroyed already|November 18, 2015}}</ref>
* A historical rendition of the [[beacon]] block featured an animated entity within it, which resembled a yellow miniaturized end crystal. The bedrock platform of the end crystal entity would also render below the beacon, though this would normally be hidden within the block below.
* Using a [[piston]] to push an end crystal's fire into an end portal block deletes the end portal block. However, natural portal blocks regenerate if the end crystal is moved.
== Gallery ==
<gallery>
End Crystal Usage.png|Using end crystals to respawn the ender dragon.
Crystal Link.png|An ender dragon being hit with the "healing beam" of an end crystal.
Ender Crystal.png|An end crystal.
EnderCrystalOverworld.png|An end crystal in the Overworld spawned using {{cmd|summon}} {{code|end_crystal}}.
Ender Dragon Revival.png|End crystals respawning the ender dragon.
CagedEnderCrystal.png|A caged end crystal.
Respawn ender dragon.png|A [[player]] trying to respawn the ender dragon.
End Crystal (item).gif|An animation of the item of the end crystal.
</gallery>
== References ==
{{reflist}}
{{Entities}}
{{Items}}
[[de:Enderkristall]]
[[el:Κρύσταλλος του Ender]]
[[es:Cristal del End]]
[[fr:Cristal de l'End]]
[[ja:エンドクリスタル]]
[[ko:엔드 수정]]
[[nl:Endkristal]]
[[pl:Kryształ Endu]]
[[pt:Cristal do End]]
[[ru:Кристалл Края]]
[[th:คริสตัลเอนด์]]
[[uk:Кристал Енду]]
[[zh:末影水晶]]</li><li>[[:Category:Fungi|Category:Fungi]]<br/>All pages covering blocks that are fungi.
[[Category:Blocks]]
[[Category:Items]]
[[ja:カテゴリ:菌類]]</li></ul></nowiki> | alpha 1.1.0.0 | Added Adventure Mode. | |||
By using /give, items with can_destroy and can_place_on NBT tags can be acquired. | |||||
| Bedrock Edition | |||||
1.6.0{{Extension DPL}}<ul><li>[[Cocoa Beans|Cocoa Beans]]<br/>{{Block
|image=<gallery>
Cocoa Age 0.png|Age 0 JE
Cocoa Age 1.png|Age 1 JE
Cocoa Age 2.png|Age 2 JE
</gallery>
|image2=<gallery>
Cocoa Age 0 BE.png|Age 0 BE
Cocoa Age 1 BE.png|Age 1 BE
Cocoa Age 2 BE.png|Age 2 BE
</gallery>
|transparent=Yes
|light=No
|tool=axe
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}} '''Cocoa beans''' are items obtained from cocoa pods and are used to plant them, as well as to craft [[dye|brown dye]] and [[cookie|cookies]].
'''Cocoa pods''' are [[Bone Meal|bonemealable]] [[plant]]s placed on [[Log|jungle log]] sides that grow cocoa beans, and can be found naturally in [[Jungle|jungles]].
==Obtaining==
In ''Java Edition'', cocoa beans are only obtained through the natural generation of cocoa pods, while in ''Bedrock Edition'', they can also be gotten in bonus chests, from [[fishing]] inside the jungle, bamboo jungle and sparse jungle biomes and during a [[trading]] with a wandering trader.
Cocoa beans come from cocoa pods, which are found on the trunks of normal-sized naturally-generated [[jungle tree]]s in [[jungle]], [[bamboo jungle]]s and [[sparse jungle]] temperate [[biome]]s.
Cocoa pods can be mined with any item, but [[axe]]s are the quickest. Fully grown cocoa pods drop 3 cocoa beans. Using a tool enchanted with Fortune does not increase the amount of cocoa beans dropped.
{{breaking row|horizontal=1|Cocoa|Axe|sword=1|link=none}}
The block itself can be obtained by inventory editing or [[add-on]]s {{in|bedrock}}.
From one to two cocoa beans can be found in 40% of bonus [[chest]]s {{in|bedrock}}.
{{LootChestItem|cocoa-beans}}
Cocoa beans can be obtained from [[fishing]] in a jungle {{in|bedrock}}.
[[Wandering trader]]s may sell 3 cocoa beans for an [[emerald]] during a [[trading]] {{in|bedrock}}.
==Usage==
===Farming===
{{main|Tutorials/Cocoa bean farming}}
Placing cocoa beans on the side of a jungle [[log]] plants a new cocoa pod. The log does not need to be attached to a tree. A cocoa pod can be placed on jungle logs, jungle [[wood]], stripped jungle logs and stripped jungle wood.
[[File:Cocoaplant farm.png|thumb|left|A somewhat efficient cocoa pod farm, minimizing space and wood use.]]
Cocoa has three stages of growth. During its first stage, the pod is small and green. In the second stage, the plant is bigger and colored tan. In its last stage, the pod is even larger and orange. The cocoa block has a 20% chance to grow a stage when receiving a [[Tick#Random tick|random tick]], giving it an average time of 5 minutes and 41 seconds per stage. When destroyed in the first two stages, the pod yields only one cocoa bean. When destroyed in the third stage, it gives 3 cocoa beans. [[Bone meal]] can be used to force the cocoa pod forward by one growth stage. Cocoa pods burst and drop their beans when struck by flowing water, pushed by a piston or if their [[log]] or wood are removed by any means.
===Composting===
Placing cocoa beans into a [[composter]] has a 65% chance of raising the compost level by 1. {{IN|bedrock}}, cocoa beans are accepted as a direct substitute of brown dye in many recipes.
===Crafting ingredient===
{{crafting usage}}
{{Dye usage}}
{{IN|bedrock}}, cocoa beans can be also used in banner patterns:
{{banner crafting usage}}
{{Banner loom usage|Cocoa Beans}}
==Sounds==
{{Sound table/Block/Wood}}
==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Cocoa
|spritetype=block
|nameid=cocoa
|form=block}}
{{ID table
|displayname=Cocoa Beans
|spritetype=item
|nameid=cocoa_beans
|form=item
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showforms=y
|showaliasids=y
|shownumericids=y
|generatetranslationkeys=y
|displayname=Cocoa
|spritetype=block
|nameid=cocoa
|id=127
|form=block}}
{{ID table
|displayname=Cocoa Beans
|spritetype=item
|nameid=cocoa_beans
|aliasid=dye / 3
|id=412
|form=item
|translationkey=item.dye.brown.name
|foot=1}}
===Block states===
{{see also|Block states}}
{{/BS}}
==History==
''For a more in-depth breakdown of changes to textures and models, including a set of renders for each state combination, see [[/Asset history]]''
{{History|java beta}}
{{History||1.2|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans.
|Cocoa beans are currently obtainable only through an inventory editor.}}
{{History||1.2_02|Prior to this, Cocoa Beans were misspelled as 'Coco Beans'.}}
{{History||1.4|Cocoa beans have been formally brought into the game as a reward found in [[dungeon]] chests.<ref>{{tweet|notch|53161729990987776}}</ref> (53% chance) Also, brown [[sheep]] now naturally spawn, making brown [[wool]] obtainable without hacking the game.
|Cocoa beans can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||May 8, 2012|link={{tweet|jeb|199867730927697920}}|[[Jeb]] revealed cocoa with a screenshot.}}
{{History||1.3.1|snap=12w18a|For only this snapshot, cocoa beans have been given a small (0.5%) chance of dropping from destroyed [[jungle tree]] [[leaves]] in a similar fashion to [[apple]]s from oak leaves, which makes cocoa beans [[renewable resource|renewable]] for the first time.}}
{{History|||snap=12w19a|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]] Added cocoa. The top textures of cocoa always keep a completely constant rotation, regardless of what direction they face. They also not shaded.
|[[File:Cocoa Beans JE2.png|32px]] The texture of cocoa beans has been changed.
|Cocoa has replaced jungle [[leaves]] as the main method of finding cocoa beans.
|[[File:Cocoa Age 3 (S) JE1.png|32px]] Cocoa with values 12–15 is inaccessible normally, and use the texture of the [[dragon egg]]. This is due to the dragon egg texture being to the left of the ripe cocoa texture in <samp>[[terrain.png]]</samp>, as cocoa textures are arranged with the oldest on the left and the youngest on the right, resulting in the unusually ripe cocoa reading the dragon egg texture.}}
{{History|||snap=1.3|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||1.4.2|snap=12w34a|Cocoa beans have been given the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Cocoa beans can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}}
{{History||1.5|snap=13w02a|Due to textures being stored in individual files, cocoa beans with data 12–15 no longer have a texture to use, and now crash the game if a [[chunk]] containing one is loaded.}}
{{History|||snap=13w03a|Cocoa with data values 12–15 now only crash the game if one is directly in the field of view.}}
{{History|||snap=13w04a|[[Bone meal]] now grows cocoa by only one stage.}}
{{History|||snap=13w10a|[[File:Cocoa Age 3 (S) JE2.png|32px]] Cocoa with data 12–15 now use the age 2 texture, resulting in a broken appearance, preventing previously mentioned crashes.}}
{{History||1.6.1|snap=13w18a|Cocoa beans have been removed from [[dungeon]] [[chest]]s.}}
{{History|||snap=13w19a|Brown [[Terracotta|stained clay]] can now be [[crafting|crafted]] using cocoa beans.}}
{{History||1.7.2|snap=13w41a|Brown [[stained glass]] can now be crafted using cocoa beans.}}
{{History||1.8|snap=14w07a|[[File:Cocoa Age 0 (S) JE2.png|32px]] [[File:Cocoa Age 1 (S) JE2.png|32px]] [[File:Cocoa Age 2 (S) JE2.png|32px]] [[File:Missing Model JE1.png|32px]] The top textures of cocoa now rotate with the blocks themselves (cocoa facing north remaining visually unaffected), and cocoa of age 3 has [[Missing model|no model]].}}
{{History|||snap=14w10a|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]] [[File:Missing Model JE2.png|32px]] The large section of cocoa is shaded, and the missing model (which age 3 cocoa uses) has changed.}}
{{History|||snap=14w25a|[[File:Cocoa Age 0 (S) JE4.png|32px]] [[File:Cocoa Age 1 (S) JE4.png|32px]] [[File:Cocoa Age 2 (S) JE4.png|32px]] The connecting region of cocoa is now shaded.}}
{{History|||snap=14w26a|Cocoa with data 12–15 has been effectively removed from the game, as such blocks now convert to a proper value with {{cmd|setblock}}. Loading worlds with existing out of range cocoa crash the game.}}
{{History|||snap=14w30a|Cocoa beans can now be used to dye [[banner]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this block's and item's numeral ID were respectively 127 and 351.}}
{{History||1.14|snap=18w43a|Cocoa beans can now be used to craft [[brown dye]].
|Cocoa beans can no longer be used as a [[dye]].
|All of the dye-related functions and crafting recipes of cocoa beans (except cookies) have been transferred to brown dye.
|"Cocoa Beans" item has been renamed to "Cocoa".
|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa has been changed.
|[[File:Cocoa Age 0 (S) JE5.png|32px]] [[File:Cocoa Age 1 (S) JE5.png|32px]] [[File:Cocoa Age 2 (S) JE5.png|32px]] The textures of cocoa have been changed.
|[[File:Cocoa Age 0 (texture) JE2 BE2.png|32px]] [[File:Cocoa Age 1 (texture) JE2 BE2.png|32px]] Textures for cocoa age 0 and 1 has palette left, visible only on particles.
|Cocoa now has a placement [[sound]].}}
{{History|||snap=19w03a|Placing cocoa into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Cocoa now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w11b|"Cocoa" item has been renamed back to "Cocoa Beans".{{verify|was this not just one bug that affected other crops as well? if so cite the ticket and add to all other affected pages}}}}
{{History||1.18|snap=Pre-release 5|[[File:Cocoa Age 0 (texture) JE3 BE3.png|32px]] [[File:Cocoa Age 1 (texture) JE3 BE3.png|32px]] Textures for cocoa age 0 and 1 were changed. This visually changes only particles.}}
{{History||1.19|snap=22w11a|[[File:Cocoa Age 2 (S) JE6.png|32px]] The texture and model of cocoa age 2 have been changed.}}
{{History|pocket alpha}}
{{History||v0.3.0|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans. They are currently unobtainable and serve no purpose.}}
{{History||v0.8.0|snap=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.
|Cocoa beans can be [[crafted]] from an [[orange dye]] and an [[ink sac]], or from [[dandelion yellow]], [[rose red]], and an ink sac, despite there being no way of obtaining ink sacs at the time.}}
{{History|||snap=build 3|Cocoa beans are now available in [[creative]].}}
{{History||v0.9.0|snap=build 1|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]] {{info needed|How did 12-16 appear?}} Added cocoa.
|Cocoa provides an additional way of obtaining cocoa beans.
|Cocoa beans are now used to craft [[cookie]]s.}}
{{History||v0.11.0|snap=build 14|Cocoa now grows over time.<ref>{{bug|MCPE-7887}}</ref>}}
{{History||?|[[File:Cocoa Age 0 (S) BE4.png|32px]] [[File:Cocoa Age 1 (S) BE4.png|32px]] [[File:Cocoa Age 2 (S) BE2.png|32px]] Cocoa no longer has a stem connecting it to the log.}}
{{History||v0.15.0|snap=Realms build 4|[[File:Cocoa Age 0 (S) JE1.png|32px]] [[File:Cocoa Age 1 (S) JE1.png|32px]] [[File:Cocoa Age 2 (S) JE1.png|32px]] Cocoa stems now render again.<ref>{{bug|MCPE-13579}}</ref>}}
{{History||v0.16.0|snap=build 1|Cocoa beans can no longer be crafted from [[orange dye]] and an ink sac.
|Cocoa beans can no longer be crafted from rose red, dandelion yellow and ink sacs.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Cocoa beans can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Cocoa beans can now be used to dye [[shulker box]]es and [[bed]]s.
|Cocoa beans can now be used to craft [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Cocoa beans can now be used to dye [[banner]]s, [[firework star]]s, and [[glass]].
|Cocoa beans can now be found in [[bonus chest]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Cocoa beans can now be used to craft brown [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.10|Cocoa beans can now be used to craft [[brown dye]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Cocoa beans are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa beans has been changed.
|[[File:Cocoa Age 0 (S) BE4.png|32px]] [[File:Cocoa Age 1 (S) BE4.png|32px]] [[File:Cocoa Age 2 (S) BE4.png|32px]] The textures of cocoa have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Cocoa beans can now be used to fill up [[composter]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of cocoa beans has been changed from <code>dye/3</code> to <code>cocoa_beans</code>.}}
{{History||1.18.10|snap=beta 1.18.10.22|[[File:Cocoa Age 0 (texture) JE3 BE3.png|32px]] [[File:Cocoa Age 1 (texture) JE3 BE3.png|32px]] Textures for cocoa age 0 and 1 were changed. This visually changes only particles.}}
{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Cocoa Beans JE1 BE1.png|32px]] Added cocoa beans.}}
{{History||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||xbox=TU12|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]]{{verify|Were these the models used?}} Added cocoa.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Cocoa Beans JE4 BE3.png|32px]] The texture of cocoa beans has been changed once again.
|[[File:Cocoa Age 0 (S) JE5.png|32px]] [[File:Cocoa Age 1 (S) JE5.png|32px]] [[File:Cocoa Age 2 (S) JE5.png|32px]]{{verify|Were these the models used?}} The textures of cocoa have been changed.}}
{{History|new 3ds}}
{{History||0.1.0|[[File:Cocoa Beans JE3 BE2.png|32px]] Added cocoa beans.
|[[File:Cocoa Age 0 (S) JE3.png|32px]] [[File:Cocoa Age 1 (S) JE3.png|32px]] [[File:Cocoa Age 2 (S) JE3.png|32px]]{{verify|Were these the models used?}} Added cocoa.}}
{{History|foot}}
=== Cocoa "item" ===
{{:Technical blocks/Cocoa}}
== Issues ==
{{issue list|Cocoa Beans|Cocoa Pod}}
== Trivia ==
*Cocoa pods have a different hitbox for each size; however, the top is always 0.25 blocks below the top of the [[log]] it is on.
*If a cocoa pod grows while the player is standing next to it, the player is forced into the appropriate form of [[suffocation prevention]] depending on available space.
*{{IN|be}}, the pixels on top of the fully grown pod are 8/7 the size of those on the side.<ref>{{bug|MC-109055||Fixed}}</ref><ref>{{bug|MCPE-152862}}</ref>
== Gallery ==
<gallery>
CocoaReveal.png|The first screenshot of cocoa pods tweeted by [[Jens Bergensten]], which revealed the plants.
CocoaPlant.png|A screenshot tweeted by Jens Bergensten, showing the pod.
Cocoa Plants in a Jungle Biome (12w19a).png|Naturally generated cocoa pods.
CPlantsJWood.png|A cocoa pod farm.
Cocoa2.jpg|A cocoa farm.
Cocoa beans phases.png|Three growing phases of the cocoa pod.
AreaOptimizedBeanPods.gif|A log and pod layout for optimizing an example area of 14×14 (including walls).
File:CocoaBean15.png|Cocoa beans with values greater than 12 appeared this way
</gallery>
==Literature==
===References===
{{reflist}}
===External Links===
*[https://www.minecraft.net/en-us/article/taking-inventory--cocoa-beans Taking Inventory: Cocoa Beans] – Minecraft.net on December 5, 2019
{{Items}}
{{Blocks|vegetation}}
[[Category:Dyes]]
[[Category:Food]]
[[Category:Plants]]
[[Category:Renewable resources]]
[[Category:Non-solid blocks]]
[[Category:Natural blocks]]
[[cs:Kakaové boby]]
[[de:Kakaobohnen]]
[[es:Semillas de cacao]]
[[fr:Fèves de cacao]]
[[hu:Kakaóbab]]
[[ja:カカオ豆]]
[[ko:코코아 콩]]
[[nl:Cacaobonen]]
[[pl:Ziarna kakaowe]]
[[pt:Sementes de cacau]]
[[ru:Какао-бобы]]
[[uk:Какао-боби]]
[[zh:可可豆]]</li><li>[[Hopper|Hopper]]<br/>{{About|the block|the crash utility|Hopper (crash utility)}}
{{Block
|image=<gallery>
Hopper (D).png|Java
Hopper (D) BE.png|Bedrock
</gallery>
|extratext = View [[#Gallery|all renders]]
|transparent=Yes
|light=No
|tool=wooden pickaxe
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}
A '''hopper''' is a low-capacity storage [[block]] that can be used to collect [[item (entity)|item entities]] directly above it, as well as to transfer [[item]]s into and out of other containers. A hopper can be locked with [[Redstone Dust|redstone power]] to stop it from moving items into or out of itself.
== Obtaining ==
=== Breaking ===
To obtain a hopper, {{control|mine}} it with a [[pickaxe]]. Using any other item to mine a hopper drops only its contents.
{{breaking row|horizontal=1|Hopper|Pickaxe|Wood|foot=1}}
===Crafting===
A hopper can be crafted from 5 iron ingots and a chest.
{{Crafting
|A1= Iron Ingot
|C1= Iron Ingot
|A2= Iron Ingot
|B2= Chest
|C2= Iron Ingot
|B3= Iron Ingot
|Output= Hopper
|type= Redstone
}}
==Usage==
{{see also|Tutorials/Hopper}}
[[File:Hopper aligment.png|Hoppers can face down or sideways.|thumb]]
A hopper can be used as a container, as a crafting ingredient, and as a redstone component.
A hopper has an "output" tube at its bottom that can face down or sideways and provides a visual indication of which block the hopper is set up to drop its items into, if that block has an inventory. To place a hopper, use the {{control|Place Block}} control while aiming at the surface to which its output should face (Hoppers ''do not'' orient themselves automatically). To place a hopper directly on the face of an already interactable block, the player can {{control|sneak}} while placing the hopper. Attempting to place a hopper aimed on the bottom face of a block instead faces downward. With some blocks, such as the [[furnace]] and [[brewing stand]], the hopper has multiple uses. A hopper does not change direction after placement, and it is not attached to the container it faces; the container can be removed or replaced, and the hopper remains unchanged.
Hoppers cannot be moved by [[piston]]s.{{only|java}} Despite not being a solid block, attached blocks such as [[rail]]s, [[lever]]s, [[tripwire]] and [[redstone]] dust can be placed on top of hoppers, but not on their sides.
===Container===
[[File:Hopper GUI.png|thumb|176px|Hopper GUI showing the hopper's five slots of inventory at the top and the player's inventory below.]]
A hopper can be used as a container and has 5 slots of inventory space.
To open the hopper GUI, use the {{control|use item|text=Use Item/Place Block}} [[control]]. To move items between the hopper inventory and the player inventory or hotbar while the hopper GUI is open, drag or shift-click the items. To exit the hopper GUI, use the {{key|Esc}} key, B button or circle button, depending on the device.
By default, the GUI of a hopper is labeled "Item Hopper". A hopper's GUI label can be changed by naming the hopper in an [[anvil]] before placing it, or, {{in|java}}, by using the [[Commands#data|data]] command (for example, to label a hopper at (0,64,0) "Steve's Hopper", use <code>/data merge block 0 64 0 {CustomName:'"Steve's Hopper"'}</code>).
{{IN|java}}, a hopper's GUI can be "locked" (or subsequently unlocked) by setting the hopper's <code>Lock</code> tag with the [[Commands#data|data]] command. If a hopper's <code>Lock</code> tag is not blank, the hopper cannot be accessed except by players holding an item with the same name as the <code>Lock</code> tag's text. For example, to lock a hopper at (0,64,0) so that only players holding an item named "Steve's Key" can access the hopper, use <code>/data merge block 0 64 0 {Lock:"Steve's Key"}</code>.
===Crafting ingredient===
A hopper can be used to craft a [[minecart with hopper]].
{{crafting usage}}
===Redstone component===
{{see also|Redstone circuit|Redstone components#Hopper}}
[[File:Hopper logic flowchart.png|thumb|Flowchart of hopper logic]]
While a hopper is ''not'' powered by redstone signals, it operates with three functions:
*'''Collect''' [[Item (entity)|item entities]] (free-floating items in the world) into its inventory from the space above it
*'''Pull''' a single item into its inventory from a container above it
*'''Push''' a single item from its own inventory into a container it faces
A hopper first attempts to push any items inside it. Afterward, it checks if the block above it is a type of container. If so, it attempts to pull from it. Otherwise, the hopper attempts to collect item entities. Notably, hoppers can push to and pull from other hoppers, forming '''hopper pipes''' or '''hopper chains''', which allow transporting items across several blocks and are further discussed below.
====Redstone signals====
When a hopper receives a redstone signal (and is considered to be "activated"), all three functions stop. To avoid confusion over the terms "activated" and "deactivated", powered hoppers are often described as being '''locked''' and unpowered hoppers described as being '''unlocked'''. Hoppers can be powered by [[Redstone_mechanics#Power|soft powered]] blocks, meaning a [[redstone dust]] trail pointing into a block touching the hopper locks it just as effectively as a [[redstone block]] or any other [[Redstone components#Power components|power component]] touching the hopper. When the hopper is unlocked during a redstone tick, it does not push or pull/collect during the same tick, but has a delay of 1 redstone tick instead.
While a locked hopper does not push or pull/collect items, it may still receive items from [[dispenser]]s, [[dropper]]s and other hoppers, and may have its items pulled out by another hopper beneath it. Hence, the item flow in a horizontal hopper pipe may be stopped by locking just one of the hoppers, but stopping a vertical hopper pipe requires locking two adjacent hoppers at the same time, such that both the pushing of the top one and the pulling of the bottom one are stopped.
A hopper does not output any redstone signals by itself, but its fullness can be read using a [[Redstone Comparator|redstone comparator]], which needs to be placed next to it and facing away from it. An empty hopper outputs a signal strength of 0 and a completely full hopper outputs a signal strength of 15. Notably, a single stackable item (16 or 64) outputs a signal strength of 1 and a single non-stackable item outputs a signal strength of 3.
{{IN|Java}}, if the hopper being read is part of a horizontal hopper pipe, the comparator can individually read each item passing through the chain, because items are pushed through the hoppers one by one at a speed that is manageable by the comparator. If there is an uninterrupted stream of items, the comparator does not switch off in between items. On the other hand, in a vertical hopper pipe, some of the hoppers may never produce a reading above 0, even with a continuous stream of items, because pushes and pulls both occur in the same game tick: The hoppers' items get pulled out a single game tick after they're pushed in and this isn't measurable by a comparator, because comparators need measurements lasting at least 1.5 redstone ticks to produce a reading.
====Collecting items====
A hopper collects items dropped on top of it if the space above the hopper not occupied by a storage block. Items are gathered from the entire 1 block space above the hopper, meaning that items sitting on partial blocks such as [[soul sand]] directly above a hopper can be collected.<ref>https://bugs.mojang.com/browse/MCPE-55824</ref> It is also possible for a hopper to collect items from inside a full, solid block, a situation that might come from items rising up through solid blocks or being [[commands/summon|summoned]]. Item entities are not collected when they are outside of the collection area however; for example, items on top of a stone block directly above a hopper are not collected. Collected items are placed in the leftmost empty slot of a hopper's inventory.
{{IN|java}}, if there is no container above the hopper, then the hopper collects dropped items in the order in which they landed on the hopper. This order is remembered even while a hopper is locked. For instance, if a hopper is locked under a carpet while a fully equipped [[armor stand]] is broken above it, then it always collects items in this order when it is unlocked: [[armor stand]], [[boots]], [[leggings]], [[chestplates]], [[helmets]]. This is due to the order in which these items land.{{Verify|Wouldn't this be due to the order in which the game creates the item entities that drop drop from the armor stand?}} {{IN|Bedrock}}, hoppers do not remember the order in which items land on the hopper. Instead, hoppers with multiple dropped items above them collect the items in the order in which they entered the chunk in which the hopper is located. Items that drop from a broken armor stand are collected in a random order.<ref>https://bugs.mojang.com/browse/MCPE-120586</ref>
Hoppers usually check for dropped items every [[game tick]] and they can collect items even before they are picked up by a [[player]]{{Verify|Does this happen always, or sometimes, and in Java only or also in Bedrock?}} or destroyed by [[lava]]. However, {{In|Bedrock}} hoppers have a "collection cooldown" time. After collecting an item (or stack of items), a hopper waits {{tooltip|4 redstone ticks|8 game ticks}} (0.4 seconds, barring lag) before attempting to collect again.
Hoppers collect groups of items all at once rather than collecting them as single items one at a time. As a result, hoppers can collect item entities much faster than they can pull items from a container. Pulling from a moving [[minecart with chest]] or [[minecart with hopper]] is even slower, since the minecart is not always above the hopper.
====Pushing and pulling items====
A hopper with a storage container above it (such as a [[furnace]], [[chest]], [[dropper]], [[composter]], or another hopper) attempts to pull from the container instead of checking for floating items above it, and hence can not collect items. A hopper always tries to push or pull items using the leftmost available slot. When a hopper is removing items from a chest, the items disappear from left to right. Similarly, when filling up a chest, the chest fills up from left to right. Hoppers prioritize pulling from the first slot of a container over pulling into the first hopper slot. If a hopper has stone in its first slot and nothing in its second while the container it is pulling from has chicken in its first slot but stone in the second, the hopper pulls the chicken from the first slot of the container into its empty second slot. However, if the hopper is unable to pull the chicken, such as if all slots are filled with stone, the hopper pulls the stone from the second slot of the container instead. Similarly, hoppers prioritize pushing from their first slot over pushing into the first slot of a container. If a hopper has stone in its first slot and chicken in its second while the container it is pushing to has chicken it its first slot but stone in the second, the hopper pushes stone from its first slot into the second slot of the container.
In [[Java Edition]] the checks done by a hopper while pulling generally require less processing than the checks done by a hopper attempting collection. Therefore, a chain of hoppers topped with storage containers rather than air/solid blocks has better performance (measured as milliseconds of processing per tick) and lower potential for processing lag. <ref name=":0">https://www.youtube.com/watch?v=LC3ZOOI1Rf0</ref> The performance improvement achieved is correlated with the number of storage slots the container has. Placing composters (with no storage slots but still with custom output logic) on top of hoppers provide the greatest efficiency, while double chests actually degrade performance, even when sharing each double chest across two hoppers.<ref name=":0" /> In [[Bedrock Edition]] a chain of hoppers with air or non-container blocks on top has better performance than a chain of hoppers topped by container blocks.<ref>https://cdn.discordapp.com/attachments/715523208530362389/890030941282631741/Redstone_MSPT_measure.xlsx</ref> This may be because, even though hoppers with containers on top do not check for items, they do check for hopper-minecarts and chest-minecarts to pull from, and that involves scanning the chunk entity list.<ref>{{bug|MCPE-109449}}</ref>
{{Schematic|caption='''Push then Pull'''
Chest A is full of items while the hopper and Chest B are empty.
|ch-$+A||-
|ho-$e|ch-$+B
}}
Item pushes and pulls are processed in the same game tick, but pushes are processed before pulls. In the schematic, the empty hopper first pulls an item from chest A as it cannot push anything into chest B. After the cooldown, the hopper first pushes its item into chest B before pulling another item from chest A, both pushing and pulling in the same tick, and the process repeats. The hopper stops pulling when A is empty, and stops pushing when B becomes full.
Hoppers also have a "transfer cooldown" time. After pulling and/or pushing items, a hopper waits {{tooltip|4 redstone ticks|8 game ticks}} (0.4 seconds, barring lag) before pulling or pushing again (a transfer rate of 2.5 items per second, barring lag). A hopper that has an item pushed into it from another hopper also starts a 4 tick cooldown period, regardless of whether it pushed or pulled items itself. Item entities can be collected at any time without affecting the transfer cooldown time. The transfer cooldown and the Bedrock Edition collection cooldown are independent of each other.
====Container interactions====
Some [[container]]s interact with hoppers in specific ways:
:;{{BlockLink|Composter}}
::Hoppers above composters can push compostable items into the composter's top face with a chance of increasing the level of the composter as if the player used the item on the composter. Items that are not compostable cannot be pushed into the composter. Hoppers below the composter can pull [[bone meal]] when the composter is in stage 8, emptying the composter and resetting it to stage 0. Hoppers to the side of a composter do not interact with it.
:;{{BlockLink|Brewing Stand}}
::A working hopper on the top face of a brewing stand deposits only into the ingredient slot and it can push only valid [[brewing]] ingredients. A hopper on side face of a brewing stand can deposit only [[blaze powder]] or filled bottles into the three brew slots. A hopper underneath a brewing stand always extracts from the three brew slots, whether brewing is finished or not—The hopper must be locked to allow potions to finish brewing.
:;{{BlockLink|Chest}}
:;{{BlockLink|Trapped Chest}}
::Large chests and large trapped chests are treated as a single container: A hopper depositing into a large chest fills up the entire chest and a hopper underneath a large chest empties the entire chest. Trapped chests being accessed by a player lock any adjacent hoppers, per the standard behavior of a hopper next to an active power source.
:;{{BlockLink|Furnace}}
:;{{BlockLink|Blast Furnace}}
:;{{BlockLink|Smoker}}
::A working hopper pointing into top of a furnace deposits only into the ingredient slot. It can push any item, including items that can't be smelted by the furnace. A hopper pointing into the side of a furnace deposits into the fuel slot, and only items that are usable as fuel. A hopper below a furnace pulls everything from the output slot and empty [[bucket]]s from the fuel slot left over from using [[lava bucket]]s as fuel. When a hopper removes items from a furnace, the experience points are 'stored' in the furnace until a player removes at least one smelted item, or the furnace block is broken.
:;{{BlockSprite|Hopper}} Hopper
::A sequence of three or more hoppers, each pushing items into the next, is called a '''hopper pipe'''. Working horizontal hopper pipes simply push items into each other at the expected rate of 2.5 items per second, but vertical hopper pipes are more complicated, as the hoppers are trying both to pull and to push. When a vertical pipe pulls from a single container, it simply transfers items at 2.5 items per second because the transfer rate is limited by the first hopper pulling items from the container. If a ''stack of items'' is in a vertical pipe, the items can be transferred twice as fast, because the hopper with the item stack is pushing items down while the hopper below it is also pulling items down.
:;{{EntityLink|Minecart with Chest}}
:;{{EntityLink|Minecart with Hopper}}
::Unlocked hoppers fill chest minecarts and hopper minecarts if any part of the entity's hitbox is within the hopper's target block-space. Hopper minecarts try to pull items from the hopper at high speed. Hoppers can pull items from minecarts above them so rails can be placed directly on the top faces of a hoppers. If a [[detector rail]] is in the right position, it could lock the hopper per standard redstone-hopper behavior.
:;{{BlockLink|Jukebox}}
::Hoppers can insert [[music disc]]s into jukeboxes, and extract the music discs after they finish playing.
:;{{BlockLink|Shulker Box}}
::Hoppers cannot put shulker boxes into other shulker boxes. This allows for the creation of certain [[Tutorials/Hopper#Potions and shulker boxes|item filters]].
::Otherwise, hoppers interact with shulker boxes normally.
:;{{BlockLink|Lectern}}
::Hoppers cannot remove or place books on lecterns. The redstone pulse emitted from a lectern when a page is turned can temporarily lock hoppers.
:;{{BlockLink|Ender Chest}}
::Hoppers cannot interact with ender chests in any way.
:;{{BlockLink|Barrel}}
:;{{BlockLink|Dispenser}}
:;{{BlockLink|Dropper}}
:;{{EntityLink|Boat with Chest}}
::Hoppers interact normally with barrels, dispensers, droppers, and boats with chests.
:;{{BlockLink|Chiseled Bookshelf}}
::Hoppers and minecart with hoppers can insert and remove books from the bookshelf. As with any other container, items are taken from the first slot that has an item that can fit in the hopper and are inserted into the first empty slot.
==Sounds==
===Generic===
{{Sound table/Block/Metal}}
===Unique===
{{Edition|Java}}:
{{Sound table
|sound=Door close.ogg
|sound2=Door open.ogg
|subtitle=Chest locked<ref group=sound name=lock>{{Bug|MC-98316||Wrong subtitles caused by missing distinction}}</ref>
|source=block
|description=When a player attempts to open a hopper locked using the {{nbt|string|Lock}} tag
|id=block.chest.locked|idnote=<ref group=sound name=lock/>
|translationkey=subtitles.block.chest.locked|translationkeynote=<ref group=sound name=lock/>
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}
{{Edition|Bedrock}}: ''None''
==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Hopper
|spritetype=block
|nameid=hopper
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=hopper
|spritetype=block
|nameid=hopper
|foot=1}}
{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Hopper
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=hopper
|spritetype=block
|nameid=hopper
|id=154
|form=block
|itemform=item.hopper}}
{{ID table
|displayname=Item
|spritename=hopper
|spritetype=item
|nameid=hopper
|id=527
|form=item
|translationkey=tile.hopper.name
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=hopper
|spritetype=block
|nameid=Hopper
|foot=1}}
===Block states===
{{see also|Block states}}
{{/BS}}
===Block data===
A hopper has a block entity associated with it that holds additional data about the block.
{{el|java}}:
{{see also|Block entity format}}
{{/BE}}
{{el|bedrock}}:
:See [[Bedrock Edition level format/Block entity format]].
==Achievements==
{{load achievements|Freight Station;Smelt Everything}}
==Video==
<div style="text-align:center">{{yt|XO0IKUsGiG8}}</div>
==History==
{{History|java}}
{{History||1.5|snap=13w01a|[[File:Hopper (D) JE1.png|32px]] [[File:Hopper (N) JE1.png|32px]] [[File:Hopper (E) JE1.png|32px]] [[File:Hopper (S) JE1.png|32px]] [[File:Hopper (W) JE1.png|32px]] [[File:Hopper (U) JE1.png|32px]] Added hoppers.
|Hoppers with the [[damage]] value of 1, which are obtainable only through world editing, visually point in no direction. They functionally push items upward, however the behavior is inconsistent.
|[[File:Hopper (item) JE1.png|32px]] There is currently a temporary "work in progress" sprite for hoppers in the [[inventory]].
|Hoppers can be [[crafting|crafted]] from a [[chest]] and [[stone]] blocks with the following recipe:
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
|A1= Stone
|C1= Stone
|A2= Stone
|B2= Chest
|C2= Stone
|B3= Stone
|Output= Hopper
}}
{{!}}}
}}
{{History|||snap=13w01b|[[Rail]]s can now be placed on top of hoppers.
|Hoppers no longer load [[item]]s into [[minecart]]s without [[chest]]s.}}
{{History|||snap=13w02a|[[File:Hopper (item) JE2 BE1.png|32px]] The [[inventory]] sprite of hoppers has been changed.
|[[File:Hopper (item) 13w02a.png|32px]] However, the [[item]] of hoppers appears bugged if [[drops|dropped]] or placed in an [[item frame]].<ref>{{bug|MC-6737}}</ref> This may be due to the game attempting to pull the item sprite from the hopper's equivalent spot in <samp>[[stitched_terrain.png]]</samp> (compare files: [[:File:13w02a stitched terrain.png|terrain]], [[:File:13w02a stitched items.png|items]]), a region which contains parts of the oak planks, end stone and iron bars textures.
|Applying a [[redstone]] signal to a hopper now deactivates the hopper until the signal is removed.
|Hoppers can no longer be used as [[fuel]] in a [[furnace]].
|Hoppers are now [[crafting|crafted]] using 5 [[iron ingot]]s rather than 5 [[stone]] blocks.
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting
|A1= Iron Ingot
|C1= Iron Ingot
|A2= Iron Ingot
|B2= Chest
|C2= Iron Ingot
|B3= Iron Ingot
|Output= Hopper
}}
{{!}}}
|Hoppers now pull only from the output slot of [[furnace]]s.
|Hoppers now output 1 signal strengh per 1/3 of a stack (21 [[item]]s) when interacting with a [[redstone comparator]].
|[[File:Hopper (D) JE2.png|32px]] [[File:Hopper (N) JE2.png|32px]] [[File:Hopper (E) JE2.png|32px]] [[File:Hopper (S) JE2.png|32px]] [[File:Hopper (W) JE2.png|32px]] [[File:Hopper (U) JE2.png|32px]] The texture of hoppers has been given a unique texture. Hoppers no longer use the [[cauldron]] texture. Note that the top texture does not rotate with facing direction.
|The preferred tool is now a pickaxe, rather than the axe.}}
{{History|||snap=13w02b|Hoppers now treat large [[chest]]s properly, no longer needing two hoppers connected to them to fill up the entire [[inventory]].
|Hoppers no longer take [[item]]s from containers when powered via a [[redstone]] current.
|Hoppers now display correctly as a [[drops|dropped]] or [[item frame|frame]] [[item]].}}
{{History|||snap=13w03a|Hoppers are now used to [[crafting|craft]] a [[minecart with hopper]].
|Hoppers can now empty a [[minecart with hopper]].}}
{{History|||snap=13w04a|The transfer rate of hoppers has been changed from 7 to 8 [[game tick]]s per [[item]] (2.5 items per second).}}
{{History||1.5.1|snap=pre|Hoppers now take empty [[bucket]]s out of furnace fuel slots.}}
{{History||1.7.2|snap=release|[[File:Hopper (D) JE3.png|32px]] [[File:Hopper (N) JE3.png|32px]] [[File:Hopper (E) JE3.png|32px]] [[File:Hopper (S) JE3.png|32px]] [[File:Hopper (W) JE3.png|32px]] [[File:Hopper (U) JE3.png|32px]] The UV of all blocks is broken on certain sides as a result of {{bug|MC-37106}} (few cases are listed on the wiki so far - this is a future project). This includes hoppers.}}
{{History||1.7.4|snap=13w47a|[[File:Hopper (D) JE4.png|32px]] [[File:Hopper (N) JE4.png|32px]] [[File:Hopper (E) JE4.png|32px]] [[File:Hopper (S) JE4.png|32px]] [[File:Hopper (W) JE4.png|32px]] [[File:Hopper (U) JE4.png|32px]] MC-37106 has been fixed, reverting hoppers to their pre-1.7.2 appearences.}}
{{History|||snap=13w48a|This version fixed {{bug|MC-190}}, which hoppers were allegedly subject to since their introduction. However, a comparison of hopper UV in 13w02a and 14w08a failed to reveal any visible differences, even accounting for the example images on the ticket. More research is needed on this matter.}}
{{History||1.8|snap=?|Hoppers no longer generate [[multiplayer]] lag when idle.}}
{{History|||snap=14w10a|[[File:Hopper (D) JE5.png|32px]] [[File:Hopper (N) JE5.png|32px]] [[File:Hopper (E) JE5.png|32px]] [[File:Hopper (S) JE5.png|32px]] [[File:Hopper (W) JE5.png|32px]] [[File:Missing Model JE2.png|32px]] Hoppers now use block models rather than having a hardcoded shape. This brings multiple changes: the inside texture now rotates with the hopper rather than being constant, the inside planes of hoppers are now shaded/have ambient occlusion, and some minor UV changes have occurred, notably on the smallest cuboid. The directionless hopper also [[Missing model|no longer has a model]].}}
{{History|||snap=14w26a|The directionless hopper has been removed.}}
{{History|||snap=14w31a|Hoppers now no longer use wood [[sound]]s.<ref>{{bug|MC-5991}}</ref>}}
{{History||1.9|snap=15w33c|A hopper now generates as a part of the [[end ship]] in the [[end city|end cities]].}}
{{History|||snap=15w41a|End ships no longer contain a hopper.}}
{{History|||snap=15w43a|[[Loot table]]s have been added; hoppers can now use loot tables.}}
{{History|||snap=15w43c|[[File:Hopper (D) JE6.png|32px]] [[File:Hopper (N) JE6.png|32px]] [[File:Hopper (E) JE6.png|32px]] [[File:Hopper (S) JE6.png|32px]] [[File:Hopper (W) JE6.png|32px]] The UV on the hopper model has changed, resulting in minor differences, particularly to the smallest cuboid. This is likely due to the fix for {{bug|MC-73401}}.}}
{{History|||snap=15w44a|[[File:Hopper (D) JE7.png|32px]] [[File:Hopper (N) JE7.png|32px]] [[File:Hopper (E) JE7.png|32px]] [[File:Hopper (S) JE7.png|32px]] [[File:Hopper (W) JE7.png|32px]] A mapping issue introduced in the previous snapshot for the sides of the large funnel region has been fixed. This may be due to the fix for {{bug|MC-50344}}.}}
{{History||1.9.1|snap=pre1|A hopper can now push into and pull [[item]]s from a blocked [[chest]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 154.}}
{{History||1.14|snap=18w43a|[[File:Hopper (D) JE8.png|32px]] [[File:Hopper (N) JE8.png|32px]] [[File:Hopper (E) JE8.png|32px]] [[File:Hopper (S) JE8.png|32px]] [[File:Hopper (W) JE8.png|32px]]<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History|||snap=19w03c|Hoppers now use correct cullface arguments, and some redundant faces have also been deleted.}}
{{History||1.19|snap=22w13a|Hoppers no longer drop when breaking a [[minecart with hopper]].}}
{{History||1.19.4|snap=23w07a|Hoppers can now interact with jukeboxes.}}
{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers. Upward hoppers also exist.}}
{{History||v0.15.0|snap=build 1|Hoppers can now be moved by [[piston]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Hopper (D) BE.png|32px]] [[File:Hopper (N) BE.png|32px]] [[File:Hopper (E) BE.png|32px]] [[File:Hopper (S) BE.png|32px]] [[File:Hopper (W) BE.png|32px]] [[File:Hopper (U) BE.png|32px]]<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History||1.19.70|snap=beta 1.19.70.20|Hoppers can now collect items through all blocks that have a lower height than a full block.}}
{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Hopper (D) JE8.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History||ps=1.91|Hoppers can now fill [[composter]]s.}}
{{History|new 3ds}}
{{History||0.1.0|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers.}}
{{History|foot}}
==Issues==
{{Issue list}}
==Trivia==
* A [[wikipedia:Hopper (particulate collection container)|real-world hopper]] is a large, pyramidal or cone-shaped container used in industrial processes to hold particulate matter, like dust, gravel, nuts, seeds, etc., and can then dispense them from the bottom.
* A hopper can transfer 9000 items per hour, or 150 items per minute.
==Gallery==
=== Renders ===
<gallery>
Hopper (N).png
Hopper (E).png
Hopper (S).png
Hopper (W).png
</gallery>
<gallery>
Hopper (N) BE.png
Hopper (E) BE.png
Hopper (S) BE.png
Hopper (W) BE.png
</gallery>
=== Screenshots ===
<gallery>
File:Hopper screenshot 1.png|In snapshot 13w01a, the hopper item uses a 'WIP' sprite, though the item still read "Hopper".
File:13w02a Banner.png|The 13w02a Banner includes a [[minecart with TNT]] and a hopper.
</gallery>
==References==
{{Reflist}}
{{Redstone}}
{{Blocks|Utility}}
{{Items}}
[[Category:Mechanisms]]
[[Category:Redstone mechanics]]
[[Category:Mechanics]]
[[Category:Storage]]
[[Category:Utility blocks]]
[[Category:Manufactured blocks]]
[[Category:Block entities]]
[[cs:Násypka]]
[[de:Trichter]]
[[el:Hopper]]
[[es:Tolva]]
[[fr:Entonnoir]]
[[it:tramoggia]]
[[ja:ホッパー]]
[[ko:호퍼]]
[[nl:Trechter]]
[[pl:Lej]]
[[pt:Funil]]
[[ru:Загрузочная воронка]]
[[uk:Лійка]]
[[zh:漏斗]]</li></ul> | Player with ability worldbuilder true can break and place blocks freely on Adventure mode. | ||||
| Legacy Console Edition | |||||
| TU19 | CU7 | 1.10 | Patch 1 | Added Adventure Mode. | |
Issues
Issues relating to "Adventure" are maintained on the bug tracker. Report issues there.
See also
References
- ↑ http://www.gamebandits.com/news/pc/minecraft-1-9-hardcore-mode-bring-it-on-17345
- ↑ http://www.gameinformer.com/b/features/archive/2011/06/14/notch-and-todd-howard-the-one-on-one-interview.aspx
- ↑ http://www.reddit.com/r/Minecraft/comments/yp597/12w34a_snapshot_is_accessible_now/c5xplgu
- ↑ https://www.mojang.com/2014/02/minecraft-snapshot-14w06a/