Minecraft Wiki
Don't have an account?
Register
Advertisement
Register
Minecraft Wiki
Minecraft Wiki
8,970
pages
in: Development, Java Edition, Bedrock Edition
English

Raw JSON text format

Revision as of 02:28, 9 May 2020 by Chixvv (talk | contribs)
Sign in to edit

Raw JSON text is the format Minecraft uses to send and display rich text to players. It can also be sent by players themselves using commands and data packs. Raw JSON text is written in JSON, a human-readable data format.

Java Edition

Raw JSON text is made up of text components. There is a single root component, which can have child components, which can have their own children and so on. Components can also have formatting and interactivity added to them, which will be inherited by their children.

A raw JSON text component can be any JSON data type, including JSON string, JSON array, JSON object, JSON boolean, JSON number, and JSON null. The game treats booleans and numbers as strings. Null value can't be parsed as a command argument, but is valid for NBT. Strings and arrays are both shorthand for longer object structures, as described below.

  • A string containing plain text to display directly. This is the same as an object that only has a  text tag. For example, "A" and {"text": "A"} are equivalent.
  • A boolean is converted to a string ("true" or "false") to display directly. This is the same as an object that only has a  text tag. For example, true, "true", and {"text": "true"} are equivalent.
  • A number is converted to a string to display directly. This is the same as an object that only has a  text tag. For example, 1.9E10, "1.9E10", and {"text": "1.9E10"} are equivalent.
  • A null value is converted to a empty string. This is the same as an object that only has a  text tag. For example, , "", and {"text": ""} are equivalent.
  • A list of raw JSON text components. Same as having all components after the first one appended to the first's  extra array.[1] For example, ["A", "B", "C"] is equivalent to {"text": "A", "extra": ["B", "C"]}.
  • A text component object. To be valid, an object must contain one content tag: text, translate, score, selector, keybind, or nbt. Having more than one is allowed, but only one will be used.[2] All non-content tags are optional.
    • Content: Plain Text
    •  text: A string containing plain text to display directly. Can also be a number or boolean that is displayed directly.
    • Content: Translated Text
    •  translate: A translation identifier, to be displayed as the corresponding text in the player's selected language. If no corresponding translation can be found, the identifier itself will be used as the translation text. This identifier is the same as the identifiers found in lang files from assets or resource packs.
    •  with: Optional. A list of raw JSON text component arguments to be inserted into slots in the translation text. Ignored if  translate is not present.
      • Translations can contain slots for text that is not known ahead of time, such as player names. These slots are defined in the translation text itself, not in the JSON text component, and generally take the form %s (displays the next argument) or %1$s (displays the first argument; replace 1 with whichever index is desired).[3] If no argument is provided for a slot, the slot will not be displayed.
    • Content: Scoreboard Value (requires resolution)
    •  score: Displays a score holder's current score in an objective. Displays nothing if the given score holder or the given objective do not exist, or if the score holder is not tracked in the objective.
      •  name: The name of the score holder whose score should be displayed. This can be a selector like @p or an explicit name. If the text is a selector, the selector must be guaranteed to never select more than one entity, possibly by adding limit=1. If the text is "*", it shows the reader's own score (for example, /tellraw @a {"score":{"name":"*","objective":"obj"}} shows every online player their own score in the "obj" objective).[4]
      •  objective: The internal name of the objective to display the player's score in.
      •  value: Optional. If present, this value is used regardless of what the score would have been.
    • Content: Entity Names (requires resolution)
    •  selector: A string containing a selector. Displayed as the name of the player or entity found by the selector. If more than one player or entity is found by the selector, their names are displayed in either the form "Name1 and Name2" or the form "Name1, Name2, Name3, and Name4". Hovering over a name will show a tooltip with the name, type, and UUID of the target. Clicking a player's name suggests a command to whisper to that player. Shift-clicking a player's name inserts that name into chat. Shift-clicking a non-player entity's name inserts its UUID into chat.
    • Content: Keybinds
    •  keybind: A keybind identifier, to be displayed as the name of the button that is currently bound to a certain action. For example, {"keybind": "key.inventory"} will display "e" if the player is using the default control scheme.
    • Content: NBT Values (requires resolution)
    •  nbt: The NBT path used for looking up NBT values from an entity, a block entity or an NBT storage. NBT strings display their contents. Other NBT values are displayed as SNBT with no spacing or linebreaks. How values are displayed depends on the value of  interpret. If more than one NBT value is found, either by selecting multiple entities or by using a multi-value path, they are displayed in the form "Value1, Value2, Value3, Value4". Requires one of block, entity, or storage. Having more than one is allowed, but only one will be used.[5]
    •  interpret: Optional, defaults to false. If true, the game will try to parse the text of each NBT value as a raw JSON text component. This usually only works if the value is an NBT string containing JSON, since JSON and SNBT are not compatible. If parsing fails, displays nothing. Ignored if  nbt is not present.
    •  block: A string specifying the coordinates of the block entity from which the NBT value is obtained. The coordinates can be absolute or relative. Ignored if  nbt is not present.
    •  entity: A string specifying the target selector for the entity or entities from which the NBT value is obtained. Ignored if  nbt is not present.
    •  storage: A string specifying the namespaced ID of the command storage from which the NBT value is obtained. Ignored if  nbt is not present.
    • Children
    •  extra: A list of additional raw JSON text components to be displayed after this one.
      • A child text component. Child text components inherit all formatting and interactivity from the parent component, unless they explicitly override them.
    • Formatting
    •  color: Optional. The color to render the content in. Valid values are "black", "dark_blue", "dark_green", "dark_aqua", "dark_red", "dark_purple", "gold", "gray", "dark_gray", "blue", "green", "aqua", "red", "light_purple", "yellow", "white", and "reset" (cancels out the effects of colors used by parent objects).
      Set to "#<hex>" to insert any color in the hexadecimal color format. Example: Using "#FF0000" makes the component red.‌[upcoming: JE 1.16] Must be a full 6-digit value, not 3-digit.
      Technically, "bold", "italic", "underlined", "strikethrough", and "obfuscated" are also accepted‌[until JE 1.16], but it is better practice to use the tags below for such formatting.
    •  font: Optional. The resource location of the font for this component in the resource pack within assets/<namespace>/font. Defaults to "minecraft:default".‌[upcoming: JE 1.16]
    •  bold: Optional. Whether to render the content in bold.
    •  italic: Optional. Whether to render the content in italics. Note that text which is italicized by default, such as custom item names, can be unitalicized by setting this to false.
    •  underlined: Optional. Whether to underline the content.
    •  strikethrough: Optional. Whether to strikethrough the content.
    •  obfuscated: Optional. Whether to render the content obfuscated.
    • Interactivity
    •  insertion: Optional. When the text is shift-clicked by a player, this string is inserted in their chat input. It does not overwrite any existing text the player was writing. This only works in chat messages.
    •  clickEvent: Optional. Allows for events to occur when the player clicks on text. Only work in chat messages and written books, unless specified otherwise.
      •  action: The action to perform when clicked. Valid values are:
        • "open_url": Opens  value as a URL in the user's default web browser.
        • "open_file": Opens the file at  value on the user's computer. This is used in messages automatically generated by the game (e.g., on taking a screenshot) and cannot be used by players for security reasons.
        • "run_command": Works in signs, but only on the root text component, not on any children. Activated by using the sign. In chat and written books, this has  value entered in chat as though the player typed it themselves and pressed enter. This can be used to run commands, provided the player has the required permissions. Since they are being run from chat, commands must be prefixed with the usual "/" slash. In signs, the command is run by the server at the sign's location, with the player who used the sign as @s. Since they are run by the server, sign commands have the same permission level as a command block instead of using the player's permission level, are not restricted by chat length limits, and do not need to be prefixed with a "/" slash.
        • "suggest_command": Opens chat and fills in  value. If a chat message was already being composed, it is overwritten.
        • "change_page": Can only be used in written books. Changes to page  value if that page exists.
        • "copy_to_clipboard": Copies  value to the clipboard.
      •  value: The URL, file path, chat, command or book page used by the specified action.
    •  hoverEvent: Optional. Allows for a tooltip to be displayed when the player hovers their mouse over text.
      •  action: The type of tooltip to show. Valid values are:
        • "show_text": Shows a raw JSON text component.
        • "show_item": Shows the tooltip of an item as if it was being hovering over it in an inventory.
        • "show_entity": Shows an entity's name, type, and UUID. Used by  selector.
      •  value: The formatting and type of this tag varies depending on the action. Deprecated, use  contents instead.‌[upcoming: JE 1.16]
        • show_text: Another raw JSON text component. Can be any valid text component type: string, array, or object. Note that clickEvent and hoverEvent do not function within the tooltip.
        • show_item: A string containing the SNBT for an item stack. See Player.dat format#Item structure.
        • show_entity: A string containing SNBT. The SNBT does not represent the full entity data, but only stores the name, type, and UUID of the entity.
          •  name: Optional. Hidden if not present. An NBT string containing some JSON that is parsed as a text component and displayed as the name of the entity. If the NBT string cannot be parsed as a text component, the entire tooltip is replaced with the text "Invalid Entity!"
          •  type: Optional. Hidden if not present. An NBT string containing some plain text that is displayed as the type of the entity. Can be any text.
          •  id: Optional. Shown as empty line if not present. An NBT string containing some plain text that is displayed as the UUID of the entity. Can be any text.
      •  contents: The formatting of this tag varies depending on the action.‌[upcoming: JE 1.16]
        • show_text: Another raw JSON text component. Can be any valid text component type: string, array, or object. Note that clickEvent and hoverEvent do not function within the tooltip.
        • show_item: The item that should be displayed.
          •  id: The namespaced item ID. Present minecraft:air if invalid.
          •  count: Optional. Size of the item stack.
          •  tag: Optional. A string containing the serialized NBT of the additional information about the item, discussed more in the subsections of the player format page.
        • show_entity: The entity that should be displayed.
          •  name: Optional. Hidden if not present. A raw JSON text that is displayed as the name of the entity.
          •  type: A string containing the type of the entity. Should be a namespaced entity ID. Present minecraft:pig if invalid.
          •  id: A string containing the UUID of the entity. Should be a valid UUID.

Due to the extra tag, the above format may be recursively nested to produce very complex and functional text strings. However, a raw JSON text doesn't have to be complicated at all: virtually all properties are optional and may be left out.

Component resolution

Certain text content types (score, selector, and nbt) will not work in all contexts. These content types need to be resolved, which involves retrieving the appropriate data from the world, rendering it into "simple" text components, and replacing the "advanced" text component with that. This resolution can be done by signs, by written books when they are first opened, and by commands such as /tellraw and /title. It can also be done by the loot table functions set_name and set_lore, if and only if their entity tag is set. Custom item names and custom entity names cannot by themselves resolve these components.

Additionally, resolution will fix a single value in place. Therefore, these content types are not dynamic, and will not update to reflect changes in their environment, while "simple" components usually will.

Bedrock Edition

Unlike in Java Edition, the raw JSON text in Bedrock Edition is more strict and simple.

  • The root tag.
    •  rawtext: A list contains all text object.
      • The base chat component object.
        •  text: A string representing raw text to display directly in chat. Note that selectors such as "@a" and "@p" are not translated into player names; "\n" is newline (enter). Ignored when  translate exist in the object.
        •  translate: The translation identifier of text to be displayed using the player's selected language. This identifier is the same as the identifiers found in lang files from assets or resource packs.
        •  with: A list of string arguments to be used by  translate. Useless otherwise.
          • The arguments are text corresponding to the arguments used by the translation string in the current language, in order (for example, the first list element corresponds to "%%1" in a translation string).
Basic raw text example
/tellraw @a { "rawtext" : [ { "text" : "Hello world" } ] }

This will send a message to all players saying "Hello World". However this will only be in English, see the Translate action to see how to send localized texts.

Appending

Raw text takes in an array of text objects. Each object in the list will be added to the previous object. For example, /tellraw @a { "rawtext" : [ { "text":"Hello" }, { "text" : " World" } ] } outputs the same "Hello World" as the first example. Appending text can be useful to combine 2 different localized texts, or apply different colors to each word etc.

Translate

The translate object allows creators to provide localized text to users. If translate is specified along with text, translate will override the text object. The string to provide to translate is the name of the string in the language files. For example, in Vanilla Minecraft "commands.op.success" is the string that displays when /op is used on a player successfully.

/tellraw @a { "rawtext": [ { "translate" : "commands.op.success" } ] }

This will output "Opped %s" to all players. Note that because of text being ignored with translate specified, the following example will output the same text:

/tellraw @a { "rawtext" : [ { "text":"Hello World", "translate":"commands.op.success" } ] }

With

In the translate example above, it outputs "Opped %s". To have a name or other text show up instead of %s "with" needs to be specified as well. Note that "with" only works with "translate" and also requires an array [] instead of curly brackets {}.

/tellraw @a { "rawtext": [ { "translate" : "commands.op.success", "with": [ "Steve" ] } ] }

%%s

"translate" and "%s" can be used without needing a corresponding string in the localization files. For example:

/tellraw @a { "rawtext": [ { "translate" : "Hello %%s", "with": [ "Steve" ] } ] }

This outputs "Hello Steve" to all players.

Multiple %s

%%s can be used multiple times. They will be filled in, in the order specified

/tellraw @a { "rawtext": [ { "translate" : "Hello %%s and %%s", "with": [ "Steve", "Alex" ] } ] }

Outputs: "Hello Steve and Alex"

Ordering with %%#

The order to fill in %s to be filled in can be changed by instead specifying it with %%#, replacing # with an actual number. For example, to swap the position of Steve and Alex in the above example, instead run the following:

/tellraw @a { "rawtext" : [ {"translate" : "Hello %%2 and %%1", "with": [ "Steve", "Alex"] } ] }

Outputs: "Hello Alex and Steve"

History

Java Edition
1.7.2
{{Extension DPL}}<ul><li>[[Ender Pearl|Ender Pearl]]<br/>{{Update|[[game rule]] <code>enderPearlsVanishOnDeath</code>}}
{{ItemEntity
|image=Ender Pearl.png
|renewable=Yes
|stackable=Yes (16)
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
}}
An '''ender pearl''' is an [[item]] that can be thrown to [[teleport]] to where it lands, or used to craft [[eye of ender|eyes of ender]] which are required to access [[the End]].

== Obtaining ==
=== Mob loot ===
An [[enderman]] has a 50% chance to drop 1 ender pearl when killed. The drop is increased by 1 per level of [[Looting]], with a maximum of 4 with Looting III.

=== Chest loot ===
{{LootChestItem|ender-pearl}}

A [[trapped chest]] always containing 2 ender pearls can be found in the "fake end portal" room of [[woodland mansion]]s.

=== Trading ===
{{IN|java}}, expert-level [[Trading#Cleric|cleric villagers]] have a {{frac|2|3}} chance to sell an ender pearl for 5 [[emerald]]s.

{{IN|bedrock}}, expert-level cleric villagers sell one ender pearl for 5 emeralds.

=== Bartering ===
[[Piglin]]s have a {{frac|10|459}} (2.18%) chance to [[barter]] 2–4 ender pearls when given a [[gold ingot]].

== Usage ==
Ender pearls can be thrown by pressing {{control|use}}. After it is thrown, the ender pearl is consumed, and the player teleports to where it lands, taking {{hp|5}} [[fall damage]]. Wearing armor enchanted with [[Protection]] and/or [[Feather Falling]] reduces the damage taken from the ender pearl. 

Ender pearls have a small cone of travel; they do not all follow the same path when thrown in the same direction. The direction and velocity of ender pearl throws is slightly randomized. They can travel about 30 blocks{{Only|java}}/45 blocks{{Only|bedrock}} when thrown straight up, and up to 54 blocks forward when thrown at an optimum launch angle of ~35° (on even ground).

The thrower's vertical velocity influences the throw. Hence timing a throw with a jump can increase the throwing range to 42 blocks when thrown straight up and 64 blocks forward at a 35° angle. Throwing while falling significantly decreases the range. Ender pearls collide with all [[minecart]] types, [[boat]]s, [[end crystal]]s and [[nether portal]]s, and travel through [[end portal]]s. Ender pearls that fall into the [[void]] disappear, and do not trigger the player to teleport. However, ender pearl entities (instead of dropped items) are ''not'' destroyed by lava and will teleport the player to the bottom of lava pools/lava oceans.

Ender pearls have a cooldown of one second before they can be used again. The cooldown is shown in the hotbar by a white overlay on the ender pearl that shrinks and must disappear before the player can use it again. If there are other inventory or hotbar slots containing ender pearls, they are covered with the white overlay as well.<ref>{{bug|MC-88236|||WAI}}</ref> 

Ender pearls can be thrown into [[end gateway]]s to reach the outer islands of the End. They can also be thrown into the [[exit portal]] to reach the player's spawn point.

Ender pearl teleportation makes no sound ''itself''{{only|java}}, but does emit a "small fall" sound at the destination when applying teleportation damage to the player.

=== Stasis chamber ===
Ender pearls are affected by [[bubble column]]s. An ender pearl can remain afloat on top of an upward bubble column, allowing it to be stored indefinitely. A mechanism can then be triggered to make the ender pearl hit a solid surface (e.g. by closing a [[trapdoor]]), teleporting the thrower back to the setup wherever they are.

=== Spawning endermites ===
An ender pearl has a 5% chance to spawn an [[endermite]] when it lands. This is the only way through which endermites can spawn, without using cheats. The endermite spawns at ''the player's position'' when the pearl lands{{only|je}}, or at the pearl's landing site{{only|be}}.

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

== Sounds ==
{{edition|java}}:<br>
Thrown ender pearls use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Ender Pearl flies
|source=neutral
|description=When an ender pearl is thrown
|id=entity.ender_pearl.throw
|translationkey=subtitles.entity.ender_pearl.throw
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Bow shoot.ogg
|source=player
|description=When an ender pearl is thrown
|id=random.bow
|volume=0.5
|pitch=0.33-0.5
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Thrown Ender Pearl
|spritetype=entity
|spritename=Ender Pearl
|nameid=ender_pearl
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|id=422
|form=item
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=entity
|nameid=ender_pearl
|id=87
|foot=1}}

