Minecraft Wiki
Advertisement
SolidLiquid

Comparison of the solid stone and liquid water blocks

Solid blocks are a category of block.

Properties

A block can be considered solid if it has a collision box that players, mobs, or other entities cannot move through; those caught inside a solid block may suffocate. The only exception to this is the cobweb, which, although considered solid, can be moved through, albeit slowly.

The collision property[verify] of solid blocks allows block-dependent blocks and entities to be placed upon them, including:

Other block-dependent blocks may be placed only on full, opaque solid blocks (with a few exceptions):

Solid blocks are also considered when generating structures.

List of solid blocks

Brush
This article needs cleanup to comply with the style guide. [discuss]
Please help improve this page. The talk page may contain suggestions.
Reason: 2

Here is a list of solid blocks, categorized by their material.

Material Blocks
Grass
Dirt
Wood
Stone Prismarine SlabPrismarineMagma Block
Metal/Mineral Command Block
Anvil
Leaves
Sponge
Wool
Sand
Glass Sea Lantern
Redstone lamp
TNT
Unknown Not applied to any blocks.
Ice
Packed ice
Snow layer (2-8)
Cactus
Clay
Gourd
Dragon egg
Cake
Cobweb
Piston
Barrier

List of non-solid blocks

Material Blocks
Air Air
Water Water
Lava Lava
Plants
Replaceable plants
Fire Fire
Non-solid
Carpet
Snow layer (1)
Snow block
Portal
Structure Void

Height

Most solid blocks are 1 meter high, but certain blocks have non-standard block heights.

A player can automatically step up from a lower to a higher height, if the difference is at most 0.6 (35) of a block. From ground level, this is anything the height of a boat [note 1] or less.

A player can fit through spaces as small as 1.8125 (2 - 316) blocks high, since players are 1.8 blocks tall. This allows players to fit through a 2-block gap with a floor as high as a trapdoor or less.

When sneaking, a player can fit through spaces as small as 1.75 (2 - 14) blocks high, since sneaking players are 1.65 blocks tall. This allows players to fit through a 2-block gap with a floor as high as 3 layers of snow or less.

When gliding with elytra, a player can fit through spaces as small as 0.625 (1 - 38) blocks high, since gliding players are 0.6 blocks tall. This allows players to fit through a 1-block gap with a floor as high as 4 layers of snow, or a flower pot, or a daylight sensor, or less.

Note that doors, although appearing to be one 2-meter-high block, are actually composed of two (top and bottom) 1-meter-high blocks.

Here is a list of blocks with non-standard heights, from tallest to shortest in height:

Height Block types
Decimal Fractional Pixelspace
1.5 12 24 Open shulker boxes
Fences, cobblestone wall [note 2]
0.9375 1516 15 Grass path, Farmland
Cactus [note 2]
0.875 78 14 Soul sand, 8 layers of snow
Chest, ender chest, trapped chest, top of brewing stand [note 2]
0.8125 1316 13 End portal frame without eye of ender
Chorus plant [note 2]
0.75 34 12 Enchantment table, 7 layers of snow
Cocoa bean plant, head on wall [note 2]
0.625 58 10 6 layers of snow
Inside of hopper, sideways-oriented end rod [note 2]
0.5625 916 9 Bed
0.5 12 8 Bottom slab, 5 layers of snow
Head on ground, bottom part of stair, cake [note 2]
0.375 38 6 Daylight sensor, 4 layers of snow
Flower pot [note 2]
0.3125 516 5 Inside of cauldron [note 2]
0.25 14 4 3 layers of snow
0.1875 316 3 Bottom trapdoor
0.125 18 2 Base of brewing stand, redstone repeater, redstone comparator, 2 layers of snow
0.09375 332 112 Lily pad [note 2]
0.0625 116 1 Carpet
  1. Although boats are entities, players can step on them.
  2. a b c d e f g h i j These blocks are also thinner, or put another way, their area having this non-standard height does not cover the width/length of a full block.

Video

Solid block/video

History

pre-classic
Pre 0.0.0
{{Extension DPL}}<ul><li>[[Charcoal|Charcoal]]<br/>{{Item
| image = Charcoal.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}
'''Charcoal''' is an [[item]] obtained by smelting [[log]]s or [[wood]]. It is used as fuel, or for crafting [[torch]]es and [[campfire]]s. Unlike [[coal]], charcoal cannot be traded with [[villager]]s, nor can it be crafted into a [[block of coal]]. Coal and charcoal cannot stack together either. It can be used as a substitute for coal, as both charcoal and coal have an equivalent duration when smelted.

== Obtaining == 

=== Breaking ===

A [[campfire]] broken without the [[Silk Touch]] enchantment drops 2 charcoal.

=== Smelting ===

{{Smelting
 |Any Log; Any Stripped Log; Any Wood; Any Stripped Wood
 |Charcoal
 |foot=1
 |0,15
}}

=== Compound creation ===

Charcoal can be created from its base [[element]]s, using the [[compound creator]].{{only|bedrock|education}}

{| class="wikitable"
!Name
!Elements
!Example recipe
|- <!-- Temporarily using crafting grid as substitute for compound creator (template not yet available), since the layout is the same, even if the appearance is different -->
!Charcoal
|7 Carbon<br>4 Hydrogen<br>1 Oxygen
|{{Crafting Table
|shapeless= 1
|A2=Carbon,7 |B2=Hydrogen,4 |C2=Oxygen
|Output=Charcoal}}
|}

== Usage ==

=== Crafting ingredient ===

{{crafting usage|Charcoal}}
{{Crafting
|B1= Stick
|A2= Stick
|B2= Coal; Charcoal
|C2= Stick
|A3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|B3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|C3= Any Log or Stem; Any Stripped Log or Stem; Any Wood or Hyphae; Any Stripped Wood or Hyphae
|Output= Campfire
}}

=== Lab table ingredient ===

Charcoal is one of the [[lab table]] ingredients needed to produce the [[heat block]].{{only|education}}

{| class="wikitable"
! Result
! Materials Needed
|-
!rowspan=2|{{slot|Heat Block.gif}}<br>[[Heat Block]]
|{{slot}}{{slot|Iron|link=Element}}{{slot|Water (compound)|link=Compound}}{{slot|Charcoal}}{{slot|Salt|link=Compound}}{{slot}}
|-
|<center>[[Element|Iron]], [[Water (compound)|Water]], Charcoal, [[Compound|Salt]]</center>
|}

=== Fuel ===

When used in a [[furnace]] as a fuel, a piece of charcoal lasts 80 seconds (smelting up to 8 items), the same as coal. Charcoal used as fuel lasts more than 5 times longer than [[wood planks]] or [[wood]] logs used as fuel, being more efficient than any other use of wood for smelting in ''[[Java Edition]]'', but outstripped by [[wooden slabs]] in Bedrock. 

Coal and charcoal are also the only fuels accepted by [[Minecart with Furnace|furnace minecarts]]. They provide approximately four minutes of transit each.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Charcoal
|spritetype=item
|nameid=charcoal
|itemtags=coals
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Charcoal
|spritetype=item
|nameid=charcoal
|aliasid=coal / 1
|id=303
|itemtags=minecraft:coals
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Renewable Energy}}

