minecraft.wiki-mirror/wiki_backup/dyeing.txt

{{Infobox 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, [[bundle]]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|thumb|width=400x400|A guide for creating all the dyes, from which leather armor can be colored in 5,713,438 possible colors<ref name=":0">https://www.youtube.com/watch?v=E47hjQKezhQ</ref><ref name="number-2">https://www.youtube.com/watch?v=SOihpLiPG5Q</ref>]]

== Obtaining ==
[[File:Dye chart.png|thumb|width=295x295|An in-game guide for creating all the dyes]]

Most dyes can be crafted from [[flower]]s and a few other items, some dyes can be crafted by combining multiple dyes of different colors, and every dye is [[trading|sold]] by the [[wandering trader]]. Some dyes can also be found in loot, and [[green dye]] is obtained by smelting [[cactus]].

{| class="wikitable" style="text-align:right;"
|+ Main articles
|-
| {{ItemLink|White Dye|link=White Dye#Obtaining}} || {{ItemLink|Light Gray Dye|link=Light Gray Dye#Obtaining}}
|-
| {{ItemLink|Gray Dye|link=Gray Dye#Obtaining}} || {{ItemLink|Black Dye|link=Black Dye#Obtaining}}
|-
| {{ItemLink|Brown Dye|link=Brown Dye#Obtaining}} || {{ItemLink|Red Dye|link=Red Dye#Obtaining}}
|-
| {{ItemLink|Orange Dye|link=Orange Dye#Obtaining}} || {{ItemLink|Yellow Dye|link=Yellow Dye#Obtaining}}
|-
| {{ItemLink|Lime Dye|link=Lime Dye#Obtaining}} || {{ItemLink|Green Dye|link=Green Dye#Obtaining}}
|-
| {{ItemLink|Cyan Dye|link=Cyan Dye#Obtaining}} || {{ItemLink|Light Blue Dye|link=Light Blue Dye#Obtaining}}
|-
| {{ItemLink|Blue Dye|link=Blue Dye#Obtaining}} || {{ItemLink|Purple Dye|link=Purple Dye#Obtaining}}
|-
| {{ItemLink|Magenta Dye|link=Magenta Dye#Obtaining}} || {{ItemLink|Pink Dye|link=Pink Dye#Obtaining}}
|}

=== Crafting dye ===
{{:Crafting/Dye}}

=== Smelting ===
{{smelting|head=1|Sea Pickle|Lime Dye|0,1}}
{{smelting|foot=1|Cactus|Green Dye|1|}}

=== Generated loot ===
{{LootChestItem|blue-dye,green-dye,orange-dye,light-blue-dye,yellow-dye,white-dye}}

=== Trading ===
[[Wandering trader]]s can sell 3 dyes for an [[emerald]].

== Usage ==
=== Crafting ===
Dye can be used to add dye to undyed items through [[crafting]], and to craft dyed items directly. {{IN|bedrock}}, [[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. <!--- sections are ordered by craftable dyeable blocks, dyeable items, version exclusive sections, and non-crafting miscellaneous uses--->
==== Wool ====
A piece of [[wool]] in any color can be dyed by combining 1 wool with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Wool
|Matching Dye
|Output=Matching Wool
}}

==== Carpets ====
A [[carpet]] of any color can be dyed by combining 1 carpet with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Carpet
|Matching Dye
|Output=Matching Carpet
}}

==== Terracotta ====
[[Terracotta]] can be [[Stained Terracotta|stained]] by placing 8 blocks of terracotta around a dye in a 3×3 crafting table. Stained terracotta can not be restained to a different color.
{{Crafting
|ignoreusage=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
}}

==== Concrete powder ====
Dyes can also be used to craft [[concrete powder]], which can then be set into their respective [[concrete]] blocks. Concrete powder and concrete cannot be redyed.
{{Crafting
|ignoreusage=1
|Sand
|Gravel
|Sand
|Gravel
|Matching Dye
|Gravel
|Sand
|Gravel
|Sand
|Output=Matching Concrete Powder,8
}}

==== Stained glass ====
[[Glass]] can be [[Stained Glass|stained]] by placing 8 blocks of glass around a dye in a 3×3 crafting grid.
{{Crafting
|ignoreusage=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
|foot=1
}}

==== Stained glass panes ====
[[Glass pane|Glass panes]] can be [[Stained Glass Pane|stained]] by placing 8 glass panes around a dye in a 3×3 crafting grid.

{{Crafting
|ignoreusage=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
|head=1
|foot=1
}}

==== Shulker boxes ====
A [[shulker box]] can be dyed by combining it with any dye in a crafting grid. A dyed shulker can be re-dyed using the same crafting recipe. A dyed shulker box can only be [[Shulker Box#Undyeing|undyed]] using a [[cauldron]].<!-- this is put here because some people might wonder why dyeing it purple does not undye it -->
{{Crafting
|ignoreusage=1
|Any Shulker Box
|Matching Dye
|Output=Matching Shulker Box
}}

==== Beds ====
A [[bed]] of any color can be dyed, by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Bed
|Matching Dye
|Output=Matching Bed
}}

==== Candles ====
An undyed [[candle]] can by dyed by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Candle
|Matching Dye
|Output=Matching Dyed Candle
}}

==== Bundles ====
A [[bundle]] of any color can be dyed, by combining it with any dye in a crafting grid.
{{Crafting
|ignoreusage=1
|Any Bundle
|Matching Dye
|Output = Matching Dyed Bundle
|foot = 1
}}

==== 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
}}

==== Balloons ====
{{education feature|section=1}}
Dye can be used to craft [[balloon]]s.
{{Crafting
|ignoreusage=1
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
}}

==== Glow sticks ====
{{education feature|section=1}}
Dye can also be used to craft [[glow stick]]s.
{{Crafting
|nocat=1
|ignoreusage=1
|ingredients=[[Polyethylene]] +<br>[[Hydrogen Peroxide]] +<br>Matching [[Dye]] +<br>[[Luminol]]
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= White Dye; Gray Dye; Brown Dye; Red Dye; Orange Dye; Yellow Dye; Lime Dye; Green Dye; Cyan Dye; Light Blue Dye; Blue Dye; Purple Dye; Magenta Dye; Pink Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
}}

=== Banner patterns ===
{{main|Banner#Patterns}}
Dye is used to add a banner pattern to a banner. Each pattern uses 1 dye, which also determines the color of that pattern.

=== Dyeing armor ===
{{Calculator|armorColor}}
[[File:DyeGraph2.png|200px|thumb|A graph showing all combinations of two dyes on a [[leather tunic]]. In total, leather armor can be colored in 5,713,438 possible colors<ref name=":0" /><ref name="number-2"/>]]
Leather [[armor]], [[wolf armor]], and leather horse armor can be dyed:
*{{IN|java}}, armor is dyed by crafting it and dyes together on a [[Crafting Table|crafting table]].
*{{IN|Bedrock}}, armor is dyed by {{control|using}} it on a [[cauldron]] filled with dyed water. This consumes 1 layer of water but does not change the color of the water.
**The armor can be undyed by {{control|using}} it on a cauldron with undyed water. This changes the water's color to the color of the armor and changes the armor to have no dye color.{{info needed|Bedrock, Java, or both?}}

It is possible to put more than one dye alongside the 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 RGBA color model, has a red value, green value, blue value and layer opacity or alpha 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, the average maximum value is divided by the maximum of the average RGB values. The average RGB values are then used as the final color and the modified average maximum value used as the layer opacity value. This procedure can be summed up with the following pseudocode:
 set all "total" variables to 0
 set numberOfColors to 0
 for each color:
  set totalRed to: totalRed + redValue
  set totalGreen to: totalGreen + greenValue
  set totalBlue to: totalBlue + blueValue
  set totalMaximum to: totalMaximum + (max of redValue, greenValue, blueValue)
  set numberOfColors to: numberOfColors + 1
 
 set averageRed to: totalRed / numberOfColors
 set averageGreen to: totalGreen / numberOfColors
 set averageBlue to: totalBlue / numberOfColors
 set averageMaximum to: totalMaximum / numberOfColors
 
 set maximumOfAverage to: max of averageRed, averageGreen, averageBlue
 set alphaFactor to: averageMaximum / maximumOfAverage
 
 set resultRed to: averageRed
 set resultGreen to: averageGreen
 set resultBlue to: averageBlue
 set resultLayerOpacity to: alphaFactor

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). Finally, this formula does not allow for every possible color to be obtained. Therefore, not all dyed armors are obtainable.

If 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 sheep ===
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.

=== Dyeing collars ===
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 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.

=== Dyeing water inside cauldrons ===
{{exclusive|bedrock|section=1}}
Water can be dyed in a cauldron by holding any dye in the hand and pressing {{Ctrl|use}} on a cauldron filled with water.

=== Trading ===
Apprentice, journeyman and expert-level shepherd [[villager]]s buy 12 of any of the dyes for an [[emerald]].

== Color values ==
The "color codes" are used to determine the color imparted on [[sheep]], [[wolf]] and [[cat]] collars, [[firework star]]s, [[beacon]] beams, and dyed [[leather armor]], [[leather horse armor]] and [[wolf armor]]. The hex value is shown in the extended tooltips of dyed 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. Color codes are usually encoded using the corresponding numeric id, although e.g. [[sign]]s store the color name instead to represent text color.

<!--- Values are up to date as of Java Edition 1.20.4--->
{| class="wikitable sortable" style="margin:2px; border: 1px solid silver; text-align: left;" data-description="Data values"
! rowspan="2" |Id
! rowspan="2" |Name
! colspan="2" style="text-align:center" |Color code
! colspan="2" style="text-align:center" |Firework color code
|-
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
|-
| style="text-align:center" |0||<code>white</code>||16383998{{only|je|short=1}}<br>15790320{{only|be|short=1}}||{{color|#F9FFFE}}{{only|je|short=1}}<br>{{color|#F0F0F0}}{{only|be|short=1}} || 15790320 || {{color|#F0F0F0}}
|-
| style="text-align:center" |1||<code>orange</code>||16351261||{{color|#F9801D}} || 15435844 || {{color|#EB8844}}
|-
| style="text-align:center" |2||<code>magenta</code>||13061821||{{color|#C74EBD}} || 12801229 || {{color|#C354CD}}
|-
| style="text-align:center" |3||<code>light_blue</code>||3847130||{{color|#3AB3DA}} || 6719955 || {{color|#6689D3}}
|-
| style="text-align:center" |4||<code>yellow</code>||16701501||{{color|#FED83D}} || 14602026 || {{color|#DECF2A}}
|-
| style="text-align:center" |5||<code>lime</code>||8439583||{{color|#80C71F}} || 4312372 || {{color|#41CD34}}
|-
| style="text-align:center" |6||<code>pink</code>||15961002||{{color|#F38BAA}} || 14188952 || {{color|#D88198}}
|-
| style="text-align:center" |7||<code>gray</code>||4673362||{{color|#474F52}} || 4408131 || {{color|#434343}}
|-
| style="text-align:center" |8||<code>light_gray</code>||10329495||{{color|#9D9D97}} || 11250603 || {{color|#ABABAB}}
|-
| style="text-align:center" |9||<code>cyan</code>||1481884||{{color|#169C9C}} || 2651799 || {{color|#287697}}
|-
| style="text-align:center" |10||<code>purple</code>||8991416||{{color|#8932B8}} || 8073150 || {{color|#7B2FBE}}
|-
| style="text-align:center" |11||<code>blue</code>||3949738||{{color|#3C44AA}} || 2437522 || {{color|#253192}}
|-
| style="text-align:center" |12||<code>brown</code>||8606770||{{color|#835432}} || 5320730 || {{color|#51301A}}
|-
| style="text-align:center" |13||<code>green</code>||6192150||{{color|#5E7C16}} || 3887386 || {{color|#3B511A}}
|-
| style="text-align:center" |14||<code>red</code>||11546150||{{color|#B02E26}} || 11743532 || {{color|#B3312C}}
|-
| style="text-align:center" |15||<code>black</code>||1908001||{{color|#1D1D21}} || 1973019 || {{color|#1E1B1B}}
|}

== Sounds ==
{{edition|java}}
{{SoundTable
| type = java
| {{SoundLine
|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}}
| {{SoundLine
|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
}}
}}

{{edition|bedrock}}:
{{SoundTable
| type = bedrock
| {{SoundLine
| sound =Dye.ogg
|source=sound
|description=When dye is used on a sign
|id=sign.dye.use
|volume=1.0
|pitch=1.0}}
| {{SoundLine
|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}}
| {{SoundLine
|source=block
|description=When armor is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
| {{SoundLine
|source=block
|description=When dye is removed from armor using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
| pitch = 1.0
}}
}}

== Achievements ==
{{load achievements|Rainbow Collection;Tie dye outfit;welcome to the world of color}}

== 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.}}

{{yt|8YD7oauNZHE|align=inline}}
{{yt|7tETaRt7STM|align=inline}}

== History ==
{{HistoryTable
|{{HistoryLine|java beta}}
|{{HistoryLine||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.}}
|{{HistoryLine||January 10, 2011|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]].<ref group="n">Supposed time when fragment was filmed. Based on modified date of client.jar/gui/trap.png in [[Beta 1.2]].</ref>}}
|{{HistoryLine||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:
{{:Color/Java Edition dye colors before 1.4.3}}
}}
|{{HistoryLine|java}}
|{{HistoryLine||1.1|dev=11w49a|[[Sheep]] can now regrow their [[wool]] by eating [[grass block|grass]]. Dyed sheep regrow wool in their new color.}}
|{{HistoryLine||1.3.1|dev=12w19a|[[File:Cocoa Beans JE2.png|32px]] The texture of [[cocoa beans]] has been changed.}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||1.4.2|dev=12w34a|Added the ability to dye leather [[armor]] and [[wolf]] collars.}}
|{{HistoryLine||1.4.4|dev=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.
{{:Color/Java Edition dye color changes in 1.4.3}}}}
|{{HistoryLine||1.6.1|dev=13w19a|[[Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||1.7.2|dev=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary dyes.}}
|{{HistoryLine|||dev=13w41a|[[Stained glass]] can now be crafted using dyes.}}
|{{HistoryLine||1.8|dev=14w02a|As cleric [[villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
|{{HistoryLine|||dev=14w30a|Added [[banner]]s, which can be dyed.}}
|{{HistoryLine||1.9|dev=15w34a|Added [[shield]]s, which can be dyed indirectly by applying a matching [[banner]].}}
|{{HistoryLine||1.11|dev=16w39b|Dyes are now used to change the color of [[shulker box]]es.}}
|{{HistoryLine||1.12|dev=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>
}}
|{{HistoryLine|||dev=17w15a|Dyes can now apply color to white [[bed]]s.}}
|{{HistoryLine||1.13|dev=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.}}
|{{HistoryLine||1.14|dev=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 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 JE3 BE3.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>}}
|{{HistoryLine|||dev=18w44a|The color of the text on [[sign]]s can now be changed with dye.}}
|{{HistoryLine|||dev=18w49a|Yellow dyes can now be found in [[chest]]s in [[village]] mason houses.}}
|{{HistoryLine|||dev=18w50a|Green dyes can now be found in [[chest]]s in [[desert]] village houses.}}
|{{HistoryLine|||dev=19w05a|Added the [[wandering trader]], which can sell any type of dye.}}
|{{HistoryLine|||dev=19w11a|All 16 types of dyes can now be [[trading|bought]] by shepherd villagers.}}
|{{HistoryLine||1.16.2|dev=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>}}
|{{HistoryLine||1.17|dev=20w45a|Added [[candle]]s, which can be dyed.}}
|{{HistoryLine|||dev=21w03a|Added a sound for applying dyes.}}
|{{HistoryLine|||dev=21w19a|Candles can no longer be dyed.}}
|{{HistoryLine|||dev=Pre-release 1|Candles can now once again be dyed.}}
|{{HistoryLine||1.19.3|exp=Update 1.20|dev=22w42a|The color of the text on [[hanging sign]]s can now be changed with dye.}}
|{{HistoryLine||1.19.4|exp=Update 1.20|dev=23w07a|[[Torchflower]]s can now be crafted into orange dye.
|[[Pink petals]] can now be crafted into pink dye.}}
|{{HistoryLine||1.20|dev=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]].}}
|{{HistoryLine|||dev=23w14a|Pitcher plants can now craft two [[cyan dye]] instead of one.}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||1.20.5|dev=24w09a|[[Wolf armor]] can now be dyed.}}
|{{HistoryLine||1.21.2|dev=24w38a|[[Bundle]]s can now be dyed.}}

|{{HistoryLine|pocket alpha}}
|{{HistoryLine||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.}}
|{{HistoryLine||v0.3.2|[[Cactus green]] is now obtainable by smelting [[cacti]].}}
|{{HistoryLine||v0.3.3|[[Bone meal]] is now obtainable via [[crafting]].}}
|{{HistoryLine||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.}}
|{{HistoryLine||v0.8.0|dev=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||v0.9.0|dev=build 1|Cocoa beans can now be obtained from [[cocoa pod]]s.
|The [[rose]] has been reworked into the [[poppy]]. It can be crafted into rose red.}}
|{{HistoryLine|||dev=build 3|All new [[flower]]s can now be [[craft]]ed 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]].}}
|{{HistoryLine|||dev=build 11|[[Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||v0.11.0|dev=build 1|[[Ink sac]]s can now be obtained from [[squid]].
|Added the ability to dye [[wolf]] collars.}}
|{{HistoryLine||v0.12.1|dev=build 1|Red [[mushroom]]s can no longer be smelted to obtain [[rose red]].}}
|{{HistoryLine||v0.14.0|dev=build 1|[[Cauldron]]s now used for leather dyeing, by applying a dye to a [[water]]-filled cauldron.}}
|{{HistoryLine||v0.16.0|dev=build 1|[[Cocoa beans]] can no longer be crafted.}}
|{{HistoryLine|pocket}}
|{{HistoryLine||1.0.0|dev=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 [[craft]]ed, but purple glass generates in [[end cities]].}}
|{{HistoryLine||1.1.0|dev=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.}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.2.0|dev=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 [[craft]]able, using dyes.}}
|{{HistoryLine||1.4.0|dev=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.}}
|{{HistoryLine||1.8.0|dev=beta 1.8.0.8|Dyes can now be used to dye [[cat]] collars.}}
|{{HistoryLine|||dev=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.}}
|{{HistoryLine||1.9.0|dev=beta 1.9.0.0|Blue and white dye can now be obtained from [[cornflower]]s and [[lily of the valley]]s.}}
|{{HistoryLine||1.10.0|dev=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.}}
|{{HistoryLine||1.11.0|dev=beta 1.11.0.4|Dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
|{{HistoryLine||1.16.210|dev=beta 1.16.210.59|The color of the text on [[sign]]s can now be changed with dye.}}
|{{HistoryLine|||dev=beta 1.16.210.60|The ability to dye the color of the text on [[sign]]s was temporarily removed.}}
|{{HistoryLine||1.16.220|dev=beta 1.16.220.50|The color of the text on [[sign]]s can now be changed with dye again.}}
|{{HistoryLine||1.17.10|dev=beta 1.17.10.22|Added [[candle]]s, which can be dyed.}}
|{{HistoryLine||1.20.80|dev=Preview 1.20.80.20|[[Wolf armor]] can now be dyed.}}
|{{HistoryLine||1.21.40|dev=Preview 1.21.40.22|[[Bundle]]s can now be dyed.}}

|{{HistoryLine|console}}
|{{HistoryLine||xbox=TU1|xbone=CU1|ps3=1.00|psvita=1.00|ps4=1.00|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.}}
|{{HistoryLine||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
|{{HistoryLine||xbox=TU14|xbone=CU1|ps3=1.04|psvita=1.00|ps4=1.00|wiiu=Patch 1|switch=1.0.1|Added the ability to dye leather [[armor]] and [[wolf]] collars.}}
|{{HistoryLine||xbox=TU19|xbone=CU7|ps3=1.12|psvita=1.12|ps4=1.12|[[Stained clay]] can now be crafted using dyes.}}
|{{HistoryLine||xbox=TU25|xbone=CU14|ps3=1.17|psvita=1.17|ps4=1.17|[[Stained glass]] can now be crafted using dyes.}}
|{{HistoryLine||xbox=TU31|xbone=CU19|ps3=1.22|psvita=1.22|ps4=1.22|wiiu=Patch 3|switch=1.0.1|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary dyes.|As cleric [[villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
|{{HistoryLine||xbox=TU43|xbone=CU33|ps3=1.36|psvita=1.36|ps4=1.36|wiiu=Patch 13|switch=1.0.1|Added [[banner]]s, which can be dyed.}}
|{{HistoryLine||xbox=TU53|xbone=CU43|ps3=1.49|psvita=1.49|ps4=1.50|wiiu=Patch 23|switch=1.0.3|Dyes are now used to change the color of [[shulker box]]es.|Dyes are now used to craft [[concrete powder]].}}
|{{HistoryLine||xbox=TU60|xbone=CU51|ps3=1.64|psvita=1.64|ps4=1.64|wiiu=Patch 30|switch=1.0.11|Dyes can now be used to dye [[leather horse armor]].|Dyes can now be used to change the water color in a [[cauldron]] to dye leather [[armor]].}}
|{{HistoryLine||xbox=none|xbone=none|ps3=none|psvita=none|ps4=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.}}
|{{HistoryLine||ps4=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.}}
|{{HistoryLine|3ds}}
|{{HistoryLine||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]].}}
}}

<gallery>
Pre-release dyes.png|Pre-release dye textures hidden within [[Items.png]].
</gallery>
;Notes
{{reflist|group=n}}

== Gallery ==
<gallery>
File:White Dye.png|White dye
File:Light Gray Dye.png|Light gray dye
File:Gray Dye.png|Gray dye
File:Black Dye.png|Black dye
File:Brown Dye.png|Brown dye
File:Red Dye.png|Red dye
File:Orange Dye.png|Orange dye
File:Yellow Dye.png|Yellow dye
File:Lime Dye.png|Lime dye
File:Green Dye.png|Green dye
File:Cyan Dye.png|Cyan dye
File:Light Blue Dye.png|Light blue dye
File:Blue Dye.png|Blue dye
File:Purple Dye.png|Purple dye
File:Magenta Dye.png|Magenta dye
File:Pink Dye.png|Pink dye
File:MineconDyesBlacks.png|alt=
</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

== Navigation ==
{{Navbox dyed block}}

{{Navbox items|Ingredients}}

[[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:染料]]