===Entity Data===
Thrown ender pearls have entity data that define various properties of the entity.

{{el|java}}:
{{main|Entity format}}
{{/ED}}

{{el|bedrock}}:
: See [[Bedrock Edition level format/Entity format]].

== Achievements ==
{{Load achievements|Beam Me Up}}

== Advancements ==
{{load advancements|Remote Getaway;Bullseye}}

== History ==
{{History|java beta}}
{{History||1.8|snap=Pre-release|[[File:Ender Pearl JE1.png|32px]] Added ender pearls along with [[endermen]]. 
|Ender pearls have no use, but can stack up to 64.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Ender pearls are now less commonly found near bodies of [[water]] since [[endermen]] now teleport away when in contact with water. Before this version, endermen didn't attempt to teleport and were [[damage]]d/killed from water much more frequently, causing numerous ender pearls to occur around bodies of water.
|Later, on a suggestion from [[wikipedia:Reddit|Reddit]] user isJesus, [[Notch]] implemented the teleporting feature for ender pearls.<ref>http://www.reddit.com/r/Minecraft/comments/kpsay/eggsnowballender_pearl_suggestiongif/c2mabfj</ref><ref>{{Tweet|notch|118614580539826176}}</ref><ref>http://www.reddit.com/r/Minecraft/comments/kss7n/twitter_ender_pearls_have_a_unique_ability_now/c2mwldd</ref>}}
{{History|||snap=Beta 1.9 Prerelease 2|Added teleporting feature to ender pearls.
|Using an ender pearl to teleport resulted in being kicked from servers for "hacking". This is due to a check triggering that was supposed to prevent modified clients from moving too quickly.
|Ender pearls now only stack up to 16.}}
{{History|||snap=Beta 1.9 Prerelease 3|Ender pearls are now used to craft [[eyes of ender]].
|Ender pearls can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History||1.3.1|snap=12w24a|[[File:Ender Pearl JE2 BE1.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.8|snap=14w02a|As part of the revamp of the trading system, cleric [[villager]]s now [[trading|buy]] ender pearls.}}
{{History|||snap=14w03a|Villager clerics no longer buy ender pearls.}}
{{History|||snap=14w11b|Ender pearls have a 5% chance to spawn [[endermite]]s when used.}}
{{History||1.9|snap=15w31a|Ender pearls can now be thrown in [[Creative]] mode.}}
{{History|||snap=15w34c|Ender pearls now have a cooldown after using them.}}
{{History|||snap=15w41a|[[Villager]] clerics now [[trading|sell]] ender pearls for 4–7 [[emerald]]s, as one of their tier III trades.}}
{{History|||snap=15w49a|Thrown ender pearls now take the user's motion into account. For example, an ender pearl thrown forward will land closer if the player is falling, and land farther if the player is ascending.}}
{{History||1.10|snap=16w21a|Ender pearls can now teleport riders off their mounts.}}
{{History||1.11|snap=16w32a|The entity ID of ender pearls has been changed from <code>ThrownEnderpearl</code> to <code>ender_pearl</code>.}}
{{History|||snap=16w39a|Ender pearls can now be found in [[woodland mansion]]s' fake portal room [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 368.}}
{{History||1.14|snap=18w43a|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.16|snap=20w07a|Ender pearls have a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 2–4.}}
{{History|||snap=20w09a|Ender pearls now have a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w10a|Ender pearls now have a {{frac|20|411}} (~4.87%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History|||snap=20w20a|Ender pearls now have a {{frac|20|423}} (~4.73%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History||1.16.2|snap=20w28a|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}
{{History|||snap=Pre-Release 1|Ender pearls are now affected by [[bubble column]]s.<ref>{{bug|MC-125758|||Fixed}}</ref>
|Ender pearls no longer get destroyed at contact with non-solid blocks.<ref>{{bug|MC-73884|||Fixed}}</ref>}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls. 
|While fully implemented, ender pearls currently have no assigned ID and are currently unobtainable in-game.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Ender pearls are now obtainable in-game.
|Ender pearls can now be used to craft [[eyes of ender]].}}
{{History|||snap=alpha 1.0.0.0|Ender pearls now require a 1-second cooldown.}}
{{History|||snap=alpha 1.0.0.1|Ender pearl cooldown now has an animation.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Ender pearls can now be [[trading|bought]] from cleric [[villager]]s for 4-7 [[emerald]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Ender pearls can now be found in [[woodland mansion]]s' [[chest]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has been changed, expert-level cleric [[villager]]s now [[trading|sell]] an ender pearl for 5 [[emerald]]s as part of their trade.}}
{{History||1.16.0|snap=beta 1.16.0.57|Ender pearls can now be obtained from [[bartering]] with [[piglin]]s.}}
{{History||1.16.100|snap=beta 1.16.100.54|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}

{{History|console}}
{{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History||xbox=TU7|A teleporting feature has been added to ender pearls.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*Ender pearls can be used to teleport/move through non-[[solid block]]s without suffocation and solid blocks by pressing against the blocks and using the ender pearl at the player's feet until the player goes through.<ref>{{bug|MC-2164}}</ref><ref>{{ytl|KA1UmxraeUg}}</ref>
*In ''Java Edition'', it is possible to spawn a thrown ender pearl using commands, but it does not teleport, unless it is assigned an owner.
*If the player throws an ender pearl and then dies before impact while the pearl is in a loaded chunk, the pearl disappears and the player is not teleported. Pearls in unloaded chunks do not disappear if their owner dies.
*If the player throws an ender pearl in Survival mode and changes to Creative mode before the pearl lands, the player is still teleported.
*The player is still teleported by throwing an ender pearl and entering [[the Nether]] before it lands. The pearl is not lost if an ender pearl is thrown into a [[nether portal]] and the player travels through the portal; the pearl lands and teleports the player as usual.
*If multiple ender pearls are thrown in succession, the player can be hurt only once from fall damage within about a one-second span.
*If a [[player]] dies from ender pearl teleportation, the [[death message]] says: "<player> hit the ground too hard".
*A thrown ender pearl faces toward the player in first-person view, while it appears rotated horizontal in [[third-person view]]. This is the case for all throwable items (ender pearl, [[egg]], [[snowball]], and all throwable [[potion]]s).
*Ender pearls and [[snowball]]s have the exact same range when fired. Therefore, snowballs can be used to predict the trajectory of ender pearls, or simply for practicing ender pearl throwing. This can be very helpful when the player has to throw ender pearls in dangerous environments, such as the Nether or the End.
*Despite the fact that ender pearls deal no damage to anything they're thrown at, provokable mobs (such as iron golems and piglins) will be provoked by the player if one is thrown at them.

== Gallery ==
<gallery>
Ender Pearl Suggestion.gif|The original suggestion image for teleporting with ender pearls.
Enderlake.png|Ender pearls were formerly found in [[water]], however endermen now teleport out to prevent damage.
</gallery>

== References ==
{{reflist}}

== See also ==
*[[The End]]
*[[Ender Dragon]]
*[[End Portal]]
*[[Enderman]]

{{Items}}
{{entities}}

[[cs:Endová perla]]
[[de:Enderperle]]
[[es:Perla de ender]]
[[fr:Perle de l'Ender]]
[[hu:Véggyöngy]]
[[ja:エンダーパール]]
[[ko:엔더 진주]]
[[nl:Enderparel]]
[[pl:Enderperła]]
[[pt:Pérola de ender]]
[[ru:Жемчуг Края]]
[[th:ไข่มุกเอนเดอร์]]
[[tr:Ender İncisi]]
[[uk:Перлина Краю]]
[[zh:末影珍珠]]</li><li>[[Dye|Dye]]<br/>{{Item
| title = Dyes
| image = White Dye.png
| extratext = View [[#Gallery|all renders]]
| renewable = Yes
| stackable = Yes (64)
}}
'''Dyes''' are a set of sixteen items used to change the color of [[wool]], [[carpet]]s, [[terracotta]], [[concrete powder]], [[glass]], [[shulker box]]es, [[bed]]s, [[candle]]s, the patterns on [[banner]]s, [[firework star]]s, certain mobs, and text on [[sign]]s and [[hanging sign]]s. {{IN|bedrock}} they can also be used to dye water in a [[cauldron]] (which is thereafter used to dye leather [[armor]]); {{in|java}} leather armor can be dyed directly. {{IN|education}} dyes can also be used to dye [[balloon]]s and [[glow stick]]s.

{{IN|bedrock|education}}, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa bean]]s can generally substitute for [[white dye]], [[black dye]], [[blue dye]], and [[brown dye]], respectively, in crafting recipes and for use in dyeing items or mobs. However, they have other important uses that aren't related to color, and are therefore not considered true dyes. They are mentioned in this article only in regard to their use as dyeing agents; see their individual articles for complete information about them.

== Obtaining ==
<!--[[File:Dye Chart.png|350px|thumb|A guide to crafting all the dyes.{{until|java 1.14}}]]-->

Dyes can be produced by crafting them from plants (mainly flowers), by crafting dyes of different colors together, by smelting plants, or by trading with a [[wandering trader]].

{{loadPage|Crafting/Dye|Crafting|h3}}

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

=== Trading ===

[[Wandering trader]]s can sell 3 dyes for an [[emerald]]. {{IN|bedrock}}, they can also sell 3 lapis lazuli, bone meal, cocoa beans, or ink sacs for one emerald.

Apprentice-level cleric [[villager]]s sell one lapis lazuli per emerald.

=== Chest loot ===

{{#invoke:LootChest|base3|blue-dye,green-dye,orange-dye,light-blue-dye,yellow-dye,white-dye}}

=== Other ===

Ink sacs can also be created using 1 iron, 1 sulfur, and 4 oxygen in the [[compound creator]]. {{only|bedrock|education}}

== Usage ==

Similar to their use in crafting, [[bone meal]], [[ink sac]]s, [[lapis lazuli]], and [[cocoa beans]] can be substituted for the corresponding dye in any of the following usages unless otherwise specified.{{only|bedrock}} <!--- sections are ordered by craftable dyeable blocks, dyeable items, version exclusive sections, and non-crafting miscellaneous uses--->

=== Dyeing wool and mobs ===

Players can dye wool by placing [[wool]] and any dye in a crafting grid.

{{Crafting
|nocat=1
|Any Wool
|Matching Dye
|Output=Any Wool
}}

Dyes can be {{control|use|text=used}} on sheep to change the color of the wool. Shearing a colored sheep drops the corresponding color of the wool, and the sheep retains the color when the wool regenerates. [[Breeding]] colored sheep produces a lamb colored as one of the parent sheep, or a color resulting from the combination of both parents' color. The color combining follows the same rules that dyes use – red and yellow sheep produce an orange lamb, but a blue and yellow sheep cannot create a green lamb. The unlimited reproduction of colored sheep makes dyeing and shearing sheep infinitely more efficient than just dyeing wool directly.
 
Dye can also be used on a tamed [[wolf]] or [[cat]] to change the color of its collar from the default red to the color of the dye.

=== Dyeing carpets ===

Carpets can be dyed.

{{Crafting
 |Any Carpet
 |Matching Dye
 |Output= Matching Carpet
 |type= Building block
}}

=== Dyeing terracotta ===

[[Terracotta]] can be dyed by placing 8 blocks around a dye on a crafting table.

{{Crafting
|nocat=1
|A1=Terracotta |B1=Terracotta |C1=Terracotta
|A2=Terracotta |B2=Matching Dye  |C2=Terracotta
|A3=Terracotta |B3=Terracotta |C3=Terracotta
|Output=Matching Dyed Terracotta,8
}}

=== Creating concrete powder ===

Dyes can also be used to craft [[concrete powder]], which can then be set into their respective [[concrete]] blocks (they cannot be dyed directly).

{{Crafting
|nocat=1
|Sand |Gravel |Sand
|Gravel |Matching Dye |Gravel
|Sand |Gravel |Sand
|Output=Matching Concrete Powder,8
}}

=== Staining glass ===

[[Stained glass]] can be stained by placing 8 blocks of glass around a dye on a [[crafting table]]. Just like regular glass, stained glass can be crafted into stained glass panes. The recipe for this is the same as with regular glass.

{{Crafting
|nocat=1
|A1=Glass |B1=Glass        |C1=Glass
|A2=Glass |B2=Matching Dye |C2=Glass
|A3=Glass |B3=Glass        |C3=Glass
|Output=Matching Stained Glass,8
|head=1
}}
{{Crafting
|nocat=1
|A1= Glass Pane
|B1= Glass Pane
|C1= Glass Pane
|A2= Glass Pane
|B2= Matching Dye
|C2= Glass Pane
|A3= Glass Pane
|B3= Glass Pane
|C3= Glass Pane
|Output= Matching Stained Glass Pane,8
|type= Decoration block
|foot=1
}}

=== Dyeing shulker boxes ===

[[Shulker box]]es are generated in a light shade of purple (like the [[purpur block]]), but can be dyed any color. They can also be re-dyed as often as desired.

{{Crafting
  |ignoreusage=1
  |showname=1
  |Any Shulker Box
  |Matching Dye
  |Output=Matching Shulker Box
}}

=== Dyeing beds ===

Players can dye beds by placing a [[bed]] and any color dye in a crafting grid.

{{Crafting
|nocat=1
|Any Bed
|Matching Dye
|Output=Matching Bed
}}

=== Dyeing candles ===

Players can dye [[candles]] by placing an undyed candle and any color dye in a crafting grid.

{{Crafting
|ignoreusage=1
|Candle
|Matching Dye
|Output=Matching Dyed Candle
}}

=== Banner patterns ===
{{main|Banner#Patterns}}

Dyes are used in most banner patterns to determine the pattern and color displayed.

=== Dyeing armor ===

[[File:DyeGraph2.png|200px|thumb|A graph showing all combinations of two dyes on a [[tunic]].]]

Leather [[armor]] can be dyed by:
* Crafting dyes with a piece of leather armor or leather [[horse armor]].{{Only|java}}
* Dousing the leather armor or leather [[horse armor]] in a [[cauldron]] to which dyes have been added.{{Only|bedrock}}

There are 5,713,438<ref>https://anrar4.github.io/DyeLeatherArmor/</ref> (34.1% of sRGB) colors leather armor can be, as it is possible to put more than one dye on the crafting bench alongside the leather armor. Armor can be dyed multiple times with previous colors affecting the final outcome. Colored armor can be reverted to their original color using a [[cauldron]] with undyed water.

The game has a specific formula for calculating the color of dyed armor: each color, in the RGB color model, has a red value, green value, and blue value. For each dye in the crafting grid, and the armor itself (if it is already dyed), the red, green, and blue values are added to running totals. In addition, a running total of the highest value (be it red, green, or blue) is also kept. After this, each total is divided by the number of colors used. This effectively produces the average red, green, blue, and maximum values. The maximum value of the average RGB values is also calculated. Finally, each average RGB value is multiplied by the average maximum value and divided by the maximum of the average RGB values. The modified average RGB values are then used as the final color. This procedure can be summed up with the following equations:
 for each color (all "total" variables start at 0 before counting):
  totalRed = totalRed + redValue
  totalGreen = totalGreen + greenValue
  totalBlue = totalBlue + blueValue
  totalMaximum = totalMaximum + max(redValue, greenValue, blueValue)
  numberOfColors = numberOfColors + 1
 
 averageRed = totalRed / numberOfColors
 averageGreen = totalGreen / numberOfColors
 averageBlue = totalBlue / numberOfColors
 averageMaximum = totalMaximum / numberOfColors
 
 maximumOfAverage = max(averageRed, averageGreen, averageBlue)
 gainFactor = averageMaximum / maximumOfAverage
 
 resultRed = averageRed * gainFactor
 resultGreen = averageGreen * gainFactor
 resultBlue = averageBlue * gainFactor

Due to the way this formula works, the resulting color can never be darker than the average of the input colors and is often lighter and more saturated. Of course, the resulting color can never be lighter or more saturated than the lightest or most saturated input color. In addition, this formula never creates an RGB value higher than 255 (which would be invalid in the 8-bit RGB color model).

If leather armor is renamed on an [[anvil]], it retains its name when dyed or undyed.

;Mixing Samples
: {{ItemSprite|Yellow Dye}} + {{ItemSprite|Yellow Dye}} = {{Tint|leather-chestplate| #{{CalcDye| yellow=2 }} | code=1}}
: {{ItemSprite|Red Dye}} + {{ItemSprite|Blue Dye}} + {{ItemSprite|White Dye}} = {{Tint|leather-chestplate| #{{CalcDye| red=1 | blue=1 | white=1}} | code=1}}
: {{ItemSprite|Green Dye}} + {{ItemSprite|Red Dye}} + {{ItemSprite|Pink Dye}} = {{Tint|leather-chestplate| #{{CalcDye| green=1 | red=1 | pink=1}} | code=1}}

=== Dyeing firework stars ===

A [[firework star]] can have a single color or a combination of up to eight colors when crafted with dyes. Adding one or more dyes to a crafted firework star adds a "fade to color" effect to it, overwriting any existing fade colors.

{{Crafting
  |head=1
  |ignoreusage=1
  |ingredients=[[Gunpowder]] +<br>Any Dye (1–8) +<br>Extra ingredient (optional)
  |Gunpowder
  |Matching Dye
  |Diamond;Glowstone Dust;Head;Gold Nugget;Feather;Fire Charge;
  |Output=Matching Firework Star
}}
{{Crafting
  |ignoreusage=1
  |Matching Firework Star
  |Any Dye
  |Output=Matching Firework Star
  |foot=1
}}

=== Creating balloons ===

Dye can be used to craft balloons.{{only|education}}

{{Crafting
|nocat=1
|A1= Latex
|B1= Matching Dye
|C1= Latex
|A2= Latex
|B2= Helium
|C2= Latex
|A3= Latex
|B3= Lead
|C3= Latex
|Output= Matching Balloon
}}

=== Creating glow sticks ===

Dye can also be used to craft glow sticks.{{only|education}}

{{Crafting
|nocat=1
|A1= Polyethylene
|B1= Hydrogen Peroxide
|C1= Polyethylene
|A2= Polyethylene
|B2= Matching Dye
|C2= Polyethylene
|A3= Polyethylene
|B3= Luminol
|C3= Polyethylene
|Output= Matching Glow Stick
}}

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

=== Signs ===
Dye can be {{control|used}} on a [[sign]] or a [[hanging sign]] to change the text color. {{IN|bedrock}}, [[ink sac]]s cannot be used for this purpose; black dye must be used to change the text to black.

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

== Color values ==
The "color codes" are used to determine the color imparted on sheep, wolf and cat collars, firework stars, [[beacon]] beams, and dyed leather armor. The hex value is shown in the extended tooltips of dyed leather armor; however, to set the color using an NBT data tag in a [[command]], the decimal value must be used instead. The color values for firework stars are slightly different from the ones listed below, and use [[Item colors#Firework stars|these values]] instead.

{| class="wikitable" style="margin:2px; border: 1px solid silver; text-align: left;" data-description="Data values"
! rowspan=2 | Description
! colspan=2 style="text-align:center" | Color Code
|-
! Dec
! <abbr title="Hexadecimal color code">Hex</abbr>
|-
| style="text-align:center" | White || 16383998 || {{color|#F9FFFE}}
|-
| style="text-align:center" | Light gray || 10329495 || {{color|#9D9D97}}
|-
| style="text-align:center" | Gray || 4673362 || {{color|#474F52}}
|-
| style="text-align:center" | Black || 1908001|| {{color|#1D1D21}}
|-
| style="text-align:center" | Brown || 8606770 || {{color|#835432}}
|-
| style="text-align:center" | Red || 11546150 || {{color|#B02E26}}
|-
| style="text-align:center" | Orange || 16351261 || {{color|#F9801D}}
|-
| style="text-align:center" | Yellow || 16701501 || {{color|#FED83D}}
|-
| style="text-align:center" | Lime || 8439583 || {{color|#80C71F}}
|-
| style="text-align:center" | Green || 6192150 || {{color|#5E7C16}}
|-
| style="text-align:center" | Cyan || 1481884|| {{color|#169C9C}}
|-
| style="text-align:center" | Light blue || 3847130 || {{color|#3AB3DA}}
|-
| style="text-align:center" | Blue || 3949738 || {{color|#3C44AA}}
|-
| style="text-align:center" | Purple || 8991416 || {{color|#8932B8}}
|-
| style="text-align:center" | Magenta || 13061821 || {{color|#C74EBD}}
|-
| style="text-align:center" | Pink || 15961002 || {{color|#F38BAA}}
|}

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Dye.ogg
|subtitle=Dye stains
|source=block
|description=When dye is used on a [[sign]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16}}
{{Sound table
|subtitle=Dye stains
|source=player
|description=When dye is used on a [[sheep]]
|id=item.dye.use
|translationkey=subtitles.item.dye.use
|volume=1.0
|pitch=1.0/0.9/0.95/1.1
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Dye.ogg
|source=sound
|description=When dye is used on a sign
|id=sign.dye.use
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=3
|sound=Water Splash Old.ogg
|source=block
|description=When dye is added to a cauldron
|id=cauldron.adddye
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When armor is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When dye is removed from armor using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0
|foot=1}}

== Achievements ==
{{load achievements|Rainbow Collection;Tie dye outfit}}

== Video ==

{{Video note|These videos are outdated, as it does not include details of the [[Java Edition 1.7.2|1.7.2]] update's changes to the dyeing system/production chain.}}

<div style="text-align:center">
<span style="display:inline-block">{{yt|8YD7oauNZHE}}</span>
<span style="display:inline-block">{{yt|7tETaRt7STM}}</span>
</div>

== History ==
{{History|java beta}}
{{History||January 3, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/2582321901/2011-here-we-go|Notch mentions adding a "paint" feature if he can figure out how.}}
{{History||January 10, 2011<ref group="n">Supposed time when fragment was filmed. Based on modified date of client.jar/gui/trap.png in [[Beta 1.2]].</ref>|link=https://www.youtube.com/watch?v=cBF2ugTzXqQ&t=181s|[[File:Red Dye (pre-release).png|32px]] Shown rose red in development as part of [[Minecraft: The Story of Mojang]].}}
{{History||1.2|[[File:Ink Sac JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Bone Meal JE1 BE1.png|32px]] Added dyes.
|[[File:Black Dye (Recreated).png|32px]] [[File:Red Dye (pre-release).png|32px]] [[File:Green Dye (Recreated).png|32px]] [[File:Brown Dye (Recreated).png|32px]] [[File:Blue Dye (Recreated).png|32px]] [[File:Purple Dye (Recreated).png|32px]] [[File:Cyan Dye (Recreated).png|32px]] [[File:Light Gray Dye (Recreated).png|32px]] [[File:Gray Dye (Recreated).png|32px]] [[File:Pink Dye (Recreated).png|32px]] [[File:Lime Dye (Recreated).png|32px]] [[File:Yellow Dye (Recreated).png|32px]] [[File:Light Blue Dye (Recreated).png|32px]] [[File:Magenta Dye (Recreated).png|32px]] [[File:Orange Dye (Recreated).png|32px]] [[File:White Dye (Recreated).png|32px]] Leftovers of old textures can be seen in [[items.png]] with 100% opacity. The white dye texture was reused for [[Sugar]].
| The colors were as follows:{{verify|Did the color codes remain the same between Beta 1.2 and Java 1.11.2?}}
{{:Color/Java Edition dye colors before 17w06a}}
}}
{{History|java}}
{{History||1.1|snap=11w49a|[[Sheep]] can now regrow their [[wool]] by eating [[grass block|grass]]. Dyed sheep regrow wool in their new color.}}
{{History||1.3.1|snap=12w19a|[[File:Cocoa Beans JE2.png|32px]] The texture of [[cocoa beans]] has been changed.}}
{{History|||snap=1.3|[[File:bone meal changes.gif|32px]] The textures of [[bone meal]], [[cactus green]], cocoa beans and [[rose red]] have been changed. The textures have been lowered one pixel.}}
{{History||1.4.2|snap=12w34a|Added the ability to dye leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.4|snap=1.4.3|Color codes have been changed. The colors of red, brown, blue, purple, cyan, pink, light blue, magenta and orange were adjusted a little vividly.}}
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted using dyes.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary dyes.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted using dyes.}}
{{History||1.8|snap=14w02a|As cleric [[villager]]s now sell lapis lazuli, all dyes have become fully renewable.}}
{{History|||snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.9|snap=15w34a|Added [[shield]]s, which can be dyed indirectly by applying a matching [[banner]].}}
{{History||1.11|snap=16w39b|Dyes are now used to change the color of [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Dyes are now used to craft [[concrete powder]].
|Color codes have been changed. All colors are adjusted more vividly. The changes were as follows:
{{:Color/Java Edition dye color changes in 17w06a}}
|Light blue dye, stained glass, and stained glass panes, did not change colors in this update. This means that they still use old colors.<ref name="unchanged dyes">{{Bug|MC-214643}}<br>{{Bug|MC-214641}}</ref>
}}
{{History|||snap=17w15a|Dyes can now apply color to white [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have been split up into their own IDs.}}
{{History||1.14|snap=18w43a|[[Bone meal]], [[ink sac]]s, [[cocoa beans]] and [[lapis lazuli]] are no longer considered dyes.
|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]] and [[blue dye]]s.
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively. 
|[[Glass pane]]s and [[carpet]]s can now be dyed.
|[[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of light gray, gray, red, orange, yellow, lime, green, cyan, light blue, purple, magenta, and pink dyes, have been changed. The color texture for light blue dye was not changed to reflect the updated colors from 1.12.<ref name="unchanged dyes"></ref>}}
{{History|||snap=18w44a|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=18w49a|Yellow dyes can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=18w50a|Green dyes can now be found in [[chest]]s in [[desert]] [[village]] houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which can sell any type of dye.}}
{{History|||snap=19w11a|All 16 types of dyes can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.16.2|snap=Pre-release 2|Reversed the order of dyes to match other colored items in the [[Creative inventory]].<ref name="reverse dye">{{Bug|MC-136553}}</ref>
|Regrouped dyes in the Creative inventory such that white, blue, brown, and black dyes are within and not [[cocoa beans]], [[ink sacs]], [[lapis lazuli]], and [[bone meal]].<ref name="regroup dye">{{Bug|MC-177684}}</ref>}}
{{History||1.17|snap=20w45a|Added [[candle]]s, which can be dyed.}}
{{History|||snap=21w03a|Added a sound for applying dyes.}}
{{History|||snap=21w19a|Candles can no longer be dyed.}}
{{History|||snap=Pre-release 1|Candles can now once again be dyed.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|The color of the text on [[hanging sign]]s can now be changed with dye.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[Torchflower]]s can now be crafted into orange dye.|[[Pink petals]] can now be crafted into pink dye.}}
{{History||1.20|snap=23w12a|[[Pitcher plant]]s can now be crafted into cyan dye.|Blue, light blue, orange, white, and yellow dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w14a|Pitcher plants can now craft two [[cyan dye]] instead of one.}}
{{History|||snap=23w16a|Blue, light blue, orange, white, and yellow dye no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; blue, light blue, orange, white, and yellow dye now are in the common loot.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes. Only [[dandelion yellow]] and [[lapis lazuli]] are currently obtainable and have functionality.}}
{{History||v0.3.2|[[Cactus green]] is now obtainable by smelting [[cacti]].}}
{{History||v0.3.3|[[Bone meal]] is now obtainable via [[crafting]].}}
{{History||v0.4.0|[[Cyan dye]], [[light blue dye]], [[lime dye]], [[magenta dye]], [[orange dye]], [[pink dye]], and [[purple dye]] are now obtainable via crafting.
|[[Rose red]] is now obtainable by smelting red [[mushroom]]s.
|All available dyes, excluding bone meal, can now be used to craft their respective [[wool]] color.}}
{{History||v0.8.0|snap=build 1|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History|||snap=build 3|[[Ink sac]]s, [[cocoa bean]]s, [[gray dye]], and [[light gray dye]] are now available in the [[creative]] [[inventory]].
|Rose red can now be obtained from [[beetroot]]s.}}
{{History||v0.9.0|snap=build 1|Cocoa beans can now be obtained from [[cocoa pod]]s.
|The [[rose]] has been removed and replaced with a new poppy [[flower]] that can be crafted into rose red.}}
{{History|||snap=build 3|All new [[flower]]s can now be [[crafting|crafted]] into dyes. Because of this, many secondary and tertiary dyes are now primary dyes.
|[[Gray dye]] and [[light gray dye]] can now be obtained in [[survival]].}}
{{History|||snap=build 11|[[Terracotta|Stained clay]] can now be crafted using dyes.}}
{{History||v0.11.0|snap=build 1|[[Ink sac]]s can now be obtained from [[squid]].
|Added the ability to dye [[wolf]] collars.}}
{{History||v0.12.1|snap=build 1|Red [[mushroom]]s can no longer be smelted to obtain [[rose red]].}}
{{History||v0.14.0|snap=build 1|[[Cauldron]]s now used for leather dyeing, by applying a dye to a [[water]]-filled cauldron.}}
{{History||v0.16.0|snap=build 1|[[Cocoa bean]]s can no longer be crafted.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added a ''Dye'' button for [[sheep]].
|Added [[shulker]]s, which can be dyed.
|Added [[stained glass]]. Stain glass cannot be [[crafting|crafted]], but purple glass generates in [[end city|end cities]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Dyes can now apply color to a white [[bed]]s.
|Dyes are now used to craft [[concrete powder]].
|The color palette has been changed.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Dyes can now be used for [[banner]] crafting.
|Dyes can now be used to craft [[firework star]]s.
|[[Stained glass]] is now [[crafting|craftable]], using dyes.}}
{{History||1.4.0|snap=beta 1.2.20.1|[[Lime dye]] can now be obtained from smelting [[sea pickle]]s.
|Dyes can now used to craft [[glow stick]]s and [[balloon]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Dyes can now be used to dye [[cat]] collars.}}
{{History|||snap=beta 1.8.0.10|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[brown dye|brown]], [[black dye|black]] and [[blue dye]]s, which can be crafted from [[lapis lazuli]], [[bone meal]], [[cocoa beans]] and [[ink sac]]s. This, however, the later four still use as dyes.<ref>{{Bug|MCPE-42473}}</ref>
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||1.9.0|snap=beta 1.9.0.0|Blue and white dye can now be obtained from [[cornflower]]s and [[lily of the valley]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Glass pane]]s and [[carpet]]s can now be dyed.
|Only a single dye is now required to apply a banner pattern in a [[loom]].
|Various dyes except black dye, white dye, brown dye and blue dye are now [[trading|sold]] by [[wandering trader]]s.
|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE3 BE3.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.210|snap=beta 1.16.210.59|The color of the text on [[sign]]s can now be changed with dye.}}
{{History|||snap=beta 1.16.210.60|The ability to dye the color of the text on [[sign]]s was temporarily removed.}}
{{History||1.16.220|snap=beta 1.16.220.50|The color of the text on [[sign]]s can now be changed with dye again.}}
{{History||1.17.10|snap=beta 1.17.10.22|Added [[candles]], which can be dyed.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE1 BE1.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes.}}
{{History||xbox=TU9|[[File:Cocoa Beans JE3 BE2.png|32px]] The texture of cocoa beans has been changed.}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|[[File:White Dye JE1 BE1.png|32px]] [[File:Black Dye JE1 BE1.png|32px]] [[File:Brown Dye JE1 BE1.png|32px]] [[File:Blue Dye JE1 BE1.png|32px]] Added [[white dye|white]], [[black dye|black]], [[brown dye|brown]], and [[blue dye|blue]] dyes, which can crafted from [[bone meal]], [[ink sac]], [[cocoa beans]], and [[lapis lazuli]].
|"Rose Red", "Dandelion Yellow" and "Cactus Green" have been renamed to "Red Dye", "Yellow Dye" and "Green Dye", respectively.}}
{{History||ps=1.90|[[File:Bone Meal JE2 BE2.png|32px]] [[File:Light Gray Dye JE2 BE2.png|32px]] [[File:Gray Dye JE2 BE2.png|32px]] [[File:Ink Sac JE2 BE2.png|32px]] [[File:Cocoa Beans JE4 BE3.png|32px]] [[File:Red Dye JE2 BE2.png|32px]] [[File:Orange Dye JE2 BE2.png|32px]] [[File:Yellow Dye JE2 BE2.png|32px]] [[File:Lime Dye JE2 BE2.png|32px]] [[File:Green Dye JE2 BE2.png|32px]] [[File:Cyan Dye.png|32px]] [[File:Light Blue Dye JE2 BE2.png|32px]] [[File:Lapis Lazuli JE2 BE2.png|32px]] [[File:Purple Dye JE2 BE2.png|32px]] [[File:Magenta Dye JE2 BE2.png|32px]] [[File:Pink Dye JE2 BE2.png|32px]] The textures of bone meal, light gray, gray, ink sac, cocoa beans, red, orange, yellow, lime, green, cyan, light blue, lapis lazuli, purple, magenta, and pink dyes have been changed.}}
{{History|3ds}}
{{History||0.1.0|[[File:Bone Meal JE1 BE1.png|32px]] [[File:Light Gray Dye JE1 BE1.png|32px]] [[File:Gray Dye JE1 BE1.png|32px]] [[File:Ink Sac JE1 BE1.png|32px]] [[File:Cocoa Beans JE3 BE2.png|32px]] [[File:Red Dye JE1 BE1.png|32px]] [[File:Orange Dye JE1 BE1.png|32px]] [[File:Yellow Dye JE1 BE1.png|32px]] [[File:Lime Dye JE1 BE1.png|32px]] [[File:Green Dye JE1 BE1.png|32px]] [[File:Cyan Dye JE1 BE1.png|32px]] [[File:Light Blue Dye JE1 BE1.png|32px]] [[File:Lapis Lazuli JE1 BE1.png|32px]] [[File:Purple Dye JE1 BE1.png|32px]] [[File:Magenta Dye JE1 BE1.png|32px]] [[File:Pink Dye JE1 BE1.png|32px]] Added dyes from [[Pocket Edition v0.15.4 alpha]].}}
{{History|foot}}
<gallery>
Pre-release dyes.png|Pre-release dye textures hidden within [[Items.png]].
</gallery>
;Notes
{{reflist|group=n}}

== Gallery ==
<gallery>
White Dye.png|White Dye
Light Gray Dye.png|Light Gray Dye
Gray Dye.png|Gray Dye
Black Dye.png|Black Dye
Brown Dye.png|Brown Dye
Red Dye.png|Red Dye
Orange Dye.png|Orange Dye
Yellow Dye.png|Yellow Dye
Lime Dye.png|Lime Dye
Green Dye.png|Green Dye
Cyan Dye.png|Cyan Dye
Light Blue Dye.png|Light Blue Dye
Blue Dye.png|Blue Dye
Purple Dye.png|Purple Dye
Magenta Dye.png|Magenta Dye
Pink Dye.png|Pink Dye
</gallery>

==Issues==
{{issue list}}

== Trivia ==
* Players can obtain each one of every color with 1 cocoa bean, 2 yellow dye, 2 ink sac, 3 green dye, 4 lapis lazuli, 4 red dye, and 6 bone meal (2 bones).
* The dyed sheep breeding behavior mirrors [[wikipedia:Lamarckism|Lamarck's theory]], in which the organisms evolve inheriting the external changes and adaptations of the previous generation, transmitting them to their offspring.
* In ''Bedrock Edition'', tertiary colors, along with their regular crafting recipes, can be crafted with primary colors. E.g.: Magenta can be crafted with one rose red and two bone meals.
* The colors of the dyes match the chat colors in [[color codes]] except for brown (dye only), light aqua, and gold (color codes only).
* The texture for light blue dye still uses the color from prior to the 1.12 World of Color update.<ref name="unchanged dyes"></ref>

== References ==
{{reflist}}

== External Links ==
* Tools for calculating leather dye combination: [https://minecraft.tools/en/armor.php minecraft.tools] (webapp); [https://github.com/pudquick/pyMCdyes/ pyMCDyes] (open-source Python script, outdated); [https://anrar4.github.io/DyeLeatherArmor/ DyeLeatherArmor]: a tool for calculating an exact crafting recipe for any sRGB color

{{Items}}

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

[[cs:Barvivo]]
[[de:Farbstoff]]
[[es:Tinte]]
[[fr:Teinture]]
[[hu:Színezés]]
[[it:Colorante]]
[[ja:染料]]
[[ko:염료]]
[[nl:Kleurstof]]
[[pl:Barwniki]]
[[pt:Corante]]
[[ru:Красители]]
[[th:สีย้อม]]
[[uk:Барвники]]
[[zh:染料]]</li></ul>
13w37aAdded /tellraw, the raw JSON text used to support this command.
1.8
{{Extension DPL}}<ul><li>[[Cyan Dye|Cyan Dye]]<br/>{{Item
| image = Cyan Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Cyan dye''' is a [[Dyeing#Secondary|secondary dye color]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showdescription=1
  |showname=0
  |Blue Dye
  |Green Dye
  |Output=Cyan Dye,2
  |type=Material
}}
{{Crafting
  |Lapis Lazuli
  |Green Dye
  |Output=Cyan Dye,2
  |description={{only|bedrock|education}}
  |type=Material
}}
{{Crafting
  |Pitcher Plant
  |Output=Cyan Dye,2
  |description=
  |type=Material
  |foot=1
}}

=== Trading ===

[[Wandering trader]]s sell 3 cyan dye for an [[emerald]].

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===
{{IN|bedrock}}, journeyman-level shepherd villagers have 20% chance to buy 12 cyan dye for an emerald.
{{More info|java=1|Java UI does not use a specific trade slot, which results in a different chance to offer this trade.}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Cyan Dye
|spritetype=item
|nameid=cyan_dye
|aliasid=dye / 6
|id=401
|form=item
|translationkey=item.dye.cyan.name
|foot=1}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Cyan Dye JE1 BE1.png|32px]] Added cyan dye.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Cyan dye can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{history||1.7.2|snap=13w36a|With the addition of new [[flower]]s, many secondary and tertiary dyes are now primary [[dye]]s.}}
{{History|||snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w02a|Due to [[lapis lazuli]] being [[renewable resource|renewable]], cyan dye is also renewable.}}
{{History|||snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|Cyan dye is now [[crafting|crafted]] using [[blue dye]], instead of [[lapis lazuli]].
|[[File:Cyan Dye.png|32px]] The texture of cyan dye has now been changed.}}
{{History|||snap=18w44a|Cyan dye can now change the text color on [[sign]]s to cyan.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell cyan dyes.}}
{{History|||snap=19w11a|Cyan dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Cyan dye can now be used to craft [[cyan candle]]s.}}
{{History|||snap=21w19a|Cyan dye can no longer be used to craft cyan candles.}}
{{History|||snap=Pre-release 1|Cyan dye can once again be used to craft cyan candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Cyan dye can now change the text color on [[hanging sign]]s to cyan.}}
{{History||1.20|snap=23w12a|Added [[pitcher plant]]s, which can be crafted into cyan dye.}}
{{History|||snap=23w14a|[[Pitcher plant]]s now craft into 2 cyan dye instead of 1.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Cyan Dye JE1 BE1.png|32px]] Added cyan dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Cyan dye is now craftable with [[lapis lazuli]] and [[cactus green]].
|Cyan dye can now be used to craft cyan wool.}}
{{History||v0.6.0|Cyan dye can now be used to dye [[sheep]].}}
{{History||v0.9.0|snap=build 11|Cyan dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Cyan dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Cyan dye can now be used to dye water in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Cyan dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Cyan dye can now be used to craft [[concrete powder]], colored [[bed]]s and dyed [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Cyan dye can now be used to craft [[firework star]]s, [[stained glass]] and patterns on [[banner]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Cyan dye can now be used to craft [[balloon|ballons]] and [[glow stick|glow sticks]].}}
{{History||1.8.0|snap=beta 1.8.0.8|Cyan dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Cyan dye are now [[trading|sold]] by [[wandering trader]]s.
|Cyan dye can now be used to dye white [[carpet|carpets]] and undyed [[glass pane]]s.
|[[File:Cyan Dye.png|32px]] The texture of cyan dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Cyan dye can be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of cyan dye has been changed from <code>dye/6</code> to <code>cyan_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Cyan Dye JE1 BE1.png|32px]] Added cyan dye.}}
{{History|PS4}}
{{History||1.90|[[File:Cyan Dye.png|32px]] The texture of cyan dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Cyan Dye JE1 BE1.png|32px]] Added cyan dye.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

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

[[cs:Azurové barvivo]]
[[de:Türkiser Farbstoff]]
[[es:Tinte cian]]
[[fr:Teinture cyan]]
[[hu:Ciánkék festék]]
[[ja:青緑色の染料]]
[[ko:청록색 염료]]
[[nl:Turquoise kleurstof]]
[[pl:Błękitny barwnik]]
[[pt:Corante ciano]]
[[ru:Бирюзовый краситель]]
[[zh:青色染料]]</li><li>[[Kelp|Kelp]]<br/>{{About|the plant|the dried variant|Dried Kelp}}
{{For}}
{{Block
|image=Kelp.gif
|invimage=Kelp
|transparent=Yes
|tool=Any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
|light=No
|hardness=0}}

'''Kelp''' is an underwater plant that generates in most [[ocean]]s.

== Obtaining ==

=== Natural generation ===

Kelp naturally generates in any [[ocean]] [[biome]]s (except in [[Frozen Ocean|frozen]], [[Deep Frozen Ocean|deep frozen]] and [[Warm Ocean|warm]]), near and around [[seagrass]]. Each chunk has {{frac|1|18}} chance to generate a [[vegetation]] of kelp.

=== Breaking ===

Kelp can be mined instantly with any [[tool]] or with the player's fist. Removing water from the kelp block destroys the kelp. Breaking one part of a kelp stalk destroys all kelp [[block]]s above it. Each block drops a kelp [[item (entity)|item]].

=== Trading ===

Kelp can be bought from [[wandering trader]]s for 3 emeralds.

== Usage ==

Kelp can be placed underwater by hand, or anywhere by the use of [[commands]] such as {{cmd|setblock}}. Placing it by hand gives it a random {{code|age}} value between 0 and 24. Kelp can be placed only in [[water]] source blocks or downward-flowing water, not horizontally flowing water.

When placed in downward-flowing water, the flowing water transforms into a water source block,<ref>{{bug|MC-134229}}</ref> which is useful for faster [[bubble column]] elevator creation.

Any building block can be placed on top of a kelp plant, which is useful for building structures over a deep ocean without needing to build from the ocean floor (see also [[lily pad]]).

=== Cooking ingredient ===

{{smelting
| showname = 1
| Kelp
| Dried Kelp
| 0.1
}}

=== Composting ===

Placing kelp into a [[composter]] has a 30% chance of raising the compost level by 1.

=== Growth mechanics ===

Kelp can be planted on a broad variety of blocks. It grows underwater if it has either a source block of water or, {{in|Java}}, flowing water above it.<ref>{{bug|MC-133354}}</ref> Neither [[player]]s nor [[dispenser]]s can remove the water source block that kelp grows in without breaking the kelp first.

Kelp does not require any [[light]] level to grow. Kelp also grows without having [[sky]] access. [[Bone meal]] can be used to grow kelp by 1 block on each use.

Kelp, when planted, is generated with a randomly chosen age value, which can be checked when pressing [[Debug screen|<kbd>F3</kbd>]]{{only|java}}. The age value of a newly planted kelp plant varies randomly from 0 to 24. Each time the kelp grows in height by one block, the newly generated top of the kelp plant increases its age by 1. When the top block of the kelp plant reaches an age of 25, it stops growing. This means that kelp can naturally grow to a height between 2 (if the first kelp plant had an age of 24) and 26 blocks (if the first kelp plant had an age of 0). 

When a kelp plant block is broken, the age of the kelp plant block underneath is randomized to a value from 0 to 24 and the kelp continues growing until it reaches age 25. It is possible to use this mechanic to cultivate a kelp plant to increase its growth height beyond its natural maximum height of 26 blocks. This can be done by breaking the top-most block of the kelp plant each time it reaches age 25. A kelp plant cultivated by a player in this way repeatedly grows until it reaches the water surface.

Each time it receives a [[random tick]], kelp has a 14% chance of growing.

If [[shears]] are used on the topmost block of kelp, that block automatically sets its {{cd|age}} value to {{cd|25}} and stop growing.{{only|JE}}

=== Farming ===
{{Main|Tutorials/Kelp farming}}
Kelp farming is similar to farming [[sugar cane]], although kelp must be placed underwater. Automation of harvest is easier because items float up in water.

== Sounds ==
=== Generic ===
{{Sound table/Block/Wet grass}}
=== Unique ===
{{edition|java}}:
{{Sound table
|sound=Shear.ogg
|subtitle=Plant cropped
|source=block
|description=When the tip of kelp is cropped with [[Shears#Cropping growing plants|shears]]
|id=block.growing_plant.crop
|translationkey=subtitles.block.growing_plant.crop
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}: ''None''

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Kelp
|spritetype=block
|nameid=kelp}}
{{ID table
|displayname=Kelp Plant
|spritetype=block
|nameid=kelp_plant
|form=block
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Kelp
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=kelp
|spritetype=item
|nameid=kelp
|id=382
|form=item}}
{{ID table
|displayname=Block
|spritename=kelp
|spritetype=block
|nameid=kelp
|id=393
|form=block
|itemform=item.kelp
|translationkey=-
|foot=1}}

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

{{/BS}}

== History ==
{{History|java classic}}
{{History||May 21, 2009|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/110762705/my-list-on-tile-types-so-far|[[Notch]] shows interest in adding a "[[seaweed]]" [[block]].}}
{{History|java}}
{{History||November 18, 2017|link={{YouTubeLink|mAapz_nIC_Y}}|Kelp plants were shown in a clip of [[MineCon Earth]].}}
{{History||1.13|snap=18w07a|[[File:Kelp JE1 BE1.gif|32px]] [[File:Kelp (item) JE1 BE2.png|32px]] Added kelp.}}
{{History|||snap=18w07b|Kelp now behaves more like [[water]], meaning [[mob]]s can no longer spawn within the plant under water nor can they replenish their breath by [[swimming]] through it.}}
{{History|||snap=18w10a|[[File:Kelp JE2.gif|32px]] The texture for kelp has been overhauled.}}
{{History|||snap=18w14a|[[File:Kelp.gif|32px]] Top of the kelp textures have been shifted slightly downward.
|The generation rules for kelp have been changed, it now mainly generates in [[cold ocean]] [[biome]]s and can no longer generate in [[warm ocean]]s.}}
{{History|||snap=18w20a|The {{cd|kelp_top}} has been changed ID to {{cd|kelp}} and {{cd|kelp}} has been changed to {{cd|kelp_plant}}, for both the [[block]] and [[item]] forms.}}
{{History|||snap=pre2|Kelp is now destroyed by [[sponge]]s.<ref>{{bug|MC-127111}}</ref>}}
{{History|||snap=pre6|Added 5 new [[sound]] events that apply to kelp: <code>block.wet_grass.break</code>, <code>block.wet_grass.fall</code>, <code>block.wet_grass.hit</code>, <code>block.wet_grass.place</code>, and <code>block.wet_grass.step</code>.}}
{{History||1.14|snap=19w03a|Placing kelp into the new [[composter]] has a 10% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Kelp now has a 30% chance of increasing the compost level in a composter by 1.
|Added [[Wandering Trader|wandering trader]]s, which sell kelp.}}
{{History||1.16|snap=20w11a|Kelp can now be grown with [[bone meal]].}}
{{History|||snap=20w13a|Kelp 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=20w46a|Kelp no longer generates on magma blocks.<ref>{{Bug|MC-185605|resolution=Fixed}}</ref>}}
{{History||1.18|snap=21w37a|Kelp now stops growing if [[shears]] are used on the tip.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[File:Kelp JE1 BE1.gif|32px]] [[File:Kelp (item) BE1.png|32px]] Added kelp.}}
{{History|||snap=beta 1.2.20.1|[[File:Kelp (item) JE1 BE2.png|32px]] The kelp [[item]] texture has been updated to the {{el|je}}'s.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Kelp.gif|32px]] The texture of the kelp plant has been updated.}}
{{History||1.10.0|snap=beta 1.10.0.3|Kelp can now be bought from [[wandering trader]]s for 3 [[emerald]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Kelp can now be used to fill [[composter]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Kelp.gif|32px]] [[File:Kelp (item) JE1 BE2.png|32px]] Added kelp.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* In real life, [[wikipedia:kelp|kelp]] is not considered a [[wikipedia:plant|plant]]. It is classified by scientists as a [[wikipedia:Brown algae|brown algae]].
** Kelp in real life absorbs nutrients directly from the water, instead of through its root-like structure, [[wikipedia:Holdfast (biology)|holdfast]], which merely attaches it to the seabed. This is in accordance with kelp being able to grow on almost any solid block in ''Minecraft''.

== Gallery ==
<gallery heights="60">
SeaPlantsMineConEarth2017.jpg|Kelp shown in a clip from MINECON Earth 2017. 
Kelp in ocean with Jappa textures.jpg|Naturally generated kelp in an [[ocean]] biome.
Kelp on shoreline.png|Naturally generated kelp near the shore.
Ocean life.png|An ocean with kelp visible in the far distance.
Kelp on Land.png|Kelp placed outside of [[water]] using the {{cmd|setblock}} command before 18w07b.
Waterless kelp.png|What kelp looks like without water (water removed using a [[resource pack]]).
Coral reef at night.png|Kelp within a [[coral reef]].
Floating Kelp.png|Kelp that generated in mid-air due to an [[ocean monument]]'s water cutting through it.
Kelp in ocean.jpg|Multiple kelps.
Kelp 255 blocks tall.png|Without obstacles, kelp can grow all the way to building limit.
ArgoMajor Kelp.jpg|First image of kelp in ''Bedrock Edition''.
</gallery>

== References ==
{{reflist}}

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

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

[[de:Seetang]]
[[es:Alga]]
[[fr:Algue]]
[[ja:コンブ]]
[[ko:켈프]]
[[pl:Wodorosty]]
[[pt:Alga]]
[[ru:Ламинария]]
[[th:สาหร่ายทะเล]]
[[zh:海带]]</li></ul>
14w02aAdded text component insertion.
14w07aAdded text component score.
14w20aAdded /title, that supported by raw JSON text.
Added text component selector.
14w25aNow supports the signs and the written books.
1.12
{{Extension DPL}}<ul><li>[[Wheat|Wheat]]<br/>{{About||the artifact in ''Minecraft Dungeons''|Minecraft Dungeons:Wonderful Wheat|the seed|Wheat Seeds}}
{{Item
| image = Wheat.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Wheat''' is an [[item]] primarily obtained by harvesting fully-grown [[Wheat Seeds|wheat crops]]. It is used for [[crafting]] as well as to feed certain animals.

== Obtaining ==

=== Natural generation ===

{{LootChestItem|wheat}}

=== Farming ===

{{main|Tutorials/Crop farming}}

When a fully-grown wheat crop is harvested, it drops 1 wheat and 1 to 4 [[wheat seeds]] ({{frac|2|5|7}} per crop harvested on average). A wheat crop has a total of eight stages (0-7) from the time it is planted until it can be harvested. If a crop is harvested before it is fully grown, it just drops one seed. Wheat needs light to grow; a seed is destroyed if planted without light. Harvesting with a [[Fortune]]-enchanted tool increases the number of seeds dropped but does not increase the yield of wheat.

=== Crafting ===

{{Crafting
|Hay Bale
|Output= Wheat,9
|type= Material
}}

=== Drops ===
A [[fox]] sometimes spawns holding wheat, which it always drops upon death. Alternatively, the player can drop a [[food]] item, causing the fox to drop the wheat.

== Usage ==

=== Food ===

[[File:New Cattle.png|thumb|Using wheat to lead a cow.]]
When wheat is held, it causes nearby [[cow]]s, [[sheep]], [[goat]]s and [[mooshroom]]s to follow the player, until either the player stops holding the wheat or goes too far away from the animal, thus leading them to lose interest.

Wheat may be used to [[breed]] cows, sheep, goats, and mooshrooms by first herding two of them together and then {{control|using}} the wheat on them to begin "Love Mode."

Wheat can heal a [[horse]] {{hp|1}} health or lower its temper by 3% when attempting to tame it. It can also decrease the time it takes for a foal to grow by 20 seconds.

Similarly, wheat can heal a [[llama]] {{hp|2}} health, and it decreases the time it takes a baby llama to grow by 10 seconds.

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===

Novice-level farmer [[Villager|villagers]] have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 20 wheat for one [[emerald]].

=== Composting ===
Placing wheat into a [[composter]] has a 65% chance of raising the compost level by 1. A stack of wheat yields an average of 5.94 [[bone meal]].

== Achievements ==
{{load achievements|Bake Bread;The Lie;Repopulation}}

== Advancements ==
{{load advancements|A Seedy Place}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wheat
|spritetype=item
|nameid=wheat
|id=334
|form=item
|foot=1}}

== Video ==

{{Video note|the narrator demonstrates at 0:56 that walking over wheat can destroy the crop and un-till the land. This is outdated: since version {{Version link|JE 1.1}}, wheat can be destroyed only by a player or mob jumping on it or falling on it.}}

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

== History ==

{{History|java indev}}
{{History||20100206|[[File:Wheat JE1 BE1.png|32px]] Wheat has been added.
|Wheat can be used to craft [[bread]].}}
{{History||20100223|Bread now requires 3 wheat (1 row of 3) instead of 6 (2 rows of 3) to be crafted.}}
{{History|java infdev}}
{{History||20100625-2|Wheat can now be found in the new [[dungeon]] [[chest]]s.}}
{{History|java beta}}
{{History||1.2|Wheat can now be used to craft [[cake]].}}
{{History||1.4|Wheat can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Wheat can now be used in [[breeding]].}}
{{History||1.3.1|snap=12w21a|Wheat can now be [[trading|sold]] to farmer [[villager]]s, at 18–21 wheat for 1 [[emerald]].}}
{{History||1.4.2|snap=12w36a|[[Chicken]]s and [[pig]]s no longer use wheat to [[breeding|breed]].}}
{{History||1.6.1|snap=13w16a|[[Horse]]s can now be healed by being fed wheat.
|Foals can now have their growth increased by being fed wheat.}}
{{History|||snap=13w17a|[[Horse]]s can now have their tempers lowered with wheat.}}
{{History|||snap=13w18a|Nine wheat can now be crafted to make a [[hay bale]].}}
{{History||1.8|snap=14w02a|Trading has been changed: farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{history||1.9|snap=15w43a|Wheat may now be found in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of wheat in [[dungeon]] chests has been decreased.}}
{{History||1.11|snap=16w39a|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 296.}}
{{History|||snap=18w09a|Wheat can now generate in the chests of [[underwater ruins]].}}
{{History|||snap=18w11a|Wheat can now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History|||snap=18w47a|Wheat can now generate inside of loot chests on top of [[pillager outpost]]s.}}
{{History|||snap=18w49a|Wheat can now generate in chests in [[village]] butcher and shepherd houses.}}
{{History|||snap=18w50a|Wheat can now generate in chests in desert [[village]] houses.}}
{{History||1.14|snap=19w03a|Placing wheat into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Wheat now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with wheat in their mouths.}}
{{History||1.17|snap=21w13a|Wheat can now be used to breed [[goat]]s.}}
{{History||1.19|snap=22w11a|Wheat can now be used to craft [[packed mud]].}}
{{History||1.20|snap=23w12a|Wheat can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Wheat no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], wheat is now common loot.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Wheat is now obtainable via farming and can be used to craft [[bread]].}}
{{History||v0.7.0|Wheat can now be used to craft [[cake]].}}
{{History||v0.8.0|snap=build 1|Wheat can now be used to breed [[cow]]s and [[sheep]].
|Wheat can now be used to craft [[hay bale]]s.}}
{{History||v0.9.0|snap=build 1|Wheat [[crop]]s now naturally spawn in [[village]]s.
|Wheat can now be used to craft [[cookie]]s.}}
{{History||v0.15.0|snap=build 1|Wheat can now be used to grow, increase tame and heal [[horse]]s, [[donkey]]s and [[mule]]s.}}
{{History||v0.16.2|Wheat can now be found in the [[chest]]s inside of large houses in [[ice plains]] and [[cold taiga]] [[village]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Wheat can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Wheat can now be found inside [[shipwreck]] chests.}}
{{History|||snap=beta 1.2.20.1|Wheat can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Wheat can now be found in [[pillager outpost]] chests.
|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Wheat can now be found in [[desert]] [[village]] house chests, village shepherd and butcher house chests.
|Wheat can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has changed, farmer [[villager]]s now have a 25% chance to buy 20 wheat for one [[emerald]] as part of their first tier trade.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can drop wheat.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Wheat SDGP.png|Wheat in the [[Super Duper Graphics Pack]].
File:Field of Wheat.jpg|[[Steve]] and [[Kai]] in a field of wheat crops.<ref>https://www.instagram.com/p/CumuJleg6Ij/</ref>
</gallery>

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--wheat Taking Inventory: Wheat] – Minecraft.net on April 21, 2022
{{Items}}

[[Category:Plants]]
[[Category:Food]]

[[cs:Pšenice]]
[[de:Weizen]]
[[es:Trigo]]
[[fr:Blé]]
[[hu:Búza]]
[[it:Grano]]
[[ja:小麦]]
[[ko:밀]]
[[nl:Tarwe]]
[[pl:Pszenica]]
[[pt:Trigo]]
[[ru:Пшеница]]
[[th:ข้าวสาลี]]
[[uk:Пшениця]]
[[zh:小麦]]
[[Category:Renewable resources]]</li><li>[[Heart of the Sea|Heart of the Sea]]<br/>{{Item
| image = Heart of the Sea.png
| stackable = Yes (64)
| rarity = Uncommon
| renewable = No
}}

A '''heart of the sea''' is a rare [[item]] that can be crafted into a [[conduit]].

== Obtaining ==
The heart of the sea must be found. It cannot be crafted or obtained by trading, making it a [[non-renewable resource]].

A heart of the sea is obtained from a [[buried treasure]]. The location is marked with a noticeable red X on a [[Explorer Map|buried treasure map]], which is found in [[Ocean_Ruins|ocean ruins]] and [[Shipwreck|shipwrecks]]. Feeding [[raw cod]] or [[raw salmon]] to a [[dolphin]] causes the dolphin to swim toward the nearest [[buried treasure]], [[shipwreck]], or [[ocean ruins]].

=== Chest loot ===

{{LootChestItem|heart-of-the-sea}}

== Usage ==
=== Crafting===

{{crafting usage}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Heart of the Sea
|spritetype=item
|nameid=heart_of_the_sea
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Heart of the Sea
|spritetype=item
|nameid=heart_of_the_sea
|id=571
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.13|snap=18w15a|[[File:Heart of the Sea JE1 BE2.png|32px]] Added heart of the sea.}}
{{History|||snap=18w19a|Heart of the sea now generates in all [[buried treasure]] [[chest]]s in a stack of 1.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|An entry in the [[buried treasure]] loot table has been added named <code>nautilus_core</code>. It is unobtainable though since the <code>nautilus_core</code> has not been added into the game yet.}}
{{History|||snap=beta 1.2.20.1|[[File:Heart of the Sea BE1.png|32px]] Added heart of the sea as an [[item]] obtainable in buried treasure [[chest]]s. It cannot be used to craft [[conduit]]s yet.}}
{{History|||snap=beta 1.2.20.2|[[File:Heart of the Sea JE1 BE2.png|32px]] The texture of heart of the sea has been changed.}}
{{History||1.5.0|snap=beta 1.5.0.1|Heart of the sea can now be used to craft [[conduit]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Heart of the Sea JE1 BE2.png|32px]] Added heart of the sea.}}

{{History|education}}
{{History||1.4.0|[[File:Heart of the Sea JE1 BE2.png|32px]] Added heart of the sea. It generates in all [[buried treasure]] [[chest]]s in a stack of 1.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Before the heart of the sea was added to {{el|be}}, there was an entry found in the buried treasure chest loot table named <code>nautilus_core</code>, which was later revealed to be the heart of the sea. Despite the name change, the heart of the sea continues to be referred to as the <code>nautilus_core</code> in most game files.

== External Links ==
*[https://www.minecraft.net/en-us/article/heart-sea Taking Inventory: Heart of the Sea] – Minecraft.net on August 31, 2023

{{items}}

[[Category:Non-renewable resources]]

[[de:Herz des Meeres]]
[[fr:Cœur de la mer]]
[[es:Corazón del mar]]
[[it:Cuore del mare]]
[[ja:海洋の心]]
[[ko:바다의 심장]]
[[nl:Hart van de zee]]
[[pl:Serce oceanu]]
[[pt:Coração do mar]]
[[ru:Сердце моря]]
[[uk:Серце моря]]
[[zh:海洋之心]]</li></ul>
17w16aAdded text component keybind.
1.13
{{Extension DPL}}<ul><li>[[Wheat|Wheat]]<br/>{{About||the artifact in ''Minecraft Dungeons''|Minecraft Dungeons:Wonderful Wheat|the seed|Wheat Seeds}}
{{Item
| image = Wheat.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Wheat''' is an [[item]] primarily obtained by harvesting fully-grown [[Wheat Seeds|wheat crops]]. It is used for [[crafting]] as well as to feed certain animals.

== Obtaining ==

=== Natural generation ===

{{LootChestItem|wheat}}

=== Farming ===

{{main|Tutorials/Crop farming}}

When a fully-grown wheat crop is harvested, it drops 1 wheat and 1 to 4 [[wheat seeds]] ({{frac|2|5|7}} per crop harvested on average). A wheat crop has a total of eight stages (0-7) from the time it is planted until it can be harvested. If a crop is harvested before it is fully grown, it just drops one seed. Wheat needs light to grow; a seed is destroyed if planted without light. Harvesting with a [[Fortune]]-enchanted tool increases the number of seeds dropped but does not increase the yield of wheat.

=== Crafting ===

{{Crafting
|Hay Bale
|Output= Wheat,9
|type= Material
}}

=== Drops ===
A [[fox]] sometimes spawns holding wheat, which it always drops upon death. Alternatively, the player can drop a [[food]] item, causing the fox to drop the wheat.

== Usage ==

=== Food ===

[[File:New Cattle.png|thumb|Using wheat to lead a cow.]]
When wheat is held, it causes nearby [[cow]]s, [[sheep]], [[goat]]s and [[mooshroom]]s to follow the player, until either the player stops holding the wheat or goes too far away from the animal, thus leading them to lose interest.

Wheat may be used to [[breed]] cows, sheep, goats, and mooshrooms by first herding two of them together and then {{control|using}} the wheat on them to begin "Love Mode."

Wheat can heal a [[horse]] {{hp|1}} health or lower its temper by 3% when attempting to tame it. It can also decrease the time it takes for a foal to grow by 20 seconds.

Similarly, wheat can heal a [[llama]] {{hp|2}} health, and it decreases the time it takes a baby llama to grow by 10 seconds.

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===

Novice-level farmer [[Villager|villagers]] have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 20 wheat for one [[emerald]].

=== Composting ===
Placing wheat into a [[composter]] has a 65% chance of raising the compost level by 1. A stack of wheat yields an average of 5.94 [[bone meal]].

== Achievements ==
{{load achievements|Bake Bread;The Lie;Repopulation}}

== Advancements ==
{{load advancements|A Seedy Place}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wheat
|spritetype=item
|nameid=wheat
|id=334
|form=item
|foot=1}}

== Video ==

{{Video note|the narrator demonstrates at 0:56 that walking over wheat can destroy the crop and un-till the land. This is outdated: since version {{Version link|JE 1.1}}, wheat can be destroyed only by a player or mob jumping on it or falling on it.}}

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

== History ==

{{History|java indev}}
{{History||20100206|[[File:Wheat JE1 BE1.png|32px]] Wheat has been added.
|Wheat can be used to craft [[bread]].}}
{{History||20100223|Bread now requires 3 wheat (1 row of 3) instead of 6 (2 rows of 3) to be crafted.}}
{{History|java infdev}}
{{History||20100625-2|Wheat can now be found in the new [[dungeon]] [[chest]]s.}}
{{History|java beta}}
{{History||1.2|Wheat can now be used to craft [[cake]].}}
{{History||1.4|Wheat can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Wheat can now be used in [[breeding]].}}
{{History||1.3.1|snap=12w21a|Wheat can now be [[trading|sold]] to farmer [[villager]]s, at 18–21 wheat for 1 [[emerald]].}}
{{History||1.4.2|snap=12w36a|[[Chicken]]s and [[pig]]s no longer use wheat to [[breeding|breed]].}}
{{History||1.6.1|snap=13w16a|[[Horse]]s can now be healed by being fed wheat.
|Foals can now have their growth increased by being fed wheat.}}
{{History|||snap=13w17a|[[Horse]]s can now have their tempers lowered with wheat.}}
{{History|||snap=13w18a|Nine wheat can now be crafted to make a [[hay bale]].}}
{{History||1.8|snap=14w02a|Trading has been changed: farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{history||1.9|snap=15w43a|Wheat may now be found in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of wheat in [[dungeon]] chests has been decreased.}}
{{History||1.11|snap=16w39a|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 296.}}
{{History|||snap=18w09a|Wheat can now generate in the chests of [[underwater ruins]].}}
{{History|||snap=18w11a|Wheat can now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History|||snap=18w47a|Wheat can now generate inside of loot chests on top of [[pillager outpost]]s.}}
{{History|||snap=18w49a|Wheat can now generate in chests in [[village]] butcher and shepherd houses.}}
{{History|||snap=18w50a|Wheat can now generate in chests in desert [[village]] houses.}}
{{History||1.14|snap=19w03a|Placing wheat into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Wheat now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with wheat in their mouths.}}
{{History||1.17|snap=21w13a|Wheat can now be used to breed [[goat]]s.}}
{{History||1.19|snap=22w11a|Wheat can now be used to craft [[packed mud]].}}
{{History||1.20|snap=23w12a|Wheat can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Wheat no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], wheat is now common loot.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Wheat is now obtainable via farming and can be used to craft [[bread]].}}
{{History||v0.7.0|Wheat can now be used to craft [[cake]].}}
{{History||v0.8.0|snap=build 1|Wheat can now be used to breed [[cow]]s and [[sheep]].
|Wheat can now be used to craft [[hay bale]]s.}}
{{History||v0.9.0|snap=build 1|Wheat [[crop]]s now naturally spawn in [[village]]s.
|Wheat can now be used to craft [[cookie]]s.}}
{{History||v0.15.0|snap=build 1|Wheat can now be used to grow, increase tame and heal [[horse]]s, [[donkey]]s and [[mule]]s.}}
{{History||v0.16.2|Wheat can now be found in the [[chest]]s inside of large houses in [[ice plains]] and [[cold taiga]] [[village]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Wheat can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Wheat can now be found inside [[shipwreck]] chests.}}
{{History|||snap=beta 1.2.20.1|Wheat can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Wheat can now be found in [[pillager outpost]] chests.
|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Wheat can now be found in [[desert]] [[village]] house chests, village shepherd and butcher house chests.
|Wheat can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has changed, farmer [[villager]]s now have a 25% chance to buy 20 wheat for one [[emerald]] as part of their first tier trade.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can drop wheat.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Wheat SDGP.png|Wheat in the [[Super Duper Graphics Pack]].
File:Field of Wheat.jpg|[[Steve]] and [[Kai]] in a field of wheat crops.<ref>https://www.instagram.com/p/CumuJleg6Ij/</ref>
</gallery>

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--wheat Taking Inventory: Wheat] – Minecraft.net on April 21, 2022
{{Items}}

[[Category:Plants]]
[[Category:Food]]

[[cs:Pšenice]]
[[de:Weizen]]
[[es:Trigo]]
[[fr:Blé]]
[[hu:Búza]]
[[it:Grano]]
[[ja:小麦]]
[[ko:밀]]
[[nl:Tarwe]]
[[pl:Pszenica]]
[[pt:Trigo]]
[[ru:Пшеница]]
[[th:ข้าวสาลี]]
[[uk:Пшениця]]
[[zh:小麦]]
[[Category:Renewable resources]]</li><li>[[Milk Bucket|Milk Bucket]]<br/>{{Item
| title=Milk Bucket
| image = Milk Bucket.png
| renewable = Yes
| effects = Clears all
| stackable = No
}}
A '''milk bucket'''{{fn|Known as '''Milk Bucket''' {{in|java}} and '''Milk''' {{in|bedrock}}.}} is a [[drink]] obtained from {{Control|use|text=using}} a [[bucket]] on [[cow]]s, [[mooshroom]]s and [[goat]]s that can be consumed to clear all [[Effect|effects]].

== Obtaining ==

=== Harvesting ===
Milk buckets can be obtained from [[cow]]s, [[mooshroom]]s, and [[goat]]s by pressing {{control|use}} while looking at them with an empty [[bucket]].

=== Mob loot ===
A milk bucket has a chance of dropping from a [[wandering trader]], if the trader is killed while holding it.{{only|java}}

== Usage ==

Holding {{control|use}} with a milk bucket starts the drinking sound and animation. {{IN|java}}, the animation is shown only in first-person camera mode.

When consumed, milk immediately removes all status [[effect]]s from the [[player]]. [[Fire]] is not a status effect; therefore, drinking milk doesn't extinguish a burning player.

The benefits of area status effects granted by [[beacon]]s and [[Conduit Power|conduit power]] are restored almost immediately in Bedrock Edition and after a few seconds in ''Java Edition''.

=== Crafting ingredient ===

{{crafting usage|Milk Bucket}}

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Drink.ogg
|subtitle=Sipping
|source=player
|description=While a player is drinking milk
|id=entity.generic.drink
|translationkey=subtitles.entity.generic.drink
|volume=0.5
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Cow milk1.ogg
|sound2=Cow milk2.ogg
|sound3=Cow milk3.ogg
|source=player
|subtitle=Cow gets milked
|description=When a cow is milked
|id=entity.cow.milk
|translationkey=subtitles.entity.cow.milk
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Mooshroom milk1.ogg
|sound2=Mooshroom milk2.ogg
|sound3=Mooshroom milk3.ogg
|subtitle=Goat gets milked
|description=When a regular goat is milked
|source=neutral
|id=entity.goat.milk
|translationkey=subtitles.entity.goat.milk
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Goat screaming milk1.ogg
|sound2=Goat screaming milk2.ogg
|sound3=Goat screaming milk3.ogg
|sound4=Goat screaming milk4.ogg
|sound5=Goat screaming milk5.ogg
|subtitle=Goat gets milked
|description=When a screaming goat is milked
|source=neutral
|id=entity.goat.screaming.milk
|translationkey=subtitles.entity.goat.milk
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Wandering trader drink milk1.ogg
|sound2=Wandering trader drink milk2.ogg
|sound3=Wandering trader drink milk3.ogg
|sound4=Wandering trader drink milk4.ogg
|sound5=Wandering trader drink milk5.ogg
|subtitle=Wandering Trader drinks milk
|source=neutral
|description=While a wandering trader is drinking milk to become visible during daytime
|id=entity.wandering_trader.drink_milk
|translationkey=subtitles.entity.wandering_trader.drink_milk
|volume=0.5
|pitch=0.9-1.0
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Drink.ogg
|source=player
|description=While a player is drinking milk
|id=random.drink
|volume=0.35
|pitch=0.9-1.1}}
{{Sound table
|sound=Cow milk1.ogg
|sound2=Cow milk2.ogg
|sound3=Cow milk3.ogg
|source=neutral
|description=When a cow is milked
|id=mob.cow.milk
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Mooshroom milk1.ogg
|sound2=Mooshroom milk2.ogg
|sound3=Mooshroom milk3.ogg
|description=When a regular goat is milked
|source=neutral
|id=mob.mooshroom.suspicious_milk
|volume=1.0
|pitch=1.0/0.9/1.1}}
{{Sound table
|sound=Goat screaming milk1.ogg
|sound2=Goat screaming milk2.ogg
|sound3=Goat screaming milk3.ogg
|sound4=Goat screaming milk4.ogg
|sound5=Goat screaming milk5.ogg
|description=When a screaming goat is milked
|source=neutral
|id=mob.goat.milk.screamer
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Wandering trader drink milk1.ogg
|sound2=Wandering trader drink milk2.ogg
|sound3=Wandering trader drink milk3.ogg
|sound4=Wandering trader drink milk4.ogg
|sound5=Wandering trader drink milk5.ogg
|source=neutral
|description=While a wandering trader is drinking milk to become visible during daytime
|id=mob.wanderingtrader.drink_milk
|volume=1.0
|pitch=0.8-1.2
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Milk Bucket
|spritetype=item
|nameid=milk_bucket
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Milk
|spritetype=item
|nameid=milk_bucket
|aliasid=bucket / 1
|id=361
|form=item
|translationkey=item.milk.name
|foot=1}}

== Achievements ==
{{load achievements|The Lie}}

== Advancements ==
{{Load advancements|Husbandry}}

== Video ==

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

== History ==

{{History|java alpha}}
{{History||v1.0.8|[[File:Milk Bucket JE1 BE1.png|32px]] Milk has been introduced, but it has no purpose and is obtainable only through inventory editing.}}
{{History||v1.0.11|Milk can now be obtained by {{control|use|text=milking}} a [[cow]] with a [[bucket]]. However, it is not yet drinkable.}}
{{History||v1.0.17|Milk buckets can now be emptied.}}
{{History|java beta}}
{{History||1.2|Milk has been incorporated into the [[crafting]] recipe of [[cake]].}}
{{History||1.2_01|[[Squid]] can now be milked by right-clicking on their mouth if part of their body was exposed to [[air]] or if they were not touching another [[block]]. An easy way to accomplish this is to pull a squid with a [[fishing rod]] away from other blocks and then milk it.}}
{{History||1.3_01|Squid milking has been removed.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Milk can now be obtained by milking [[mooshroom]]s.}}
{{History|||snap=Beta 1.9 Prerelease 2|Milk has been made drinkable.
|According to a tweet by [[Jeb]] on September 30th 2011, milk was made a cure for all status effects.<ref>{{tweet|jeb_|119842906528944129|@Nexusdog_UK I haven't! In beta 1.9 pre2 milk works like a clear-everything drink|September 30, 2011}}</ref>
|Milk is no longer emptiable.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 335.}}
{{History|||snap=18w20a|"Milk" has been renamed to "Milk Bucket".}}
{{History||1.14|snap=18w43a|[[File:Milk Bucket JE2 BE2.png|32px]] The texture of milk buckets has been changed.}}
{{History||1.14|snap=19w06a|[[Wandering trader]]s now drink from milk buckets at dawn, and have a change to drop them.}}
{{History||1.17|snap=21w13a|Milk can now be obtained by milking [[goat]]s.}}
{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|Wander traders now have a chance to [[trading|buy]] a milk bucket from the player.}}

{{History|pocket alpha}}
{{History||v0.7.0|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk buckets. 
|Milk buckets are not yet drinkable.}}
{{History||v0.11.0|snap=build 4|Drinking milk now removes [[status effects]].
|Added milk buckets to the Creative inventory.{{verify|type=update}}{{info needed}}<!---same update?--->}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Moved all bucket items, including milk, from the Equipment tab to the Items tab in the [[Creative inventory]].{{verify|type=update}}{{info needed}}<!---please check snapshots, only 1 major release version was checked each--->}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Milk Bucket JE2 BE2.png|32px]] The texture of milk buckets has been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of milk has been changed from <code>bucket/1</code> to <code>milk_bucket</code>.}}
{{History||1.16.200|snap=beta 1.16.200.52|Milk can now be obtained by milking [[goat]]s.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk buckets.}}
{{History|Ps4}}
{{History||1.90|[[File:Milk Bucket JE2 BE2.png|32px]] The texture of milk buckets has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Milk Bucket JE1 BE1.png|32px]] Added milk buckets.}}
{{History|foot}}

== Issues ==
{{issue list}}

== See also ==
*[[Water Bucket]]
*[[Lava]]
*[[Food]]
*[[Cake]]
*[[Honey Bottle]] (alternative to remove poison effect)
*[[Medicine]]

== Notes ==
{{fnlist}}

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--milk-bucket Taking Inventory: Milk Bucket] – Minecraft.net on October 8, 2019

{{Items}}

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

[[cs:Mléko]]
[[de:Milcheimer]]
[[es:Cubo con leche]]
[[fr:Seau de lait]]
[[hu:Tej]]
[[it:Secchio di latte]]
[[ja:ミルク入りバケツ]]
[[ko:우유 양동이]]
[[nl:Emmer melk]]
[[pl:Wiadro mleka]]
[[pt:Balde de leite]]
[[ru:Ведро с молоком]]
[[th:ถังนม]]
[[uk:Відро молока]]
[[zh:奶桶]]</li></ul>
18w01aNow supports the custom names.
18w05aAdded /bossbar, The argument <name> supported by raw JSON text.
1.14
{{Extension DPL}}<ul><li>[[Explorer Map|Explorer Map]]<br/>{{about|the map used to find rare structures|the craftable map|Map|others|Map (disambiguation)}}{{Needs updating|Add info on the new jungle, swamp, and village maps in Java 1.20.2 Pre-Release 1}}{{Item
| image = <gallery>
Ocean Explorer Map.png | Ocean
Woodland Explorer Map.png | Woodland
Buried Treasure Map.png | Buried Treasure
</gallery>
|image2 = <gallery>
Ocean Explorer Map BE.png | Ocean (BE)
Woodland Explorer Map BE.png | Woodland (BE)
Buried Treasure Map BE.png | Buried in Treasure (BE)
</gallery>
| renewable = 
* '''Buried Treasure''': No
* '''Woodland and Ocean''': Yes
| stackable = Yes (64)
}}
An '''explorer map''' is a special [[map]] used to aid in finding rare [[generated structures]], including [[woodland mansion]]s, [[ocean monument]]s, and [[buried treasure]]s.

== Obtaining ==
=== Trading ===
Apprentice-level [[cartographer]] villagers sell ocean explorer maps for 13 emeralds and a compass. Journeyman-level cartographer villagers sell woodland explorer maps for 14 emeralds and a compass.

{{IN|java}}, if the cartographer is in [[the Nether]] or [[the End]], either spawned or transported, the trades for the map do not unlock. However, {{in|bedrock}}, the cartographer trades for the map are unlocked, but the purchased map shows the same layout as in the corresponding dimension and shows no destination structure, but if cartographer trades are unlocked in an old world type (prior-1.11.0), the game stops ticking.

In ''Java Edition'', each cartographer sells its own unique explorer map that points to a different location than other cartographers. Purchasing another explorer map from the same cartographer results in the same explorer map. In Bedrock Edition, a cartographer sells an explorer map that points to the nearest location, regardless of whether it is explored or previously mapped by another cartographer.<!-- start to glitched out-->

=== Chest loot ===
Treasure maps, in contrast to explorer maps, generate in underwater ruins or in shipwrecks.
{{LootChestItem|buried-treasure-map}}

== Usage ==
[[File:Explorer Map Comparison.gif|thumb|217px|Unexplored and partially explored maps.]]

{{See also|Map#Mapping|Map#Map content}}

=== Locating structures ===
There are three types of explorer maps: woodland, [[ocean]], and buried treasure. The maps differ from a normal map, in that it shows the area's land-water outline, with an orange striated (striped) texture for water<ref>Specifically, biomes in the "water_on_map_outlines" [[Tag#Biomes|biome tag]].</ref>, and the blank map texture for land. The maps show a section of land that contains a [[woodland mansion]], [[monument]] or [[buried treasure]] respectively. This may not be the nearest such [[structure]] to the [[player]]. The structures are displayed as a small icon. If the player icon is smaller than it would be on a normal map, that means the player is a great distance away. When the player is less than 1027 blocks away from the map border, the icon returns to the proper size. When the player reaches the map's area of land (512×512), the [[map]] fills in like a normal map.

The basic functions of a buried treasure explorer map are similar to that of the other two. However, instead of showing the structure icon on the map, it shows a red X instead. The [[buried treasure]] structure is located on the same X and Z coordinates as the middle of the X (the player marker may need to be aligned with the bottom of the middle 2×2 pixel square of the X). To locate the [[chest]] spot, hold the treasure map with both hands, not in the offhand slot.

=== Cloning ===
{{Crafting
|showdescription=1
|shapeless=1
|name=[[Explorer Map]]<br>(cloned)
|;;;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map 
|;;;;Empty Map;Empty Map;Empty Map;Empty Map
|;;;;;Empty Map;Empty Map;Empty Map
|Ocean Explorer Map; Woodland Explorer Map; Buried Treasure Map; Ocean Explorer Map; Woodland Explorer Map; Buried Treasure Map; Ocean Explorer Map; Woodland Explorer Map
|Empty Map
|;;;;;;Empty Map;Empty Map 
|;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map 
|;;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map;Empty Map
|;;;;;;;Empty Map
|Output= Ocean Explorer Map,2; Woodland Explorer Map,3; Buried Treasure Map,4; Ocean Explorer Map,5; Woodland Explorer Map,6; Buried Treasure Map,7; Ocean Explorer Map,8; Woodland Explorer Map,9
|type= Miscellaneous
|description=The output has the same map center as the input map, and the same [[monument]], [[woodland mansion]] or [[buried treasure]] marker. Cloned maps are stackable.
}}

The parts of the world that have already been explored and mapped are copied, and newly explored areas appear on both instances. In Creative mode, cloned explorer maps can be obtained by pick blocking on the explorer map displayed on [[item frames]] (the map needs to be out of the [[player]]'s inventory when using pick block, or else that map moves into the active hotbar slot).

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|subtitle=Map drawn
|source=block
|description=When an explorer map is edited using a cartography table
|id=ui.cartography_table.take_result
|translationkey=subtitles.ui.cartography_table.take_result
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}: ''None''

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Map
|spritetype=item
|nameid=filled_map
|form=item
|translationkey=filled_map.mansion,filled_map.ocean,filled_map.buried_treasure
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Map
|spritetype=item
|nameid=filled_map
|aliasid=map
|id=358
|form=item
|translationkey=item.map.exploration.monument.name,item.map.exploration.mansion.name,item.map.exploration.treasure.name
|foot=1}}

=== Metadata ===
{{see also|Bedrock Edition data values}}
{{IN|bedrock}}, the item [[Data value]] distinguishes explorer maps from one another:

{{:Map/DV}}

=== Item data ===
An explorer map differs from a map in that its <code>display</code> tag is set, which includes a <code>Mapcolor</code> and a <code>LocName</code>; also its <code>Decorations</code> list includes an entry for its target monument, mansion or buried treasure. Its [[Map item format#map_<#>.dat format|map item entry]] is identical to that of a normal map, except that by the time the player sees it, its <code>colors</code> byte array is pre-filled with explorer maps' characteristic land-water boundary lines and water shading.

<div class="treeview">
It should be noted that this additional data is stored in the Cartographer's NBT data and in the inventory item's NBT data, and not in the map file (e.g. <samp>map_0.dat</samp>). If the [[player]] were to use the {{cmd|give}} command to give themselves a map with the same map ID as an existing explorer map, it would still have the Ocean Monument or the Woodland Mansion icon on the map, but it would simply be named "Map" instead of, for example, "Ocean Explorer Map".
* {{nbt|compound}} Item data
** {{nbt|compound|tag}}: 
*** {{nbt|compound|display}}: How the map looks in an item slot. See also [[Player.dat_format#Display Properties]].
**** {{nbt|string|Name}}: The name the map is given. In this case, they are localized strings: either <code>{"translate":"filled_map.monument"}</code>,<code>{"translate":"filled_map.mansion"}</code> or <code>{"translate":"filled_map.buried_treasure"}</code>.
**** {{nbt|int|MapColor}}: Color codes are calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''.<ref group=note>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref> Monument maps use 3830373, which is {{color swatch|58|114|101}}. Mansion maps use 5393476, which is {{color swatch|82|76|68}}. Buried treasure explorer maps do not use a color code.
*** {{nbt|list|Decorations}}:
**** {{nbt|compound}}: One of these for each icon on the map. Explorer maps always have at least one representing their target.
***** {{nbt|string|id}}: An arbitrary unique string identifying the decoration. For explorer map target structures, this is "+".
***** {{nbt|double|rot}}: The rotation of the icon. For explorer map target structures, this is always 180.
***** {{nbt|byte|type}}: The ID of the [[Map#Map icons|map icon]]: 8 for a mansion map, 9 for a monument map, 26 for a treasure map.
***** {{nbt|double|x}}: The world x-coordinate of the target structure icon.
***** {{nbt|double|z}}: The world z-coordinate of the target structure icon.
</div>
; Notes
{{notelist}}

== Achievements ==
{{load achievements|Treasure Hunter}}

== History ==
{{History|java}}
{{History||1.11|snap=16w39a|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added woodland and ocean explorer maps.}}
{{History|||snap=16w41a|Explorer maps can now no longer be zoomed out.}}
{{History||1.13|snap=18w10a|[[File:Map (item) JE1 BE1.png|32px]] Added buried treasure explorer maps.}}
{{History|||snap=18w11a|Buried treasure explorer maps now generate in the [[chest]]s of [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}}
{{History||1.20.2|snap=1.20.2 Pre-release 1|Updated structure icons on explorer maps sold by cartographers.}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=1.20.2 Pre-release 1|Added seven new maps which cartographers can sell.}}

{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.<ref>{{Mcnet|discovery-update-pocket-and-win-10-soon|The Discovery Update: on Pocket and Win 10 soon|March 29, 2017}}</ref>
|Explorer maps are not yet obtainable in [[survival]] mode.}}
{{History|||snap=alpha 1.1.0.3|Explorer maps are now obtainable as [[trading|trades]] from [[cartographer]] [[villager]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[File:Map (item) JE1 BE1.png|32px]] Added buried treasure explorer maps.}}
{{History|||snap=beta 1.2.20.1|Treasure maps now generate in [[underwater ruins]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed, woodland and ocean explorer maps now cost a [[compass]] and 12 [[emerald]]s.
|Journeyman-level [[cartographer]] [[villager]]s no longer [[trading|sell]] 2 type of explorer map as they now have {{frac|1|3}} chance to sell woodland explorer maps, {{frac|1|3}} chance to sell ocean explorer maps, or {{frac|1|3}} chance to sell other [[item]]s<!-- empty locator map--> as part of their [[trading|trades]].
|Woodland explorer maps can now be [[trading|bought]] from fletcher [[villager]]s.}}
{{History||1.12.0|snap=beta 1.12.0.3|Journeyman-level fletcher villagers no longer [[trading|sell]] woodland explorer maps.}}
{{History||1.13.0|snap=beta 1.13.0.1|[[File:Woodland Explorer Map BE3.png|32px]] [[File:Ocean Explorer Map BE3.png|32px]] [[File:Buried Treasure Map BE3.png|32px]] The textures of explorer maps have now been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of maps has been changed from <code>map</code> to <code>filled_map</code>.}}

{{History|console}}
{{History||xbox=TU54|xbone=CU44|ps=1.52|wiiu=Patch 24|switch=1.0.4|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.}}
{{History|PS4}}
{{History||1.90|[[File:Woodland Explorer Map JE2 BE2.png|32px]] [[File:Ocean Explorer Map JE2 BE2.png|32px]] The textures for explorer maps have now been changed.}}

{{History|new3ds}}
{{History||1.9.19|[[File:Woodland Explorer Map JE1 BE1.png|32px]] [[File:Ocean Explorer Map JE1 BE1.png|32px]] Added explorer maps.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
* When a [[cartographer]] generates the trade offers for the explorer maps, it chooses the location of one of the nearest structures of the respective type ([[monument]] or [[woodland mansion]]).
* For the reason above, explorer maps obtained from one cartographer are always the same. Also, if two cartographers unlock the explorer map trades approximately at the same place and at the same time, the map locations are usually identical. This sometimes also happens when finding multiple treasure maps from [[ocean ruins]].
* Explorer maps fill as the [[chunk]]s are generated, rather than when the [[player]] holds them while in the area; leaving an explorer map while exploring the area still fills the map.
* Buried treasure explorer maps are named ''Buried Treasure Map'' {{in|java}} while {{in|bedrock}}, they are named ''Treasure Map''.
* It is possible for a cartographer to give a monument or woodland mansion explorer map for areas where the [[generated structures|structures]] would have spawned in the world, but were unable to as a result of terrain generation. As a result, explorer maps, unfortunately, don't always guarantee that a structure exists at the purported location. This is most common with woodland mansion explorer maps, due to its generation algorithm.
* On [[Bedrock Edition]], inventory editors and add-ons can be used to create Explorer Maps that lead to any structure.

== Gallery ==
<gallery>
File:Explorer Maps.png|An ocean explorer map in the [[off-hand]], a woodland explorer map in the main hand, and a [[cartographer]] [[villager]] in between them.
File:Partial Explorer Map.png|A partially-explored explorer map.
File:ExplorerToNormal Map Comparison.png|Two fully-explored maps of the same place, one of which is a woodland explorer map.
File:Buried Treasure Explorer Map.png|An [[item frame]] holding a buried treasure explorer map. The player can see the red X on the left side of the map.
File:Purchase.png|Purchasing explorer maps from a cartographer.
</gallery>

== See also ==
* [[Map]]
* [[Woodland Mansion]]
* [[Ocean Monument]]
* [[Shipwreck]]
* [[Buried treasure]]

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--explorer-map Taking Inventory: Explorer Map] – Minecraft.net on November 13, 2019

{{Items}}

[[de:Schatzkarte]]
[[es:Mapa (localización de estructura)]]
[[fr:Carte d'exploration]]
[[ja:探検家の地図]]
[[ko:탐험 지도]]
[[pl:Mapa eksploracyjna]]
[[pt:Mapa de exploração]]
[[ru:Карта сокровищ]]
[[zh:探险家地图]]</li><li>[[Brown Dye|Brown Dye]]<br/>{{Item
| image = Brown Dye.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Brown dye''' is a [[Dye#Primary|primary color dye]] derived from [[cocoa beans]].

== Obtaining ==
=== Crafting ===
{{Crafting
 |Cocoa Beans
 |Output=Brown Dye
 |type=Material
 |head=
}}

== Usage  ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===

Apprentice-level Shepherd villagers have a 20% chance to buy 12 brown dye for an emerald.‌{{only|bedrock}}

Expert-level Shepherd villagers have a {{frac|2|7}} chance to buy 12 brown dye for an emerald.{{only|java}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Brown Dye
|spritetype=item
|nameid=brown_dye
|aliasid=dye / 17
|id=398
|form=item
|translationkey=item.dye.brown_new.name
|foot=1}}

== History ==
{{expand section|Item textures and more from a development video on twitter by bartek.}}
{{History|java}}
{{History||1.14|snap=18w43a|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}}
{{History|||snap=18w44a|Brown dye now can change the text color on [[sign]]s to brown.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sell brown dyes.}}
{{History|||snap=19w11a|Brown dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Brown dye can now used to craft newly added [[brown candle]]s.}}
{{History|||snap=21w19a|Brown dye can no longer used to craft brown candles.}}
{{History|||snap=Pre-release 1|Brown dye can once again used to craft brown candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Brown dye now can change the text color on [[hanging sign]]s to brown.}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}}
{{History||1.11.0|snap=beta 1.11.0.4|Brown dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of brown dye has been changed from <code>dye/17</code> to <code>brown_dye</code>.}}

{{History|ps4}}
{{History||1.83|[[File:Brown Dye JE1 BE1.png|32px]] Added brown dye.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

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

[[de:Brauner Farbstoff]]
[[es:Tinte marrón]]
[[fr:Teinture marron]]
[[ja:茶色の染料]]
[[ko:갈색 염료]]
[[pl:Brązowy barwnik]]
[[pt:Corante marrom]]
[[th:สีย้อมสีน้ำตาล]]
[[zh:棕色染料]]</li></ul>
18w43aAdded text component nbt, block and entity.
Now supports the item lore tag.
18w44aAdded text component interpret.
1.15
{{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>[[Yellow Dye|Yellow Dye]]<br/>{{Item
| title = Yellow Dye
| renewable = Yes
| stackable = Yes (64)
}}
'''Yellow dye''' is a [[Dye#Primary|primary dye]] created by placing a [[dandelion]] or [[sunflower]] into a [[crafting]] grid.

== Obtaining ==

=== Crafting ===
{{Crafting
  |Dandelion;Sunflower
  |Output=Yellow Dye;Yellow Dye,2
  |type=Material
}}

=== Chest loot ===
{{LootChestItem|yellow-dye}}

=== Trading ===

[[Wandering trader]]s sell 3 yellow dye for an [[emerald]].

== Usage ==
{{dye usage}}

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

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Yellow Dye
|spritetype=item
|nameid=yellow_dye
|aliasid=dye / 11
|id=406
|form=item
|translationkey=item.dye.yellow.name
|foot=1}}

== Video ==
{{yt|nOQUDjEHGRg}}

== History ==
{{History|java beta}}
{{History||1.2|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History||1.6.6|Dandelions can now be generated using [[Bone Meal|bone meal]], making dandelion yellow [[renewable resource|renewable]].}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Dandelion yellow can be crafted with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{History||1.7.2|snap=13w36a|Can now be crafted using sunflower.}}
{{History|||snap=13w37a|Each dandelion now yields only 1 dandelion yellow, instead of 2.}}
{{History|||snap=13w41a|[[Stained glass]] can now be [[crafting|crafted]].}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be [[dye]]d.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w06a|Yellow dye can now be used to craft yellow [[concrete powder]].}}
{{History|||snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History||1.14|snap=18w43a|"Dandelion Yellow" has now been renamed to "Yellow Dye".
|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}
{{History|||snap=18w44a|Yellow dye can now change the text color on [[sign]]s to yellow.}}
{{History|||snap=18w49a|Yellow dye can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells yellow dye.}}
{{History|||snap=19w11a|Yellow dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Yellow dye can now be used to craft [[yellow candle]]s.}}
{{History|||snap=21w19a|Yellow dye can no longer be used to craft yellow candles.}}
{{History|||snap=Pre-release 1|Yellow dye can once again used to craft yellow candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Yellow dye can now change the text color on [[hanging sign]]s to yellow.}}
{{History||1.20|snap=23w12a|Yellow dye can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Yellow dye no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], yellow dye is now common loot.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History||v0.8.0|snap=build 1|Dandelion yellow is now used to craft [[cocoa beans]].}}
{{History||v0.14.0|snap=build 1|Yellow dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History||v0.16.0|snap=build 1|Dandelion yellow is no longer used to [[crafting|craft]] cocoa beans.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Yellow dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Yellow dye can now be used to dye [[shulker box]]es, [[bed]]s, and craft [[concrete powder]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Yellow dye can now be used to craft patterns on [[banner]]s, [[firework star]]s, and [[stained glass]].}}
{{History||1.4.0|snap=beta 1.2.20.1|Yellow dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Dandelion yellow can now be used to dye [[cat]] collars.}}
{{History|||snap=beta 1.8.0.10|"Dandelion Yellow" has now been renamed to "Yellow Dye".}}
{{History||1.10.0|snap=beta 1.10.0.3|Yellow dye is now [[trading|sold]] by [[wandering trader]]s.
|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Yellow dye can now be found in [[village]] mason [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Yellow dye can now be sold to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of yellow dye has been changed from <code>dye/11</code> to <code>yellow_dye</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|switch=1.0.1|wiiu=Patch 1|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History|ps4}}
{{History||1.83|"Dandelion Yellow" has now been renamed to "Yellow Dye".}}
{{History||1.90|[[File:Yellow Dye JE2 BE2.png|32px]] The texture of yellow dye has now been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Yellow Dye JE1 BE1.png|32px]] Added dandelion yellow.}}
{{History|foot}}

== Issues ==

{{issue list}}

== References ==

{{reflist}}

{{Items}}

[[cs:Pampelišková žluť]]
[[de:Gelber Farbstoff]]
[[es:Tinte amarillo]]
[[fr:Teinture jaune]]
[[hu:Pitypangsárga]]
[[ja:黄色の染料]]
[[ko:노란색 염료]]
[[nl:Paardenbloemgeel]]
[[pl:Żółty barwnik]]
[[pt:Corante amarelo]]
[[ru:Жёлтый краситель]]
[[zh:黄色染料]]

[[Category:Items]]
[[Category:Dyes]]
[[Category:Renewable resources]]</li></ul>
19w39aAdded text component storage.
19w41aAdded the action copy_to_clipboard for the text component clickEvent.
Upcoming Java Edition
1.16
{{Extension DPL}}<ul><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><li>[[Photo|Photo]]<br/>{{exclusive|education}}
{{Item
| image = Photo EE2.png
| renewable = No (unless [[portfolio]] is available)
| stackable = 
}}

A '''photo''' is an [[item]] containing a picture taken with a [[camera]].<ref>{{cite|url=https://web.archive.org/web/20210925044841mp_/https://educommunity.minecraft.net/hc/en-us/articles/4407489082644-Feature-Walkthrough-Minecraft-Education-Edition-GOAT-Beta-version-1-17-30-| title = Feature Walkthrough Minecraft: Education Edition GOAT Beta (version 1.17.30)|website=Minecraft: Education Edition Support|date=September 24, 2021}}</ref><ref>{{cite|url=https://education.minecraft.net/en-us/blog/new-update-and-anniversary-for-mee| title = The GOAT Update Celebrates a Minecraft Milestone!|website=Minecraft: Education Edition|date=November 2, 2021}}</ref><ref>{{ytl|2Wd0J-EIfws|GOAT Release Playthrough|Minecraft: Education Edition|December 2, 2021}}</ref>

== Obtaining ==
A photo in a [[portfolio]] can be saved as a photo item by selecting the "Save to Inventory" button underneath it.

== Usage ==
Photos display an image when held in the hand or when placed in an [[item frame]], similarly to [[map]]s. Photos can have captions added to them by renaming them in an [[anvil]] or by adding a caption while they are in a portfolio. Photos can be added to [[book and quill]]s and portfolios by selecting the "Add Photo" button in the book and quill or portfolio.

== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Photo
|spritetype=item
|nameid=photo_item
|id=?
|form=item
|foot=1}}

== History ==
{{History|education}}
{{History||1.17.30|snap=1.17.30.2|[[File:Photo EE1.png|32px]] Added photos.}}
{{History||1.17.30|snap=release|[[File:Photo EE2.png|32px]] Changed photo texture.}}
{{History|foot}}

== Gallery ==
<gallery>
Photo Item 1.png|A photo being placed in an item frame.
Photo Item 2.png|A photo being saved from a portfolio.
Photo Item 3.png|A photo being added to a book and quill.
</gallery>

== References ==
{{Reflist}}

{{Items}}
{{Education Edition}}

[[Category:Education Edition items]]
[[Category:Non-renewable resources]]

[[ja:写真]]
[[zh:相片]]</li></ul></nowiki>
20w17aAdded text component font.
Added argument contents for hoverEvent, replacing value which is now deprecated but still supported.
The color component can now contain a hexadecimal RGB value prefixed by # (Example: "color":"#ff0088").
Bedrock Edition
1.9.0
{{Extension DPL}}<ul><li>[[Honeycomb|Honeycomb]]<br/>{{distinguish|Honeycomb Block}}
{{Item
| image = Honeycomb.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Honeycombs''' are items obtained from [[bee nest]]s and beehives.

== Obtaining ==
{{See also|Tutorials/Honey farming}}
When a bee nest or beehive at {{cd|honey_level}} 5 is [[shear]]ed, it drops 3 honeycombs and angers any bees inside, causing them to attack. Having a lit [[campfire]] or lighting a fire underneath the nest or hive prevents the bees from becoming hostile.

A [[dispenser]] with shears inside can be used to shear the nest without angering the bees. The honeycomb pops out as a dropped item.

== Usage ==

=== Signs ===

{{Control|Using}} a honeycomb on a [[sign]] or a hanging sign prevents the sign from being edited.

=== Waxing ===
{{Control|Using}} a honeycomb on a [[block of copper]] changes the block into its waxed variant, preventing oxidation of the copper.

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

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Beehive shear.ogg
|subtitle=Shears scrape
|source=neutral
|description=When honeycombs are collected from a beehive
|id=block.beehive.shear
|translationkey=subtitles.block.beehive.shear
|volume=0.8
|pitch=1.0/0.9/0.8
|distance=16}}
{{Sound table
|sound=Wax on1.ogg
|sound2=Wax on2.ogg
|sound3=Wax on3.ogg
|subtitle=Wax on
|source=block
|description=When a honeycomb waxes something
|id=item.honeycomb.wax_on
|translationkey=subtitles.item.honeycomb.wax_on
|volume=1.0
|pitch=1.0/0.9/1.1
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Beehive shear.ogg
|source=block
|description=When honeycombs are collected from a beehive
|id=block.beehive.shear
|volume=0.8
|pitch=0.8-1.0}}
{{Sound table
|sound=Wax on1.ogg
|sound2=Wax on2.ogg
|sound3=Wax on3.ogg
|source=neutral
|description=When a honeycomb waxes something
|id=copper.wax.on
|volume=1.0
|pitch=0.8-1.2
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Honeycomb
|spritetype=item
|nameid=honeycomb
|id=591
|form=item
|foot=1}}

== Advancements ==
{{load advancements|Wax on;Wax off}}

== History ==
{{History|java}}
{{History||1.15|snap=19w34a|[[File:Honeycomb JE1.png|32px]] Added honeycombs.
|Honeycombs can be used to craft [[beehive]]s.}}
{{History|||snap=19w41a|Honeycombs can now be used to craft [[honeycomb block]]s.}}
{{History|||snap=Pre-release 3|[[File:Honeycomb texture change 1.15pre2 to 1.15pre3.gif|32px]] The texture file of honeycombs has been slightly changed. The color channel of transparent pixels are now filled to black. The in-game texture has not been changed.}}
{{History||1.17|snap=20w45a|Honeycomb can now be used to craft [[candle]]s and [[waxed copper]].}}
{{History|||snap=21w11a|Honeycomb can now be used to wax copper blocks by right clicking or dispensing honeycomb onto the block.}}
{{History|||snap=21w14a|Honeycomb can now be used to wax oxidized copper blocks.}}
{{History|||snap=21w19a|Honeycomb can no longer used to craft candles.}}
{{History|||snap=Pre-release 1|Honeycomb can once again used to craft candles.}}
{{History||1.20|snap=23w12a|[[Sign]]s and hanging signs can now be waxed with honeycomb to prevent them from being edited.}}

{{History|bedrock}}
{{History||1.14.0|snap=beta 1.14.0.1|[[File:Honeycomb BE1.png|32px]] Added honeycombs.}}
{{History|||snap=beta 1.14.0.4|[[File:Honeycomb BE2.png|32px]] The texture of honeycombs has been changed to match {{el|je}}'s.}}
{{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.210.57|Honeycomb can now be used to craft [[waxed copper]].
|Honeycomb can now be used to wax copper blocks by right clicking or dispensing honeycomb onto the block.}}
{{History||1.17.0|snap=beta 1.16.230.52|Honeycomb can now be used to wax oxidized copper blocks.}}
{{History||1.17.10|snap=beta 1.17.10.22|Honeycomb can now be used to craft [[candle]]s.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.22|[[Sign]]s and hanging signs can now be waxed with honeycomb to prevent them from being edited.}}

{{History|foot}}

== Issues ==
{{issue list}}


{{items}}

[[cs:Plástev medu]]
[[de:Honigwabe]]
[[es:Panal]]
[[fr:Rayon de miel]]
[[ja:ハニカム]]
[[ko:벌집 조각]]
[[pl:Plaster miodu]]
[[pt:Favo de mel]]
[[ru:Пчелиные соты]]
[[zh:蜜脾]]
[[Category:Renewable resources]]</li><li>[[Brush|Brush]]<br/>{{Item
|image=Brush.png
|rarity=Common
|renewable=Yes
|durability=64
|stackable=No
}}
A '''brush''' is a [[tool]] used in [[archaeology]] to excavate [[suspicious block]]s for different items.

==Obtaining==
===Crafting===
{{Crafting
|head=1
|showname=0
|showdescription=1
|B1=Feather
|B2=Copper Ingot
|B3=Stick
|Output=Brush
|type=Tool
}}
{{crafting
|foot=1
|ignoreusage=1
|Damaged Brush
|Damaged Brush
|Output=Brush
|description=The durability of the two brushes is added together, plus an extra 5% durability.
|type=Tool
}}

==Usage==
{{Main|Suspicious Block}}
{{Control|Using}} the brush on any block displays a brushing animation, slowing down the player and creating breaking [[particles]], but not actually damaging the block or brush. When continuously brushing a [[suspicious block]], a random item slowly emerges from it until it drops out, and the block turns into regular [[sand]] or regular [[gravel]], depleting 1 [[durability]] point on the brush. It takes 96 [[game tick]]s (4.8 seconds) to brush a single suspicious block. 

=== Enchantments ===
A brush can receive the following [[enchantment]]s:
{|class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Anvil}}   
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}   
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}   
|}

== Sounds ==
{{Edition|Java}}:
{{Sound table
<!--All of these sounds are, in fact, different-->
|sound=Brushing sand1.ogg
|sound2=Brushing sand2.ogg
|sound3=Brushing sand3.ogg
|sound4=Brushing sand4.ogg
|subtitle=Brushing Sand
|source=block
|description=While a brush is brushing suspicious sand
|id=item.brush.brushing.sand
|translationkey=subtitles.item.brush.brushing.sand
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing gravel1.ogg
|sound2=Brushing gravel2.ogg
|sound3=Brushing gravel3.ogg
|sound4=Brushing gravel4.ogg
|subtitle=Brushing Gravel
|source=block
|description=While a brush is brushing suspicious gravel
|id=item.brush.brushing.gravel
|translationkey=subtitles.item.brush.brushing.gravel
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing generic1.ogg
|sound2=Brushing generic2.ogg
|sound3=Brushing generic3.ogg
|sound4=Brushing generic4.ogg
|subtitle=Brushing
|source=block
|description=While a brush is brushing any other block
|id=item.brush.brushing.generic
|translationkey=subtitles.item.brush.brushing.generic
|volume=0.6
|pitch=0.6
|distance=16}}
{{Sound table
|sound=Brushing sand completed1.ogg
|sound2=Brushing sand completed2.ogg
|sound3=Brushing sand completed3.ogg
|sound4=Brushing sand completed4.ogg
|sound5=Brushing sand completed5.ogg
|subtitle=Brushing Sand completed
|source=Players<ref group=sound name=badsource>{{Bug|MC-260202}}</ref>|overridesource=1
|description=When a brush finishes brushing suspicious sand
|id=item.brush.brushing.sand.complete
|translationkey=subtitles.item.brush.brushing.sand.complete
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Brushing gravel completed1.ogg
|sound2=Brushing gravel completed2.ogg
|sound3=Brushing gravel completed3.ogg
|sound4=Brushing gravel completed4.ogg
|subtitle=Brushing Gravel completed
|source=Players<ref group=sound name=badsource/>|overridesource=1
|description=When a brush finishes brushing suspicious gravel
|id=item.brush.brushing.gravel.complete
|translationkey=subtitles.item.brush.brushing.gravel.complete
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Brushing sand1.ogg
|sound2=Brushing sand2.ogg
|sound3=Brushing sand3.ogg
|sound4=Brushing sand4.ogg
|source=player
|description=While a brush is brushing suspicious sand
|id=brush.suspicious_sand
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing gravel1.ogg
|sound2=Brushing gravel2.ogg
|sound3=Brushing gravel3.ogg
|sound4=Brushing gravel4.ogg
|source=player
|description=While a brush is brushing suspicious gravel
|id=brush.suspicious_gravel
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing generic1.ogg
|sound2=Brushing generic2.ogg
|sound3=Brushing generic3.ogg
|sound4=Brushing generic4.ogg
|source=player
|description=While a brush is brushing any other block
|id=brush.generic
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing sand completed1.ogg
|sound2=Brushing sand completed2.ogg
|sound3=Brushing sand completed3.ogg
|sound4=Brushing sand completed4.ogg
|sound5=Brushing sand completed5.ogg
|source=player
|description=When a brush finishes brushing suspicious sand
|id=brush_completed.suspicious_sand
|volume=1.0
|pitch=0.8-1.0}}
{{Sound table
|sound=Brushing gravel completed1.ogg
|sound2=Brushing gravel completed2.ogg
|sound3=Brushing gravel completed3.ogg
|sound4=Brushing gravel completed4.ogg
|source=player
|description=When a brush finishes brushing suspicious gravel
|id=brush_completed.suspicious_gravel
|volume=1.0
|pitch=0.8-1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Brush
|spritetype=item
|nameid=brush
|id=684
|form=item
|foot=1}}

== Advancements ==
{{load advancements|Respecting the Remnants}}

== History ==
{{History||October 3, 2020|link=https://youtu.be/DBvZ2Iqmm3M?t=2178|[[File:Brush (pre-release 1).png|32px]][[File:Brush 2.png|32px]] Brushes were announced at [[Minecraft Live 2020]] with two variants.}}
{{History||?|link=https://youtu.be/klP9SrJFDU8?t=206|[[File:Brush (pre-release 2).png|32px]] Changed the brush's item texture.}}
{{History||February 10, 2023|[[File:Brush JE1 BE1.png|32px]] [[Sofia Dankis]] posted an article about upcoming archaeology features, including brushes.|link=https://www.minecraft.net/en-us/article/archeology-coming-minecraft-120}}
{{History|java}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Brush JE1 BE1.png|32px]] Added brushes with an updated texture behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].|The crafting recipe was originally three [[string]] and two [[stick]]s.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|A1 = String
|B1 = String
|C1 = String
|B2 = Stick
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History|||snap=1.19.4 Pre-release 1|The crafting recipe for brushes has been changed:
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|B1 = Feather
|B2 = Copper Ingot
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||1.20|snap=23w12a|Brushes are now available without using the "Update 1.20" experimental data pack.
|Brushes can now brush [[suspicious gravel]].}}
{{History|||snap=23w14a|The brushing sound of brush is now controlled by the "Blocks" sound slider instead of the "Players" sound slider.}}
{{History|||snap=23w17a|The player now gets the [[advancement]] "Respecting the Remnants" when they use a brush on a [[suspicious block]] to obtain a [[pottery sherd]].}}

{{History|bedrock}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|[[File:Brush JE1 BE1.png|32px]] Added brushes behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.
|The crafting recipe is originally three [[string]] and two [[stick]]s.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|A1 = String
|B1 = String
|C1 = String
|B2 = Stick
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|The crafting recipe for brushes has been changed:
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}{{Crafting Table
|B1 = Feather
|B2 = Copper Ingot
|B3 = Stick
|Output = Brush
|type = Tool
|ignoreusage=1}}
{{!}}}
}}
{{History||1.20.0|snap=beta 1.20.0.21|Brushes are now available without using the "Next Major Update" experimental toggle.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== References ==
{{Reflist}}

==External Links==
*[https://www.minecraft.net/en-us/article/brush Taking Inventory: Brush] – Minecraft.net on July 6, 2023

{{Items}}

[[Category:Renewable resources]]

[[de:Pinsel]]
[[es:Pincel]]
[[ja:ブラシ]]
[[pt:Pincel]]
[[pl:Pędzel]]
[[uk:Щітка]]
[[zh:刷子]]</li></ul>
beta 1.9.0.0Added /tellraw, the raw JSON text used to support this command.

References

  1. ↑ Note that because the later components are actually children of the first one, any formatting applied to the first component will be inherited by the later ones. For example, [{"text": "A", "color": "red"}, "B", "C"] would display all three letters with red text.
  2. ↑ Content tags are checked in the order text, translate, score, selector, keybind, nbt. If multiple are present, whichever one comes first in that list will be used.
  3. ↑ Selecting the "next" argument ignores slots that specify an index explicitly. So if the translation text "Hello %s, %2$s, and %s." was given the arguments "John" and "Becky", it would display "Hello John, Becky, and Becky."
  4. ↑ Showing the reader's own score only works in situations where a message has one singular reader. That is chat messages, /titles, and written books. It doesn't work for things like signs that can have more than one "reader".
  5. ↑ NBT sources are checked in the order block, entity, storage. If multiple are present, whichever one comes first in that list will be used.

See also

Minecraft: Java Edition
Versions
Development
Version history
Technical
.minecraft
Development resources
Legacy development resources
Multiplayer
Game customization
Minecraft: Bedrock Edition
Editions
Merged
Ports to consoles
Discontinued
Development
Version history
Technical
Multiplayer
Exclusive features
Effects
Unused
Removed
Deutsch 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki