Minecraft Wiki
Advertisement

Template:Mob

Information icon
This feature is exclusive to Java Edition and Bedrock Edition. 
Crafting Table
This article describes content that may be included in a future update. 
This content has appeared in development versions, but the full update containing it has not been released yet.

The wandering trader is a villager-like passive NPC mob found randomly across the world.

Spawning

The wandering trader appears randomly across the world or periodically in village gathering sites, usually near village meeting points, with one to two leashed trader llamas.

At any time, there can be only one wandering trader naturally spawned in the world.

After 24000 ticks (20 real-life minutes) have passed since the world is created, the game will start to attempt spawning a wandering trader.[note 1] If there are no wandering traders currently in the world, the game tries to spawn a new wandering trader after every following 24000 ticks, within a 48-block radius of a player. The first spawn attempt has a 2.5% chance that one will spawn; if it fails, after another 24000 ticks another spawn attempt will be made with a 5% chance of success. If that fails, for all subsequent spawn attempts the chance will cap at 7.5%. After 48000 or 72000 ticks the trader will despawn and reset the cycle, leaving the llamas behind, and may respawn later.

In Bedrock Edition, when using spawn eggs or the /summon command to spawn a wandering trader, the llamas will always spawn with it. Wandering traders will never spawn if /mobevent minecraft:wandering_trader is set to false.‌[upcoming: BE 1.11.0]

Behavior

The wandering trader has six random trades in Java Edition, or four in Bedrock Edition[until BE 1.11.0]. New trades are not unlocked after trading with it.

After spawning, the wandering trader will have a managed schedule for 40–60 minutes. After the time expires, the wandering trader will despawn. They will despawn even if they are named with a name tag or put in a vehicle such as a minecart or boat. A wandering trader will despawn sooner if all trades have been locked. The Trader may later respawn with new trades.

The wandering trader can sometimes form a caravan, due to wild llamas that follow the leashed trader llama(s).

Wandering traders will drink a potion of invisibility during dusk‌[upcoming: JE 1.14 & BE 1.11.0]. Once it is dawn, they will drink milk to remove the invisibility.‌[Java Edition only]

Wandering traders will avoid zombies and their variants, all illager variants, and vexes, staying at least 8 blocks away.

Wandering traders will drink potions of invisibility if hurt by projectiles, magic attacks, or when avoiding illagers, vexes, and zombies.‌[upcoming: BE 1.11.0]

Drops

When killed, the wandering trader will unleash its trader llamas. The leads will break and appear at the position of the llamas.

Wandering traders have a small chance of dropping a bucket of milk or a potion of invisibility if holding either and killed before they can finish drinking. The chances of them dropping either is increased with the Looting enchantment.

Trading

For the available trades for the wandering trader, see Trading § Wandering trader.

The trading system is a gameplay mechanic that allows players to trade emeralds for items and vice-versa. Their trades can be considered good or bad, depending on what the cost is and what items the player might get.

Right-clicking a wandering trader will allow a player to trade with them. Different offers may be viewed by pressing the left and right buttons next to the currently displayed offer. All offers involve emerald as a currency. Trading allows the acquisition of rare items that would otherwise be fairly difficult to obtain, such as coral or blue ice.

In Java Edition, after 2–12 times an offer is repeated, the wandering trader will lock the trade offer, and the wandering trader will no longer offer this trade permanently.

Unlike villagers who both give and receive emeralds in exchange for items, wandering traders only sell items for emeralds. Players cannot exchange items for emeralds. Wandering traders also have no experience bar and they don't modify their offers based on increased demand.

Advancements

Icon Advancement In-game description Parent Actual requirements (if different) Resource location
Advancement-plain-rawWhat a Deal!
Successfully trade with a Villager AdventureTake an item from a villager or wandering trader's trading output slot, and put it in your inventory.adventure/trade

Data values

See also: Chunk format

Wandering traders have entity data associated with them that contain various properties of the mob.

  • Entity data
      • Additional fields for mobs that can breed
    • Tags common to all entities
    • Tags common to all mobs
    •  DespawnDelay: The number of ticks counted down until this wandering trader is forced to despawn. The wandering trader despawns when this value reaches 1.
    •  Offers: Is generated when the trading menu is opened for the first time.
      •  Recipes: List of trade options.
        • A trade option.
          •  buy: The first 'cost' item, without the Slot tag.
            • Tags common to all items
          •  buyB: May not exist. The second 'cost' item, without the Slot tag.
            • Tags common to all items
          •  maxUses: The maximum number of times this trade can be used before it is disabled. Increases by a random amount from 2 to 12 when offers are refreshed.
          •  rewardExp: 1 or 0 (true/false) - true if this trade provides XP orb drops. All trades from naturally-generated villagers in Java Edition reward XP orbs.
          •  sell: The item being sold for each set of cost items, without the Slot tag.
            • Tags common to all items
          •  uses: The number of times this trade has been used. The trade becomes disabled when this is greater or equal to maxUses.
    •  WanderTarget: Destination toward where this trader wanders.
      •  X: The X coordinate to wander toward.
      •  Y: The Y coordinate to wander toward.
      •  Z: The Z coordinate to wander toward.
    •  Inventory: Each compound tag in this list is an item in the wandering trader's inventory, up to a maximum of 8 slots. Items in two or more slots that can be stacked together are automatically be condensed into one slot. If there are more than 8 slots, the last slot is removed until the total is 8. If there are 9 slots but two previous slots can be condensed, the last slot returns after the two other slots are combined. Wandering traders don't change their inventory automatically or drop items from it upon death. The inventory is currently unused.
      • An item in the inventory, excluding the Slot tag.
        • Tags common to all items

History

Upcoming Java Edition
1.14
{{Extension DPL}}<ul><li>[[Blue Dye|Blue Dye]]<br/>{{Item
|image = Blue_Dye_JE1_BE1.png
|renewable = Yes
|stackable = Yes (64)
}}

'''Blue dye''' is a [[Dye#Primary|primary dye color]].

== Obtaining ==
=== Crafting ===
{{Crafting
 |Lapis Lazuli
 |Output=Blue Dye
 |type=Material
 |head=1
}}
{{Crafting
 |Cornflower
 |Output=Blue Dye
 |type=Material
 |foot=1
}}
=== Chest loot ===
{{#invoke:LootChest|base3|blue-dye}}

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

{{crafting usage|ignore=Banner|continue=1}}
{{banner crafting usage}}

=== Loom ingredient ===
{{Banner loom usage|Blue Dye}}

=== Trading ===
Expert-level shepherd villagers have a {{frac|1|6}} chance to buy 12 blue dye for an emerald.

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Blue Dye
|spritetype=item
|nameid=blue_dye
|aliasid=dye / 18
|id=399
|form=item
|translationkey=item.dye.blue_new.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.14|snap=18w43a|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History|||snap=18w44a|Blue dyes now can changed the text color on the [[sign]]s to blue.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell blue dyes.}}
{{History|||snap=19w11a|Blue dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Blue dyes can now used to craft newly added [[blue candle]]s.}}
{{History|||snap=21w19a|Blue dyes can no longer used to craft blue candles.}}
{{History|||snap=Pre-release 1|Blue dyes can once again used to craft blue candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Blue dyes can now change the text color on [[hanging sign]]s to blue.}}
{{History||1.20|snap=23w12a|Blue dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Blue 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 dye now is in the common loot.}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History||1.9.0|snap=beta 1.9.0.0|Added [[flower|cornflowers]], which can be used to [[crafting|craft]] blue dye.}}
{{History||1.10.0|snap=beta 1.10.0.3|Blue dye can now be used to [[dye]] white [[carpet]]s and uncolored [[glass pane]]s.}}
{{History||1.11.0|snap=beta 1.11.0.4|Blue dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of blue dye has been changed from <code>dye/18</code> to <code>blue_dye</code>.}}

{{History|ps4}}
{{History||1.83|[[File:Blue_Dye_JE1_BE1.png|32px]] Added blue dye.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

[[Category:Items]]
[[Category:Dyes]]
[[Category:Renewable resources]]

[[de:Blauer Farbstoff]]
[[es:Tinte azul]]
[[fr:Teinture bleue]]
[[ja:青色の染料]]
[[ko:파란색 염료]]
[[pl: Niebieski barwnik]]
[[pt:Corante azul]]
[[zh:蓝色染料]]</li><li>[[Food|Food]]<br/>{{For|food in ''Minecraft Dungeons''|MCD:Food}}
[[File:Eating Steve.png|thumb|right|150px]]
[[File:Eating Alex.png|thumb|right|150px]]
'''Food''' refers to any consumable [[item]]s that, when eaten, restore [[hunger]] points and hunger saturation points, and sometimes cause [[status effect]]s. They are essential to survival, as going without them eventually causes the player to starve, causing damage until reaching {{hp|10}} in Easy [[difficulty]], and {{hp|1}} on Normal. [[Hunger#Effects of hunger|Starvation]] damage kills the player in Hard and [[Hardcore]] Mode.

Food is eaten by holding {{control|use}} while having the food item selected in the hot bar or in the off-hand.

[[Cake]] cannot be eaten this way, and must instead be placed on a surface before being eaten.

With the exception of [[chorus fruit]], [[golden apple]]s, [[honey bottle]]s, [[milk]], and [[suspicious stew]]{{only|Java}}, food cannot be eaten when the hunger bar is completely full. In [[Creative]] Mode, any food can be consumed at any time.

All food items and ingredients can be stacked in the inventory slots, except for [[milk]], [[rabbit stew]], [[mushroom stew]], [[beetroot soup]], [[suspicious stew]], and [[cake]].{{only|Java}}

This page covers food items for players; blocks and items that can be eaten by other [[mob]]s are not included here.

== Hunger and saturation ==
{{main|Hunger#Mechanics}}
{{seealso|Tutorials/Hunger_management}}

[[File:Raw_and_Cooked_Chicken_Comparison.png|thumb|Raw (left) and cooked (right) [[chicken]]. Eating raw chicken can give the [[player]] [[food poisoning]].]]

[[Player]]s have two different food statistics, one of which is visible: The hunger level is visible, and the saturation level is not.

[[Saturation]] is the first statistic to decrease when a player performs energy-intensive actions, and it must be completely depleted before the visible hunger meter begins decreasing. Although the current saturation level is generally hidden, the player can tell that their saturation level is completely depleted if the visible hunger meter begins displaying a jittering effect.

Eating a food item replenishes a fixed number of hunger points and saturation points, based on the item. Some foods have a better ratio of saturation to hunger points replenished than others. Overeating the hunger bar does not overflow to saturation.

A player's current saturation level can never exceed their current hunger level. A player at a hunger level of 5, for example, can be at a maximum of 5 saturation. Food always restores hunger (raising the saturation limit) ''before'' supplying saturation. The most efficient use of food is to eat low-saturation food to fill the hunger bar, followed by high-saturation food to fill saturation.  While a few hunger points may be wasted when eating nourishing food when nearly full, eating nourishing foods on a low hunger bar wastes even more points of saturation.  Maximizing saturation increases the length of time (and/or the amount of damage healed) before the player needs to eat again.

=== Usage ===

Most foods can be eaten by holding down the right-click button with a food item in hand. It takes 1.61 seconds to eat most foods; dried kelp takes 0.865 seconds to eat. Additionally, a player can hold food in their [[offhand]] {{in|Java}}.

While eating, food [[particles]] form from the player's mouth correlated with their respective food item, and produces a munching noise. Eating also slows the user significantly.

Unlike other foods, [[cake]] has to be eaten by placing it, then right-clicking on its block form. Eating cake is instant and it has 7 edible slices, each giving {{hunger|2}} hunger and 0.4 hunger [[saturation]].

=== Nourishment value ===

Nourishment is defined as the ratio of saturation to hunger points restored. Foods with higher nourishment values should be eaten when the hunger bar is more full.

The "nourishment" table below can help by categorizing foods by their saturation-to-hunger restoration ratios. See the more detailed [[#Foods|Foods]] table for the exact hunger and saturation statistics of each food.

<!-- do not change the locations of the food in this table without providing an explanation in the edit summary -->
{| class="wikitable" data-description="Nourishment value"
 |-
!Nourishment
! Value
 !Food
 |- style="text-align: left;"
!Supernatural
| 2.4
 | {{Slot|Enchanted Golden Apple}}{{Slot|Golden Apple}}{{Slot|Golden Carrot}}
 |- style="text-align: left;"
!Good
| 1.6
 | {{Slot|Cooked Mutton}}{{Slot|Cooked Porkchop}}{{Slot|Cooked Salmon}}{{Slot|Steak}}
 |- style="text-align: left;"
!Normal
| 1.2
 | {{Slot|Baked Potato}}{{Slot|Beetroot}}{{Slot|Beetroot Soup}}{{Slot|Bread}}{{Slot|Carrot}}{{Slot|Cooked Chicken}}{{Slot|Cooked Cod}}{{Slot|Cooked Rabbit}}{{Slot|Mushroom Stew}}{{Slot|Rabbit Stew}}{{Slot|Suspicious Stew}}
 |- style="text-align: left;"
! Low
| 0.6
 | {{Slot|Apple}}{{Slot|Chorus Fruit}}{{Slot|Dried Kelp}}<ref group="note" name="Java">{{only|java}}</ref>{{Slot|Melon Slice}}{{Slot|Poisonous Potato}}{{Slot|Potato}}{{Slot|Pumpkin Pie}}{{Slot|Raw Beef}}{{Slot|Raw Chicken}}{{Slot|Raw Mutton}}{{Slot|Raw Porkchop}}{{Slot|Raw Rabbit}}{{Slot|Sweet Berries}}<ref group="note" name="Bedrock">{{only|bedrock}}</ref>
 |- style="text-align: left;"
!Poor 
| 0.2
 | {{Slot|Cake}}{{Slot|Cookie}}{{Slot|Dried Kelp}}<ref group="note" name="Bedrock"/>{{Slot|Glow Berries}}{{Slot|Honey Bottle}}{{Slot|Pufferfish|link=Pufferfish (item)}}{{Slot|Raw Cod}}{{Slot|Raw Salmon}}{{Slot|Rotten Flesh}}{{Slot|Spider Eye}}{{Slot|Sweet Berries}}<ref group="note" name="Java"/>{{Slot|Tropical Fish|link=Tropical Fish (item)}}
 |}

== Foods ==
{{/table}}

=== Ingredients ===

The following items cannot be eaten on their own. Instead, they are used to craft consumable food items.
<!-- 
Please leave spaces between each row in the table - this has no effect on the appearance of the table, but it makes it a lot easier on future wiki editors!
-->

{| class="sortable wikitable list-style-none" data-description="Ingredients"
|-
! Name
! Icon
! Used to make
! Source(s)
! Notes

|- id="Bowl"
! scope="row" | [[Bowl]]
| {{Slot|Bowl}}
| {{itemLink|Mushroom Stew}}
* {{itemLink|Beetroot Soup}}
* {{itemLink|Rabbit Stew}}
* {{itemLink|Suspicious Stew}}
|
* [[Crafting]] from [[planks]]
* [[Fishing Rod#Usage|Fishing]]
* [[Turtle]] killed by [[lightning]]
* Eating food made with them
|

|- id="Cocoa Bean"
! scope="row" | [[Cocoa Beans]]
| {{Slot|Cocoa Beans}}
| {{itemLink|Cookie}}s
|
* Breaking [[cocoa plant]]s
* Bought from [[wandering trader]]
|

|- id="Egg"
! scope="row" | [[Egg]]
| {{Slot|Egg}}
|
* {{itemLink|Cake}}
* {{itemLink|Pumpkin Pie}}
|
* Laid by [[chicken]]s
* Found in village fletcher chests
|

|- id="Milk"
! scope="row" | [[Milk Bucket]]
| {{Slot|Milk Bucket}}
| {{itemLink|Cake}}
|
* Milking a [[cow]], [[mooshroom]]s, or [[goat]]s
* Killing a [[Wandering trader]] drinking it
| Can also be consumed to clear [[status effect]]s

|- id="Mushroom"
! scope="row" | [[Brown Mushroom]] and [[Red Mushroom]]
| {{Slot|Brown Mushroom;Red Mushroom}}
| {{itemLink|Mushroom Stew}}
* {{itemLink|Rabbit Stew}}
* {{itemLink|Suspicious Stew}}
| {{anchor|Brown Mushroom|Red Mushroom}}
* Dark/shady areas
* Swamp [[biome]]s
* [[Mushroom fields]]
* Breaking [[Huge Mushroom|huge brown or red mushrooms]]
* [[The Nether]]
* Using [[shears]] on a [[mooshroom|brown mooshroom or red mushroom]]
* Bought from [[wandering trader]] 
|
|- id="Flower"
! scope="row" | [[Flower]]
| {{Slot|Any Flower}}
|{{itemLink|Suspicious Stew}}
|
* Breaking [[Flower]]
* Using [[Bone Meal]] on a [[Grass Block]]
* Bought from [[wandering trader]]
* Killing [[Iron Golem]] (poppy)
|

|- id="Pumpkin"
! scope="row" | [[Pumpkin]]
| {{Slot|Pumpkin}}
| {{itemLink|Pumpkin Pie}}
|
* Harvesting mature [[pumpkin]]s grown from [[pumpkin seeds]]
* Naturally occurring [[pumpkin]]s
* Taiga and Snowy Taiga [[Village]]s
* Bought from [[wandering trader]]  
|

|- id="Sugar"
! scope="row" | [[Sugar]]
| {{Slot|Sugar}}
|
* {{itemLink|Cake}}
* {{itemLink|Pumpkin Pie}}
|
* Crafting [[sugar cane]]
* Dropped by [[witch]]es
* Creating from its base [[element]]s {{only|bedrock|education}}
* Redeemed from [[honey bottle]] on a crafting table 
|

|- id="Wheat"
! scope="row" | [[Wheat]]
| {{Slot|Wheat}}
|
* {{itemLink|Bread}}
* {{itemLink|Cake}}
* {{itemLink|Cookie}}s
|
* Harvesting mature [[wheat]]
* Found in [[Dungeon#Loot|dungeon]], [[Woodland Mansion#Loot|woodland mansion]], [[Shipwreck#Loot|shipwreck]], [[Igloo#Loot|igloo]], [[Village#Loot|village]], [[Ocean Ruins#Loot|ocean ruins]], and [[Pillager Outpost#Loot|pillager outpost]] chest
* Crafting [[hay bale]]s
|

|- id="Gold Nugget"
! scope="row" | [[Gold Nugget]]
| {{Slot|Gold Nugget}}
| {{itemLink|Golden Carrot}}
|
* Crafting [[gold ingot]]s
* Dropped by [[zombified piglin]]s
* Found in [[Shipwreck#Loot|shipwreck]], [[Igloo#Loot|igloo]], [[Village#Loot|village]], and [[Ocean Ruins#Loot|ocean ruins]] chest
* Smelting golden armor or tools
* Mining [[nether gold ore]] without [[Silk Touch]]
|

|- id="Gold Ingot"
! scope="row" | [[Gold Ingot]]
| {{Slot|Gold Ingot}}
| {{itemLink|Golden Apple}}
|
* Crafting [[gold block]]s or [[gold nugget]]s
* Rarely dropped by [[zombified piglin]]s and by [[Drowned]]
* Smelting [[gold ore]] or [[nether gold ore]]
* Found in [[Shipwreck#Loot|shipwreck]], [[Jungle Pyramid#Structure:Loot|jungle pyramid]], [[Dungeon#Loot|dungeon]], [[Woodland Mansion#Loot|woodland mansion]], [[Nether Fortress#Loot|nether fortress]], [[End city#Loot|end city]], [[Mineshaft#Loot|mineshaft]], [[Village#Structure:Loot|village]], [[Stronghold#Loot|stronghold]], [[Buried Treasure#Loot|buried treasure]] and [[Desert pyramid#Structure:Loot|desert pyramid]] chest
|
|- id="Honey Block"
! scope="row" | [[Honey Block]]
| {{Slot|Honey Block}}
| {{itemLink|Honey Bottle}}
|
* Crafting [[honey bottle]]s
|
|}

== Sounds ==
{{Sound table/Entity/Food}}

== Achievements ==
{{load achievements|Pork Chop;Iron Belly;Rabbit Season;Overpowered;Castaway;Delicious Fish;The Lie;Bake Bread;Time For Stew}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet;A Furious Cocktail;How Did We Get Here;Fishy Business}}

== History ==

{{History|java classic}}
{{History||June 14, 2009|link=https://notch.tumblr.com/post/123343045/my-vision-for-survival|[[Notch]] discussed how food would work in [[survival]] mode: "Monsters will hurt you and take away from your health. The only way to regain health is to eat food. You get food from either hunting or from farming."}}
{{History||0.24_SURVIVAL_TEST|[[Mushroom]]s are now edible, making them the first food to be added in the game. At this point, food restores [[health]] instead of [[hunger]], and are eaten instantly without sound or animation. Pigs drop them upon death.}}
{{History|java indev}}
{{History||0.31|snap=20091231-2|Added [[apple]]s, which are currently non-functional.}}
{{History|||snap=20100110|Apples are now edible, and restore {{hp|4}} each.}}
{{History|||snap=?|Mushrooms are no longer edible.}}
{{History|||snap=20100130|Added [[mushroom stew]], which restores {{hp|8}} health.}}
{{History||20100206|Added [[wheat]] and [[bread]].
|Mushroom stew now restores {{hp|10}} health.}}
{{History||20100219|[[Pig]]s now drop [[raw porkchop]]s, which can be [[smelt]]ed to become [[cooked porkchop]]s.}}
{{History|java infdev}}
{{History||20100227-1|Added [[golden apple]]s. At this point, they were crafted with [[block of gold]], and restored {{hp|20}}.}}
{{History|java alpha}}
{{History||v1.0.8|Added [[milk]], which was at this point unobtainable and the player could not use it in any way.}}
{{History||v1.0.11|Milk can now be obtained in the game, by milking a [[cow]] with an empty [[bucket]].}}
{{History||v1.0.14|With the addition of [[chicken]]s, [[egg]]s are now in the game, but have no use. Chickens do not drop raw chicken at this point in time.}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|Added [[pumpkin]]s, but not pumpkin seeds.
|Added [[raw fish]] and [[cooked fish]], obtainable through [[fishing]].}}
{{History||v1.2.3|Eating food now functions correctly in multiplayer.}}
{{History|java beta}}
{{History||1.2|Added [[sugar]] and [[cake]].}}
{{History||1.4|[[Cocoa beans]] now appear naturally in the game; since Beta 1.2, they were available only through inventory editors.
|Added [[cookie]]s.}}
{{History||1.5|Pigs now drop cooked porkchops if killed while on fire.}}
{{History||1.8|snap=Pre-release|Added [[melon]]s, [[melon seeds]], and [[pumpkin seeds]].
|Added [[raw chicken]] as a drop from chickens, which can be smelted into [[cooked chicken]].
|Added [[raw beef]] as a drop from cows, which can be smelted into [[steak]].
|Added [[rotten flesh]] as a new drop from [[zombie]]s.
|Added an eating animation, instead of food simply disappearing from the player's hand as if a block had been placed.
|Added [[hunger bar]]; now food restores hunger instead of health.
|Food now stacks in the inventory, with the exception of cake, mushroom stew, and milk.
|[[Huge mushroom]]s were added as a new source for [[mushroom]]s.
|With the addition of the hunger bar, golden apples now restore {{Hunger|10}} and give 30 seconds of [[regeneration]], but do not heal health directly anymore.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Mushrooms can now be obtained from the mushroom island [[biome]], via the huge mushrooms, random scattered mushrooms, or the new [[mooshroom]]s.
|[[Milk]] can be used to nullify the effects of [[potion]]s.
|[[Spider]]s now drop [[Spider Eye|eyes]].}}
{{History||1.1|snap=release|Golden apples are now made with [[gold nugget]]s instead of blocks of gold, restore {{Hunger|4}} and give 4 seconds of regeneration.}}
{{History||1.3.1|snap=12w21a|Added enchanted golden apples, which functioned like golden apples prior to 1.1 and had the same crafting recipe, but also gave resistance and fire resistance for 5 minutes each.
|[[Cocoa Beans]] are now a crop, making all food items a renewable resource.}}
{{History||1.4.2|snap=12w34a|[[Potato]]es and [[carrot]]s can be obtainable from zombies (rare drop) or harvested.
|Potatoes can be cooked to make [[baked potato]]es
|Harvesting potatoes may give 0–2 [[poisonous potato]]es.
|Carrots can be crafted into [[golden carrot]]s.
|Added [[pumpkin pie]], making [[pumpkin]]s a food ingredient.}}
{{History||1.7.2|snap=13w36a|Added [[tropical fish (item)|clownfish]], [[Raw Salmon|raw]] and [[cooked salmon]], and [[pufferfish (item)|pufferfish]].}}
{{History||1.8|snap=14w02a|Baked potatoes now restore {{Hunger|5}} hunger points instead of 6, with a corresponding reduction in saturation restored.
|Carrots now restore {{Hunger|3}} hunger points instead of 4, with a corresponding reduction in saturation restored.}}
{{History|||snap=14w27a|Added [[Raw Mutton|raw]] and [[cooked mutton]], [[Raw Rabbit|raw]] and [[cooked rabbit]], and [[rabbit stew]].}}
{{History||1.9|snap=15w31a|Added [[chorus fruit]], [[beetroot]] and [[beetroot soup]].
|Enchanted golden apples are no longer craftable, making them no longer renewable.}}
{{History||1.13|snap=18w07a|Added [[dried kelp]], which is edible.}}
{{History||1.14|snap=18w43a|Added [[suspicious stew]].}}
{{History|||snap=18w49a|Added [[sweet berries]].}}
{{History||1.15|snap=19w34a|Added [[honey bottle]]s.}}
{{History|||snap=19w35a|[[Honey bottle]]s now remove [[poison]] effects when consumed.}}
{{History|||snap=19w46a|All foods can now be consumed in Creative mode, including cake.}}
{{History||1.17|snap=21w05a|Added [[glow berries]].}}


{{History|pocket alpha}}
{{History||v0.4.0|Added the first food items: [[apple]]s, [[bread]], [[mushroom stew]], [[raw beef]], [[steak]], [[raw chicken]], [[cooked chicken]], [[raw porkchop]]s, and [[cooked porkchop]].}}
{{History||v0.5.0|Added [[melon]]s, [[melon slice]]s, and [[melon seeds]].}}
{{History||v0.7.0|Added [[milk]] and [[cake]].}}
{{History||v0.8.0|snap=build 1|Added [[pumpkin pie]], [[carrot]]s, [[potato]]es, and [[baked potato]]es.}}
{{History|||snap=build 2|Added [[beetroot]]s and [[beetroot soup]].}}
{{History||v0.9.0|snap=build 1|[[Potato]]es and [[carrot]]s can be obtainable from zombies (rare drop) or harvested.
|Added [[cookie]]s.}} 
{{History||v0.11.0|snap=build 1|Added [[rotten flesh]] as a new drop from [[zombie]]s, at this time, it inflicts poison.
|Added [[Raw Fish|raw]] and [[cooked fish]], [[clownfish]], [[Raw Salmon|raw]] and [[cooked salmon]], and [[pufferfish]].}}
{{History|||snap=build 4|[[Milk]] can be used to nullify the effects of [[potion]]s.}}
{{History||v0.12.1|snap=build 1|Eating food now restores hunger.
|[[Spider]]s now drop [[Spider Eye|eyes]].
|Added poisonous potatoes, golden apples, enchanted golden apples and golden carrots.}}
{{History||v0.13.0|snap=build 1|Hunger restored by food now matches Minecraft PC.
|Added raw rabbit, cooked rabbit, and [[rabbit stew]].}}
{{History||v0.15.0|snap=build 1|Added raw mutton and cooked mutton.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added chorus fruit.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Added [[dried kelp]], which is edible.}} 
{{History||1.7.0|snap=beta 1.7.0.2|Food can now be eaten in creative mode and on peaceful difficulty.}}
{{History||1.10.0|snap=beta 1.10.0.3|Added [[sweet berries]].}}
{{History||1.13.0|snap=beta 1.13.0.9|Added [[suspicious stew]].}}
{{History||1.14.0|snap=beta 1.14.0.1|Added [[honey bottle]].}}
{{History||1.17.0|snap=beta 1.16.220.52|Added [[glow berries]].}}
{{History|foot}}

{{items}}

[[Category:Food]]

[[cs:Potraviny]]
[[de:Hunger]]
[[es:Comida]]
[[fr:Nourriture]]
[[hu:Étel]]
[[it:Cibo]]
[[ja:食料]]
[[ko:식료품]]
[[nl:Voedsel]]
[[pl:Jedzenie]]
[[pt:Alimento]]
[[ru:Еда]]
[[th:อาหาร]]
[[uk:Їжа]]
[[zh:食物]]</li></ul></nowiki>
19w05aAdded the wandering trader.
19w06aWandering traders will now drink invisibility potions at dusk and milk buckets at dawn.
19w09aAdded two new sounds for wandering traders when they drink invisibility potions and milk.
Upcoming Bedrock Edition
1.10.0
{{Extension DPL}}<ul><li>[[Cooked Salmon|Cooked Salmon]]<br/>{{Dungeons hatnote|type=consumable}}
{{Item
| title = Cooked Salmon
| image = Cooked Salmon.png
| renewable = Yes
| heals = {{hunger|6}}
| stackable = Yes (64)
}}
'''Cooked salmon''' is a [[food]] item obtained by cooking [[raw salmon]].

== Obtaining ==

=== Mob loot ===

====Salmon====
[[Salmon]] always drops 1 raw salmon when killed, unaffected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref> If it is killed while on [[fire]], it drops 1 [[Cooked Salmon|cooked salmon]] instead.
====Guardians and elder guardians====
[[Guardian|Guardians]] and [[Elder Guardian|elder guardians]] have a 2.5% chance to drop a random fish, with 25% of them being raw salmon, which drops as cooked if the guardian was on fire. The chance of getting the fish drop is increased by 1% per level with [[Looting]] (for a maximum of 5.5% with Looting III), but the type of fish is not affected.
====Polar bears ====
[[Polar bear]]s have a 25% chance of dropping 0–2 raw salmon when killed. The maximum amount can be increased by 1 per level of Looting, for a maximum of 0-5 with Looting III. If killed while on fire, they drop cooked salmon instead.
=== Cooking ===

Cooked salmon can be obtained by cooking raw salmon in a [[furnace]], [[smoker]], or on a [[campfire]]. Each piece of cooked salmon removed from a furnace output slot gives 0.35 [[experience]] (22.4 experience per stack).

{{smelting|Raw Salmon|Cooked Salmon|0,35}}

=== Chest loot ===
{{LootChestItem|cooked-salmon}}

=== Trading ===

Apprentice-level fishermen villagers have a 50%{{only|bedrock}} or {{frac|2|3}}{{only|java}} chance to sell 6 cooked salmon for 6 raw salmon and an [[emerald]].

== Usage ==

=== Food ===

To eat cooked salmon, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|6}} and 9.6 [[Hunger#Mechanics|saturation]], the same as [[cooked mutton]].

=== Wolves ===

{{IN|Bedrock}}, cooked salmon can be fed to [[wolves]] only if they are not at full health, healing them by {{hp|6|mob=1}}. Cooked salmon does not accelerate the growth of baby wolves and cannot be used to [[breed]] them.

==Sounds==
{{Sound table/Entity/Food}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Cooked Salmon
|spritetype=item
|nameid=cooked_salmon
|itemtags=fishes
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Cooked Salmon
|spritetype=item
|nameid=cooked_salmon
|id=269
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Lion Hunter}}

== Advancements ==
{{load advancements|Husbandry;A Balanced Diet;Fishy Business}}

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

== History ==

{{History|java}}
{{History||1.7.2|snap=13w36a|[[File:Cooked Salmon JE1 BE1.png|32px]] Added cooked salmon.}}
{{History||1.8|snap=14w02a|Cooked salmon can no longer be [[trading|traded]] by [[villager]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>cooked_fish</code> IDs have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 349 and 250.}}
{{History|||snap=18w08b|Salmon has been added as a [[mob]], which drops raw salmon when killed (cooked while on [[fire]]).
|[[File:Cooked Salmon JE2 BE2.png|32px]] The texture of cooked salmon has been changed.}}
{{History|||snap=18w10a|Cooked salmon now generates in [[buried treasure]] [[chest]]s.}}
{{History|||snap=19w11a|Fisherman [[villager]]s can now convert raw salmon to cooked salmon, if [[trading|paid]] with emeralds.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Cooked Salmon JE1 BE1.png|32px]] Added cooked salmon.}}
{{History||v0.12.1|snap=build 1|Salmon now restores [[hunger]] instead of [[health]].}}
{{History||v0.16.0|snap=build 1|Salmon is now dropped by [[guardian]]s and [[elder guardian]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Salmon has been added as a [[mob]], which drops raw salmon when killed (cooked while on [[fire]]).
|[[File:Cooked Salmon JE2 BE2.png|32px]] The texture of cooked salmon has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Cooked salmon can now be obtained from [[trading]] with fishermen [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.52|Salmon now drops cooked salmon when killed on [[fire]].}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Cooked Salmon JE1 BE1.png|32px]] Added cooked salmon.}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Cooked Salmon JE2 BE2.png|32px]] The texture of cooked salmon has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Cooked Salmon JE1 BE1.png|32px]] Added cooked salmon.}}
{{History|foot}}

== Issues ==

{{issue list}}

== See also ==

* [[Fishing]]
* [[Cooked Cod]]

{{items}}

[[Category:Food]]
[[Category:Renewable resources]]

[[de:Gebratener Lachs]]
[[es:Salmón ahumado]]
[[pt:Salmão assado]]
[[ko:익힌 연어]]
[[zh:熟鲑鱼]]
[[ru:Жареный лосось]]</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|}}

=== 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>
beta 1.10.0.3Added the wandering trader, which is only available through Experimental Gameplay.
1.11.0
{{Extension DPL}}<ul><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}

'''Sugar cane''' is a block found as 1–4-block-tall. It plants near water in the [[Overworld]]. As an item, it is an important crafting ingredient.

==Obtaining==
Sugar cane can be mined instantly with anything.

When the spot a sugar cane block is placed in becomes unsuitable, such as when the supporting block is removed, the sugar cane block uproots and drops as an item. {{IN|be}}, sugar cane uproots immediately after all adjacent water is removed. {{IN|je}}, sugar cane uproots on the next block update or [[Tick#Random tick|random tick]].

A sugar cane block drops itself as an item if a piston tries to push it (trying to pull it does nothing) or moves a block into its space.

===Natural generation===
[[File:Sugar Canez.png|thumb|250px|Naturally-occurring sugar cane near a river.]]
Sugar cane can generate naturally near [[water]] and [[ice]], as two ({{frac|11|18}} chance), three ({{frac|5|18}} chance), or four ({{frac|2|18}} chance) blocks tall. Rare taller sugar canes can be found if the world generator places two smaller canes on top of each other. It generates in approximately 0.8 sugar cane per chunk seeing as how they only generate near bodies of water.

Sugar canes attempt to generate 10 times in any Overworld biome, which requires water. An extra 10 attempts are made in [[swamp]] biomes, and 50 in [[desert]] biomes, which makes sugar cane twice as frequent in swamps and six times as frequent in desert biomes, making the banks of [[river]]s that cut through deserts lined with sugar canes.

Sugar cane cannot generate in caves {{in|je}}.<ref>{{bug|MC-214959||Sugar cane generated in cave|Fixed}}</ref>

===Trading===
[[Wandering trader]]s can sell sugar cane for an [[emerald]].

==Usage==
Due to its water-displacing properties, sugar cane can interestingly be used to create underwater paths, allowing [[player]]s to move at normal speed and breathe if it is two blocks in height.{{only|java}}<ref>{{bug|MC-929||Sugar cane can be placed underwater|WAI}}</ref>

Sugar cane takes on a different shade of green depending on the biome in which it is placed.

===Crafting ingredient===
{{crafting usage}}

===Farming===
{{main|Tutorials/Sugar cane farming}}
[[File:Underground Sugar Farm.png|200px|thumb|An underground sugar cane farm.]]

Sugar cane can generate naturally up to any number of blocks tall, but ''grow'' only to a height of three blocks, adding a block of height when the top sugar cane block has received 16 random [[Tick#Block tick|block tick]]s (i.e. on average every 18 minutes on ''Java Edition''<!-- Average 68.27 seconds/tick * 16 ticks/growth = 18.2 minutes --> or 54 minutes on Bedrock Edition, but the actual rate can vary widely). 
Sugar cane must be planted on a [[grass block]], [[dirt]], [[coarse dirt]], [[rooted dirt]], [[podzol]], [[mycelium]], [[sand]], [[red sand]], [[suspicious sand]], [[moss block]], or [[mud]] that is directly adjacent to [[water]], [[waterlogged]] block, or [[frosted ice]] (not merely above or diagonal to water), or on top of another sugar cane block. The adjacent water block can be covered with another block, whether [[opacity|opaque or transparent]], and sugar cane can still be placed and grow next to it. Sugar cane grows regardless of light level, even in complete darkness.
[[File:4blockcane.png|thumb|A natural 4-block-high sugar cane plant.]]
{{IN|bedrock}}, [[bone meal]] can be used to instantly grow sugar cane to three blocks. Only one bone meal is consumed. {{IN|java}}, bone meal cannot be used on sugar cane.<ref>{{bug|MC-73963||Can't use bonemeal on cacti or sugar cane|WAI}}</ref>

On average, it takes [[Tutorials/Sugar_cane_farming#Mechanics|18 minutes]] for a single block of sugar cane to grow 3 blocks tall.

=== Composting ===
Placing sugar cane into a [[composter]] has a 50% chance of raising the compost level by 1.

== List of colors ==
{{Missing information|Bedrock Edition colors (see [[Water#Color]]{{verify|it's there?}})}}

=== ''Java Edition'' ===
These values are generated by the biome dyeing algorithm. See [[Color#Biome colors|Biome colors]] for more information.
<div class="mw-collapsible mw-collapsed" style="float: left">
{| class="wikitable sortable" style="text-align:center" data-description="Java edition biome colors"
!Biome !! Category !! Rainfall !! Sugarcane Color !! Temperature Affects !! Render
|-
| {{BiomeLink|Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Beach}} || Beach || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Birch Forest}} || Forest || Rain || #88bb67 || || [[File:Birch Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Cold Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Dark Forest}} || Forest || Rain || #507a32 || || [[File:Dark Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Cold Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Frozen Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Lukewarm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Deep Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Desert}} || Desert || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Barrens}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Highlands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|End Midlands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Eroded Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Flower Forest}} || Forest || Rain || #79c05a || || [[File:Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Forest}} || Forest || Rain || #79c05a || || [[File:Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|Frozen Ocean}} || Ocean || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Frozen River}} || River || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Spruce Taiga}} || Taiga || Rain || #86b783 || || [[File:Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Pine Taiga}} || Taiga || Rain || #86b87f || || [[File:Old Growth Pine Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Ice Spikes}} || Icy || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Jungle}} || Jungle || Rain || #59c93c || || [[File:Jungle Sugar Cane.png|32px]]
|-
| {{BiomeLink|Sparse Jungle}} || Jungle || Rain || #64c73f || || [[File:Sparse Jungle Sugar Cane.png|32px]]
|-
| {{BiomeLink|Lukewarm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Hills}} || Extreme Hills || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|-
| {{BiomeLink|Mushroom Fields}} || Mushroom || Rain || #55c93f || || [[File:Mushroom Fields Sugar Cane.png|32px]]
|-
| {{BiomeLink|Nether}} || Nether || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Plains}} || Plains || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|River}} || River || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Savanna}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Savanna Plateau}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Savanna}} || Savanna || No || #bfb755 || || [[File:Desert Sugar Cane.png|32px]]
|-
| {{BiomeLink|Small End Islands}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Beach}} || Beach || Snow || #83b593 || || [[File:Snowy Beach Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Taiga}} || Taiga || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Snowy Plains}} || Icy || Snow || #80b497 || || [[File:Snowy Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Stony Shore}} || None || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|-
| {{BiomeLink|Sunflower Plains}} || Plains || Rain || #91bd59 || || [[File:Plains Sugar Cane.png|32px]]
|-
| {{BiomeLink|Swamp}} || Swamp || Rain || #6A7039 || If temperature below -0.1, used #4C763C. || [[File:Swamp Sugar Cane.png|32px]] / [[File:Swamp Sugar Cane (Cold).png|32px]]
|-
| {{BiomeLink|Taiga}} || Taiga || Rain || #86b783 || || [[File:Taiga Sugar Cane.png|32px]]
|-
| {{BiomeLink|Old Growth Birch Forest}} || Forest || Rain || #88bb67 || || [[File:Birch Forest Sugar Cane.png|32px]]
|-
| {{BiomeLink|The End}} || The End || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|The Void}} || None || No || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Warm Ocean}} || Ocean || Rain || #8eb971 || || [[File:Ocean Sugar Cane.png|32px]]
|-
| {{BiomeLink|Wooded Badlands}} || Mesa || No || #90814d || No || [[File:Badlands Sugar Cane.png|32px]]
|-
| {{BiomeLink|Windswept Forest}} || Extreme Hills || Rain || #8ab689 || || [[File:Windswept Hills Sugar Cane.png|32px]]
|}
</div>
{{clear}}
=== Bedrock Edition ===
{{empty section}}

== Sounds ==
{{Sound table/Block/Grass}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Sugar Cane
|spritetype=block
|nameid=sugar_cane
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Sugar Cane
|shownumericids=y
|showforms=y
|showaliasids=y
|generatetranslationkeys=y
|displayname=Block
|spritename=sugar-cane
|spritetype=block
|nameid=reeds
|id=83
|form=block
|itemform=item.reeds}}
{{ID table
|displayname=Item
|spritename=sugar-cane
|spritetype=item
|nameid=sugar_cane
|id=385
|form=item
|aliasid=reeds
|translationkey=item.reeds.name
|foot=1}}

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

{{/BS}}

== Video ==
{{Video note|This video was made before sugar cane had a different shade of green depending on the biome.|minor}}
<div style="text-align:center">{{yt|zlOnwn3PH5o}}</div>

== History ==
{{more images|Appearance when affected by {{bug|MC-48831}}}}
{{History|java alpha}}
{{History||v1.0.11|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added reeds in the [[Seecret Updates|Seecret Friday Update 6]].
|Reeds are informally referred to as "bamboo" or "papyrus" by many [[player]]s. 
|Since reeds can be washed away with [[water]] currents or instantly destroyed by removing the water adjacent to them, automated reed farms can be made. 
|Reeds can be used to craft [[paper]].}}
{{History|java beta}}
{{History||1.2|[[Notch]] has [[wikipedia:Retroactive continuity|retconned]] reeds into sugar cane so that it can now be [[crafting|crafted]] into [[sugar]], included in the recipe for the [[cake]]s.}}
{{History||1.6|snap=Test Build 3|[[Arrow]]s no longer stick to sugar cane, and instead, they pass through. However, [[snowball]]s still come into contact with any sugar cane blocks, as if they are solid.}}
{{History||1.8|snap=Pre-release|Sugar cane can now grow and be placed onto [[sand]] as long as they are adjacent to [[water]]. This update allows sugar canes to appear next to [[water]] ponds in [[desert]] biomes.
|Sugar cane is now available in the [[creative]] [[inventory]] in both block and item forms.}}
{{History|java}}
{{History||1.0.0|snap=?|The sugar cane block has been removed from the creative inventory.}}
{{History||1.7.2|snap=13w36a|[[File:Sugar Cane JE2 BE2.png|32px]] Sugar cane is now [[tint]]ed depending on the [[biome]] it's in.
|The item texture remained unchanged, however, and still used the color palette from Alpha to 1.6.4.<ref name="Bug">{{bug|MC-216227}}</ref>}}
{{History||1.9|snap=15w43a|Sugar cane no longer breaks if its adjacent [[water]] is turned to [[frosted ice]].}}
{{History||1.13|snap=17w47a|The ID of sugar cane has now been changed from <code>reeds</code> to <code>sugar_cane</code>.
|"Sugar Canes" have now been renamed to "Sugar Cane".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 83, and the [[item]]'s 338.}}
{{History||1.14|snap=18w43a|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane item has been changed.}}
{{History|||snap=19w03a|Placing sugar cane into a [[composter]] has a 20% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Sugar cane now has a 50% chance of increasing the compost level in a composter by 1.
|Added [[wandering trader]]s, which sell sugar cane.}}
{{History||1.16|snap=20w13a|Sugar cane has been moved from the Miscellaneous tab to the Decoration Blocks tab in the [[Creative inventory]].<ref name="misc decoration">https://bugs.mojang.com/browse/MC-174434</ref>}}
{{History||1.17|snap=21w11a|[[File:Sugar Cane (item) JE3.png|32px]] The texture of the sugar cane item has been changed, so that it actually matches the color it uses when placed again.<ref name="Bug"/>}}
{{History|||snap=Pre-release 1|Sugar cane now generates in mushroom fields.<ref>{{bug|MC-226683}}</ref>}}
{{History||1.19|snap=22w15a|Sugar cane can now be planted on mud.}}
{{History||1.20|snap=23w14a|Sugar cane can now be planted on [[suspicious sand]].}}

{{History|pocket alpha}}
{{History||Pre-release|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar cane.}}
{{History||v0.2.0|Despite being visible in the inventory, sugar cane does not drop anything when mined, making it unobtainable in Survival mode.}}
{{History||v0.2.1|Survival players now start with an infinite stack of sugar cane in the inventory.}}
{{History||v0.3.0|Sugar cane now drops its item form when mined.
|Survival players no longer start with an infinite stack of sugar cane in the inventory.}}
{{History||v0.5.0|Sugar cane can now be grown on [[sand]].
|Sugar cane can now be obtained after activating the [[nether reactor]].}}
{{History||v0.8.0|snap=build 5|[[Bone meal]] can now grow sugar cane to maximum height.}}
{{History||v0.9.0|snap=build 1|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar cane now changes depending on the [[biome]] they are in.
|Using bone meal on sugar cane is no longer able to break blocks above it.}}
{{History||v0.12.1|snap=build 1|Sugar cane is no longer available from the [[nether reactor]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Sugar Cane JE1 BE1.png|32px]] Due to a bug, sugar canes no longer change color depending on the [[biome]].}}
{{History|bedrock}}
{{History||1.2.13|snap=beta 1.2.13.5|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar canes now changes depending on the [[biome]], once again.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane [[item]] has been changed.
|Sugar cane can now be [[trading|bought]] from [[wandering trader]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Sugar canes can now be used to fill up [[composter]]s.}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Sugar Cane (item) JE3.png|32px]] The texture of the sugar cane item has been changed, so that it actually matches the color it uses when placed again.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar canes.
|Sugar canes are solid, making it useful for growable walls. Unlike on Java Edition, they were never renamed to Sugar Cane.}}
{{History||xbox=TU2|Sugar canes are no longer solid, and arrows pass through them.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Sugar Cane JE2 BE2.png|32px]] The color of sugar cane now changes depending on the [[biome]] they're in.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|Sugar cane can now be grown with [[bonemeal]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Sugar Cane (item) JE2 BE2.png|32px]] The texture of the sugar cane [[item]] has been changed.}}
{{History||xbox=none|xbone=none|ps=1.91|wiiu=none|switch=none|Sugar cane can now be [[trading|bought]] from [[wandering trader]]s.
|Sugar canes can now be used to fill up [[composter]]s.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Sugar Cane JE1 BE1.png|32px]] [[File:Sugar Cane (item) JE1 BE1.png|32px]] Added sugar cane.}}
{{History|foot}}

=== Sugar cane "item" ===
{{:Technical blocks/Sugar Cane}}

== Issues ==
{{Issue list}}

== Trivia ==
*When a sugar cane is broken at the second level, the time resets (for example, if a two-block high sugar cane is broken, but is just about to grow to the third stage, it would reset that time).
*By placing more sugar canes on top of a sugar cane plant, it is possible to create tall sugar canes (up to y=319, the maximum height for building), although they do not naturally grow this high.
*Before sugar cane received an official name, they were sometimes referred to as [[bamboo]], a block added 9 years later. Other names were "reeds" and "papyrus".

== Gallery ==
=== Renders ===
<gallery>
Plains Sugar Cane.png|Plains
Taiga Sugar Cane.png|Taiga
Snowy Plains Sugar Cane.png|Snowy plains
Jungle Sugar Cane.png|Jungle
Desert Sugar Cane.png|Desert
Swamp Sugar Cane (Cold).png|Swamp (cold)
Swamp Sugar Cane.png|Swamp
Badlands Sugar Cane.png|Badlands
</gallery>

=== In-game ===
<gallery>
Huge Sugar Farm.png|A large sugar cane farm using 2×2 [[water]] holes.
Sugar Cane Waterfall.png|Water flowing over sugar cane.
UnderwaterSugarCane.png|Naturally generated sugar cane found underwater.
Sugar and Cactus.png|A [[cactus]] and sugar cane stalk generated next to each other.
SugarCaneRavine.png|Sugar cane found in the [[ravine]].
Reeds in Winter mode.png|Reeds generated in the [[winter mode]].
Sugar Cane Naturally Growing.png|Sugar cane growing between [[biome]]s.
Mesa Sugar Cane.jpg|Sugar cane growing on [[red sand]] in a [[badlands]] biome.
Sugarcanenowaterglitch.png|Sugar cane generated without a water source.
SwampCane.png|Sugar cane generated in a [[swamp]] biome.
Sugar cane savanna.png|Sugar cane growing in a [[savanna]] biome.
ForestSugarcane.png|Sugar cane growing in a [[forest]] biome.
Lava cane.png|Sugar cane growing with lava flowing around it.
Before breaking.png|Sugar canes few seconds before breaking because the water is frozen.
Undergroundreed.png|A sugar cane plant that generated in an underground [[water lake]].
Cave Sugar.png|Another example.
</gallery>

=== Heights ===
<gallery>
Tall Sugar Cane.png|Four-block tall sugar cane.
4RiverCane.png|Four-block tall sugar cane.
4-block tall sugar cane.png|Four-block tall sugar cane in a [[plains]] biome.
</gallery>

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li><li>[[Redstone Comparator|Redstone Comparator]]<br/>{{Block
| image = 
| image2 = 
| transparent = Yes
| light = No
| tool = any
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = No
| group = Redstone Comparator
| group2 = Subtracting
| group3 = Powered
| group4 = Powered+Subtracting
| 1-1 = Redstone Comparator.png
| 2-1 = Subtracting Redstone Comparator.png
| 3-1 = Powered Redstone Comparator.png
| 4-1 = Powered Subtracting Redstone Comparator.png
}}
{{Many images}}
A '''redstone comparator''' is a [[block]] that can produce an [[Redstone Dust|output signal]] from its front by reading [[chest]]s, [[lectern]]s, [[beehive]]s and similar blocks, or repeat a signal without changing its strength. It can also be set to either stop outputting a signal when its side input recieves a stronger one (front torch off), or subtract its side input's signal strength from its output (front torch on).

== Obtaining ==
=== Natural generation ===
Redstone comparators generate in [[Ancient City|ancient cities]].

=== Breaking ===
A redstone comparator can be broken instantly with any [[tool]], or by hand, and drops itself as an item.

{{Breaking row|Redstone Comparator|horizontal=y}}

A redstone comparator is removed and dropped as an item if:
* its attachment block is moved, removed, or destroyed;
* [[water]] flows into its space;{{only|java}}
* a [[piston]] tries to push it or moves a block into its space.

If [[lava]] flows into a redstone comparator's space, the redstone comparator is destroyed without dropping as an item.

=== Crafting ===
{{Crafting
|B1=Redstone Torch
|A2=Redstone Torch
|B2=Nether Quartz
|C2=Redstone Torch
|A3=Stone
|B3=Stone
|C3=Stone
|Output= Redstone Comparator
|type=Redstone
}}

== Usage ==
A redstone comparator can be placed on the top of any [[opaque]] block with a solid full-height top surface (including upside-down [[slab]]s and upside-down [[stairs]]). {{IN|be}}, a comparator can also be placed on [[wall]]s and fences. For more information about placement on transparent blocks, see [[Opacity/Placement]].

The redstone comparator has a front and a back — the arrow on the top of the comparator points to the front. When placed, the comparator faces away from the player. The comparator has two miniature redstone torches at the back and one at the front. The back torches turn on when the comparator's output is greater than zero (the arrow on top also turns red). The front torch has two states that can be toggled by {{control|using}} the comparator:
* Down and unpowered (indicating the comparator is in "comparison mode")
* Up and powered (indicating the comparator is in "subtraction mode")

The redstone comparator can take a signal strength input from its rear as well as from both sides. Side inputs are accepted only from [[redstone dust]], [[block of redstone]], [[redstone repeater]]s, other comparators, and [[observer]]s in specific scenarios. The redstone comparator's front is its output.

It takes 1 [[redstone tick]] (2 game ticks, or 0.1 seconds barring lag) for signals to move through a redstone comparator, either from the rear or from the sides. This applies to changing signal strengths as well as simply to turning on and off. 

Redstone comparators check their power state before their scheduled ticks update. This results in redstone comparators not usually responding to 1-tick fluctuations of power or signal strength — for example, a [[clock circuit|1-clock]] input is treated as always off from the side, and always on from the rear. This happens because the signal changes back to its original state before the redstone comparator checks its input states. However, certain setups such as powering any input with two separate observer pulses at the same time will cause a redstone comparator to respond to 2 gametick pulses.

The redstone comparator has four functions: maintain signal strength, compare signal strength, subtract signal strength, and measure certain block states (primarily the fullness of containers).

=== Maintain signal strength ===
A redstone comparator with no powered sides outputs the same signal strength as its rear input.

=== Compare signal strength ===
[[File:Comparators Explained.png|Comparators in comparison mode.|thumb]]
A redstone comparator in comparison mode (front torch down and unpowered) compares its rear input to its two side inputs. If either side input is greater than the rear input, the comparator output turns off. If neither side input is greater than the rear input, the comparator outputs the same signal strength as its rear input.

The formula for calculating the output signal strength is as follows:

<code>output = rear × [[Wikipedia:Iverson bracket|[]]'''''left''''' ≤ '''''rear''''' AND '''''right''''' ≤ '''''rear'''''[[Wikipedia:Iverson bracket|<nowiki>]]]</code>
{{-}}

=== Subtract signal strength ===
[[File:Redstone comparator.png|thumb|The greatest of the side inputs A and C is subtracted from the rear input B, outputting 1. If either A or C were greater than B, it would output 0.]]
A redstone comparator in subtraction mode (front torch up and powered) subtracts the signal strength of the higher side input from the signal strength of the rear input.

<code>output = max('''''rear''''' − max('''''left''', '''right'''''), 0)</code>

For example: if the signal strength is 6 at the left input, 7 at the right input and 4 at the rear, the output signal has a strength of ''max(4 − max(6, 7), 0) = max(4−7, 0) = max(−3, 0) = 0''.

If the signal strength is 9 at the rear, 2 at the right input and 5 at the left input, the output signal has a strength of ''max(9 − max(2, 5), 0) = max(9−5, 0) = 4''.

=== Measure block state ===
{{Schematic | caption = A redstone comparator can measure the fullness of a chest, as well as other block states, even through an opaque block.
 |rd-ew!|rc-w!|ch|SB|rc-e!|rd-ew!
}}
A redstone comparator treats certain blocks behind it as power sources and outputs a signal strength proportional to the block's state. The comparator may be separated from the measured block by an opaque block. However, {{in|je}}, if the opaque block is powered to signal strength 15, then the comparator outputs 15 no matter the fullness of the container.<ref>{{bug|MC-64394}} (resolved as "Works As Intended")</ref>
[[Category:Java Edition specific information]]
{{-}}

==== Fullness of containers ====
{| class="wikitable floatright" style="margin-left: 0.5em; margin-right: 0; text-align: center;"
|+ Minimum Items for Container Signal Strength
|-
!Containers
!{{BlockSprite|Furnace|link=Furnace}}<br>{{BlockSprite|Blast Furnace|link=Blast Furnace}}<br>{{BlockSprite|Smoker|link=Smoker}}
!{{BlockSprite|Hopper|link=Hopper}}<br>{{EntitySprite|Minecart with Hopper|link=Minecart with Hopper}}<br>{{BlockSprite|Brewing Stand|link=Brewing Stand}}
!{{BlockSprite|Dispenser|link=Dispenser}}<br>{{BlockSprite|Dropper|link=Dropper}}
!{{BlockSprite|Chest|link=Chest}}<br>{{EntitySprite|Minecart with Chest|link=Minecart with Chest}}<br>{{BlockSprite|Shulker Box|link=Shulker Box}}<br>{{BlockSprite|Barrel|link=Barrel}}
![[Double Chest|{{Schematic|size=16|ch-s|-|ch-n}}
]]
!{{BlockSprite|Jukebox|link=Jukebox}}
|-
!Total Slots
!3!!5!!9!!27!!54!!1
|-
!Power Level
! colspan="5" |Number of Items
!Music Disc
|-
|0||0||0||0||0||0||No disc
|-
|1||1||1||1||1||1||"13"
|-
|2||14||23||42||1s 60||3s 55||"cat"
|-
|3||28||46||1s 19||3s 55||7s 46||"blocks"
|-
|4||42||1s 5||1s 60||5s 51||11s 37||"chirp"
|-
|5||55||1s 28||2s 37||7s 46||15s 28||"far"
|-
|6||1s 5||1s 51||3s 14||9s 42||19s 19||"mall"
|-
|7||1s 19||2s 10||3s 55||11s 37||23s 10||"mellohi"
|-
|8||1s 32||2s 32||4s 32||13s 32||27s||"stal"
|-
|9||1s 46||2s 55||5s 10||15s 28||30s 55||"strad"
|-
|10||1s 60||3s 14||5s 51||17s 23||34s 46||"ward"
|-
|11||2s 10||3s 37||6s 28||19s 19||38s 37||"11"
|-
|12||2s 23||3s 60||7s 5||21s 14||42s 28||"wait"
|-
|13||2s 37||4s 19||7s 46||23s 10||46s 19||"Pigstep"
|-
|14||2s 51||4s 42||8s 23||25s 5||50s 10||"Otherside"<br>"Relic"
|-
|15||3s||5s||9s||27s||54s||"5"
|}
A redstone comparator can output a signal indicating how full a container is. (0 for empty, 15 for full, etc.) The table on the right is described more in detail, later in this section.

Containers that can be measured by a comparator include:
* {{BlockLink|Furnace}}
* {{BlockLink|Blast Furnace}}
* {{BlockLink|Smoker}}
* {{BlockLink|Brewing Stand}}
* {{BlockLink|Hopper}}
* {{ItemLink|Minecart with Hopper}} on top of a [[detector rail]]
* {{BlockLink|Dispenser}}
* {{BlockLink|Dropper}}
* {{BlockLink|Chest}}
* {{BlockLink|Trapped Chest}}
* {{ItemLink|Minecart with Chest}} on top of a [[detector rail]]
* {{BlockLink|Barrel}}
* {{SchematicSprite|size=16|ch-e}}{{SchematicSprite|size=16|ch-w}} Large chest
* {{SchematicSprite|size=16|ch-e}}{{SchematicSprite|size=16|ch-w}} Large trapped chest
* {{BlockLink|Shulker Box}} (any color)

Generally speaking, the comparator output signal strength represents the average fullness of the slots, based on how many of that item form a full stack (64, 16, or 1 for non-stackable items).

The ''Minimum Items for Container Signal Strength'' table (right) shows the minimum '''''full-stack-equivalent (FSE)''''' to produce different signal strengths from common containers. A '''''full-stack-equivalent''''' quantifies how many normal 64-stackable items are needed to output a corresponding signal strength. The 's' is a constant 64, with the additional amount needed following after.

One may also consider the terms: '''c''umulative-weight''''' or '''''weighted-sum''''' instead of '''''full-stack-equivalent'''''.

Items that stack to a max of 16  ([[snowball]]s, [[sign]]s, [[ender pearl]]s, etc.), contribute +4 to the ''full-stack-equivalent'' for each unity (count of 1 item). Similarly, items that stack to 1 ([[minecart]], [[boat]], etc.) contribute +64, and items that stack to 64 contribute +1.

Example 1: 3 ender pearls will contribute a 3 x 4 = 12 ''full-stack-equivalent''.

Example 2: 16 ender pearls and 60 redstone dust contributes a 16x4 + 60x1 = 124 ''full-stack-equivalent''.

Example 3: 1 minecart and 60 redstone dust contributes a 1x64 + 60x1 = 124 ''full-stack-equivalent''.

Example 4: To produce a signal strength of 10 from a hopper, one requires a ''full-stack-equivalent'' of at least 3s + 14 = 206 but strictly less than than 3s + 37 = 229. This can be done with 3 minecarts, and 14 dirt.

When a comparator measures a large chest or large trapped chest, it measures the entire large chest (54 slots), not just the half directly behind the comparator. A chest or trapped chest that cannot be opened (either because it has an opaque block, [[ocelot]], or [[cat]] above it) always produces an output of 0 no matter how many items are in the container — shulker boxes can always be measured, even if they cannot open.

;Calculating signal strength from items

:When a container is empty, the output is off.

:When it is not empty, the output signal strength is calculated as follows:

:<code>'''''signal strength''''' = floor(1 + (('''''sum of all slots' fullnesses''''') / ('''''number of slots in container''''')) × 14)</code>

:<code>fullness of a slot = '''''number of items in slot''''' / '''''max stack size for this type of item'''''</code>

:''Example:'' 300 blocks in a dispenser (which has 9 slots), where each block stacks to a maximum of 64 has a 300 ''full-stack-equivalent.'' This produces an output with a signal strength of 8:
<blockquote>
1 + ((300 items / 64 items per slot) / 9 slots) × 14 = 8.292, floored is 8
</blockquote>

;Calculating items from signal strength

:It can be useful in redstone circuits to use containers with comparators to create signals of a specific strength. The number of items required in a container to produce a signal of desired strength is calculated as follows:

:<code>items required = max('''''desired signal strength''''', roundup(('''''total slots in container''''' × 64 / 14) × (desired signal strength − 1)))</code>

:''Example:'' To use a furnace (which has 3 slots) to create a strength 9 signal, players need 110 items:
<blockquote>
max(9, (3×64/14) × (9−1)) = 109.714, rounded up is 110
</blockquote>
{{-}}

==== Miscellaneous ====
[[File:Comparator storage.png|Comparators used to measure containers.|thumb]]
Some non-container blocks can also be measured by a redstone comparator:

;{{BlockLink|Beehive}} and {{BlockLink|Bee nest}}

: A hive or nest outputs a signal strength equal to the amount of honey in the hive/nest.

;{{BlockLink|Cake}}

: A cake outputs a signal strength relative to the amount of cake remaining.  Each slice is worth 2 signal strength, with 7 total slices, for an output of 14 for a full cake.

[[File:Cauldron Redstone Strength Values.png|Cauldron signal strength|thumb]]
;{{BlockLink|Cauldron}}

: A cauldron outputs different signal strengths depending on how much water or powdered snow is inside. From completely empty to completely full, the output values are 0, 1, 2, and 3. If lava or powder snow is inside, the strength is always 3.

[[File:Composter Redstone Strength Values.png|Composter signal strength|thumb]]
;{{BlockLink|Composter}}

: A composter outputs different signal strengths depending on the level inside. From completely empty to completely full, the output values are 0, 1, 2, 3, 4, 5, 6, 7 and 8.

;{{Anchor|CommandBlock}}{{BlockLink|Command Block}}

: A command block stores the "success count" of the last command executed, which represents the number of times the most recently used command of this command block succeeded. A "success" is defined by the [[command]]'s success conditions: if a red error message is returned in the chat, the command was not successful.

: Most commands can succeed once per execution, but certain commands (such as those that accept players as arguments) can succeed multiple times, and the comparator outputs the number of times it succeeded (maximum 15 when sent to redstone dust, but in the code it is able to go up to the 32-bit integer limit, and can be used in contraptions with no redstone dust with those values).

: A command block continues to store the success count of the last command executed until it executes its command again, thus the comparator continues to output the same signal strength even after the command block is no longer being activated (it doesn't turn off when the signal to the command block turns off).

;{{BlockLink|End Portal Frame}}

: An end portal frame outputs a full signal of 15 if it contains an [[eye of ender]] and zero otherwise.

[[File:Item frame and comparator.png|A comparator can measure the presence and rotation of an item frame's contents.|thumb]]

;{{EntityLink|Item Frame}}

: A comparator can measure the state of an [[item frame]]'s contents. An item frame comparator outputs 0 if the item frame is empty, or 1 to 8 for any item depending on its rotation: 1 at initial placement, plus 1 for each 45° of rotation for a maximum of 8.

: For an item frame that holds a map, a unit of rotation is 90° instead of 45°, but a comparator still outputs power levels 1 to 8. It takes two full rotations to cycle through all comparator outputs, and each orientation of the map corresponds to two output levels that differ by 4.

: The comparator must be placed behind the block the item frame is attached to, facing away from the item frame. The block must be a full block, and the item frame cannot be submerged in water. Having a sign in the same block as the item frame will prevent the frame from sending a signal as well.{{only|java}}

;{{BlockLink|Jukebox}}

: A jukebox outputs a signal strength indicating which music disc is currently playing. See the ''Minimum Items for Container Signal Strength'' table above.

;{{BlockLink|Lectern}}

: A lectern outputs a signal strength that depends on what page the player is currently on. The calculation used is:
:<code>'''''signal strength''''' = floor(1 + (('''''current page''''' - 1) / ('''''number of pages in book''''' - 1)) × 14)</code>
:This results in page 1 having a signal strength of 1, and the last page having a signal strength of 15. The exception is a single page book, which will output a signal strength of 15.
:For example, a book with 15 pages will output a signal equal to the current page number.  A book with 5 pages will output signal strengths of 1, 4, 8, 11 and 15 for the different pages. A book with 100 pages will have the signal strength increase to the next level on pages 1, 9, 16, 23, 30, 37, 44, 51, 58, 65, 72, 79, 86, 93 and 100.
:

;{{BlockLink|Respawn Anchor}}

: A respawn anchor outputs a signal strength of 0, 3, 7, 11, or 15, depending on the "charged" value.

;{{BlockLink|Sculk Sensor}}

: A sculk sensor outputs a signal strength depending on the type of vibration that is detected.

;{{BlockLink|Chiseled Bookshelf}}

: A chisled bookshelf outputs a signal strength between 1 and 6 indicating the last slot interacted with. When no slot has been interacted with yet, it outputs 0.
{{-}}

== Sounds ==
=== Generic ===
{{Edition|Java}}:
{{Sound table/Block/Stone/JE}}
{{Edition|Bedrock}}:
{{Sound table/Block/Wood/BE}}

=== Unique ===
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Click.ogg
|subtitle=Comparator clicks
|source=block
|description=When a comparator is set to subtraction mode
|id=block.comparator.click
|translationkey=subtitles.block.comparator.click
|volume=0.3
|pitch=0.55
|distance=16}}
{{Sound table
|subtitle=Comparator clicks
|source=block
|description=When a comparator is set to comparison mode
|id=block.comparator.click
|translationkey=subtitles.block.comparator.click
|volume=0.3
|pitch=0.5
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|rowspan=2
|sound=Click.ogg
|source=block
|description=When a comparator is set to subtraction mode
|id=block.click
|volume=0.2
|pitch=0.55}}
{{Sound table
|source=block
|description=When a comparator is set to comparison mode
|id=block.click
|volume=0.2
|pitch=0.5
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Redstone Comparator
|spritetype=block
|nameid=comparator
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=redstone-comparator
|spritetype=block
|nameid=comparator
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Redstone Comparator
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Unpowered block
|spritename=unpowered-comparator
|spritetype=block
|nameid=unpowered_comparator
|id=149
|form=block
|translationkey=-}}
{{ID table
|displayname=Powered block
|spritename=powered-comparator
|spritetype=block
|nameid=powered_comparator
|id=150
|form=block
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=redstone-comparator
|spritetype=item
|nameid=comparator
|id=522
|form=item
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=redstone-comparator
|spritetype=block
|nameid=Comparator
|foot=1}}

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

=== Block data ===
A redstone comparator has a block entity associated with it that holds additional data about the block.

{{el|je}}:
{{see also|Block entity format}}
{{/BE}}

{{el|be}}:
: See [[Bedrock Edition level format/Block entity format]].

== Advancements ==
{{Load advancements|the power of books}}

== Video ==

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

== History ==
{{info needed section|If {{bug|MC-50242}} also affected comparators?}}
''For a more in-depth breakdown of changes to repeater textures and models, including a set of renders for each state combination, see [[/Asset history]]''
{{History|java}}
{{History||November 24, 2012|link=https://youtube.com/watch?v=YG9RNyRhIow&t=6m56s|[[Jeb]] stated that there may be a "capacitor" in [[Minecraft]]. }}
{{History||December 27, 2012|link={{tweet|Dinnerbone|284388625595125760}}|[[Dinnerbone]] released [https://web.archive.org/web/20190710120115/https://imgur.com/a/FBKed pictures] of the first version of the "comparator", stating it was a replacement for the "capacitor" idea that has variable, alternate inputs.}}
{{History||January 2, 2013|link={{tweet|Dinnerbone|286428595423965184}}|Dinnerbone released one more [http://dinnerbone.com/media/uploads/2013-01/screenshots/2013-01-02_12.06.47.png picture] of the comparator. The picture itself showing a digital-to-analog converter, using the comparator as the main [[block]].}}
{{History||1.5|snap=13w01a|[[File:Redstone Comparator (S) JE1.png|32px]] [[File:Powered Redstone Comparator (S) JE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE1.png|32px]] [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.
|Redstone comparators have 0 delay.
At this point, block ID 149 was used for unpowered comparators, and block ID 150 for powered comparators.}}
{{History|||snap=13w01b|A delay of 1 game tick ({{frac|1|2}} redstone tick) has now been added to redstone comparators to fix bugs.
|The ability to measure containers to redstone comparators has now been added.}}
{{History|||snap=13w02a|[[File:Redstone Comparator (S) JE2.png|32px]] [[File:Powered Redstone Comparator (S) JE2.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2.png|32px]] The appearance of redstone comparators has now been changed - the top texture has changed to show [[quartz]] in the middle and the sides now use the [[smooth stone]] texture rather than the smooth stone slab side texture.
|The algorithm for measuring containers has now been changed so that redstone comparators output a signal with as few as 1 [[item]] in the container.}}
{{History|||snap=13w02b|Redstone comparators now treat large [[chest]]s as a single container.}}
{{History|||snap=13w03a|Redstone comparators now output success count of [[command block]]s.
|Redstone comparators now measure container [[minecart]]s on [[detector rail]]s.}}
{{History|||snap=13w04a|Redstone comparators now measure [[jukebox]]es.}}
{{History|||snap=13w05a|Redstone comparators no longer cause constant [[block]] updates. The delay has now been made consistent, and side input no longer causes a pulse output.
|Block 150 (later <code>powered_comparator</code>) is no longer used; powered state is now represented by the 8s bit on block 149 (later <code>unpowered_comparator</code>).}}
{{History|||snap=13w05b|Redstone comparator delay has now been changed from 1 game tick (1/2 [[redstone]] tick) to 2 game ticks (1 redstone tick).}}
{{History|||snap=13w09c|The redstone signal strength from a redstone comparator next to a [[brewing stand]] with 3 [[water bottle]]s in it is now the same as one with 3 water bottles and 1 ingredient in it.}}
{{History||1.6.1|snap=13w18a|Redstone comparators now measure [[cauldron]]s and [[end portal frame]]s.}}
{{History||1.8|snap=14w04a|Redstone comparators now measure [[item frame]]s.}}
{{History|||snap=14w10a|The torches under redstone comparators have now been shortened, which has changed the underside appearance from [[File:Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Powered Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Subtracting Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Powered Subtracting Redstone Comparator UNKVER1 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER2 (facing NWU).png|32px]].}}
{{History|||snap=14w25a|[[File:Redstone Comparator (S) JE3.png|32px]] [[File:Powered Redstone Comparator (S) JE3.png|32px]] [[File:Subtracting Redstone Comparator (S) JE3.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE3.png|32px]] The torches on comparators are now subject to ambient occlusion.
|Comparators set to subtract mode appear to be powered as well regardless of incoming power. The subtracting-only model still exists and can be achieved through {{cmd|setblock}}.}}
{{History|||snap=14w25b|[[File:Subtracting Redstone Comparator (S) JE4.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE4.png|32px]] The powered front torch when in subtraction mode is now lower.
|Comparators set to subtract by hand now appear normally again.}}
{{History|||snap=14w28a|Redstone comparators now measure [[cake]]s.}}
{{History||1.9|snap=15w42a|With the addition of the [[blaze powder]] fuel slot, [[brewing stand]]s now have 5 slots instead of 4. Their original comparative power values from redstone comparators are listed below:
{{{!}} class{{=}}"wikitable collapsible collapsed" data-description{{=}}"Original values"
! Original values
{{!}}-
{{!}}
*0: 0
*1: 1
*2: 19
*3: 37
*4: 55
*5: 1s 10
*6: 1s 28
*7: 1s 46
*8: 2s
*9: 2s 19
*10: 2s 37
*11: 2s 55
*12: 3s 10
*13: 3s 28
*14: 3s 46
*15: 4s
{{!}}}
}}
{{History|||snap=15w47a|Redstone comparators' side inputs now take power from [[redstone block]]s.}}
{{History||1.13|snap=17w47a|All 3 IDs for the redstone comparator have now been merged into one ID: <code>comparator</code>.
|Redstone comparators now render their underside, which has changed their undersides from [[File:Redstone Comparator UNKVER2 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER3 (facing NWU).png|32px]].
|Prior to [[1.13/Flattening|''The Flattening'']], these blocks' numeral IDs were 149 and 150, and the [[item]]'s 404.
|As a result, the formerly unused comparator ID is now technically used again, due to both unpowered and powered versions being merged into a single comparator block ID.}}
{{History||1.14|snap=18w43a|[[File:Redstone Comparator (S) JE4.png|32px]] [[File:Powered Redstone Comparator (S) JE4.png|32px]] [[File:Subtracting Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE5.png|32px]] [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}
{{History|||snap=19w02a|Redstone comparators now measure [[lectern]]s.}}
{{History|||snap=19w03a|Redstone comparators now measure [[composter]]s.}}
{{History|||snap=19w12b|Redstone comparators can now be placed on [[glass]], [[ice]], [[glowstone]] and [[sea lantern]]s.}}
{{History||1.15|snap=19w34a|Redstone comparators now measure how much honey is inside [[beehive|bee hive]]s and [[bee nest]]s.}}
{{History||1.16|snap=20w06a|The way to calculate the input signals of redstone comparators has now been changed.}}
{{History|||snap=20w11a|The changes to the way of calculating the input signals of redstone comparators from [[Java Edition 20w06a|20w06a]] have now been reverted.}}
{{History|||snap=20w16a|Redstone comparators now measure [[Pigstep music disc]]s in [[jukebox]]es.}}
{{History||1.17|snap=20w45a|Redstone comparators now measure [[lava cauldron]]s.}}
{{History|||snap=20w46a|Redstone comparators now measure [[Cauldron#Holding powder snow|powder snow cauldron‌]]s.}}
{{History||1.18|snap=21w41a|[[File:Powered Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE6.png|32px]] The texture of powered redstone comparator have now been changed.}}
{{History||1.19|snap=22w13a|Redstone comparators now generate as part of [[ancient cities]].}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Redstone comparators now measure [[chiseled bookshelves]].}}
{{History||1.20.2|snap=23w33a|Redstone comparators now use stone sounds instead of wood sounds.<ref>{{bug|MC-182820|||Fixed}}</ref>}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Redstone comparators now measure [[end portal frame]]s.}}
{{History||1.0.5|snap=alpha 1.0.5.0|Redstone comparators now output success count of [[command block]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Redstone comparators now measure [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Redstone comparators now measure [[jukebox]]es.
|Redstone comparators now render their underside, which has changed their undersides from [[File:Redstone Comparator UNKVER1 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER3 (facing NWU).png|32px]]}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Redstone Comparator (S) BE.png|32px]] [[File:Powered Redstone Comparator (S) BE.png|32px]] [[File:Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Redstone comparators now measure [[smoker]]s, [[blast furnace]]s, [[lectern]]s and [[composter]]s.}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Powered Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE6.png|32px]] The texture of powered redstone comparator have now been changed.}}
{{History||1.20.30|snap=beta 1.20.30.20|Redstone comparators now use the <code>minecraft:cardinal_direction</code> [[block state]] instead of <code>direction</code>.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|Redstone comparators can now measure [[item frame]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Redstone Comparator (S) BE.png|32px]] [[File:Powered Redstone Comparator (S) BE.png|32px]] [[File:Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) BE.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE2 BE2.png|32px]] Added redstone comparators.}}
{{History|foot}}

=== Redstone comparator "items" ===
{{:Technical blocks/Redstone Comparator}}

== Issues ==
{{issue list}}

== Trivia ==
* Comparators do not emit redstone particles when powered, unlike redstone torches and repeaters.<ref>{{bug|MC-51692|||WAI}}</ref>

== Gallery ==
<gallery>
Dinnerbone Comparator 1.png|Dinnerbone showing how comparators work.
Dinnerbone Comparator 2.png|Dinnerbone showing how comparators work.
Dinnerbone Comparator 3.png|Dinnerbone showing how comparators work.
Dinnerbone Comparators 1.png|A contraption incorporating comparators.
Dinnerbone Comparators 2.png|Comparators in action.
Dinnerbone Comparators 3.png|Output specific signals.
Dinnerbone Comparator Thing.png|Another comparator in use.
Item Frame Comparator.png|Rotating the torch in the item frame adjusts the comparator's output.
</gallery>

== References ==
{{reflist}}

{{Redstone}}
{{Blocks|Utility}}
{{Items}}

[[Category:Mechanics]]
[[Category:Block entities]]
[[Category:Redstone mechanics]]
[[Category:Mechanisms]]
[[Category:Manufactured blocks]]
[[Category:Non-solid blocks]]

[[de:Redstone-Komparator]]
[[es:Comparador de redstone]]
[[fr:Comparateur de redstone]]
[[hu:Redstone-komparátor]]
[[ja:レッドストーンコンパレーター]]
[[ko:레드스톤 비교기]]
[[nl:Redstonevergelijker]]
[[pl:Komparator]]
[[pt:Comparador de redstone]]
[[ru:Компаратор]]
[[uk:Редстоуновий компаратор]]
[[zh:红石比较器]]</li></ul></nowiki>
beta 1.11.0.3Wandering traders will now drink a potion of invisibility during dusk, when hurt by projectiles or magic attacks, and when avoiding illagers and zombies.
If a player is holding an emerald, wandering traders now hold items they want to trade.
beta 1.11.0.4Fully implemented wandering traders, separate from Experimental Gameplay.
Wandering traders now disappear after all trades are disabled.
Wandering trader now has 6 random trades, instead of 4.

Issues

Issues relating to "Wandering Trader" are maintained on the bug tracker. Report issues there.

Gallery

Notes

  1. If a world is upgraded to Java Edition 1.14 (starting from 19w05a) from a previous version, the timer will start at the time the world was saved. So if the world was last saved at noon in 1.13 and then upgraded to 1.14, the algorithm will try to spawn a wandering trader every day at noon.
Advertisement