== History ==

{{History|java beta}}
{{History||December 25, 2010|link=http://www.minecraftforum.net/topic/131047-lantern-update-incoming/page__st__20#entry1986964| In 0.3.2, charcoal was suggested to [[Markus Persson|Notch]] by [https://twitter.com/Moleculor @Moleculor] on [[wikipedia:Twitter|Twitter]] as a writing implement.}}
{{History||1.2|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal, with the same texture as coal.
|Charcoal is not used as a writing implement.}}
{{History|java}}
{{History||1.2.1|snap=12w04a|Charcoal can now be used to craft [[fire charge]]s.}}
{{History||1.3.1|snap=?|Charcoal is now directly available in the creative inventory.}}
{{History|||snap=1.3|[[File:Charcoal JE2 BE2.png|32px]] The texture of charcoal has been changed.}}
{{History||1.6.1|snap=13w19a|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History||1.8|snap=14w02a|Charcoal can no longer be [[trading|traded]] from [[villager]]s.}}
{{History||1.13|snap=17w47a|The different data values for the {{code|coal}} ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 263.}}
{{History||1.14|snap=18w43a|[[File:Charcoal JE4 BE4.png|32px]] The texture of charcoal has been changed.}}
{{History|||snap=19w02a|Charcoal can now be used to craft [[campfire]]s. Destroying a campfire returns 2 charcoal.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal, with the same texture as coal. It is not yet obtainable.}}
{{History||v0.3.2|Charcoal is now obtainable by smelting [[log|wood]] in a furnace.}}
{{History||v0.8.0|snap=build 1|[[File:Charcoal JE2 BE2.png|32px]] The texture of charcoal has been changed.}}
{{History||v0.8.1|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.13.8|Added [[stripped log]] variants, which can be [[smelting|smelted]] to obtain charcoal.}}
{{History|||snap=beta 1.2.20.1|Charcoal now can be crafted using 7 Carbon, 4 Hydrogen, and an Oxygen in a [[compound creator]].
|Charcoal can now be used in the [[lab table]] to create a [[heat block]].}}
{{History||1.10.0|snap=beta 1.10.0.3|Charcoal can now be used to craft [[campfire]]s. Destroying a campfire returns 2 charcoal.
|[[File:Charcoal JE4 BE4.png|32px]] The textures of charcoal has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.51|Charcoal are now used to craft [[soul fire torch]]es.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of charcoal has been changed from {{code|coal/1}} to {{code|charcoal}}.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Charcoal JE1 BE1.png|32px]] Added charcoal.}}
{{History||?|[[File:Charcoal JE3 BE3.png|32px]] The texture of charcoal has been changed.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Charcoal JE4 BE4.png|32px]] The texture of charcoal has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Charcoal JE3 BE3.png|32px]] Added charcoal.}}
{{History|foot}}

== Issues ==
{{issue list|Charcoal}}

== How it's renewable ==
Charcoal comes from smelting log. Logs are renewable and charcoal can be used as fuel to smelt logs{{Items}}

[[Category:Renewable resources]]

[[de:Holzkohle]]
[[fr:Charbon (objet)#Charbon de bois]]
[[hu:Faszén]]
[[it:Carbonella]]
[[ko:목탄]]
[[pt:Carvão#Carvão vegetal]]
[[nl:Steenkool#Houtskool]]
[[ru:Уголь#Древесный уголь]]
[[zh:木炭]]</li><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></ul>
Added grass blocks and cobblestone, the first two types of solid blocks.
Solid blocks were the only available type of block, until rd-161348, when the first legitimately-obtainable non-solid blocks (saplings) were added.
release
1.10.1
{{Extension DPL}}<ul><li>[[Ender Pearl|Ender Pearl]]<br/>
{{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 and [[teleport|teleports]] the thrower to where it lands, and 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}} (4.27) chance to [[barter]] 3-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 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 10% 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
|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 ==
*[[End Dimension]]
*[[Ender Dragon]]
*[[Ender 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.

[[File:Dye Recipes.png|400px|thumb|A guide for creating all the dyes]]

== 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||b=Lapis Lazuli|c=Any fuel|d=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>
Farmland blocks reduced from a full block tall to 1516.

Issues

Issues relating to "Solid block" are maintained on the bug tracker. Report issues there.

See also

Advertisement