Minecraft Wiki
Advertisement

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 may be either a JSON string, a JSON array, or a JSON object. 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 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.
    • 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, 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. Must be valid.
          •  count: Size of the item stack.
          •  tag: A string containing the serialized NBT of the additional information about the item, discussed more in the subsections of the player format page. This tag is optional for most items.
        • show_entity: The entity that should be displayed. [needs testing]
          •  name: Optional. Hidden if not present. A raw JSON text that is displayed as the name of the 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.

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

== Obtaining == 

=== Breaking ===

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

=== Smelting ===

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

=== Compound creation ===

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

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

== Usage ==

=== Crafting ingredient ===

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

=== Lab table ingredient ===

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

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

=== Fuel ===

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

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

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

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

== Achievements ==

{{load achievements|Renewable Energy}}

== History ==

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

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

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

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

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

{{Items}}

[[Category:Renewable resources]]

[[de:Holzkohle]]
[[fr:Charbon (objet)#Charbon de bois]]
[[hu:Faszén]]
[[it:Carbonella]]
[[ko:목탄]]
[[pt:Carvão#Carvão vegetal]]
[[nl:Steenkool#Houtskool]]
[[ru:Уголь#Древесный уголь]]
[[zh:木炭]]</li><li>[[Door|Door]]<br/>{{About|the block|the music track|Minecraft - Volume Alpha}}
{{See also|Trapdoor}}
{{Block
| image = <gallery>
Iron Door.png|Java Edition
Iron Door BE.png|Bedrock Edition
</gallery>
| extratext = View [[#Gallery|all renders]]
| transparent = Partial
| light = No
| tntres = {{Blast resistance values|Wooden Door}} <small>(Wood)</small><br>{{Blast resistance values|Iron Door}}<small> (Iron)</small>
| hardness = {{Hardness values|Wooden Door}} <small>(Wood)</small><br>{{Hardness values|Iron Door}}<small> (Iron)</small>
| tool = axe
| tool2 = wooden pickaxe
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = '''Overworld wood''': Yes<br>'''Nether wood''','''iron''': No
}}
A '''door''' is a block that can be used as a barrier that can be opened by hand or with [[redstone]].

== Obtaining ==
Doors can be found in any Overworld biome, and can also be crafted from any type of [[wood]] as well as materials found in [[the Nether]]. Some have built-in openings that are useful for determining the time of day.

=== Breaking ===
Wooden doors can be broken with anything, but [[axe]]s are fastest. An iron door can be broken with anything if the top half of the door is broken.<ref>{{bug|MC-189739}}</ref><ref>{{bug|MCPE-126620}}</ref> All doors drop themselves if they no longer have a block beneath them that can support them.
{{breaking row
|Oak Door, Spruce Door, Birch Door, Jungle Door, Acacia Door, Dark Oak Door, Mangrove Door, Cherry Door, Bamboo Door, Crimson Door, Warped Door; Iron Door
|textTrim=Door
|Axe;Pickaxe
|;
|item=1;1
|link=none;none
}}

A door is removed and drops itself as an item:

* if the block beneath the door is moved, removed, or destroyed
* if a [[piston]] tries to push the door (trying to pull a door does nothing) or moves a block into its space

=== Natural generation ===
Doors generate in some generated structures, forming the entrances to the majority of buildings. Doors do not generate in [[zombie village]]s.

;{{BlockSprite|Oak Door|text=Oak}}

Oak doors generate as part of:

* Plains [[village]]s
* [[Stronghold]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Spruce Door|text=Spruce}}

Spruce doors generate as part of:

* Taiga, snowy tundra and snowy taiga [[village]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Jungle Door|text=Jungle}}

Jungle doors generate as part of:

* Desert [[village]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Acacia Door|text=Acacia}}

Acacia doors generate as part of:

* Savanna [[village]]s
<!-- * Right-side-up [[shipwreck]]s{{only|BE}}{{need testing}} -->

;{{BlockSprite|Dark Oak Door|text=Dark oak}}

Dark oak doors generate as part of:

* Master bedroom closets in [[woodland mansion]]s
* Right-side-up [[shipwreck]]s

;{{BlockSprite|Iron Door|text=Iron}}

Iron doors generate as part of:

* Prison rooms in [[woodland mansion]]s
* [[Stronghold]]s with a stone [[button]] to open{{only|JE}}

=== Crafting ===
{{Crafting
|head=1
|name=[[Wood Door]]
|A1= Matching Planks
|B1= Matching Planks
|A2= Matching Planks
|B2= Matching Planks
|A3= Matching Planks
|B3= Matching Planks
|Output= Matching wood Door,3
|type= Redstone
}}
{{Crafting
|A1= Iron Ingot
|B1= Iron Ingot
|A2= Iron Ingot
|B2= Iron Ingot
|A3= Iron Ingot
|B3= Iron Ingot
|Output= Iron Door,3
|type= Redstone
|foot=1
}}

== Usage ==
Wooden doors can be opened and closed by players, [[villager]]s, [[wandering trader]]s{{only|bedrock|short=1}}<!--Wandering traders cannot open doors in java edition. -->, [[vindicator]]s{{only|java|short=1}}, and [[piglin]]s. Wooden doors can be broken by all variants of [[zombie]]s (except [[drowned]]) and [[vindicator]]s in Hard difficulty.

Iron doors can be opened only with redstone power.

=== Placement ===
Doors must be "attached" to a block beneath them. To place a door, {{control|use}} a door item while pointing at the top of the block it should be attached to. A door can be attached to:
* the '''top''' of any full solid [[opaque]] block ([[stone]], [[dirt]], [[blocks of gold]], etc.)
* the '''top''' of an upside-down [[slab]] or upside-down [[stairs]]
* the '''top''' of a [[slime block]] or downward-facing [[piston]]

More information about placement on transparent blocks can be found at [[Opacity/Placement]].

When placed, a door occupies the side of the block facing the player, or behind a player if placed in the player's own space.

By default, a door's "hinge" appears on the side of the half of the block that the player pointed at when placing and its "handle" on the opposite side{{only|java}}, but the hinge is forced to other side by:
* Placing a door besides another door (creating a double door where both doors open away from each other)
* Placing a door between a full solid and any opaque block (top or bottom), making the hinge appear to attach to the solid block.

=== Behavior ===
[[Water]] and [[lava]] flow around doors. Lava can create [[fire]] in air blocks next to wooden doors as if the wooden doors were flammable, but the doors do not burn (and cannot be burned by other methods either, except throwing them into lava).

[[Mob]]s can spawn in a space occupied by a door.

The sound of opening and closing of a door can be heard up to 16 blocks away, like most mob sounds.

When placed using the {{cmd|setblock}} command, only one half of a door is placed, because doors are actually two separate blocks. The lower half still works, but with graphical bugs, and the upper half does not. Redstone cannot be used because it updates the half, breaking it. The upper half does not drop anything when broken, the lower half drops a normal door. This implies that the upper half is dependent on the lower.

=== Barrier ===
A door can be used as a switchable barrier to entity movement. Although primarily used to block movement by mobs and players, a door can also be used to control the movement of boats (for example, a door placed in a two-wide water flow stops a boat when perpendicular to the flow, but allow it to move again when parallel), items and minecarts (a door can stop a falling item or minecart, then allow it to drop again when the door moves), etc.

{{IN|Java}}, doors provide a breathable space if placed underwater. {{IN|bedrock}}, doors in water source blocks are [[waterlogging|waterlogged]] and do not displace water source blocks.

Doors are 0.1875 ({{frac|3|16}}) blocks thick (0.1825 {{in|bedrock}}). The rest of a door's space can be moved through freely. A door occupies two block spaces and both halves normally act as a single barrier, although doors can be opened or closed with a player or mob occupying the bottom block of the door,<ref>{{bug|MC-54255}} – "You can stand on the bottom block of a door, allowing you to climb it like a ladder" resolved as "Won't Fix"</ref> in which case the player can jump up to land on the bottom half of the door and then again to land on top of the door.

To open or close a wooden door, use the {{control|use|text=Use Item/Place Block}} [[control]]. When a door opens or closes, it immediately changes its orientation without affecting anything in the space it "swings through". Moving doors do not push entities the way that pistons do.

[[Villager]]s, [[wandering trader]]s,{{only|bedrock|short=1}} [[vindicator]]s{{only|java|short=1}}, [[piglin]]s and [[piglin brute]]s can open and close wooden doors when pathfinding.

Some [[zombie]]s can break wooden doors in [[Hard]] [[difficulty]]. Zombies have a 5% chance to spawn with the ability to break doors. Vindicators spawned from a [[raid]] in [[Normal]] and Hard difficulty can also break wooden doors, but they do so only to reach targeted players, villagers, or wandering traders. Some vindicators may sometimes open a wooden door instead of breaking it.{{only|java}} Both zombies and vindicators attempt to break wooden doors only when in their "closed" state, even if a door is placed so that its "open" state blocks access (for example, by facing sideways when placing a door so that it allows passage when closed and blocks passage when open).

Iron doors can be opened only with redstone power (a [[button]], a [[redstone circuit]], etc.). Any mob can activate an iron door by stepping on a pressure plate or by triggering a tripwire.

=== Redstone component ===
{{see also|Redstone circuit}}

Both wood and iron doors can be controlled with redstone power.

A door is a redstone [[mechanism component]] and can be activated by:
* an adjacent active '''[[power component]]''', including above or below: for example, a [[redstone torch]], a [[block of redstone]], a [[daylight sensor]], etc.
* an adjacent '''powered block''' (for example, a block with an active redstone torch under it), including above or below
* a powered '''[[redstone comparator]]''' or '''[[redstone repeater]]''' facing the door
* powered '''[[redstone dust]]''' configured to point at the door or a directionless "dot" next to it; a door is ''not'' activated by adjacent powered redstone dust that is configured to point in another direction.

All methods of activating a door can be applied to either the top or bottom parts of a door.

When activated, a door immediately rotates around its hinge side to its open state. When deactivated, a door immediately returns to its closed state.

An activated wood door can still be closed by a player or villager and does not re-open until it receives a new activation signal (if a door has been closed "by hand", it still needs to be deactivated and then reactivated to open by redstone).

=== Fuel ===
Overworld wooden doors can be used as a [[Smelting#Fuel|fuel]] in [[furnace]]s, smelting 1 item per door.

=== Note blocks ===
Wooden doors can be placed under [[note block]]s to produce "bass" sound.

== Sounds ==
=== Generic ===
==== Iron ====
{{Sound table/Block/Metal}}

==== Normal wood ====
{{Sound table/Block/Wood}}

==== Cherry wood ====
{{Sound table/Block/Cherry wood}}

==== Bamboo wood ====
{{Sound table/Block/Bamboo wood}}

==== Nether wood ====
{{Sound table/Block/Nether wood}}

=== Unique ===
{{el|java}}:
{{Sound table
|sound=Iron Door open1.ogg
|sound2=Iron Door open2.ogg
|sound3=Iron Door open3.ogg
|sound4=Iron Door open4.ogg
|subtitle=Door creaks
|source=block
|description=When an iron door opens
|id=block.iron_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Iron Door close1.ogg
|sound2=Iron Door close2.ogg
|sound3=Iron Door close3.ogg
|sound4=Iron Door close4.ogg
|subtitle=Door creaks
|source=block
|description=When an iron door closes
|id=block.iron_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Wooden Door open3.ogg
|sound2=Wooden Door open4.ogg
|subtitle=Door creaks
|source=block
|description=When a wooden door opens
|id=block.wooden_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Wooden Door close2.ogg
|sound2=Wooden Door close5.ogg
|sound3=Wooden Door close6.ogg
|subtitle=Door creaks
|source=block
|description=When a wooden door closes
|id=block.wooden_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Cherry door toggle1.ogg
|sound2=Cherry door toggle2.ogg
|sound3=Cherry door toggle3.ogg
|sound4=Cherry door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a cherry wood door opens
|id=block.cherry_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a cherry wood door closes
|id=block.cherry_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Bamboo Door toggle1.ogg
|sound2=Bamboo Door toggle2.ogg
|sound3=Bamboo Door toggle3.ogg
|sound4=Bamboo Door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a bamboo wood door opens
|id=block.bamboo_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a bamboo wood door closes
|id=block.bamboo_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=0.9
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Nether Door toggle1.ogg
|sound2=Nether Door toggle2.ogg
|sound3=Nether Door toggle3.ogg
|sound4=Nether Door toggle4.ogg
|subtitle=Door creaks
|source=block
|description=When a Nether wood door opens
|id=block.nether_wood_door.open
|translationkey=subtitles.block.door.toggle
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|subtitle=Door creaks
|source=block
|description=When a Nether wood door closes
|id=block.nether_wood_door.close
|translationkey=subtitles.block.door.toggle
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Zombie hit wood1.ogg
|sound2=Zombie hit wood2.ogg
|sound3=Zombie hit wood3.ogg
|sound4=Zombie hit wood4.ogg
|subtitle=Door shakes
|source=hostile
|description=When a [[zombie]] attacks a door
|id=entity.zombie.attack_wooden_door
|translationkey=subtitles.entity.zombie.attack_wooden_door
|volume=2.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Zombie hit metal1.ogg
|sound2=Zombie hit metal2.ogg
|sound3=Zombie hit metal3.ogg
|subtitle=Block broken <ref group=sound name=ironsubtitle>{{Bug|MC-226770}}</ref>
|source=None
|description=''Unused sound event''<ref group=sound>{{bug|MC-218122}}</ref>
|id=entity.zombie.attack_iron_door
|translationkey=subtitles.block.generic.break|translationkeynote=<ref group=sound name=ironsubtitle/>
|volume=''None''
|pitch=''None''
|distance=''None''}}
{{Sound table
|sound=Zombie breaks door.ogg
|subtitle=Door breaks
|source=hostile
|description=When a zombie breaks a door
|id=entity.zombie.break_wooden_door
|translationkey=subtitles.entity.zombie.break_wooden_door
|volume=2.0
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|bedrock}}:
{{Sound table
|type=bedrock
|sound=Iron Door open1.ogg
|sound2=Iron Door open2.ogg
|sound3=Iron Door open3.ogg
|sound4=Iron Door open4.ogg
|source=block
|description=When an iron door opens
|id=open.iron_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Iron Door close1.ogg
|sound2=Iron Door close2.ogg
|sound3=Iron Door close3.ogg
|sound4=Iron Door close4.ogg
|source=block
|description=When an iron door closes
|id=close.iron_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Wooden Door open3.ogg
|sound2=Wooden Door open4.ogg
|source=block
|description=When a wooden door opens
|id=open.wooden_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|sound=Wooden Door close2.ogg
|sound2=Wooden Door close5.ogg
|sound3=Wooden Door close6.ogg
|source=block
|description=When a wooden door closes
|id=close.wooden_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Cherry door toggle1.ogg
|sound2=Cherry door toggle2.ogg
|sound3=Cherry door toggle3.ogg
|sound4=Cherry door toggle4.ogg
|source=block
|description=When a cherry wood door opens
|id=open.cherry_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a cherry wood door closes
|id=close.cherry_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Bamboo Door toggle1.ogg
|sound2=Bamboo Door toggle2.ogg
|sound3=Bamboo Door toggle3.ogg
|sound4=Bamboo Door toggle4.ogg
|source=block
|description=When a bamboo wood door opens
|id=open.bamboo_wood_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a bamboo wood door closes
|id=close.bamboo_wood_door
|volume=0.9
|pitch=0.9-1.0}}
{{Sound table
|rowspan=2
|sound=Nether Door toggle1.ogg
|sound2=Nether Door toggle2.ogg
|sound3=Nether Door toggle3.ogg
|sound4=Nether Door toggle4.ogg
|source=block
|description=When a Nether wood door opens
|id=open.nether_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|source=block
|description=When a Nether wood door closes
|id=close.nether_wood_door
|volume=1.0
|pitch=0.9-1.0}}
{{Sound table
|sound=Zombie hit wood1.ogg
|sound2=Zombie hit wood2.ogg
|sound3=Zombie hit wood3.ogg
|sound4=Zombie hit wood4.ogg
|source=hostile
|description=While a zombie is breaking a wooden door
|id=mob.zombie.wood
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Zombie breaks door.ogg
|source=hostile
|description=When a zombie breaks a wooden door
|id=mob.zombie.woodbreak
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Iron Door
|spritetype=block
|nameid=iron_door
|blocktags=doors
|itemtags=doors}}
{{ID table
|displayname=Oak Door
|spritetype=block
|nameid=oak_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Spruce Door
|spritetype=block
|nameid=spruce_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Birch Door
|spritetype=block
|nameid=birch_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Jungle Door
|spritetype=block
|nameid=jungle_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Acacia Door
|spritetype=block
|nameid=acacia_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Dark Oak Door
|spritetype=block
|nameid=dark_oak_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Mangrove Door
|spritetype=block
|nameid=mangrove_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Cherry Door
|spritetype=block
|nameid=cherry_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Bamboo Door
|spritetype=block
|nameid=bamboo_door
|blocktags=doors, wooden_doors
|itemtags=doors, wooden_doors}}
{{ID table
|displayname=Crimson Door
|spritetype=block
|nameid=crimson_door
|blocktags=doors, non_flammable_wood, wooden_doors
|itemtags=doors, non_flammable_wood, wooden_doors}}
{{ID table
|displayname=Warped Door
|spritetype=block
|nameid=warped_door
|blocktags=doors, non_flammable_wood, wooden_doors
|itemtags=doors, non_flammable_wood, wooden_doors
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|firstcolumnname=Door
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|spritename=iron-door
|displayname=Iron block
|spritetype=block
|nameid=iron_door
|id=71
|form=block
|itemform=item.iron_door}}
{{ID table
|spritename=oak-door
|displayname=Oak block
|spritetype=block
|nameid=wooden_door
|id=64
|form=block
|itemform=item.wooden_door
|translationkey=-}}
{{ID table
|spritename=spruce-door
|displayname=Spruce block
|spritetype=block
|nameid=spruce_door
|id=193
|form=block
|itemform=item.spruce_door
|translationkey=-}}
{{ID table
|spritename=birch-door
|displayname=Birch block
|spritetype=block
|nameid=birch_door
|id=194
|form=block
|itemform=item.birch_door
|translationkey=-}}
{{ID table
|spritename=jungle-door
|displayname=Jungle block
|spritetype=block
|nameid=jungle_door
|id=195
|form=block
|itemform=item.jungle_door
|translationkey=-}}
{{ID table
|spritename=acacia-door
|displayname=Acacia block
|spritetype=block
|nameid=acacia_door
|id=196
|form=block
|itemform=item.acacia_door
|translationkey=-}}
{{ID table
|spritename=dark-oak-door
|displayname=Dark Oak block
|spritetype=block
|nameid=dark_oak_door
|id=197
|form=block
|itemform=item.dark_oak_door
|translationkey=-}}
{{ID table
|spritename=mangrove-door
|displayname=Mangrove block
|spritetype=block
|nameid=mangrove_door
|id=-493
|form=block
|itemform=item.mangrove_door
|translationkey=-}}
{{ID table
|displayname=Cherry Door
|spritetype=block
|nameid=cherry_door
|id=-531
|itemtags=minecraft:door
|translationkey=item.cherry_door.name}}
{{ID table
|displayname=Bamboo Door
|spritetype=block
|nameid=bamboo_door
|id=-517
|itemtags=minecraft:door
|translationkey=item.bamboo_door.name}}
{{ID table
|spritename=crimson-door
|displayname=Crimson block
|spritetype=block
|nameid=crimson_door
|id=499
|form=block
|itemform=item.crimson_door}}
{{ID table
|spritename=warped-door
|displayname=Warped block
|spritetype=block
|nameid=warped_door
|id=500
|form=block
|itemform=item.warped_door}}
{{ID table
|spritename=iron-door
|displayname=Iron item
|spritetype=item
|nameid=iron_door
|id=372
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=oak-door
|displayname=Oak item
|spritetype=item
|nameid=wooden_door
|id=359
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=spruce-door
|displayname=Spruce item
|spritetype=item
|nameid=spruce_door
|id=553
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=birch-door
|displayname=Birch item
|spritetype=item
|nameid=birch_door
|id=554
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=jungle-door
|displayname=Jungle item
|spritetype=item
|nameid=jungle_door
|id=555
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=acacia-door
|displayname=Acacia item
|spritetype=item
|nameid=acacia_door
|id=556
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=dark-oak-door
|displayname=Dark Oak item
|spritetype=item
|nameid=dark_oak_door
|id=557
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=mangrove-door
|displayname=Mangrove item
|spritetype=item
|nameid=mangrove_door
|id=641
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=crimson-door
|displayname=Crimson item
|spritetype=item
|nameid=crimson_door
|id=616
|form=item
|itemtags=minecraft:door}}
{{ID table
|spritename=warped-door
|displayname=Warped item
|spritetype=item
|nameid=warped_door
|id=617
|form=item
|itemtags=minecraft:door
|foot=1}}

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

{{/BS}}

== Video ==
Note: The videos do not mention or state Crimson, Warped, Bamboo, or Cherry doors, since the videos were uploaded before 1.16.
<div style="text-align:center">
<span style="display:inline-block">{{yt|7jlIQcbHFts}}</span>
<span style="display:inline-block">{{yt|CC6ujEdvzQY}}</span>
</div>

== History ==
''For a history of changes to textures and models for each block state, see [[/Asset history]]''
{{History||3 June 2010|link=https://notch.tumblr.com/post/659506746/asynchronous-saving-and-loading-and-slightly-more|Notch states plans to implement doors.}}
{{History|java infdev}}{{History||20100607|[[File:Oak Door JE1.png|32px]] [[File:Oak Door (Right) JE1.png|32px]] [[File:Oak Door (item) JE1.png|32px]] Added wooden doors.}}
{{History||20100608|Doors have been given smarter rotation logic.}}
{{History||20100611|[[File:Oak Door JE2.png|32px]] [[File:Oak Door (Right) JE2.png|32px]] The models of doors have been changed to use door bottom half texture on sides instead of the wooden [[planks]] texture.}}
{{History||20100618|[[File:Oak Door JE3 BE1.png|32px]] [[File:Oak Door (Right) JE3.png|32px]] The textures of doors have been changed.}}
{{History||20100624|[[File:Oak Door (Right) JE4 BE1.png|32px]] The model of door with right hinge has been changed to mirror and use textures of door with left hinge.}}
{{History|java alpha}}
{{History||v1.0.1|[[File:Iron Door JE1 BE1.png|32px]] [[File:Iron Door (Right) JE1 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added iron doors.
|[[File:Oak Door (item) JE2 BE1.png|32px]] The texture of wooden doors in [[item]] form has been changed.
|Doors can now be controlled by redstone power.}}
{{History|java beta}}
{{History||1.7|Punching the back face of a left-hinge oak or iron door or the front face of a right-hinge door, as well as destroying a door, would [[Java Edition placeholder texture uses|create]] particles using the [[Placeholder texture#Texture atlas blank spaces|block placeholder texture]].}}
{{History||1.7.3|Doors no longer produce placeholder texture particles.}}
{{History||1.8|snap=Pre-release|Doors now occur naturally in [[village]]s and [[stronghold]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 6|Wooden doors are now broken faster using an [[axe]].
|Iron doors are broken much faster using a [[pickaxe]], and the [[mining]] speed is now [[tier]] dependent.}}
{{History|||snap=RC1|The opening and closing [[sound]]s for doors have been changed.}}
{{History||1.1|snap=11w47a|Double doors now open correctly.}}
{{History||1.2.1|snap=12w05b|[[Villager]]s can now open and close doors.}}
{{History|||snap=12w06a|[[File:Oak Door JE4 BE3.png|32px]] [[File:Iron Door JE2 BE5.png|32px]] Changed top model of door.
|[[Zombie]]s can now break wooden doors.
|Doors have been changed to properly detect if they are open or closed. Placing two [[pressure plate]]s directly in front of doors and stepping on them now opens them correctly.}}
{{History|||snap=12w07a|Zombies can no longer break iron doors.}}
{{History||1.4.2|snap=12w40a|Wooden doors can no longer be opened by attacking (left-click).}}
{{History||1.8|snap=December 13, 2013|slink=https://twitter.com/jeb_/status/411425952338808832|[[Jens Bergensten|Jeb]] tweeted an image showing that the crafting recipes for doors are changed so that 3 doors are crafted at once. Doors are also stackable to 64.}}
{{History|||snap=14w02a|Doors are now stackable to 64.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.}}
{{History|||snap=14w10a|[[File:Oak Door JE5.png|32px]] [[File:Iron Door JE3.png|32px]] The models of doors have been changed.}}
{{History|||snap=August 8, 2014|slink=https://twitter.com/TheMogMiner/status/497751889102905344|[[Ryan Holtz|TheMogMiner]] tweeted an image showing new types of [[wood]] doors.}}
{{History|||snap=14w32d|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE1.png|32px]] [[File:Acacia Door JE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Spruce Door (item) JE1.png|32px]] [[File:Birch Door (item) JE1.png|32px]] [[File:Jungle Door (item) JE1.png|32px]] [[File:Acacia Door (item) JE1.png|32px]] [[File:Dark Oak Door (item) JE1.png|32px]] New types of wood doors have been added: spruce, birch, jungle, acacia and dark oak.}}
{{History|||snap=14w33a|[[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] The models of jungle and acacia doors no longer have inner faces in the holes in their models.
|[[File:Spruce Door (item) JE2.png|32px]] [[File:Birch Door (item) JE2.png|32px]] [[File:Jungle Door (item) JE2.png|32px]] [[File:Acacia Door (item) JE2.png|32px]] [[File:Dark Oak Door (item) JE2.png|32px]] [[Item]] textures of new doors have been changed to match the dimensions of oak and iron doors.
|The wooden door (''Door'') has been renamed to ''Oak Door''.}}
{{History|||snap=14w33b|[[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]][[File:Iron Door (item) JE2 BE2.png|32px]] All [[item]] textures for all doors have been changed. Doors now have hinges on the left and handles on the right, existing wooden doors & iron doors have a slight item textures change as well.}}
{{History||1.9|snap=15w31a|[[File:Birch Door JE2.png|32px]] [[File:Jungle Door JE3.png|32px]] [[File:Acacia Door JE3.png|32px]] [[File:Dark Oak Door JE2.png|32px]] Shading on the [[block]] textures of birch, jungle, acacia, and dark oak doors have been changed, so that the shadow is in the upper left and the highlight is in the lower right.}}
{{History|||snap=15w43a|Iron doors now have different [[sound]]s than wooden doors.
|Doors now have [[sound]]s for placing and different sounds for opening and closing - see sounds section.}}
{{History|||snap=15w47a|Doors now make [[sound]]s when placed,<ref>{{bug|MC-2844}} – "Doors have no placement sound." resolved as "Fixed"</ref> despite these apparently already being added in 15w43a.}}
{{History|||snap=15w49a|Doors are now placed facing left/right depending on which half of the [[block]] the [[player]] clicks on, unless neighboring doors or solid/opaque blocks cause them to place a certain way.}}
{{History||1.10|snap=16w20a|Acacia and spruce doors now generate in [[savanna]] and [[taiga]] [[villages]].}}
{{History||1.11|snap=16w33a|Wooden doors can now be used to fuel [[furnace]]s.|Iron doors no longer have a right-click action - previously they would result in the hand swinging, and would override other valid right click actions such as snowball throwing.}}
{{History|||snap=16w39a|Dark oak doors and iron doors now generate in [[woodland mansion]]s.}}
{{History||July 19, 2017|link=https://twitter.com/jeb_/status/887599625045250048|[[Jeb]] tweets image of a new jungle [[wood planks]], jungle doors, [[cauldron]], and [[dandelion]] textures.}}
{{History||1.13|snap=17w47a|The oak door ID has been changed from <code>wooden_door</code> to <code>oak_door</code>.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[block]]s' numeral IDs were 64, 71, 193, 194, 195, 196 and 197, and the [[item]]s' 324, 330, 427, 428, 429, 430 and 431.}}
{{History|||snap=18w11a|Doors now generate as part of the newly added [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Oak Door JE6.png|32px]] [[File:Spruce Door JE2.png|32px]] [[File:Birch Door JE3.png|32px]] [[File:Jungle Door JE4.png|32px]] [[File:Acacia Door JE4.png|32px]] [[File:Dark Oak Door JE3.png|32px]] [[File:Iron Door JE4.png|32px]] The textures of all doors have been changed.
|[[Vindicator]]s can now break doors.}}
{{History|||snap=18w47b|[[File:Spruce Door JE3.png|32px]] The textures of spruce doors have been changed.}}
{{History|||snap=18w49a|Added [[snowy tundra]] villages, which generate with spruce doors.}}
{{History|||snap=18w50a|The updated [[desert]] villages now generate with jungle doors instead of oak doors.}}
{{History|||snap=19w08a|[[File:Oak Door JE7.png|32px]] The texture of oak doors has been changed.}}
{{History|||snap=19w12b|Doors can now be placed on glass, ice, glowstone and sea lanterns.}}
{{History|||snap=19w13a|[[Evoker]]s and [[pillager]]s can now open doors during [[raid]]s.}}
{{History|||snap=19w14a|Pillagers can no longer open doors.}}
{{History||1.15|snap=19w39a|Iron doors must now be mined with a [[pickaxe]] for it to be dropped as an [[item]].}}
{{History||1.16|snap=20w06a|[[File:Crimson Door JE1.png|32px]] [[File:Warped Door JE1.png|32px]] [[File:Crimson Door (item) JE1 BE1.png|32px]] [[File:Warped Door (item) JE1 BE1.png|32px]] Added crimson and warped doors.}}
{{History|||snap=20w07a|Added [[piglin]]s, which can open and close doors.}}
{{History|||snap=20w19a|[[File:Crimson Door JE2.png|32px]] [[File:Warped Door JE2.png|32px]] [[File:Crimson Door (item) JE2 BE2.png|32px]] [[File:Warped Door (item) JE2 BE2.png|32px]] The textures of crimson and warped doors have been changed.}}
{{History||1.17|snap=21w11a|[[File:Jungle Door (item) JE4 BE2.png|32px]] Changed the texture of the jungle door item.}}
{{History||1.18|snap=21w41a|[[File:Oak Door (item) JE4 BE3.png|32px]] [[File:Spruce Door (item) JE4 BE2.png|32px]] [[File:Birch Door (item) JE4 BE2.png|32px]] [[File:Jungle Door (item) JE5 BE3.png|32px]] [[File:Acacia Door (item) JE4 BE2.png|32px]] [[File:Dark Oak Door (item) JE4 BE2.png|32px]][[File:Iron Door (item) JE3 BE3.png|32px]] All [[item]] textures for all doors except crimson and warped have been changed.}}
{{History|||snap=Pre-release 5|[[File:Oak Door JE8.png|32px]] [[File:Spruce Door JE4.png|32px]] [[File:Birch Door JE4.png|32px]] [[File:Jungle Door JE5.png|32px]] [[File:Acacia Door JE5.png|32px]] [[File:Dark Oak Door JE4.png|32px]] [[File:Crimson Door JE3.png|32px]] [[File:Warped Door JE3.png|32px]] [[File:Iron Door JE5.png|32px]] Changed top and bottom models of door. Changed oak and iron doors textures.}}
{{History||1.19|snap=22w11a|[[File:Mangrove Door JE1.png|32px]][[File:Mangrove Door (item) JE1 BE1.png|32px]] Added mangrove door.}}
{{History|||snap=22w14a|Due to the addition of the [[mangrove tree]] and [[mangrove swamp]], mangrove doors are now obtainable and renewable.}}
{{History||October 15, 2022|link={{ytl|https://youtu.be/iM9KtHaDcUg?t=5659}}|[[File:Bamboo Door JE1.png|32px]] Bamboo doors were shown on [[Minecraft Live 2022]].}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|[[File:Bamboo Door JE1.png|32px]] [[File:Bamboo Door (item) JE1 BE1.png|32px]] Added bamboo doors behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Cherry Door JE1.png|32px]] [[File:Cherry Door (item) JE1.png|32px]] Added cherry doors behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History|||snap=1.19.4-pre2|[[File:Cherry Door JE2.png|32px]] [[File:Cherry Door (item) JE2.png|32px]] Changed the texture of cherry doors.}}
{{History||1.20|snap=23w12a|Bamboo and cherry doors are now available without using the "Update 1.20" experimental datapack.}}

{{History|pocket alpha}}
{{History||v0.1.0|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] Added doors.
[[File:Oak Door (bottom texture) JE2 BE1.png|32px]] [[File:Iron Door (bottom texture) JE1 BE1.png|32px]] These are the textures defined for the door blocks in <samp>[[gui_blocks.png]]</samp>. The door items exist, but due to a bug in the code that renders items in the hotbar, they cannot be used.}}
{{History||v0.1.3|[[File:Oak Door BE2.png|32px]] [[File:Iron Door BE2.png|32px]] The models of doors have been changed to not display transparency on upper half.}}
{{History||v0.2.0|[[File:Oak Door (item) JE2 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added door inventory icons.
|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] The models of doors have been changed to display transparency on upper half.
|Wooden doors are now available in the inventory, including in [[Creative]].}}
{{History||v0.2.1 alpha2|link=Pocket Edition v0.2.1 alpha2|[[File:Iron Door BE3.png|32px]] The textures of iron doors have been changed.}}
{{History||v0.3.0|A crafting recipe for wooden doors has been added.
|Survival players no longer start out with an infinite stack of wooden doors in the inventory.}}
{{History||v0.3.2|Wooden doors now drop their item form when broken.}}
{{History||v0.5.0|[[File:Oak Door JE4 BE3.png|32px]] [[File:Iron Door BE4.png|32px]] The models of doors have been changed.
|Wooden doors can now be obtained after activating the [[nether reactor]].}}
{{History||v0.8.0|snap=build 2|[[File:Iron Door JE2 BE5.png|32px]] The textures of iron doors have been changed to before v0.2.1 alpha2.}}
{{History||v0.11.0|snap=build 1|''Door'' has been now renamed to ''Oak Door''.}}
{{History||v0.12.1|snap=build 1|Doors are now stackable to 64.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.
|[[Zombie]]s can now break down wooden doors.
|Oak doors can now be opened by [[villager]]s.
|Oak doors are no longer available from the [[nether reactor]].}}
{{History||v0.13.0|snap=build 1|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] Added spruce, birch, jungle, acacia and dark oak doors.
|Iron doors are now available in the [[Creative]] [[inventory]].
|A [[crafting]] recipe for iron doors has been added.
|Redstone mechanics added, making iron doors able to function normally.}}
{{History|||snap=build 2|Spruce, birch, jungle, acacia, and dark oak doors can now be opened by [[villager]]s.}}
{{History|||snap=build 4|[[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Iron Door (item) JE2 BE2.png|32px]] The [[item]] textures of oak and iron door has been changed.}}
{{History||v0.15.0|snap=build 1|Acacia doors now generate in [[savanna]] [[village]]s.
|Spruce doors now generate in [[taiga]] and [[snowy tundra]] villages.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Dark oak doors and iron doors now generate in [[woodland mansion]]s.
|Doors now have [[sound]]s when placed.<ref>{{bug|MCPE-10079}} – "Doors don't have a placement sound" resolved as "Fixed"</ref>}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Various wooden doors now generate in [[shipwreck]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Oak Door BE4.png|32px]] [[File:Spruce Door BE2.png|32px]] [[File:Birch Door BE2.png|32px]] [[File:Jungle Door BE2.png|32px]] [[File:Acacia Door BE2.png|32px]] [[File:Dark Oak Door BE2.png|32px]] [[File:Iron Door BE6.png|32px]] The textures of all doors have been changed.
|Jungle doors now generate in the new [[desert]] [[village]]s.
|Added [[wandering trader]]s, which can open and close wooden doors.}}
{{History||1.11.0|snap=beta 1.11.0.7|[[Vindicator]]s can now break doors during [[raid]]s.}}
{{History||1.16.0|snap=beta 1.15.0.51|Zombies can no longer break iron doors.<ref>{{bug|MCPE-43725}}</ref>}}
{{History|||snap=beta 1.16.0.51|[[File:Crimson Door BE1.png|32px]] [[File:Warped Door BE1.png|32px]] [[File:Crimson Door (item) JE1 BE1.png|32px]] [[File:Warped Door (item) JE1 BE1.png|32px]] Added crimson and warped doors.
|Added [[piglin]]s, which can open and close doors.}}
{{History|||snap=beta 1.16.0.63|[[File:Crimson Door BE2.png|32px]] [[File:Warped Door BE2.png|32px]] [[File:Crimson Door (item) JE2 BE2.png|32px]] [[File:Warped Door (item) JE2 BE2.png|32px]] The textures of crimson and warped doors have been changed.}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Jungle Door (item) JE4 BE2.png|32px]] Changed the texture of the jungle door item.}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Oak Door (item) JE4 BE3.png|32px]] [[File:Spruce Door (item) JE4 BE2.png|32px]] [[File:Birch Door (item) JE4 BE2.png|32px]] [[File:Jungle Door (item) JE5 BE3.png|32px]] [[File:Acacia Door (item) JE4 BE2.png|32px]] [[File:Dark Oak Door (item) JE4 BE2.png|32px]][[File:Iron Door (item) JE3 BE3.png|32px]] All [[item]] textures for all doors except crimson and warped have been changed.}}
{{History||1.19.0|snap=beta 1.19.0.20|[[File:Mangrove Door BE1.png|32px]] [[File:Mangrove Door (item) JE1 BE1.png|32px]] Added mangrove doors.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|[[File:Bamboo Door BE1.png|32px]] [[File:Bamboo Door (item) JE1 BE1.png|32px]] Added bamboo doors behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.
|The doors now use the same opening and closing [[sound]] effects as ''[[Java Edition]]''.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|[[File:Cherry Door JE2.png|32px]] [[File:Cherry Door (item) JE2.png|32px]] Added cherry doors behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.}}
{{History||1.20.0|snap=beta 1.20.0.21|Bamboo and cherry doors are now available without using the "Next Major Update" experimental toggle.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Oak Door JE3 BE1.png|32px]] [[File:Iron Door JE1 BE1.png|32px]] [[File:Oak Door (item) JE2 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added doors.}}
{{History||xbox=TU5|Doors can be found in the Redstone & Transportation tab in the [[Creative inventory]].}}
{{History||xbox=TU14|ps=1.04|Doors being broken by [[zombie]]s now show [[damage]].
|Moved doors to the Building Blocks tab in the Creative inventory.}}
{{History||xbox=TU25|xbone=CU14|ps=1.17|[[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] Added spruce, birch, and jungle door variants.
|The [[crafting]] recipes of doors now yield 3 doors instead of 1.
|The original wooden door (''Door'') has been renamed to ''Oak Door''.}}
{{History||xbox=TU27|xbone=CU15|ps=1.18|[[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] Acacia and dark oak doors have been added to the [[Creative]] [[inventory]].}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Acacia doors and dark oak doors are now obtainable in [[survival]] mode.}}
{{History||?| [[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Iron Door (item) JE2 BE2.png|32px]] Oak and iron door's inventory textures have been changed to match Java Edition}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Oak Door BE4.png|32px]] [[File:Spruce Door BE2.png|32px]] [[File:Birch Door BE2.png|32px]] [[File:Jungle Door BE2.png|32px]] [[File:Acacia Door BE2.png|32px]] [[File:Dark Oak Door BE2.png|32px]] [[File:Iron Door BE6.png|32px]] The textures of all doors have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Oak Door JE2.png|32px]] [[File:Spruce Door JE1 BE1.png|32px]] [[File:Birch Door JE1 BE1.png|32px]] [[File:Jungle Door JE2 BE1.png|32px]] [[File:Acacia Door JE2 BE1.png|32px]] [[File:Dark Oak Door JE1 BE1.png|32px]] [[File:Iron Door JE2 BE5.png|32px]] [[File:Oak Door (item) JE3 BE2.png|32px]] [[File:Spruce Door (item) JE3 BE1.png|32px]] [[File:Birch Door (item) JE3 BE1.png|32px]] [[File:Jungle Door (item) JE3 BE1.png|32px]] [[File:Acacia Door (item) JE3 BE1.png|32px]] [[File:Dark Oak Door (item) JE3 BE1.png|32px]] [[File:Iron Door (item) JE1 BE1.png|32px]] Added doors.}}
{{History|foot}}

<gallery>
Beta 1.7 punching oak door.png|From [[Java Edition Beta 1.7]] to Beta 1.7.2, doors produced [[placeholder texture]] particles when broken or punched on some sides.
</gallery>

Historical sounds:
{| class="wikitable"
! Sound
! From
! to
! Pitch
|-
| {{sound||Door closing old.ogg|Door opening old.ogg}}
| ?
| Sound Update
| ?
|-
| {{sound||Door open.ogg|Door close.ogg}}
| Sound Update
| 15w43a
| ?
|}

=== Door "items" ===
{{:Technical blocks/Doors}}

== Issues ==
{{Issue list}}

== Trivia ==

* Door models have an extra hinge on the opposite side of the actual functional hinge.<ref>{{bug|MC-106697|||WAI}}</ref>

== Gallery ==
<gallery>
Oak Door.png|Oak Door
Spruce Door.png|Spruce Door
Birch Door.png|Birch Door
Jungle Door.png|Jungle Door
Acacia Door.png|Acacia Door
Dark Oak Door.png|Dark Oak Door
Mangrove Door.png|Mangrove Door
Cherry Door.png|Cherry Door
Bamboo Door.png|Bamboo Door
Crimson Door.png|Crimson Door
Warped Door.png|Warped Door
Iron Door.png|Iron Door
Oak Door (item) JE4 BE3.png|Oak Door (item)
Spruce Door (item) JE4 BE2.png|Spruce Door (item)
Birch Door (item) JE4 BE2.png|Birch Door (item)
Jungle Door (item) JE5 BE3.png|Jungle Door (item)
Acacia Door (item) JE4 BE2.png|Acacia Door (item)
Dark Oak Door (item) JE4 BE2.png|Dark Oak Door (item)
Mangrove Door (item) JE1 BE1.png|Mangrove Door (item)
Cherry Door (item) JE2.png|Cherry Door (item)
Bamboo Door (item) JE1 BE1.png|Bamboo Door (item)
Crimson Door (item) JE2 BE2.png|Crimson Door (item)
Warped Door (item) JE2 BE2.png|Warped Door (item)
Iron Door (item) JE3 BE3.png|Iron Door (item)
</gallery>

=== Screenshots ===
<gallery>
Iron Door in Stronghold.png|Naturally occurring iron door in a [[stronghold]].
Wooden Doors 1.8.png|First picture of brand-new 1.8 variants of doors.
Door Creeper.png|A creeper behind some dark oak doors.
Doortypes.png|All types of doors with their respective trapdoors.
FloatingDoorArrows.jpg|Arrows shot into a door that was opened, causing a floating bug.
Jeb Crafting Doors.png|First image of three doors being crafted at once.
Jappa Closet.jpg|A closet made from oak doors.
</gallery>

=== Concept Art ===
<gallery>
Bamboo Wood and Door Concept Art.png|Bamboo door concept art.
Bamboo Door Prototype Textures.png|Bamboo door prototype textures.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--door Taking Inventory: Door] – Minecraft.net on September 29, 2022

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

[[Category:Manufactured blocks]]
[[Category:Generated structure blocks]]
[[Category:Utility blocks]]
[[Category:Mechanics]]
[[Category:Redstone mechanics]]
[[Category:Mechanisms]]

[[cs:Dveře]]
[[de:Tür]]
[[el:Door]]
[[es:Puerta]]
[[fr:Porte]]
[[hu:Ajtók]]
[[it:Porta]]
[[ja:ドア]]
[[ko:문]]
[[nl:Deur]]
[[pl:Drzwi]]
[[pt:Porta]]
[[ru:Дверь]]
[[th:ประตู]]
[[uk:Двері]]
[[zh:门]]</li></ul>
13w37aAdded /tellraw, the raw JSON text used to support this command.
1.8
{{Extension DPL}}<ul><li>[[Blue Dye|Blue Dye]]<br/>{{Item
|image = Blue_Dye_JE1_BE1.png
|renewable = Yes
|stackable = Yes (64)
}}

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

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

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

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

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

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

== History ==

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

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

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

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

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

[[de:Blauer Farbstoff]]
[[es:Tinte azul]]
[[fr:Teinture bleue]]
[[ja:青色の染料]]
[[ko:파란색 염료]]
[[pl: Niebieski barwnik]]
[[pt:Corante azul]]
[[zh:蓝色染料]]</li><li>[[Chestplate|Chestplate]]<br/>{{Update|Include information about armor trims and updated netherite upgrade information.}}
{{Item
| image = <gallery>
Leather Tunic.png | Leather
Chainmail Chestplate.png | Chainmail
Iron Chestplate.png | Iron
Diamond Chestplate.png | Diamond
Golden Chestplate.png | Golden
Netherite Chestplate.png | Netherite
</gallery>
| durability = 
* Leather: 80
* Chainmail: 240
* Iron: 240
* Golden: 112
* Diamond: 528
* Netherite: 592
| renewable = 
* '''Netherite''': No
* '''All Other''': Yes
| stackable = No
}}
'''Chestplates''' are a type of [[armor]] that covers the upper body of the player. There are six types of chestplates: '''leather''', '''chainmail''', '''iron''', '''diamond''', '''gold''' and '''netherite'''.

== Obtaining ==

=== Crafting ===

{{crafting
  |head=1
  |showname=0
  |showdescription=1
  |name=[[Chestplate]]
  |A1= Leather;Gold Ingot;Iron Ingot;Diamond
  |C1= Leather;Gold Ingot;Iron Ingot;Diamond
  |A2= Leather;Gold Ingot;Iron Ingot;Diamond
  |B2= Leather;Gold Ingot;Iron Ingot;Diamond
  |C2= Leather;Gold Ingot;Iron Ingot;Diamond
  |A3= Leather;Gold Ingot;Iron Ingot;Diamond
  |B3= Leather;Gold Ingot;Iron Ingot;Diamond
  |C3= Leather;Gold Ingot;Iron Ingot;Diamond
  |Output= Leather Tunic;Golden Chestplate;Iron Chestplate;Diamond Chestplate
  |type= Combat
}}
{{crafting
  |foot=1
  |ignoreusage=1
  |name=[[Chestplate]]
  |ingredients=Damaged Matching [[Chestplate]]
  |Damaged Leather Tunic; Damaged Golden Chestplate; Damaged Chainmail Chestplate; Damaged Iron Chestplate; Damaged Diamond Chestplate; Damaged Netherite Chestplate
  |Damaged Leather Tunic; Damaged Golden Chestplate; Damaged Chainmail Chestplate; Damaged Iron Chestplate; Damaged Diamond Chestplate; Damaged Netherite Chestplate
  |Output= Leather Tunic; Golden Chestplate; Chainmail Chestplate; Iron Chestplate; Diamond Chestplate; Netherite Chestplate
  |description= The durability of the two chestplates is added together, making a fully healed chestplate. You can get 5% more durability while using a grindstone to fix.
  |type= Combat
}}

=== Upgrading ===
{{Smithing
|Netherite Upgrade
|Diamond Chestplate
|Netherite Ingot
|Netherite Chestplate
|description=
|tail=1
}}

=== Repairing ===
==== Grinding ====
{{Grinding
|showdescription=1
|ingredients=Damaged Matching Chestplates
|Damaged Leather Tunic; Damaged Chainmail Chestplate; Damaged Iron Chestplate; Damaged Golden Chestplate; Damaged Diamond Chestplate; Damaged Netherite Chestplate
|Damaged Leather Tunic; Damaged Chainmail Chestplate; Damaged Iron Chestplate; Damaged Golden Chestplate; Damaged Diamond Chestplate; Damaged Netherite Chestplate
|Leather Tunic; Chainmail Chestplate; Iron Chestplate; Golden Chestplate; Diamond Chestplate; Netherite Chestplate
|description=The durability of the two chestplates are added together, plus an extra 5% durability.
}}

==== [[Anvil mechanics#Unit repair|Unit repair]] ====
Chestplates can be repaired in an [[anvil]] by adding units of the [[armor material]]'s repair material, with each repair material restoring 25% of the chestplate's maximum durability, rounded down.

=== Mob loot ===

[[Zombie]]s and [[skeleton]]s have a small chance to spawn wearing any armor. There is an 8.5% chance (9.5% with [[Looting]] I, 10.5% with Looting II and 11.5% with Looting III) for the mob to drop a chestplate upon death. The chestplate the mob drops is usually badly damaged, and rarely enchanted.

[[Vindicator]]s and [[Pillager]]s spawning in [[raid]]s have a 4.1% chance (5.12% on hard difficulty) to drop iron chestplate, which is almost always badly damaged and rarely enchanted.

=== Natural generation ===
Two [[armor stand]]s are found in each taiga [[village]] outdoor armory, one of them equipped with an [[iron chestplate]].

=== Chest loot ===
{{IN|BE}}, a sealed room in [[woodland mansion]]s can appear that has a chest sometimes containing an [[Efficiency]] I leather tunic.<ref>{{bug|MCPE-109048}}</ref>
{{LootChestItem|leather-tunic,random-enchanted-leather-tunic,chainmail-chestplate,iron-chestplate,level-enchanted-iron-chestplate,golden-chestplate,random-enchanted-golden-chestplate,diamond-chestplate,damaged-diamond-chestplate,level-enchanted-diamond-chestplate,damaged-random-enchanted-diamond-chestplate,damaged-random-enchanted-diamond-chestplate-2}}

=== Trading ===

{{IN|java}}, novice-level armorer villagers have a 40% chance to sell an iron chestplate for 9 emeralds. Journeyman-level armorers have a 40% chance to sell a chainmail chestplate for 4 emeralds. Master-level armorers always sell an enchanted<ref group="note" name="enchantment" /> diamond chestplate for 18-35 emeralds. Novice-level leatherworker villagers have a {{frac|2|3}} chance to sell a leather tunic<ref group="note" name="dye note">The leather armor has a random color created by two dyes (possibly the same dye twice).</ref> for 7 emeralds. Journeyman-level Leatherworker villagers always offer the same trade.

Armorer villagers may give the players with the [[Hero of the Village]] effect a chainmail chestplate.

{{IN|bedrock}}, novice-level armorer villagers have a 25% chance to sell an iron chestplate for 9 emeralds. Journeyman-level armorers have a {{frac|1|3}} chance to sell a chainmail chestplate for 4 emeralds. Master-level armorers have a 50% chance to sell an enchanted<ref group="note" name="enchantment">When creating an enchantment offer, the game uses a random enchantment level from 5 – 19. The enchantments are never treasure enchantments.</ref> diamond chestplate for 16 emeralds. Novice-level leatherworker villagers have a 50% chance to sell leather tunic for 7 emeralds. Master-level leatherworkers always sell an enchanted<ref group="note" name="enchantment" /> leather tunic for 7 emeralds.

{{notelist|columns=1}}

== Usage ==

Chestplates can be placed in the 2nd armor slot of a player's [[inventory]] for activation.

=== Defense points ===

Defense points are each signified by chestplates in the armor bar above the [[health]] bar. 1 defense point is half of a chestplate in the armor bar. Each defense point reduces any damage dealt to the player, which is absorbed by armor by 4%, increasing additively with the number of defense points. Different materials and combinations of armor provide different levels of defense.

The following table shows the amount of defense points added by chestplates.

{| class="wikitable" data-description="Chestplate defense points"
|-
!scope="col" | Material
!scope="col" | Defense points
|-
!scope="row" | Leather
| {{armor|3}}
|-
!scope="row" | Golden
| rowspan="2" | {{armor|5}}
|-
!scope="row" | Chainmail
|-
!scope="row" | Iron
| {{armor|6}}
|-
!scope="row" | Diamond
| rowspan="2" | {{armor|8}}
|-
!scope="row" | Netherite
|}

===Knockback Resistance ===

A netherite chestplate provides 10% knockback resistance.

=== Durability ===

The following table shows the amount of damage each piece of armor can absorb before being destroyed.

Any "hit" from a damage source that can be blocked by armor removes one point of durability from each piece of armor worn for every {{hp|4}} of incoming damage (rounded down, but never below 1). Damage taken that unenchanted armor does not protect against (such as [[Damage#Fall damage|falling]] or [[Damage#Drowning|drowning]]) does not damage the armor, even if it is enchanted to protect against that type of damage. The following chart displays how many hits chest plates can endure.

Netherite armor is not damaged by [[lava]] or [[fire]] when worn.

{| class="wikitable" data-description="Chestplate durability"
|-
! Material
! Durability
|-
!scope="row" | Leather
| 80
|-
!scope="row" | Golden
| 112
|-
!scope="row" | Chainmail
| rowspan="2" | 240
|-
!Iron
|-
!scope="row" | Diamond
| 528
|-
!scope="row" | Netherite
| 592
|}

==== Repair ====

Chestplates may be [[item repair|repaired]] by using them along with some of their crafting material ([[leather]], [[gold ingot]]s, [[iron ingot]]s, [[diamond]]s, or [[netherite ingot]]s) in an [[anvil]]. Chainmail chestplates may be repaired in this way with iron ingots. They may also be repaired by crafting them together with another chestplate of the same material.

=== Enchantments ===

A chestplate can receive the following [[enchantment]]s:

{| class="wikitable"
|-
! Enchantment !! Max Level  !! Notes
|-
| [[Fire Protection]] || IV || <ref group=note name=exclusive>Fire Protection, Blast Protection, Projectile Protection and Protection are mutually exclusive</ref>
|-
| [[Projectile Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Blast Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Protection]] || IV || <ref group=note name="exclusive"/>
|-
| [[Unbreaking]] || III ||
|-
|  [[Thorns]] || III || <ref group="note" name="maxlvl">The max level obtainable in the enchanting table is 2</ref>
|-
| [[Mending]] || I || <ref group=note name="anvil2">Only from chest loot, fishing, or an anvil and enchanted books.</ref>
|-
| [[Curse of Binding]] || I || <ref group="note" name="anvil2"/>
|-
| [[Curse of Vanishing]] || I || <ref group="note" name="anvil2"/>
|}
{{notelist}}

=== Smelting usage ===

{{Smelting|showname=1|Iron Chestplate;Chainmail Chestplate;Golden Chestplate|Iron Nugget;Iron Nugget;Gold Nugget|0,1}}
=== Piglins ===
{{EntityLink|Piglin|Piglins}} are attracted to ''golden'' chestplates and pick them up, examining them for 6 to 8 seconds. Piglins can wear other chestplates but are not attracted to them. They prefer stronger chestplates over weaker chestplates, with one exception: They always prefer golden chestplates over all other chestplates, throwing out stronger chestplates to equip them. Enchanted chestplates are preferred over unenchanted chestplates.

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|subtitle=Leather armor rustles
|source=player
|description=When a leather chestplate is equipped
|id=item.armor.equip_leather
|translationkey=subtitles.item.armor.equip_leather
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|subtitle=Chain armor jingles
|source=player
|description=When a chainmail chestplate is equipped
|id=item.armor.equip_chain
|translationkey=subtitles.item.armor.equip_chain
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|subtitle=Iron armor clanks
|source=player
|description=When an iron chestplate is equipped
|id=item.armor.equip_iron
|translationkey=subtitles.item.armor.equip_iron
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|subtitle=Gold armor clinks
|source=player
|description=When a gold chestplate is equipped
|id=item.armor.equip_gold
|translationkey=subtitles.item.armor.equip_gold
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|subtitle=Diamond armor clangs
|source=player
|description=When a diamond chestplate is equipped
|id=item.armor.equip_diamond
|translationkey=subtitles.item.armor.equip_diamond
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|subtitle=Netherite armor clanks
|source=player
|description=When a netherite chestplate is equipped
|id=item.armor.equip_netherite
|translationkey=subtitles.item.armor.equip_netherite
|volume=0.8
|pitch=1.0/0.9
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=dependent
|description=When a chestplate's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|source=player
|description=When a leather chestplate is equipped
|id=armor.equip_leather
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip chain1.ogg
|sound2=Equip chain2.ogg
|sound3=Equip chain3.ogg
|sound4=Equip chain4.ogg
|sound5=Equip chain5.ogg
|sound6=Equip chain6.ogg
|source=player
|description=When a chain chestplate is equipped
|id=armor.equip_chain
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip iron1.ogg
|sound2=Equip iron2.ogg
|sound3=Equip iron3.ogg
|sound4=Equip iron4.ogg
|sound5=Equip iron5.ogg
|sound6=Equip iron6.ogg
|source=player
|description=When an iron chestplate is equipped
|id=armor.equip_iron
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip gold1.ogg
|sound2=Equip gold2.ogg
|sound3=Equip gold3.ogg
|sound4=Equip gold4.ogg
|sound5=Equip gold5.ogg
|sound6=Equip gold6.ogg
|source=player
|description=When a gold chestplate is equipped
|id=armor.equip_gold
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip diamond1.ogg
|sound2=Equip diamond2.ogg
|sound3=Equip diamond3.ogg
|sound4=Equip diamond4.ogg
|sound5=Equip diamond5.ogg
|sound6=Equip diamond6.ogg
|source=player
|description=When a diamond chestplate is equipped
|id=armor.equip_diamond
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Equip netherite1.ogg
|sound2=Equip netherite2.ogg
|sound3=Equip netherite3.ogg
|sound4=Equip netherite4.ogg
|source=player
|description=When a netherite chestplate is equipped.
|id=armor.equip_netherite
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=2
|sound=Water Splash Old.ogg
|source=block
|description=When a leather chestplate is dyed using a cauldron
|id=cauldron.dyearmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a leather chestplate's dye is removed using a cauldron
|id=cauldron.cleanarmor
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a chestplate's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Leather Tunic
|spritetype=item
|nameid=leather_chestplate
|itemtags=freeze_immune_wearables
|form=item}}
{{ID table
|displayname=Chainmail Chestplate
|spritetype=item
|nameid=chainmail_chestplate
|form=item}}
{{ID table
|displayname=Iron Chestplate
|spritetype=item
|nameid=iron_chestplate
|form=item}}
{{ID table
|displayname=Diamond Chestplate
|spritetype=item
|nameid=diamond_chestplate
|form=item}}
{{ID table
|displayname=Golden Chestplate
|spritetype=item
|nameid=golden_chestplate
|form=item}}
{{ID table
|displayname=Netherite Chestplate
|spritetype=item
|nameid=netherite_chestplate
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather Tunic
|spritetype=item
|nameid=leather_chestplate
|id=336
|form=item}}
{{ID table
|displayname=Chainmail Chestplate
|spritetype=item
|nameid=chainmail_chestplate
|id=340
|form=item}}
{{ID table
|displayname=Iron Chestplate
|spritetype=item
|nameid=iron_chestplate
|id=344
|form=item}}
{{ID table
|displayname=Diamond Chestplate
|spritetype=item
|nameid=diamond_chestplate
|id=348
|form=item}}
{{ID table
|displayname=Golden Chestplate
|spritetype=item
|nameid=golden_chestplate
|id=352
|form=item}}
{{ID table
|displayname=Netherite Chestplate
|spritetype=item
|nameid=netherite_chestplate
|id=610
|form=item
|foot=1}}

=== Item data ===
When leather tunics are dyed, it has the following NBT:
<div class="treeview">
* {{nbt|compound|tag}}: Parent tag.
** {{nbt|compound|display}}: Display properties.
*** {{nbt|int|color}}: The color of the leather armor. The tooltip displays "Dyed" if advanced tooltips are disabled, otherwise it displays the hexadecimal color value. 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>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref>
</div>

== Achievements ==
{{load achievements|Iron Man;Tie Dye Outfit;Cover me in debris;Oooh, shiny!}}

== Advancements ==
{{load advancements|Suit Up;Cover me With Diamonds;Oh Shiny;Cover Me in Debris}}

== History ==

{{History|java classic}}
{{History||June 14, 2009|link=wordofnotch:123343045|[[Notch]] discussed how armor would work in [[Survival]] mode: "Two types of swords, two types of armor, two types of helmets. The basic versions require iron. The advanced versions require steel, which you make by combining iron and coal. Carrying swords, armor or helmets take up inventory slots, but otherwise have no penalty and work pretty much as you expect (prevent some damage, or cause more damage)".}}
{{History||August 13, 2009|link=wordofnotch:162091556|Notch tested chestplates on the [[human]]. They were merely aesthetic at the time and had no effect on gameplay.}}
{{History||0.24_SURVIVAL_TEST|[[File:Plate Chestplate.png|32px]] Added the [[Java_Edition_removed_features#Armor_in_Survival_Test|plate chestplate]].
|[[File:Chainmail Chestplate JE1.png|32px]] Added the model and the texture for the unused [[Java_Edition_removed_features#Armor_in_Survival Test|chain chestplate]].
|[[File:Zombie full set.png|32px]] [[File:Skeleton helmet.png|26px]] The plate chestplate has been tested on [[zombie]]s and [[skeleton]]s. It had no effect on gameplay.}}
{{History|java indev}}
{{History||0.31|snap=20091223-1|Plate and chain armor chestplates are no longer used.}}
{{History|||snap=20091231-2|[[File:Leather Tunic (item) JE1 BE1.png|32px]] [[File:Studded Chestplate (item) JE1.png|32px]] [[File:Chainmail Chestplate (item) JE1 BE1.png|32px]] [[File:Iron Chestplate (item) JE1 BE1.png|32px]] Added the single item form of relation to leather, [[History of textures/Unused textures#Studded armor|studded]], chainmail, and plate (iron) chestplates.
|The textures of the cloth chestplate are taken from one of [[Notch]]'s previous games, ''[[Legend of the Chambered]]''. The rest are from ''[[Legend of the Chambered 2]]''.}}
{{History||20100206|[[File:Golden Chestplate (item) JE1 BE1.png|32px]] [[File:Diamond Chestplate (item) JE1 BE1.png|32px]] Added the item form of golden and diamond chestplates.
|Removed the leather-chain chestplate.}}
{{History||February 9, 2010|link=wordofnotch:380486636|[[File:Notch revealed armor.png|32px]] [[Notch]] revealed new models for armor - including chestplates.}}
{{History||20100212-1|Added armor models.
|[[File:Indev 20100212 armor.png|50px]] Armor models are now displayed on the [[player]] in the [[inventory]].}}
{{History||20100218|[[File:Leather Tunic JE1 BE1.png|32px]] [[File:Chainmail Chestplate JE2 BE1.png|32px]] [[File:Iron Chestplate JE1 BE1.png|32px]] [[File:Golden Chestplate JE1 BE1.png|32px]] [[File:Diamond Chestplate JE1 BE1.png|32px]] Added models of cloth, chainmail, iron, gold, and diamond chestplates.
|Chestplates can now be [[crafting|crafted]] and worn.
|Chestplates now functions. All chestplates give {{Armor|8}}. Chestplates have limited [[item durability|durability]], with lower tier chestplates less durable than higher tier chestplates.}}
{{History|java alpha}}
{{History||v1.0.8|With the introduction of [[leather]], "Cloth Chestplate" has been renamed to "Leather Tunic".
|Leather tunics is now [[crafting|crafted]] with leather instead of [[wool|cloth]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|The armor protection behavior has been changed. Previous to this update, the total armor protection is based in this equation: ((''total equipped armor damage reduction'' − 1) × (''all equipped armor max damage'' − ''total equipped armor damage'')) ÷ (''total equipped armor max damage'' + 1)). Armor no longer reduces certain damage types to be covered by enchantments.}}
{{History|||snap=October 3, 2011|slink={{tweet|notch|120859830339637249}}|The first images of a [[player]] wearing enchanted chestplates are revealed.}}
{{History|||snap=Beta 1.9 Prerelease 3|Iron chestplates can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=Beta 1.9 Prerelease 4|Chestplates can now be [[enchanting|enchanted]].}}
{{History||1.1|snap=12w01a|Iron chestplates can now be found in the new blacksmith [[chest]]s in [[village]]s.}}
{{History||1.3.1|snap=12w15a|{{key|Shift}}+clicking can now be used to wear chestplates.}}
{{History|||snap=12w21a|Chainmail chestplates can now be obtained legitimately in [[survival]] mode through [[trading]].
|Blacksmith [[villager]]s now [[trading|sell]] chainmail chestplates for 11–14 emeralds.
|Blacksmith villagers now sell diamond chestplates for 16–18 emeralds.
|Blacksmith villagers now sell iron chestplates for 10–13 emeralds.
|Butchers now sell leather tunics for 4 emeralds.}}
{{History||1.4.2|snap=12w32a|[[Mob]] armor has been reintroduced. A partial or full set of any armor is now sometimes worn by [[zombie]]s, [[skeleton]]s and [[zombified piglins|zombie pigmen]], with the likelihood increasing with difficulty.}}
{{History|||snap=August 17, 2012|slink={{tweet|Dinnerbone|236445090929844225}}|[[Jeb]] and [[Dinnerbone]] tweeted pictures of [[dye]]able leather chestplates.}}
{{History|||snap=12w34a|Leather tunics can now be dyed by [[crafting]] a leather tunic piece with [[dye]]s. Dyes can be removed by {{control|use|text=using}} dyed leather tunics on a [[cauldron]] with [[water]].
|[[File:Leather Tunic JE2.png|32px]] [[File:Leather Tunic (item) JE2.png|32px]] Default leather tunic textures are now slightly darker and have buttons.}}
{{History|||snap=12w34b|[[File:Leather Tunic JE3 BE2.png|32px]] [[File:Leather Tunic (item) JE3 BE2.png|32px]] [[File:Diamond Chestplate JE2.png|32px]] The texture of leather and diamond chestplates has been changed. Leather tunics now have longer sleeves. Diamond chestplates now have notches under the shoulders.}}
{{History|||snap=12w36a|[[Dye]]d leather tunics are now more saturated and have a slight tint of tan in respect to the default armor color.}}
{{History|||snap=12w37a|[[File:Leather Cap JE3 BE2.png|32px]] [[File:Leather Boots JE2 BE2.png|32px]] [[File:Leather Cap (item) JE3 BE2.png|32px]] [[File:Leather Boots (item) JE3 BE2.png|32px]] Leather armor now have non-dyed parts on cap, pants and boots. This has been implemented so that [[player]]s can distinguish between other types of armor and similarly colored leather armor.}}
{{History||1.4.6|snap=12w50a|The [[Thorns]] enchantment can now be [[enchanting|enchanted]] on chestplates.}}
{{History||1.5|snap=13w04a|Armor in the [[player]]'s hand can now be equipped by right-clicking.
|[[Dispenser]]s can now equip nearby players with armor.}}
{{History||1.6.1|snap=13w18a|Golden chestplates are now found in the new [[chest]]s in [[nether fortress]]es.}}
{{History||1.7.2|snap=13w36a|Leather [[boots]] can now be obtained as one of the "junk" items by [[fishing]].}}
{{History||1.8|snap=14w02a|[[Trading|Trades]] changed: armorer [[villager]]s now [[trading|sell]] chain boots for 5–7 [[emerald]]s, chain [[leggings]] for 9–11 emeralds, chain chestplates for 11–15 emeralds and chain helmets for 5–7 emeralds.
|Armorer villagers now sell enchanted diamond chestplates for 16–19 emeralds, and no longer sell other diamond armor.
|Armorer villagers now sell iron chestplates for 10–14 emeralds and iron helmets for 4–6 emeralds, and no longer sell other iron armor.
|Leatherworkers now sell enchanted leather tunics for 7–12 emeralds, and no longer sell other leather armor.}}
{{History|||snap=14w05a|Armor no longer turns red when [[mob]]s and [[player]]s are hurt.}}
{{History|||snap=14w06a|Armor is now visible on [[giant]]s.}}
{{History|||snap=14w25a|Chain armor [[Java Edition removed features#Chainmail armor|cannot be crafted anymore]] due to the [[item]] form of [[fire]] being [[Java Edition removed features#Obtainable until 1.8|removed]].}}
{{History||1.9|snap=15w31a|Enchanted iron and diamond armor can now be found in [[end city]] ship [[chest]]s.
|[[Mob]]s now wear armor from the bottom to the top, rather than from the top to the bottom. This means that a mob with three armor pieces, for example, spawn with all armor except a helmet.}}
{{History|||snap=15w34b|Armor [[item durability|durability]] now affects armor value.}}
{{History|||snap=15w36a|Armor and armor [[enchanting|enchantment]] calculations have been changed. For the original values, see [[Armor/Before 1.9|here]].}}
{{History|||snap=15w36d|Armor durability affecting value has been removed.
|Armor now has an attribute controlling the defense points.}}
{{History|||snap=15w43a|The average yield of gold chestplates in [[nether fortress]] [[chest]]s has been decreased.}}
{{History|||snap=15w50a|Added <code>equip</code> [[sound]]s for all types of armor.}}
{{History|||snap=16w02a|Armor and armor enchantment calculations have been changed again.}}
{{History|||snap=16w05a|Armor calculations have been changed, once again.}}
{{History||1.11|snap=16w39a|Diamond and chainmail chestplates are now found in the new [[woodland mansion]] chests.}}
{{History||1.11.1|snap=16w50a|Golden, chain and iron armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 298 through 317.}}
{{History|||snap=18w09a|Leather tunics now have a chance of generating in [[underwater ruins]].}}
{{History|||snap=18w10a|Leather tunics can now generate in [[buried treasure]] [[chest]]s.}}
{{History|||snap=18w11a|Enchanted leather tunics can now generate in the chests of [[shipwreck]]s.}}
{{History|||snap=18w20a|Chain armor pieces have been renamed to "chainmail".}}
{{History||1.14|snap=18w43a|[[File:Leather Tunic JE4 BE2.png|32px]] [[File:Chainmail Chestplate JE3 BE2.png|32px]] [[File:Iron Chestplate JE2 BE2.png|32px]] [[File:Golden Chestplate JE2 BE2.png|32px]] [[File:Diamond Chestplate JE3 BE2.png|32px]] [[File:Leather Tunic (item) JE4 BE3.png|32px]] [[File:Chainmail Chestplate (item) JE2 BE2.png|32px]] [[File:Iron Chestplate (item) JE2 BE2.png|32px]] [[File:Golden Chestplate (item) JE2 BE2.png|32px]] [[File:Diamond Chestplate (item) JE2 BE2.png|32px]] The textures of all types of armor have been changed.}}
{{History|||snap=18w48a|Leather tunics can now be found in [[chest]]s in [[village]] tanneries.}}
{{History|||snap=18w50a|Iron chestplates can now be found on [[armor stand]]s in [[taiga]] villages.}}
{{History|||snap=19w08a|[[File:Golden Chestplate (item) JE3 BE3.png|32px]] The textures of gold chestplate [[item]] have been changed.}}
{{History|||snap=19w11a|Leatherworker villagers now sell randomly [[dye]]d leather tunics, instead of enchanted leather tunics.}}
{{History|||snap=19w13a|Armorer villagers now give chainmail chestplates to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Chestplate JE1.png|32px]] [[File:Netherite Chestplate (item) JE1.png|32px]] Added netherite chestplate.}}
{{History|||snap=20w10a|[[File:Netherite Chestplate JE2 BE1.png|32px]] [[File:Netherite Chestplate (item) JE2 BE1.png|32px]] The texture of netherite chestplate have been changed.
|Netherite chestplate can no longer be [[crafting|crafted]].
|Netherite chestplate is now obtained by combining one diamond armor piece and one netherite ingot in a [[smithing table]].}}
{{History|||snap=20w16a|All parts of golden and netherite chestplates now generate randomly [[enchanting|enchanted]], and sometimes [[damage]]d, in [[bastion remnant]] and [[ruined portal]] chests.}}
{{History|||snap=20w17a|Diamonds chestplates now generates in place of netherite armor in bastion remnant [[chest]]s.}}
{{History||1.17|snap=20w48a|Wearing any piece of leather armor now prevents [[Powder Snow#Freezing|freezing]] entirely.}}
{{History||1.18.2|snap=22w03a|Netherite chestplate knockback resistance is no longer random.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Non-leather chestplates can now be trimmed using a [[smithing table]].
|There are 10 types of material that determine the color of the trim:
*Iron
*Copper
*Gold
*Lapis
*Emerald
*Diamond
*Netherite
*Redstone
*Amethyst
*Quartz
|Upgrading diamond chestplate to netherite chestplate now requires the netherite upgrade [[smithing template]].}}
{{History|||snap=23w05a|Leather tunics can now be trimmed using a smithing table.|Chestplates can now have trims of the same material it is made out of.|The texture of the dune armor trim has been tweaked, so that the symbol on the chestplate is moved up a few pixels.}}
{{History|||snap=23w06a|Swapped {{cd|iron}} and {{cd|iron_darker}} palette, then made {{cd|iron_darker}} darker overall.|Added a darkest pixel to {{cd|chestplate_trim}} trim item texture.}}
{{History||1.19.4|snap=23w05a|Chestplates can now be swapped by {{ctrl|using}} them/elytra in the hotbar.<ref>{{bug|MC-216270|||Fixed}}</ref>}}
{{History||?|Chestplates can now be swapped in [[armor stand]]s by {{ctrl|using}} them/elytra in the armor stand's slot.}}
{{History||1.20|snap=23w12a|The pattern textures of dune and sentry armor trims are changed.|
Those previous patterns were left with different names: dune was renamed sentry and sentry was renamed shaper.}}

{{History|pocket alpha}}
{{History||v0.6.0|[[File:Leather Tunic JE1 BE1.png|32px]] [[File:Chainmail Chestplate JE2 BE1.png|32px]] [[File:Iron Chestplate JE1 BE1.png|32px]] [[File:Golden Chestplate JE1 BE1.png|32px]] [[File:Diamond Chestplate JE1 BE1.png|32px]] [[File:Leather Tunic (item) JE1 BE1.png|32px]] [[File:Chainmail Chestplate (item) JE1 BE1.png|32px]] [[File:Iron Chestplate (item) JE1 BE1.png|32px]] [[File:Golden Chestplate (item) JE1 BE1.png|32px]] [[File:Diamond Chestplate (item) JE1 BE1.png|32px]] Added chestplates.}}
{{History||v0.8.0|snap=build 2|[[File:Leather Tunic (item) JE3 BE2.png|32px]] The leather armor sprites have been changed to that of {{el|je}}, but its armor [[model]] remains that of older versions.}}
{{History||v0.9.0|snap=build 1|Iron armor now naturally generates in [[village]] [[chest]]s and a [[stronghold]] altar chest.}}
{{History||v0.11.0|snap=build 11|Armor now protects against [[damage]] from [[mob]]s only.}}
{{History||v0.12.1|snap=build 1|Armor can now be worn by mobs.
|Golden chestplates can now be found in [[nether fortress]] [[chest]]s.
|Chainmail armor can now be obtained in [[survival]] mode from a mob wearing it.}}
{{History||?|Armor no longer turns red when [[mob]]s and [[player]]s are hurt.}}
{{History||v0.14.0|snap=build 1|[[File:Leather Tunic JE3 BE2.png|32px]] The textures of leather chestplate have been changed.
|Leather armor can now be dyed.}}
{{History||v0.15.0|snap=build 1|Armor can now be obtained from [[stray]]s and [[husk]]s that naturally spawn with armor.}}
{{History||v0.15.10|[[Cape]]s no longer clip through armor.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron armor and enchanted diamond armor can now be found inside [[chest]]s within [[end city]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Iron [[helmet]]s, iron chestplates, enchanted diamond chestplates and chainmail armor are now [[trading|sold]] by armorer smith [[villager]]s via [[trading]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Golden, chain and iron armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.
|Diamond chestplates and chainmail chestplates can now be found inside [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Chainmail chestplates now generate in [[buried treasure]] chests.
|Enchanted leather armor can now be found inside [[shipwreck]] supply room [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Leather chestplates can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Leather Tunic JE4 BE2.png|32px]] [[File:Chainmail Chestplate JE3 BE2.png|32px]] [[File:Iron Chestplate JE2 BE2.png|32px]] [[File:Golden Chestplate JE2 BE2.png|32px]] [[File:Diamond Chestplate JE3 BE2.png|32px]] [[File:Leather Tunic (item) JE4 BE3.png|32px]] [[File:Chainmail Chestplate (item) JE2 BE2.png|32px]] [[File:Iron Chestplate (item) JE2 BE2.png|32px]] [[File:Golden Chestplate (item) JE2 BE2.png|32px]] [[File:Diamond Chestplate (item) JE2 BE2.png|32px]] The textures of all types of chestplates have been changed.
|Iron armor now can be found in plains [[village]] weaponsmith [[chest]]s.
|Leather armor can now be found inside plains village tannery chests.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron armor now can be found in [[savanna]], [[taiga]], [[desert]], [[snowy taiga]] and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.
|Leather armor can now be found inside savanna, taiga, desert, snowy taiga and snowy tundra village tannery chests.}}
{{History|||snap=beta 1.11.0.4|[[Pillager]]s and [[vindicator]]s that spawn in [[raid]]s can now drop iron armor.}}
{{History||1.11.0|snap=beta 1.11.0.5|[[File:Golden Chestplate (item) JE3 BE3.png|32px]] The textures of gold chestplate [[item]] have been changed.}}
{{History||1.12.0|snap=beta 1.12.0.2|[[File:Armor Stand with Leather Armor MCPE-44669.png|32px]] Leather armor no longer show as being [[dye]]d properly when worn by [[armor stand]]s.}}
{{History||1.13.0|snap=beta 1.13.0.1|Leather armor now appears dyed properly when worn by armor stands.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Chestplate JE2 BE1.png|32px]] [[File:Netherite Chestplate (item) JE2 BE1.png|32px]] Added netherite chestplate.
|Armor can now be obtained from [[piglin]]s that naturally spawn with golden armor.}}
{{History|||snap=beta 1.16.0.57|All parts of golden and netherite armor now generate randomly [[enchanting|enchanted]], and sometimes [[damage]]d, in [[bastion remnant]] chests.
|Netherite armor can no longer be [[crafting|crafted]].
|Netherite armor is now obtained by combining one diamond armor piece and one netherite ingot in a [[smithing table]].}}
{{History|||snap=beta 1.16.0.63|Diamonds armor now generates in place of netherite armor in bastion remnant [[chest]]s.}}
{{History|||snap=beta 1.16.200.53|Netherite Armor now gives a 90% reduction in Knockback.}}
{{History||1.16.210|snap=beta 1.16.210.53|Wearing any piece of leather armor now prevents [[Powder Snow#Freezing|freezing]] entirely.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Leather Tunic JE1 BE1.png|32px]] [[File:Chainmail Chestplate JE2 BE1.png|32px]] [[File:Iron Chestplate JE1 BE1.png|32px]] [[File:Golden Chestplate JE1 BE1.png|32px]] [[File:Diamond Chestplate JE1 BE1.png|32px]] [[File:Leather Tunic (item) JE1 BE1.png|32px]] [[File:Chainmail Chestplate (item) JE1 BE1.png|32px]] [[File:Iron Chestplate (item) JE1 BE1.png|32px]] [[File:Golden Chestplate (item) JE1 BE1.png|32px]] [[File:Diamond Chestplate (item) JE1 BE1.png|32px]] Added chestplates.
|Added a quick equip for armor to the [[inventory]] interface.}}
{{History||xbox=TU12|ps=1.03|[[File:Leather Tunic JE3 BE2.png|32px]] [[File:Leather Tunic (item) JE3 BE2.png|32px]] The textures for leather chestplate have been changed.}}
{{History||xbox=TU14|ps=1.05|Leather armor can now be [[dye]]d.
|[[Item repair]] can now repair armor.}}
{{History||xbox=TU25|xbone=CU13|ps=1.16|Armor now have the quick equip functionality.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Golden, chain and iron armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History|PS4}}
{{History||1.90|[[File:Chainmail Chestplate (item) JE2 BE2.png|32px]] [[File:Iron Chestplate (item) JE2 BE2.png|32px]] [[File:Golden Chestplate (item) JE2 BE2.png|32px]] [[File:Diamond Chestplate (item) JE2 BE2.png|32px]] The textures of all types of chestplate items have been changed (except for the leather one).}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Leather Tunic JE1 BE1.png|32px]] [[File:Chainmail Chestplate JE2 BE1.png|32px]] [[File:Iron Chestplate JE1 BE1.png|32px]] [[File:Golden Chestplate JE1 BE1.png|32px]] [[File:Diamond Chestplate JE1 BE1.png|32px]] [[File:Leather Tunic (item) JE3 BE2.png|32px]] [[File:Chainmail Chestplate (item) JE1 BE1.png|32px]] [[File:Iron Chestplate (item) JE1 BE1.png|32px]] [[File:Golden Chestplate (item) JE1 BE1.png|32px]] [[File:Diamond Chestplate (item) JE1 BE1.png|32px]] Added chestplates.}}
{{History|foot}}

; Armor durability from Indev until late Beta
{| class="wikitable" data-description="Armor Durability during Indev until late Beta" style="text-align:center;"
|-
!scope="col" | Material
!scope="col" | Helmet
!scope="col" | Chestplate
!scope="col" | Leggings
!scope="col" | Boots
|-
|scope="row" | '''Leather'''
| 33
| 48
| 45
| 39
|-
|scope="row" | '''Golden'''
| 66
| 96
| 90
| 78
|-
|scope="row" | '''Chainmail'''
| 66
| 96
| 90
| 78
|-
|scope="row" | '''Iron'''
| 132
| 192
| 180
| 156
|-
|scope="row" | '''Diamond'''
| 264
| 384
| 360
| 312
|}

== Issues ==
{{issue list}}

== Trivia ==
* Chestplates do not render on the player's arm in first person view.<ref>{{bug|MC-25512}}</ref><ref>{{bug|MCPE-30000}}</ref>

== Gallery ==

=== Enchanted Chestplates ===
<gallery>
File:Enchanted Leather Tunic (item).gif
File:Enchanted Chainmail Chestplate (item).gif
File:Enchanted Iron Chestplate (item).gif
File:Enchanted Golden Chestplate (item).gif
File:Enchanted Diamond Chestplate (item).gif
File:Enchanted Netherite Chestplate (item).gif
</gallery>
<gallery>
File:Enchanted Leather Chestplate.gif
File:Enchanted Chainmail Chestplate.gif
File:Enchanted Iron Chestplate.gif
File:Enchanted Golden Chestplate.gif
File:Enchanted Diamond Chestplate.gif
File:Enchanted Netherite Chestplate.gif
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--chestplate Taking Inventory: Chestplate] – Minecraft.net on August 4, 2021

{{Items}}

[[Category:Armor]]

[[ja:チェストプレート]]
[[ko:흉갑]]
[[pt:Peitoral]]
[[pl:Napierśnik]]
[[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>[[Emerald|Emerald]]<br/>{{About|the item|the currency in ''Minecraft Dungeons''|MCD:Emerald|the skin|MCD:Emerald (skin)|the ore|Emerald Ore|the mineral block|Block of Emerald}}
{{Item
| image = Emerald.png
| renewable =  Yes
| stackable = Yes (64)
| rarity = Common}}
'''Emeralds''' are rare minerals that are used primarily as the currency for [[trading]] with [[villager]]s and [[wandering trader]]s. Naturally-occurring emeralds are rarer than [[diamond]]s.

== Obtaining ==

=== Trading ===
{{main|Trading}}
Emeralds can be obtained by trading with [[villager]]s, since they are the currency that villagers use for trading. Villagers either buy or sell specific goods for emeralds.

=== Mining ===
[[Emerald ore]] drops one emerald when mined using an iron or better [[pickaxe]]. If the pickaxe is enchanted with [[Fortune]], it may drop an extra emerald per level of Fortune, up to a maximum of 4 emeralds with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops itself in ore form instead of an emerald.

=== Crafting ===

{{Crafting
|Block of Emerald
|Output= Emerald,9
|type= Material
}}

=== Smelting ===

{{Smelting
|Emerald Ore; Deepslate Emerald Ore
|Emerald
|1
}}

=== Natural generation ===
{{see also|Emerald Ore#Natural generation}}

Emeralds can generate in [[chest]]s in some [[village]] houses or other generated [[Generated structures|structures]].

{{needs update|inaccurate=1|section=1}}
{{LootChestItem|emerald}}

=== Drops ===
[[Vindicator]]s and [[evoker]]s drop 0–1 emeralds upon death. [[Looting]] increases the maximum emerald drop by one per level, for a maximum of 4 emeralds with Looting III.

[[Fox]]es that are holding emeralds also have a chance of 100% to drop the emerald they are holding upon death. Alternatively, the player can drop a food item to entice the fox to drop the emerald without killing it.

{{IN|bedrock}}, vindicators and [[pillager]]s spawned from [[raids]] can drop 0–1 emeralds. Depending on difficulty, vindicators and pillagers spawned from raids also have a chance of dropping additional emeralds. There is a 65% chance of dropping on easy and normal, and an 80% chance of dropping on hard. If this additional drop condition is met, different emerald counts can drop with different chances. There is a {{frac|10|39}} chance to drop an additional 0–1 emeralds, a {{frac|5|39}} chance to drop an additional 2–3, and a {{frac|2|39}} chance to drop an additional 4–5.

{{IN|bedrock}}, with Looting III, it is possible for a vindicator in a raid to drop up to 16 emeralds upon death (vindicator drops + raid drops + an additional drop<!-- emerald from 2/39 chance-->).

== Usage ==

=== Trading ===

{{main|Trading}}

Emeralds are primarily used as currency for [[trading]] with villagers and wandering traders. Trading is typically a faster way to obtain emeralds than by mining, as an emerald ore is rarer than a diamond ore.

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

===Beacons===

Emeralds can be used to select powers from a [[beacon]]. The player must select one of the available powers and then insert an emerald into the item slot. 

An emerald can be substituted for an [[iron ingot]], a [[gold ingot]], a [[diamond]] or a [[netherite ingot]] in a beacon.

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Emerald
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Emerald
|Emerald Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.
|tail=1
}}

;Trim color palette
The following color palette is shown on the designs on trimmed armor:
*{{TrimPalette|emerald}}

== Achievements ==

{{load achievements|The Haggler;Buy Low;Master Trader}}

== Advancements ==
{{load advancements|What a Deal!}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Emerald
|spritetype=item
|nameid=emerald
|itemtags=beacon_payment_items
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Emerald
|spritetype=item
|nameid=emerald
|id=512
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100129|Added [[diamond]]s, referred to as emeralds in the code.}}
{{History|java}}
{{History||May 21, 2012|link={{tweet|jeb_|204619936616808451}}|[[File:Ruby pJE20120521.png|32px]] [[Jens Bergensten|Jeb]] released a screenshot of himself testing the [[trading]] system. At this time, what would become emeralds were [[History_of_textures/Unused_textures#Ruby|rubies]].<ref>http://www.minecraftforum.net/topic/1621716-15-new-blocksitems/#entry19977082</ref>}}
{{History||1.3.1|snap=12w21a|[[File:Emerald JE1 BE1.png|32px]] Added emeralds and [[emerald ore]].
|Emeralds can be [[trading|traded]] with [[villager]]s in exchange for different [[item]]s.
|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing emeralds.
|[[File:Ruby JE1 BE1.png|32px]] The texture of [[History_of_textures/Unused_textures#Ruby|rubies]] can be found in the (at this time unused) file {{cd|items.png}}.<ref name="en_US 12w21">Snapshot 12w21a/b ''lang/en_US.lang'': '''item.ruby.name=Ruby'''</ref>}}
{{History|||snap=12w22a|[[Block of emerald]] has now been added, which is [[crafting|crafted]] from nine emeralds and can be placed as a decorative [[block]].
|Added [[jungle temple]]s, which contain loot [[chest]]s with emeralds.}}
{{History||1.4.2|snap=12w32a|As [[zombie villager]]s can now spawn and be cured, emeralds can now still be obtained in [[trading|trades]] even if [[generated structures]] are disabled.}}
{{history||1.9|snap=15w31a|Emeralds now generate in [[end city]] ship [[chest]]s.}}
{{history|||snap=15w43a|Emeralds now generate in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of emeralds in [[desert temple]] chests has now been increased.}}
{{History||1.11|snap=16w39a|Added [[vindicator]]s and [[evoker]]s, which drop emeralds if killed by a player.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 388.}}
{{History|||snap=18w09a|Emeralds can now generate in the loot [[chest]]s of [[underwater ruins]].}}
{{History|||snap=18w10a|Emeralds can now generate in [[buried treasure]] chests.}}
{{History|||snap=18w11a|Emeralds can now generate in the chests of [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.
|Added [[pillager]]s, which can [[drops|drop]] emeralds.}}
{{History|||snap=18w46a|Pillagers no longer drop emeralds.}}
{{History|||snap=18w48a|Emeralds now generate in chests in [[village]] tanneries, fisher cottages and plains village houses.}}
{{History|||snap=18w49a|Emeralds now generate in chests in [[village]] shepherd houses, mason houses, butcher shops, and savanna and snowy village houses.}}
{{History|||snap=18w50a|Emeralds now generate in chests in [[village]] fletcher houses, temples, and desert and taiga village houses.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with emeralds in their mouths.}}
{{History|||snap=19w08a|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again and it looks smaller.}}
{{History||1.17|snap=21w13a|The unused [[History_of_textures/Unused_textures#Ruby|rubies]] texture was removed.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Emeralds can now be used as an armor trim material.}}
{{History|||snap=23w07a|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}}
{{History||1.20|snap=23w12a|The probability for the emerald to generate in the [[suspicious sand]] in [[desert temple]] and in [[desert well]] has been changed from 1/7 to 1/8.|Emerald can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Emerald 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]]; emerald now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.9.0|snap=build 1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|||snap=build 5|Emeralds can now be used to craft [[blocks of emerald]].}}
{{History||v0.13.0|snap=build 1|Emeralds can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.15.0|snap=build 1|Added [[jungle temple]]s, which contain loot chests with emeralds.}}
{{History||v0.16.0|snap=build 1|Emeralds can now be used to power [[beacon]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Emeralds can now be found in [[end city]] ship [[chest]]s.
|Emeralds can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Emeralds are now used as "currency" for [[villager]] [[trading]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Added [[evoker]]s and [[vindicator]]s, which [[drops|drop]] emeralds when killed.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Emeralds can now be found in some [[shipwreck]] [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Emeralds can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Emeralds can now be used to [[trading|buy]] items from [[wandering trader]]s.
|Emeralds can now be found in [[plains]] [[village]] house and tannery [[chest]]s.
|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Emeralds can now be found in [[village]] [[chest]]s other than [[plains]].}}
{{History|||snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn from [[raid]]s can now [[drops|drop]] bonus emeralds.}}
{{History|||snap=beta 1.11.0.5|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can [[drops|drop]] emeralds.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}}
{{History|||snap=beta 1.19.80.21|Emeralds can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|Ps4}}
{{History||1.90|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}}

{{History|new3DS}}
{{History||0.1.0|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==

<gallery>
Villager trading preview.png|The first image of the trading system released by [[Jeb]]. What would become emeralds can be seen in the [[inventory]] space.
Emerald Ore 12w21a.png|A wall of [[emerald ore]] utilizing a previous texture in snapshot [[12w21a]].
Room of Emeralds.png|All forms of emeralds in one photo: emerald (in the form of [[emerald block|block]], [[emerald ore|ore]] and the emerald itself).
</gallery>

==Trivia==

*The [[History_of_textures/Unused_textures#Ruby|ruby]] was going to be the [[villager]] currency but was changed to emeralds before the update's release.

== References ==

{{Reflist}}

{{Items}}

[[Category:Renewable resources]]

[[cs:Smaragd]]
[[de:Smaragd]]
[[es:Esmeralda]]
[[fr:Émeraude]]
[[hu:Smaragd]]
[[it:Smeraldo]]
[[ja:エメラルド]]
[[ko:에메랄드]]
[[nl:Smaragd]]
[[pl:Szmaragd]]
[[pt:Esmeralda]]
[[ru:Изумруд]]
[[th:มรกต]]
[[tr:Zümrüt]]
[[uk:Смарагд]]
[[zh:绿宝石]]</li><li>[[Raw Cod|Raw Cod]]<br/>{{about|the item|the mob|Cod}}
{{redirect|Raw Fish|raw salmon|Raw Salmon|pufferfish|Pufferfish (item)|tropical fish/clownfish|Tropical fish (item)}}
{{Item
| image = Raw Cod.png
| renewable = Yes
| heals = {{hunger|2}}
| stackable = Yes (64)
}}

'''Raw cod''' is a [[food]] item that can be eaten by the player or cooked to make [[cooked cod]].

== Obtaining ==

=== Mob loot ===

==== Cod ====
[[Cod]] always drops 1 raw cod 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 cod]] instead.

==== Dolphins ====
When killed, [[Dolphin|dolphins]] drop 0–1 raw cod. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 0-4 with Looting III. If killed while on fire, they drop cooked cod instead.

==== Guardians and elder guardians ====

[[Guardian]]s and [[elder guardian]]s have a 40% and 50% chance, respectively, to drop raw cod when killed. {{IN|java}}, cooked cod is dropped if a guardian is on fire when killed.

Guardians and elder guardians also have a 2.5% chance to drop a random fish, with 60% of them being raw cod, 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 75% chance of dropping 0–2 raw cod 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 cod instead.

=== Fishing ===
{{main|Fishing}}

Raw cod can be obtained from fishing. The wait time of one being caught is decreased with the [[Lure]] enchantment and the chance of one being caught is slightly decreased with the [[Luck of the Sea]] enchantment (named as such because it increases treasure, not fish).

Catching cod awards 1-6 experience.

=== Natural generation ===
{{el|java}}{{LootChestItem|raw-cod}}

=== Villager gifts ===
{{in|java}}, fisherman [[villager]]<nowiki/>s throw raw cod at [[player]]s under the [[Hero of the Village]] effect.

== Usage ==

=== Smelting ingredient ===

{{smelting
|Raw Cod
|Cooked Cod
|0.35
}}

=== Food ===

Raw cod restores {{hunger|2}} [[hunger]] and 0.4 [[Hunger#Mechanics|saturation]].

=== Cats ===

Raw cod can be used to tame [[cat]]s with {{frac|1|3}} chance of success, get cats off of [[chest]]s, and [[bed]]s, [[breed]] cats, and make baby cats grow up faster by 10% of the remaining time. Additionally, raw cod can be used to heal cats by {{hp|2|mob=1}}.

Raw cod can be used to gain [[ocelot]] trust, breed ocelots, and make baby ocelots grow up by 10%. 

=== Dolphins ===

[[Dolphin]]s can be fed raw cod. Doing this improves their trust and interaction with the player. However, unlike most animals, feeding dolphins does not allow them to breed.

When a player feeds raw cod to a dolphin, it swims toward the nearest chest in an [[underwater ruins]] or [[shipwreck]]. If the chest in the nearest structure is broken, they swim to the next nearest structure that has a chest.

===Trading===

Fisherman villagers have 50% chance to sell 6 cooked cod for 6 raw cod and 1 [[emerald]] as part of their first tier trade.

Apprentice-level fisherman villagers have a {{frac|2|3}} chance to buy 15 raw cod for an emerald in Java Edition, and always offer the same trade in Bedrock Edition.

=== Wolves ===
{{IN|bedrock}}, raw cod can be used to feed [[wolves]], to heal them by {{hp|2|mob=1}}. However, unlike other meat items, raw cod cannot be used to speed up the growth of baby wolves nor used to breed them, thus making it only feedable when wolves are not at full health.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Cod
|spritetype=item
|nameid=cod
|aliasid=fish
|id=264
|form=item
|translationkey=item.fish.name
|foot=1}}

== Achievements ==

{{load achievements|Delicious Fish;Lion Tamer;Echolocation}}

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

== History ==
{{History|java alpha}}
{{History||v1.2.0|snap=<nowiki>?|slink=:Category:Information needed requiring unarchived version|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish, which restores {{hp|2}}.}}
{{History|java beta}}
{{History||1.5|Cooking raw fish now gives the '''Delicious Fish''' [[achievement]].}}
{{History||1.8|snap=Pre-release|Raw fish is now stackable to 64 and fills {{hunger|2}} instead of {{hp|2}}.}}
{{History|java}}
{{History||1.2.1|snap=12w04a|Raw fish can now be fed to [[ocelot]]s to tame them into cats.}}
{{History||1.8|snap=14w02a|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|||snap=14w25a|Raw fish is now obtainable as a rare [[drops|drop]] from [[guardian]]s and [[elder guardian]]s.}}
{{History||1.10|snap=16w20a|Raw fish is now dropped from [[polar bear]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>fish</code> and <code>cooked_fish</code> IDs have been split up into their own IDs.
|"Raw Fish" has been renamed to "Raw Cod".
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 349.}}
{{History|||snap=18w07a|Raw cod is now used to breed [[turtle]]s.}}
{{History|||snap=18w07b|Raw cod is no longer used to [[breeding|breed]] turtles. [[Seagrass]] is used instead.}}
{{History|||snap=18w08b|Cod, and other [[fish]], have been added as [[mob]]s, which drop their (raw) item form when killed.
|[[File:Raw Cod JE2 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w15a|Raw cod can now be used to feed [[dolphin]]s.
|Raw cod can now be obtained as a [[drops|drop]] from [[dolphin]]s.}}
{{History||1.14|snap=18w43a|[[File:Raw Cod JE3.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=18w47b|[[File:Raw Cod JE4 BE2.png|32px]] The previous texture change to raw cod has been reverted.}}
{{History|||snap=18w48a|Raw cod can now be found in chests in [[village]] fisher cottages.}}
{{History|||snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] raw cod.}}
{{History|||snap=19w13a|Fisherman villagers now give raw cod to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||v0.12.1|snap=build 1|Raw fish now restore [[hunger]] instead of [[health]].
|Raw fish can now be used to feed [[ocelot]]s to tame them into [[cat]]s.}}
{{History||v0.16.0|snap=build 1|Raw fish is now [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Added [[polar bear]]s, which [[drops|drop]] raw fish.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Fisherman [[villager]]s now [[trading|sell]] 6 cooked fish for 1 [[emerald]] plus 6 raw fish.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|[[Cod]] and other [[fish]] have been added as [[mob]]s, which [[drops|drop]] their (raw) [[item]] form when killed.
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}
{{History|||snap=beta 1.2.20.2|Raw cod is now [[drops|dropped]] by [[dolphin]]s and can be used to feed them.}}
{{History||1.5.0|snap=beta 1.5.0.0|Giving raw cod to [[dolphin]]s lead the [[player]] to the nearest [[underwater ruins]] or [[shipwreck]].}}
{{History||1.7.0|snap=beta 1.7.0.2|"Raw Fish" has been renamed to "Raw Cod".}}
{{History||1.8.0|snap=beta 1.8.0.8|Raw cod can no longer can be used to tame [[ocelot]]s.
|Raw cod can now be used to [[breeding|breed]] ocelots and increase baby ocelot growth speed.
|Added [[stray cat]]s, which can be tamed using raw cod.}}
{{History||1.11.0|snap=beta 1.11.0.4|Raw cod can be [[trading|sold]] to fisherman [[villager]]s.
|Fisherman villagers now have 50% chance to [[trading|sell]] 6 cooked cod for 6 raw cod and an [[emerald]] as part of their first tier [[trading|trade]].}} 

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History||xbox=TU5|Raw fish is now stackable to 64.
|Raw fish now fills [[hunger]] instead of [[health]].}}
{{History||xbox=TU12|Raw fish can now be fed to [[ocelot]]s to tame them into [[cat]]s.}}
{{History||xbox=TU13|ps=1.0|Raw fish is no longer removed from the [[player]]'s [[inventory]] when trying to tame an [[ocelot]] in [[creative]] mode.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|"Raw Fish" has been renamed to "Raw Cod".
|[[File:Raw Cod JE4 BE2.png|32px]] The texture of raw cod has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Raw Cod JE1 BE1.png|32px]] Added raw fish.}}
{{History|foot}}

== Issues ==

{{issue list}}
== Trivia ==
[[File:Steve wearing Raw Cod.png|75px]] [[File:Alex wearing Raw Cod.png|75px]]

* While a raw cod cannot be equipped in the head slot in Survival mode, equipping it using the {{cmd|item}} command causes it to appear at the side of the player's head.

== See also ==
* [[Fishing]]

== References ==
{{reflist}}

{{items}}

[[de:Roher Kabeljau]]
[[es:Bacalao crudo]]
[[ja:生鱈]]
[[ko:생대구]]
[[pt:Bacalhau cru]]
[[ru:Сырая треска]]
[[zh:生鳕鱼]]
[[Category:Food]]
[[Category:Renewable resources]]</li></ul></nowiki>
17w16aAdded text component keybind.
1.13
{{Extension DPL}}<ul><li>[[Blaze Rod|Blaze Rod]]<br/>{{Item
| image = Blaze Rod.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Blaze rods''' are [[item]]s exclusively obtained from [[blaze]]s. They act as a fuel for both brewing and [[smelting]], and are required to craft [[eye of ender|eyes of ender]] used to access to [[the End]].

== Obtaining ==

=== Mob loot ===
When killed by a player or tamed [[wolf]], a [[blaze]] has a 50% chance to drop a blaze rod. The [[Looting]] [[enchantment]] can increase the drops by one per level, for a maximum of 4 blaze rods. Blazes do not drop any blaze rods if killed by any other source.

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Fuel ===

When used in a [[furnace]], a blaze rod lasts 120 seconds (12 items).

== Achievements ==
{{load achievements|Into Fire}}

== Advancements ==
{{load advancements|Into Fire}}

== Video ==
{{Video note|This video does not mention the crafting of [[End Rod]]s.|minor}}

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

== Data values ==
=== ID ===
{{el|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Blaze Rod
|spritetype=item
|nameid=blaze_rod
|form=item
|foot=1}}

{{el|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Blaze Rod
|spritetype=item
|nameid=blaze_rod
|id=423
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|[[File:Blaze Rod JE1 BE1.png|32px]] Added blaze rods.}}
{{History|||snap=Beta 1.9 Prerelease 2|Blaze rods are now used to craft [[blaze powder]].}}
{{History|||snap=Beta 1.9 Prerelease 3|Blaze rods are now used to craft [[brewing stand]]s.}}
{{History||1.8|snap=14w07a|Blaze rods are now held similarly to [[tools]].}}
{{History||1.9|snap=15w44b|Blaze rods are now used to craft [[end rod]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 369.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Blaze Rod JE1 BE1.png|32px]] Added blaze rods. 
|Blaze rods can be used to craft [[blaze powder]] and [[brewing stand]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Blaze rods are now used to craft [[end rod]]s.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Blaze Rod JE1 BE1.png|32px]] Added blaze rods.
|Blaze rods can be used to craft [[blaze powder]] and [[brewing stand]]s.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|Blaze rods are now used to craft [[end rod]]s.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Blaze Rod JE1 BE1.png|32px]] Added blaze rods.
|Blaze rods can be used to craft [[blaze powder]] and [[brewing stand]]s.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* As part of an official collaboration, blaze rods are included in a free add-on for the roleplaying game [https://en.wikipedia.org/wiki/Dungeons_%26_Dragons ''Dungeons and Dragons''].<ref>https://www.google.com/url?sa=t&rct=j&q=&esrc=s&source=web&cd=&cad=rja&uact=8&ved=2ahUKEwj9uvqlwIT-AhV7LUQIHYlVDiwQFnoECBAQAQ&url=https%3A%2F%2Fwww.minecraft.net%2Fcontent%2Fdam%2Fgames%2Fminecraft%2Fsoftware%2FMinecraft-Monstrous-Compendium.pdf&usg=AOvVaw0aKOqpKAHSH11qgZhN_Bhx</ref> In the game, they are worth 100 gold pieces, create light, and can be broken to create an explosion.

{{items}}

== References ==
{{Reflist}}

[[Category:Renewable resources]]

[[cs:Ohnivá hůl]]
[[de:Lohenrute]]
[[el:Οι ράβδοι των Blaze]]
[[es:Vara de blaze]]
[[fr:Bâton de Blaze]]
[[hu:Lángrúd]]
[[it:Verga di blaze]]
[[ja:ブレイズロッド]]
[[ko:블레이즈 막대]]
[[lzh:炎靈桿]]
[[nl:Blazestaf]]
[[pl:Płomienna różdżka]]
[[pt:Vara de blaze]]
[[ru:Огненный стержень]]
[[th:แท่งเบลซ]]
[[tr:Alaz Çubuğu]]
[[uk:Стрижень Блейза]]
[[zh:烈焰棒]]</li><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}
'''Sugar cane''' is a block found as 1–4-block-tall. It plants near water in the [[Overworld]]. As an item, it is an important crafting ingredient.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

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

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

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li></ul>
18w01aNow supports the custom names.
18w05aAdded /bossbar, The argument <name> supported by raw JSON text.
1.14
{{Extension DPL}}<ul><li>[[Knowledge Book|Knowledge Book]]<br/>{{exclusive|java}}
{{Item
| image = Knowledge Book.png
| renewable = No
| stackable = No
| rarity = Epic
}}
A '''knowledge book''' is a utility item that reveals available [[crafting]] recipes to the player when {{control|used|use}}.

== Obtaining ==
Knowledge books can be obtained only by using [[commands]], as it is not found in the [[creative]] inventory; therefore, it is impossible to obtain in other modes such as [[survival]] and [[adventure]] except with commands.

For example, to give oneself a knowledge book that reveals the recipes for [[bucket]]s and [[flower pot]]s, use: {{cmd|give @s minecraft:knowledge_book{Recipes:["minecraft:bucket", "minecraft:flower_pot"]} }}.

== Usage ==
Knowledge books are used to reveal recipes to the player who uses it, by adding it to their [[recipe book]]. Using a knowledge book consumes it, removing it from the player's inventory.

Knowledge books are especially useful to mapmakers in conjunction with {{cmd|gamerule doLimitedCrafting true}}, because then any item is craftable only if its recipe is unlocked first.

== Sounds ==
{{Sound table
|sound=Chiseled bookshelf insert1.ogg
|sound2=Chiseled bookshelf insert2.ogg
|sound3=Chiseled bookshelf insert3.ogg
|sound4=Chiseled bookshelf insert4.ogg
|subtitle=Book placed
|source=block
|description=When a knowledge book is placed in a chiseled bookshelf
|id=block.chiseled_bookshelf.insert
|translationkey=subtitles.chiseled_bookshelf.insert
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.85, or 1.1 for each sound</ref>
|distance=16}}
{{Sound table
|sound=Chiseled bookshelf pickup1.ogg
|sound2=Chiseled bookshelf pickup2.ogg
|sound3=Chiseled bookshelf pickup3.ogg
|subtitle=Book taken
|source=block
|description=When a knowledge book is removed from a chiseled bookshelf
|id=block.chiseled_bookshelf.pickup
|translationkey=subtitles.chiseled_bookshelf.take
|volume=0.8
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|distance=16
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Knowledge Book
|spritetype=item
|nameid=knowledge_book
|form=item
|foot=1}}

=== Item data ===
Recipe books use the NBT tag <code>Recipes</code> to indicate the recipes they contain.

''The following NBT structure is provided to show how the <code>Recipes</code> tag is organized, and is not comprehensive above the <code>tag</code> tag. The full NBT for an item can be found [[Chunk format#Items and XP Orbs|here]].''

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound}} Entity data
** {{nbt|compound|Item}}: The item
*** {{nbt|compound|tag}}: Additional information about the item. This tag is optional for most items.
**** {{nbt|list|Recipes}}: The list of recipes this book contains.
***** {{nbt|string}} the name of a recipe, for instance <code>minecraft:gold_nugget</code> or <code>minecraft:gold_ingot_from_nuggets</code>
</div>

== History ==
{{History|java}}
{{History||1.12|snap=17w13a|[[File:Knowledge Book JE1.png|32px]] Added knowledge books.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 453.}}
{{History||1.14|snap=18w43a|[[File:Knowledge Book JE2.png|32px]] The texture of knowledge books has now been changed.}}
{{History||1.20|snap=1.20 Release Candidate 1|Knowledge books can now be placed in [[chiseled bookshelf|chiseled bookshelves]].}}
{{History|Foot}}

== Issues ==
{{Issue list}}

== See also ==
* [[Book]]
* [[Enchanted Book]]
* {{cmd|recipe}} command

{{Items}}

[[Category:Non-renewable resources]]

[[de:Buch des Wissens]]
[[es:Enciclopedia]]
[[fr:Livre des connaissances]]
[[ja:知恵の本]]
[[ko:지식의 책]]
[[lzh:天工開物]]
[[pl:Księga wiedzy]]
[[pt:Enciclopédia]]
[[ru:Книга знаний]]
[[zh:知识之书]]</li><li>[[Potion|Potion]]<br/>{{about|the drinkable potions|the throwable potions|Splash Potion|the throwable potions that leave a lingering area of effect|Lingering Potion}}
{{Redirect|Potion of Water Breathing|the potion in Minecraft Dungeons|MCD:Potion of Water Breathing}}{{About|the mechanics of potions|instructions on how to brew potions, and their recipes|Brewing}}{{update|The texture for ''[[Bedrock Edition]]'' is different, please add it.

Some potions texture/color was changed as of 1.19.4 pre-release 3, please add them.}}
{{Item
| image = Water Bottle.png
| extratext = View [[#Potions|all potions]]
| renewable = '''Uncraftable, Luck{{only|je|short=y}}, Decay{{only|be|short=y}}''': No<br>'''All others''': Yes
| stackable = BE: No<br/>JE: No{{until|Java Combat Tests}}<br>Yes (16){{upcoming|Java Combat Tests}}
}}'''Potions''' are bottled substances designed to inflict [[effects]]. They are created by [[brewing]] and when drunk give the player an [[effect]] for a limited time. All potions are brewed from a '''water bottle''', which is considered a type of potion but has no effects.

== Obtaining ==

=== Mob loot ===

==== Witches ====

[[Witch]]es can drop potions of Healing, Fire Resistance, Swiftness, or Water Breathing if they die while drinking that potion.

==== Wandering traders ====

[[Wandering trader]]s have a chance to drop a Potion of Invisibility if they die while drinking the potion.

=== Fishing ===
[[Water bottle]]s can be [[fishing|fished]] up as junk items.

=== Brewing ===
{{main|Brewing}}

Almost all potions are obtained by [[brewing]].

The Potion of Luck{{only|java|short=1}} and the Potion of Decay{{only|bedrock|short=1}} cannot be brewed. A command to give a Luck Potion is {{cmd|give @s minecraft:potion{Potion:luck} }}, while a Potion of Decay can be obtained via {{cmd|give @s potion 1 36}}. Both are also available in the [[creative inventory]].

=== Chest loot ===

Two Health II potions can be found in the brewing stand on ships in [[end cities]], and one splash potion of Weakness can be found in a brewing stand in [[igloo]] basements.

{{In|Bedrock}}, the cauldron in a [[swamp hut]] contains a random potion.
{{LootChestItem|potion-of-regeneration,potion-of-water-breathing,potion-of-healing}}

=== Bartering ===
[[Piglin]]s may [[barter]] a potion or a splash potion of Fire Resistance when given a [[gold ingot]].

== Usage ==

Potions are used by pressing and holding {{control|use}} with the potion bottle in hand, as with all consumable items. When drunk they bestow the corresponding [[status effect]] to the player.

Drinking a potion while already under the effects of the same potion does not add onto the effect's duration, but simply resets it. A potion effect does not "downgrade" if a lower level is activated. For example, if a [[player]] has [[Regeneration]] II, drinking a regular potion of Regeneration does not have any effect.

Using a potion on a cauldron does not transfer the potion to the cauldron, but begins to play the drinking animation.{{only|java|short=1}}

=== Modifiers ===
{{main|Brewing}}

Potions can be modified in five ways. 
# Brewing [[glowstone dust]] into certain potions will ''enhance'' their level of effect. 
# Adding [[redstone]] will ''extend'' the duration of the effect.
# Brewing [[gunpowder]] into a potion makes it into a ''splash'' potion (area effect).
# Adding [[dragon's breath]] to a splash potion creates a [[lingering potion]] (area effect that lingers on the ground).
# Brewing a [[fermented spider eye]] into specific potions modifies their effect, usually inverting it, which is referred to as "corruption". 

The modifications of Enhancement and Extension are mutually exclusive. 

Enhancing most potions trades some of its duration for a bigger effect. For example, the base Regeneration works for 44 seconds whereas Regeneration II lasts for only 22 seconds but heals more per tick during that time. 

Extending a potion generally makes it last {{frac|8|3}} as long as its base potion, so a duration of 3 minutes becomes 8 minutes. 
==== Corruption ====
The usual result of corruption is to invert the potion's effect (for example Swiftness becomes Slowness). Interestingly, corrupting Poison (continuous damage effect) creates a Potion of Harming, an instant damage effect, instead of the continuous healing effect (regeneration) one would normally expect. Corrupting a Potion of Night Vision turns it into a Potion of Invisibility rather than an inverse effect that might be something like blindness.

Corrupting an extended or enhanced potion results in a corrupted potion with the same modifier, if it is supported by the corrupted effect. All of the "corrupted" potions except Harming can be extended, but it is the only one that can be enhanced. {{IN|bedrock}}, the corruption of Healing II or Poison II potions results in a potion of Harming I.

=== Base potions ===

Base potions are potions that have no effect when the player drinks them, but are necessary as the basis for other potions.

{| class="wikitable col-1-center col3-left" data-description="Base potions"
! Icon
! Name
! Use
|-
| {{Slot|Water Bottle|link=none}}
! Water Bottle
| the base for the Awkward Potion and Potions of Weakness
|-
| rowspan="3"| {{Slot|Water Bottle|link=none}}
! Awkward Potion
| The base for all other effect potions
|-
! Mundane Potion
| Only usable as an alternative base for  Potion of Weakness{{only|bedrock}}
|-
! Thick Potion
| No use
|}

=== Effect potions ===

==== Potions with positive effects ====

{| class="wikitable col-1-center" data-description="Positive potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of Regeneration|link=none}}
! {{text anchor|Potion of Regeneration}}
| 0:45
| rowspan="3" | {{EffectLink|Regeneration}}
| Restores {{hp|18}} health over time, {{hp|1}} every 50 [[tick]]s (2.5 seconds).
|-
! Potion of Regeneration +
| 1:30{{only|java|short=1}}<br>2:00{{only|bedrock|short=1}}
| Restores {{hp|36}}{{only|java|short=1}} or {{hp|48}}{{only|bedrock|short=1}} health over time, {{hp|1}} every 50 ticks (2.5 seconds).
|-
! Potion of Regeneration II
| 0:22.5
| Restores {{hp|18}} health over time, {{hp|1}} every 25 ticks (1.25 seconds).
|-
| rowspan="3" | {{Slot|Potion of Swiftness|link=none}}
! {{text anchor|Potion of Swiftness}}
| 3:00
| rowspan="3" | {{EffectLink|Speed}}
| rowspan="2" | Increases speed and jump distance by 20% and increases FOV (6.6 meters per second sprinting).
|-
! Potion of Swiftness +
| 8:00
|-
! Potion of Swiftness II
| 1:30
| Increases speed and jump distance by 40% and increases FOV (8 meters per second sprinting).
|-
| rowspan="2" | {{Slot|Potion of Fire Resistance|link=none}}
! {{text anchor|Potion of Fire Resistance}}
| 3:00
| rowspan="2" | {{EffectLink|Fire Resistance}}
| rowspan="2" | Gives immunity to all heat-related damage.
|-
! Potion of Fire Resistance +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Healing|link=none}}
! {{text anchor|Potion of Healing}}
| Instant
| rowspan="2" | {{EffectLink|Instant Health}}
| Restores {{hp|4}} health.
|-
! Potion of Healing II
| Instant
| Restores {{hp|8}} health. (doubles with every additional level)
|-
| rowspan="2" | {{Slot|Potion of Night Vision|link=none}}
! {{text anchor|Potion of Night Vision}}
| 3:00
| rowspan="2" | {{EffectLink|Night Vision}}
| rowspan="2" | Visually brightens everything to a light level of 15, brightens up water with a blue shine, brightens up lava with an orange shine (other players cannot see the enhanced lighting without this effect).
|-
! Potion of Night Vision +
| 8:00
|-
| rowspan="3" | {{Slot|Potion of Strength|link=none}}
! {{text anchor|Potion of Strength}}
| 3:00
| rowspan="3" | {{EffectLink|Strength}}
| rowspan="2" | Increases melee damage by {{hp|3}}.{{only|java}}<br>Increases melee damage by 30% of the base damage and {{Hp|1}}.{{only|bedrock}}
|-
! Potion of Strength +
| 8:00
|-
! Potion of Strength II
| 1:30
| Increases melee damage by {{hp|6}} (+ {{hp|3}} per tier).{{only|java}}<br>Increases melee damage by 69% of the base damage and {{Hp|1.3}}. 
For each level: (<math>BaseDamage\times1.3^{level}+{1.3^{level}-1\over0.3}</math>){{only|bedrock}}
|-
| rowspan="3" | {{Slot|Potion of Leaping|link=none}}
! {{text anchor|Potion of Leaping}}
| 3:00
| rowspan="3" | {{EffectLink|Jump Boost}}
| rowspan="2" | Allows the player to jump {{frac|1|2}} blocks higher and reduces fall damage.
|-
!Potion of Leaping +
| 8:00
|-
! Potion of Leaping II
| 1:30
| Further increases jump height to {{frac|2|1|2}} blocks and further reduces fall damage.
|-
| rowspan="2" | {{Slot|Potion of Water Breathing|link=none}}
! style="white-space:nowrap" | {{text anchor|Potion of Water Breathing}}
| 3:00
| rowspan="2" | {{EffectLink|Water Breathing}}
| rowspan="2" | Allows the entity to swim without drowning or needing to surface for air. The oxygen bar does not decrease when underwater.
|-
! Potion of Water Breathing +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Invisibility|link=none}}
! {{text anchor|Potion of Invisibility}}
| 3:00
| rowspan="2" | {{EffectLink|Invisibility}}
| rowspan="2" |
Makes player  disappear from view. Mobs can detect and track the player only at close range, although the range increases when the player wears armor. The splash version make mobs or other players invisible. Some items are unaffected and so remain visible. These include: armor, items held in hand, arrows stuck into the player, a [[pig]]'s saddle, a [[llama]]'s carpet pattern, a [[shulker]]'s yellow head, and the glowing eyes of [[spider]]s, [[Phantom|phantoms]], and [[enderman|endermen]].
|-
! Potion of Invisibility +
| 8:00
|-
| rowspan="2" | {{Slot|Potion of Slow Falling|link=none}}
! {{text anchor|Potion of Slow Falling}}
| 1:30
| rowspan="2" | {{EffectLink|Slow Falling}}
| rowspan="2" | The mob/player falls at a much slower rate, and damage from hitting the ground is reduced to zero. A sprinting  leap of almost 6 blocks becomes possible and farmland is not affected by the player falling onto it.
|-
! Potion of Slow Falling +
| 4:00
|-
| {{Slot|Potion of Luck|link=none}}
! {{text anchor|Potion of Luck}}<br>{{only|java|short=1}}{{only|Console|short=1}}
| 5:00
| {{EffectLink|Luck}}
| Increases the luck [[Attribute#Attributes for players|attribute]] by 1 point.
|}

==== Potions with negative effects ====

{| class="wikitable col-1-center" data-description="Negative potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of Poison|link=none}}
! {{text anchor|Potion of Poison}}
| 0:45
| rowspan="3" | {{EffectLink|Poison}}
| Causes up to {{hp|36|poisoned=1}} damage over time at a rate of 1 every 50 ticks, but does not reduce health below {{hp|1}}.
|-
! Potion of Poison +
| 1:30
| Causes up to {{hp|72|poisoned=1}}{{only|java|short=1}} or {{hp|96|poisoned=1}}{{only|bedrock|short=1}} damage over time, but does not reduce health below {{hp|1}}.
|-
! Potion of Poison II
| 0:21.6{{only|java|short=1}}<br>0:22.5{{only|bedrock|short=1}}
| Causes up to {{hp|38|poisoned=1}} damage over time, but does not reduce health below {{hp|1}}.
|-
| rowspan="2" | {{Slot|Potion of Weakness|link=none}}
! {{text anchor|Potion of Weakness}}
| 1:30
| rowspan="2" | {{EffectLink|Weakness}}
| rowspan="2" | Reduces melee damage by {{hp|4}}.{{only|java}}<br>Reduces melee damage by 20% of the base damage and {{hp|0.5}}.{{only|bedrock}}
|-
! Potion of Weakness +
| 4:00
|-
| rowspan="3" | {{Slot|Potion of Slowness|link=none}}
! {{text anchor|Potion of Slowness}}
| 1:30
| rowspan="3" | {{EffectLink|Slowness}}
| rowspan="2" | Slows players and mobs by 15%, to about 4.75 blocks per second sprinting.
|-
! Potion of Slowness +
| 4:00
|-
! Potion of Slowness IV<!--The IV is correct, it is not Slowness II-->
| 0:20
| Slows players and mobs by 60%, to about 2.25 blocks per second sprinting.
|-
| rowspan="2" |{{Slot|Potion of Harming|link=none}}
! {{text anchor|Potion of Harming}}
| Instant
| rowspan="2" | {{EffectLink|Instant Damage}}
| Damages {{hp|6}}.
|-
! Potion of Harming II
| Instant
| Damages {{hp|12}}. (doubles with every additional level)
|-
| {{Slot|Potion of Decay|link=none}}
! Potion of Decay<br>{{only|bedrock|short=1}}{{Anchor|Potion of Decay}}
| 0:40
| {{EffectLink|Wither|link=Wither (status effect)}}
| Damages {{hp|1|withered=1}} every second, making a total of {{hp|40|withered=1}} damage 
|}

==== Potions with mixed effects ====

{| class="wikitable col-1-center col-2-center" data-description="Base potions"
! Icon
! Name
! Duration
! Effect
! Description
|-
| rowspan="3" | {{Slot|Potion of the Turtle Master|link=none}}
! {{text anchor|Potion of the Turtle Master}}
| style="text-align:center" | 0:20
| rowspan="3" | {{EffectLink|Slowness}}<br>{{EffectLink|Resistance}}
| rowspan="2" | Slows players and mobs by 60%, to about 2.25 blocks per second sprinting, and reduces their damage taken by 60%.
|-
! Potion of the Turtle Master +<br>
| 0:40
|-
! Potion of the Turtle Master II<br>
| 0:20
| Slows players and mobs by 90%, to about 0.5625 blocks per second sprinting, and reduces their damage taken by 80%.
|}

=== Uncraftable potion ===

{{IN|java}}, the Uncraftable Potion is a potion with no effect that is unobtainable in regular gameplay.

It is also available in splash potion and lingering potion forms, as well as for tipped arrows.

It can be obtained using the following command: {{cmd|give @s minecraft:potion{Potion:"minecraft:empty"} }}. It is also obtained any time a potion has invalid or missing potion effect tags, and thus serves as a placeholder.

{| class="wikitable" style="text-align: center;" data-description="Unused potions"
! Icon
! Name
! Effect
|-
| {{Slot|Uncraftable Potion|link=none}}
! Uncraftable Potion
| No effect
|}

=== Joke potions===

====[[Java Edition 15w14a]]====

{| class="wikitable col-1-center col-2-center" data-description="Base potions"
!Icon
!Name
!Duration
!Effect
! Description 
|-
|{{Slot|Potion of Slowness Revision 1|link=none}}
!{{text anchor|Potion of Caring}}
| style="text-align:center" |Instant
|{{EffectLink|id=Slowness Revision 1|Caring}}
| rowspan="3" |Changes the mob AI to move toward the nearest mob as if it were to attack it.
|-
| rowspan="2" |{{Slot|Potion of Poison Revision 1|link=none}}
!{{text anchor|Potion of Caring}}
| style="text-align:center" |Instant
| rowspan="2" | {{EffectLink|id=Poison Revision 1|Caring}} 
|-
! {{text anchor|Potion of Caring II}}
| style="text-align:center" |Instant
|-
| rowspan="2" |{{Slot|Potion of Weakness Revision 1|link=none}}
!{{text anchor|Potion of Sharing}}
| style="text-align:center" |1:30
| rowspan="2" |{{EffectLink|id=Weakness Revision 1|Sharing}}
| rowspan="2" |Drops items in a random amount of time, ranging from food to rare items like [[saddle]]s or [[diamond]]s.
|-
!{{text anchor|Potion of Sharing +}}
| style="text-align:center" |4:00
|}

==== [[Java Edition 23w13a_or_b]]====

{{Empty section}}

===Undead mobs===

The effects given by Potions of Healing and Harming are opposite on undead mobs, which includes skeletons and zombies. Potions of Healing cause harm, and Harming heals them. In addition, undead mobs are not affected by Poison or Regeneration. 

{{IN|bedrock}}, hitting an undead mob with a Regeneration Potion will always register as Regeneration I, no matter the level of the used potion.

===Mud conversion===

Using a water bottle, splash water bottle, or lingering water bottle on [[dirt]], [[coarse dirt]], or [[rooted dirt]] will convert it into [[mud]], returning a glass bottle with it. This process can be automated with a [[dispenser]]. 

===Filling cauldrons with Potions===

{{IN|Bedrock|Legacy Console}} potion bottles may be used on a cauldron to fill it. Using a glass bottle on a cauldron filled with a potion drains it and fills the bottle. Potions cannot be combined in a cauldron, nor can they be mixed with water, but as an added bonus if you use a stack of arrows in a full cauldron you get a stack of tipped arrows. for 1 layer you get 16, 2 layers 32.

==Custom effects==

{{IN|java}}, potions can also be obtained with any status effect using {{cmd|give}} and the tag <code>CustomPotionEffects</code>, which is an array of effects for the potion. See [[Item format#Potion Effects]] for more information, and [[status effect]] for a list of effects and IDs.

==Sounds==
{{edition|java}}:
{{Sound table
|sound=Drink.ogg
|subtitle=Sipping
|source=player
|description=While a player is drinking a potion
|id=entity.generic.drink
|translationkey=subtitles.entity.generic.drink
|volume=0.5
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Witch drink1.ogg
|sound2=Witch drink2.ogg
|sound3=Witch drink3.ogg
|sound4=Witch drink4.ogg
|subtitle=Witch drinks
|source=hostile
|description=When a witch drinks a potion
|id=entity.witch.drink
|translationkey=subtitles.entity.witch.drink
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Wandering trader drink potion.ogg
|sound2=Drink.ogg
|subtitle=Wandering Trader drinks potion
|source=neutral
|description=While a [[wandering trader]] is drinking a potion to become invisible during nighttime
|id=entity.wandering_trader.drink_potion
|translationkey=subtitles.entity.wandering_trader.drink_potion
|volume=''varies'' <ref group=sound>0.35 for the first sound, 0.325 for the second sound</ref>
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|subtitle=Bottle empties
|source=block
|description=When a water bottle is emptied
|id=item.bottle.empty
|translationkey=subtitles.item.bottle.empty
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bottle fill water1.ogg
|sound2=Bottle fill water2.ogg
|sound3=Bottle fill water3.ogg
|sound4=Bottle fill water4.ogg
|subtitle=Bottle fills
|source=block
|description=When a water bottle is filled
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Drink.ogg
|source=player
|description=When a player drinks a potion
|id=random.drink
|volume=0.35
|pitch=0.9-1.1}}
{{Sound table
|sound=Witch drink1.ogg
|sound2=Witch drink2.ogg
|sound3=Witch drink3.ogg
|sound4=Witch drink4.ogg
|source=hostile
|description=When a witch drinks a potion
|id=mob.witch.drink
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Wandering trader drink potion.ogg
|sound2=Drink.ogg
|source=neutral
|description=When a wandering trader drinks a potion to become invisible during nighttime
|id=mob.wanderingtrader.drink_potion
|volume=''varies'' <ref group=sound>0.7 for the first sound, 0.65 for the second sound</ref>
|pitch=0.8-1.2}}
{{Sound table
|rowspan=4
|sound=Water Splash Old.ogg
|source=block
|description=When a potion is placed in a cauldron<wbr><ref group=sound name=potionsplash>{{Bug|MCPE-174867}}</ref>
|id=cauldron.fillpotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a potion is taken from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takepotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When water from a bottle is placed in a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.fillwater
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When water from a bottle is taken from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takewater
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|source=sound<!--bottle-->
|description=When a water bottle or potion is emptied<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.empty
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bottle fill water1.ogg
|sound2=Bottle fill water2.ogg
|sound3=Bottle fill water3.ogg
|sound4=Bottle fill water4.ogg
|source=sound<!--bottle-->
|description=When a water bottle or potion is filled<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.fill
|volume=1.0
|pitch=1.0
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Potion
|spritetype=item
|nameid=potion
|form=item
|translationkey=item.minecraft.potion,item.minecraft.potion.effect.empty,item.minecraft.potion.effect.water,item.minecraft.potion.effect.mundane,item.minecraft.potion.effect.thick,item.minecraft.potion.effect.awkward,item.minecraft.potion.effect.night_vision,item.minecraft.potion.effect.invisibility,item.minecraft.potion.effect.leaping,item.minecraft.potion.effect.fire_resistance,item.minecraft.potion.effect.swiftness,item.minecraft.potion.effect.slowness,item.minecraft.potion.effect.water_breathing,item.minecraft.potion.effect.healing,item.minecraft.potion.effect.harming,item.minecraft.potion.effect.poison,item.minecraft.potion.effect.regeneration,item.minecraft.potion.effect.strength,item.minecraft.potion.effect.weakness,item.minecraft.potion.effect.levitation,item.minecraft.potion.effect.luck,item.minecraft.potion.effect.turtle_master,item.minecraft.potion.effect.slow_falling
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Potion
|spritetype=item
|nameid=potion
|id=426
|form=item
|translationkey=potion.emptyPotion.name,potion.mundane.name,potion.mundane.extended.name,potion.thick.name,potion.awkward.name,potion.nightVision.name,potion.invisibility.name,potion.jump.name,potion.fireResistance.name,potion.moveSpeed.name,potion.moveSlowdown.name,potion.heal.name,potion.harm.name,potion.poison.name,potion.regeneration.name,potion.damageBoost.name,potion.weakness.name,potion.wither.name,potion.turtleMaster.name,potion.slowFalling.name
|foot=1}}

=== Metadata===
{{IN|bedrock}}, potions use the following item data values to indicate the kind of potion:
{{/DV}}

===Item data===

====Java Edition====

<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Potion}}
</div>
Normal potions use an NBT "Potion" tag to indicate the potion type. The values of the tag (to be prefixed with <code>minecraft:</code>) are:
{| class="wikitable sortable" style="text-align: center;" data-description="Potion NBT data"
!Potion
! Regular
!Level II
!Extended + 
|-
| Uncraftable Potion
|anything except the below
|–
|–
|-
|Water Bottle
|{{code|water}} 
|–
|–
|-
|Mundane Potion
|{{code|mundane}}
|–
|–
|-
| Thick Potion
|{{code|thick}}
|–
|–
|-
|Awkward Potion
|{{code|awkward}}
|–
|–
|-
| Night Vision
|{{code|night_vision}}
|–
|{{code|long_night_vision}}
|-
|Invisibility
|{{code|invisibility}}
|–
|{{code|long_invisibility}}
|-
|Leaping
|{{code|leaping}}
|{{code|strong_leaping}}
|{{code|long_leaping}}
|-
|Fire Resistance
|{{code|fire_resistance}}
|–
|{{code|long_fire_resistance}}
|-
|Swiftness
|{{code|swiftness}}
|{{code|strong_swiftness}}
|{{code|long_swiftness}}
|-
|Slowness
|{{code|slowness}}
|{{code|strong_slowness}}
|{{code|long_slowness}}
|-
|Water Breathing
|{{code|water_breathing}}
|–
|{{code|long_water_breathing}}
|-
| Instant Health
|{{code|healing}}
|{{code|strong_healing}}
|–
|-
| Harming
|{{code|harming}}
|{{code|strong_harming}}
|–
|-
|Poison
|{{code|poison}}
|{{code|strong_poison}}
|{{code|long_poison}}
|-
|Regeneration
|{{code|regeneration}}
|{{code|strong_regeneration}}
| {{code|long_regeneration}}
|-
|Strength
|{{code|strength}} 
| {{code|strong_strength}}
|{{code|long_strength}}
|-
|Weakness
|{{code|weakness}}
|–
|{{code|long_weakness}}
|-
|Luck
|{{code|luck}}
|–
|–
|-
|The Turtle Master
|{{code|turtle_master}}
|{{code|strong_turtle_master}}
|{{code|long_turtle_master}}
|-
| Slow Falling
|{{code|slow_falling}}
|–
|{{code|long_slow_falling}}
|}

====Bedrock Edition====

:See [[Bedrock Edition level format/Item format]].

==Achievements==
{{load achievements|Local Brewery|Taste of your own Medicine}}

==Advancements==
{{Load advancements|Local Brewery;A Furious Cocktail;How Did We Get Here?;Husbandry}}

==History==
{{Info needed section|Potion of Weakness;Uncraftable Potion texture in JE 1.11}}
{{History|java beta}}
{{History||July 7, 2010|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/779956568/the-rationale-for-redstone|[[Brewing|Alchemy]] was first hinted by [[Notch]] when he explained why [[redstone ore]] disintegrates into "[[redstone|dust]]". He states that dust would be used later in potions.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[Jeb]] tweeted a screenshot showing potion durations and [[glass bottle]]s.<ref>{{tweet|jeb|118681103350501376|This will probably ->NOT<- be included in Beta 1.9, but it's a nice screenshot: http://i.imgur.com/oK2tE.png |September 28, 2011}}</ref>
|Potions are [[brewing|brewed]] using [[cauldron]]s<ref>{{tweet|jeb|119466949708222465|Potions are delayed because *add to cauldron, pick up, look at tooltip, pour back into cauldron, repeat* was extremely tedious|September 30, 2011}}</ref> by combining ingredients and other potions in cauldrons. Cauldrons, although they are functional and can be used to brew potions, are unavailable in this update.
|In total, there are 161 possible potion combinations and 2,653 different types of potions.<ref>{{tweet|jeb|120520408792432641|In the prerelease, there are 161 brewable unique potions. Unless we change it, there are 2,653 with all ingredients added.|October 3, 2011}}</ref>
|[[Jeb]] later tweeted that both [[Notch]] and he had come up with a different way to [[brewing|brew]] potions, which was revealed to be [[brewing stand]]s.<ref>{{tweet|jeb|119710836469149697|A quick discussion with @notch led me in on a new way of doing the potion brewing. Cauldron is out...|September 30, 2011}}</ref>}}
{{History|||snap=Beta 1.9 Prerelease 3|[[Brewing stand]]s have been implemented, which has replaced the (previously unimplemented) [[cauldron]]s' [[brewing]] functionality, so potions are now obtainable without mods. Potions Brewed in the previous version will now be glitched. Water Bottles have been added.}}
{{History||1.3.1|snap=12w21b|[[File:Water Bottle JE1 BE1.png|32px]] Water bottles have been added to the [[Creative inventory]].}}
{{History||1.3.1|snap=12w22a|[[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Potions have been added to the [[Creative]] [[inventory]]. This includes extended-enhanced potions with both extended duration and enhanced effect for four potion effects.}}
{{History||1.4.2|snap=12w32a|[[File:Potion of Night Vision JE1 BE1.png|32px]] Added potion of [[Night Vision]]. However, it is [[brewing|unbrewable]] at the time.}}
{{History|||snap=12w38a|Added Healing and Harming potions to the Creative inventory.}}
{{History||1.5|snap=?|Extended-enhanced potions are no longer available in the Creative inventory for all four potion effects. {{info needed}}{{verify}}<!--only checked v1.4.7 and v1.5.2, but did not check any version in between, please check all-->}}
{{History|||snap=12w34a|[[File:Potion of Invisibility JE1 BE1.png|32px]] Added potions of [[Invisibility]].
|Potions of Night Vision are now [[brewing|brewable]].}}
{{History|||snap=12w38a|[[Witch]]es now cast potions at [[player]]s and can rarely [[drops|drop]] potions upon [[death]].}}
{{History|||snap=12w39a|Potions are now customizable using NBT editors or MCEdit.}}
{{History||1.6.1|snap=?|Potions of [[Weakness]] now reduce [[damage]] by half hearts, instead of 1 heart as it was before.}}
{{History|||snap=13w23a|Potions of [[Healing]] and [[Regeneration]] have been nerfed (by 33.3% and 50%).}} 
{{History||1.7.2|snap=13w36a|[[File:Potion of Water Breathing JE1 BE1.png|32px]] Added potions of [[Water Breathing]].
|[[Water bottle]]s can now be obtained as one of the "junk" [[item]]s from [[fishing]].}}
{{History||1.8|snap=14w27a|[[File:Potion of Leaping JE1 BE1.png|32px]] Added potions of [[Leaping]].}}
{{History||1.8.1|snap=pre1|Potion of Leaping can now be extended.}}
{{History||1.9|snap=15w31a|Numeric IDs are no longer used for potions. Instead, an NBT "Potion" [[tag]] is used, e.g. {{cmd|give @p minecraft:potion 1 0 {Potion:"minecraft:swiftness"} }}. See [[/Before 1.9|here]] for the old numeric IDs. This means the order of potion effects have changed in the Creative inventory.
|Splash potions now have a separate data value and ID name.
|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Water Bottle JE1 BE1.png|32px]] [[File:Water Bottle JE1 BE1.png|32px]] Added Mundane, Thick and Awkward potions to the [[creative]] [[inventory]].
|Mixed potions' colors now blend.}}
{{History|||snap=15w33a|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].
|The duration of potions of [[Poison]] has been extended, the duration of potions of [[Regeneration]] has been extended, and the duration of potions of [[Poison]] II has been reduced.
|Potion of [[Strength]] has been changed from 130% increase to 3-point increase.
|Potion of [[Weakness]] has been changed to 4-point decrease, was 0.5-point decrease.}}
{{History|||snap=15w44b|[[File:Uncraftable Potion JE1.png|32px]] Added the uncraftable potion.
|[[File:Potion of Luck JE1.png|32px]] Added potions of [[Luck]].}}
{{History||1.11|snap=16w33a|A [[water bottle]] is now able to add 1 water level to a [[cauldron]].}}
{{History|||snap=16w38a|The uncraftable potion is now magenta, has no glint, and is now obtained anytime a potion is specified with invalid or missing potion effect [[tag]]s.
|Due to the [[water bottle]] without tags being changed to the uncraftable potion, the [[brewing]] icon has also been changed to the uncraftable potion in [[creative]] [[inventory]].
|The uncraftable potion has been removed from the [[creative]] [[inventory]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 373.}}
{{History|||snap=18w07a|[[File:Potion of the Turtle Master JE1 BE1.png|32px]] Added potion of the Turtle Master, which gives Slowness IV and Resistance IV for 1 minute.
|Extended potions give both effects for 3 minutes.
|Level 2 potions give level VI of both effects for 1 minute.}}
{{History|||snap=18w14a|[[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Slow Falling]].}}
{{History|||snap=18w16a|Regular and extended potions of the Turtle Master now give only Resistance III.
|Level 2 potions of the Turtle Master now give only Resistance IV. This is because Resistance VI made the player invincible.}}
{{History||1.14|snap=18w43a|[[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Luck JE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] [[File:Water Bottle JE2 BE2.png|32px]] [[File:Uncraftable Potion JE2.png|32px]]<br>[[File:Potion of Night Vision.gif|32px]] [[File:Potion of Invisibility.gif|32px]] [[File:Potion of Leaping.gif|32px]] [[File:Potion of Fire Resistance.gif|32px]] [[File:Potion of Swiftness.gif|32px]] [[File:Potion of Slowness.gif|32px]] [[File:Potion of the Turtle Master.gif|32px]] [[File:Potion of Water Breathing.gif|32px]] [[File:Potion of Healing.gif|32px]] [[File:Potion of Harming.gif|32px]] [[File:Potion of Poison.gif|32px]] [[File:Potion of Regeneration.gif|32px]] [[File:Potion of Strength.gif|32px]] [[File:Potion of Weakness.gif|32px]] [[File:Potion of Luck.gif|32px]] [[File:Potion of Slow Falling.gif|32px]] The textures of potions have been changed.}}
{{History|||snap=19w06a|[[Wandering trader]]s now drink [[Invisibility]] potions at [[night]] and [[milk bucket]]s at dawn.}}
{{History||1.16|snap=20w09a|[[Fire resistance]] potions can now be obtained through [[bartering]].}}
{{History||1.16.2|snap=20w28a|Water bottles can now be obtained through [[bartering]].|Potions and splash potions of Fire Resistance now have a {{frac|8|459}} (~1.74%) chance of being offered by [[piglin]]s when bartering.}}
{{History||1.18|snap=21w39a|Potions of Water Breathing can now generate in [[buried treasure]] chests.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Potions of Healing now generate in [[ancient city]] chests.}}
{{History|||snap=22w11a|Water bottles can now be used on [[dirt]], [[coarse dirt]], or [[rooted dirt]] to turn it into [[mud]].}}
{{History|||snap=22w13a|Potions of Healing no longer generate in [[ancient city]] [[chest]]s.|Potions of Regeneration may now be found in [[ancient city]] [[chest]]s.}}
{{History||1.19.4|snap=Pre-release 1|Potions no longer have an enchantment glint.}}
{{History|||snap=Pre-release 3|[[File:Potion of Night Vision JE3.png|32px]] [[File:Potion of Invisibility JE3.png|32px]] [[File:Potion of Leaping JE3.png|32px]] [[File:Potion of Fire Resistance JE3.png|32px]] [[File:Potion of Swiftness JE3.png|32px]] [[File:Potion of Slowness JE3.png|32px]] [[File:Potion of the Turtle Master JE3.png|32px]] [[File:Potion of Water Breathing JE3.png|32px]] [[File:Potion of Harming JE3.png|32px]] [[File:Potion of Poison JE3.png|32px]] [[File:Potion of Strength JE3.png|32px]] Changed colors of the following potions (all forms): Night Vision, Invisibility, Leaping, Fire Resistance, Swiftness, Slowness, Turtle Master, Water Breathing, Harming, Poison, Strength, Resistance.}}
{{History||1.20|snap=23w12a|Wither [[effect]] particle colors have been adjusted to make them more distinguishable.
|The potion of [[Slow Falling]] has had its color tweaked to make it more distinguishable from the potion of [[Invisibility]].}}
{{History|java upcoming}}
{{History||Combat Tests|snap=Combat Test 7c|Potions with the same tags can now stack to 16.}}
{{History|||snap=Combat Test 8b|Potions (and liquid food) can now be drank faster (20 ticks, was 32 ticks).}}
{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|[[Wandering trader]]s now have a chance to [[trading|buy]] a water bottle or sell a potion of Invisibility.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] [[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Water Breathing JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.
|Water bottles, mundane, long mundane, thick, and awkward potions are all available in the Creative inventory.}}
{{History||v0.13.0|snap=build 1|Potions of [[Leaping]] are now obtainable in [[survival]].}}
{{History||v0.14.0|snap=build 1|Potions can now be used to fill 1/3 layer of [[cauldron]], filling cauldron with different [[liquids|liquid]] empties the cauldron.
|Using a [[glass bottle]] to a [[cauldron]] filled by a potion now fills the glass bottle with that potion.
|[[Swamp hut]]s now generate [[cauldron]]s filled with a random potion, making potions now obtainable in [[survival]] without [[brewing]].
|Potions of [[Healing]], [[Fire Resistance]], [[Water Breathing]] and [[Swiftness]] can now be obtained by killing [[witch]]es while they're drinking potions.}}
{{History||v0.16.0|snap=build 4|[[File:Potion of Decay BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]].}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|2 Potions of [[Healing]] II can now be found in a [[brewing stand]] inside [[end ship]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Potions of [[Water Breathing]] and potions of [[Regeneration]] can now be found inside [[buried treasure]] chests.}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Potion of the Turtle Master JE1 BE1.png|32px]] Added potions of the Turtle Master.}}
{{History||1.6.0|snap=beta 1.6.0.5|[[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Slow Falling]].}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Water Bottle JE2 BE2.png|32px]] [[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Decay BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] The textures of potions have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.3|Potions of [[Invisibility]] can now be obtained by killing [[wandering trader]]s while they're drinking potions.}}
{{History||1.16.0|snap=beta 1.15.0.51|Added potions of [[Slowness]] IV, which can be brewed from potions of Slowness using glowstone dust.}}
{{History|||snap=beta 1.16.0.57|[[Fire resistance]] potions can now be obtained through [[bartering]].}}
{{History||1.16.100|snap=beta 1.16.100.54|Water Bottles can now be obtained through [[bartering]].|Potions and splash potions of Fire Resistance now have a {{frac|8|459}} (~1.74%) chance of being offered by [[piglin]]s when bartering.}}
{{History||1.19.80|snap=beta 1.19.80.21|Changed potion colors for the following potions: Fire Resistance, Harming, Invisibility, Leaping, Night Vision, Poison, Slowness, Strength, Swiftness, Turtle Master, and Water Breathing.
|Removed enchantment glint from splash potions.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.}}
{{History||xbox=TU8|Added the awkward potion to the [[Creative]] menu.}}
{{History||xbox=TU14|ps=1.04|[[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] Added potions of [[Night Vision]] and potions of [[Invisibility]].
|Awkward potion is no longer obtainable from the [[Creative inventory]].
|Extended-enhanced potions are now listed individually for four potion effects.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Water Breathing JE1 BE1.png|32px]] Added potions of [[Jump Boost|Leaping]] and potions of [[Water Breathing]]. These are both available in four variants unlike ''Java'' and ''Bedrock'' where the latter group only added two variants of water breathing and three variants for leaping.}}
{{History||xbox=TU34|xbone=CU22|ps=1.25|wiiu=Patch 4|Removed two of the four types of water breathing potions and splash potions.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|[[File:Potion of Luck JE1.png|32px]] Added potions of [[Luck]].
|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].
|Removed all types of extended-enhanced potions for all five potion effects.
|Potions effects are now arranged more like ''Java Edition''.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|[[File:Potion of Decay BE1.png|32px]] [[File:Potion of the Turtle Master JE1 BE1.png|32px]] [[File:Potion of Slow Falling JE1 BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]], Turtle Master, and [[Slow Falling]].}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|Awkward potion is once again obtainable from the Creative inventory.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Water Bottle JE2 BE2.png|32px]] [[File:Potion of Night Vision JE2 BE2.png|32px]] [[File:Potion of Invisibility JE2 BE2.png|32px]] [[File:Potion of Leaping JE2 BE2.png|32px]] [[File:Potion of Fire Resistance JE2 BE2.png|32px]] [[File:Potion of Swiftness JE2 BE2.png|32px]] [[File:Potion of Slowness JE2 BE2.png|32px]] [[File:Potion of Water Breathing JE2 BE2.png|32px]] [[File:Potion of Healing JE2 BE2.png|32px]] [[File:Potion of Harming JE2 BE2.png|32px]] [[File:Potion of Poison JE2 BE2.png|32px]] [[File:Potion of Regeneration JE2 BE2.png|32px]] [[File:Potion of Strength JE2 BE2.png|32px]] [[File:Potion of Weakness JE2 BE2.png|32px]] [[File:Potion of Luck JE2.png|32px]] [[File:Potion of Decay BE2.png|32px]] [[File:Potion of the Turtle Master JE2 BE2.png|32px]] [[File:Potion of Slow Falling JE2 BE2.png|32px]] The textures of potions have been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Water Bottle JE1 BE1.png|32px]] [[File:Potion of Night Vision JE1 BE1.png|32px]] [[File:Potion of Invisibility JE1 BE1.png|32px]] [[File:Potion of Leaping JE1 BE1.png|32px]] [[File:Potion of Fire Resistance JE1 BE1.png|32px]] [[File:Potion of Swiftness JE1 BE1.png|32px]] [[File:Potion of Slowness JE1 BE1.png|32px]] [[File:Potion of Healing JE1 BE1.png|32px]] [[File:Potion of Harming JE1 BE1.png|32px]] [[File:Potion of Poison JE1 BE1.png|32px]] [[File:Potion of Regeneration JE1 BE1.png|32px]] [[File:Potion of Strength JE1 BE1.png|32px]] [[File:Potion of Weakness JE1 BE1.png|32px]] Added potions.
|Water bottles, mundane, thick, and awkward potions are all available in the Creative inventory.}}
{{History||1.3.12|[[File:Potion of Decay BE1.png|32px]] Added potions of [[Wither (status effect)|Decay]].}}
{{History||1.7.10|Added [[lingering potion]]s, which are [[brewing|brewed]] with [[splash potion]]s and [[dragon breath]] after splash potions are brewed with potions and [[gunpowder]].}}
{{History|foot}}

<gallery>
Health_Potion.png|Thick Potion with status effects of Mining Fatigue (duration 4:00) and Instant Health II (duration 4:00).
Invisible_sheep.png|An invisible sheep. Its wool can still be seen.
New Potion Colors.png|The new potion colors.
</gallery>

==Issues==
{{issue list}}

==Trivia==
*A potion can reach a maximum tier of 127, but using the {{cmd|effect}} [[commands|command]], effect levels can reach 255.
*When a player drinks two potions by quickly switching to another potion immediately after drinking one, the second drinking animation is not shown.{{verify|type=current|Still in recent versions?}} 
*A potion of [[Poison]] II lasts for 22.5 seconds, but it is displayed as 22 seconds because the [[item]] hover display shows rounded-down integer values.
*The "Local Brewery" [[advancement]] uses the Uncraftable Potion texture for its icon.

==Unused potions ==
''[[Bedrock Edition]]'' has [[History of textures/Unused textures#Unused potions|unused potion textures]] for several [[effect]]s, along with their [[Splash Potion#Unused splash potions|splash variants]]. These effects are: [[Absorption]], [[Blindness]], [[Haste]], [[Health Boost]], [[Hunger]], [[Mining Fatigue]], [[Nausea]], [[Resistance]], [[Saturation]], and [[Levitation]], as well as the [[Luck]] potion textures also present in [[Java Edition]]. These unused textures were added along with the other potion textures in [[Pocket Edition v0.12.1 alpha]], except for the potion of levitation, which was added in [[Pocket Edition 1.0.0]]. The textures were changed along with the other potion textures during the [[texture update]] in [[Bedrock Edition 1.10.0]]. Strangely, the potion of levitation texture is a duplicate of the splash potion of levitation texture.
<gallery>
Potion of Absorption BE2.png|Potion of Absorption
Potion of Blindness BE2.png|Potion of Blindness
Potion of Haste BE2.png|Potion of Haste
Potion of Health Boost BE2.png|Potion of Health Boost
Potion of Hunger BE2.png|Potion of Hunger
Potion of Mining Fatigue BE2.png|Potion of Mining Fatigue
Potion of Nausea BE2.png|Potion of Nausea
Potion of Resistance BE2.png|Potion of Resistance
Potion of Saturation BE2.png|Potion of Saturation
Potion of Levitation BE2.png|Potion of Levitation
</gallery>

==Gallery==
===Potions===
;Java Edition
<gallery>
Water Bottle.png|Water Bottle
Potion of Night Vision.png|Potion of Night Vision
Potion of Invisibility.png|Potion of Invisibility
Potion of Leaping.png|Potion of Leaping
Potion of Fire Resistance.png|Potion of Fire Resistance
Potion of Swiftness.png|Potion of Swiftness
Potion of Slowness.png|Potion of Slowness
Potion of the Turtle Master.png|Potion of the Turtle Master
Potion of Water Breathing.png|Potion of Water Breathing
Potion of Healing.png|Potion of Healing
Potion of Harming.png|Potion of Harming
Potion of Poison.png|Potion of Poison
Potion of Regeneration.png|Potion of Regeneration
Potion of Strength.png|Potion of Strength
Potion of Weakness.png|Potion of Weakness
Potion of Slow Falling.png|Potion of Slow Falling
Potion of Luck.png|Potion of Luck
Potion of Decay.png|Potion of Decay
Uncraftable Potion.png|Uncraftable Potion
</gallery>

===Screenshots===
<gallery>
OK2tE.png|Potion effects showing up in [[inventory]].
PotionBubbles.png|The bubbles emitted when a player drinks a potion.
Nightvision.png|The effect of night vision (left image is with night vision, right image is without).
NetherPotionEffect.png|The view when a player uses night vision in the Nether.
PotionTable.png|A brewing stand with a potion displayed next to it.
MinecraftPotionsClean.png|A guide to brewing before [[Java Edition 1.6.1|1.6]].
</gallery>

=== In other media===
<gallery>
File:Elixir (MCSM).png|The [[Minecraft Story Mode:Elixir|Elixir]], a unique potion featured in [[Minecraft Story Mode]].
File:Witch Potion (Dungeons).png|A potion thrown by a [[MCD:Witch|witch]], as depicted in [[Minecraft Dungeons]].
File:Strength Potion.png|A [[MCD:Strength Potion|strength potion]], as it appears in Minecraft Dungeons.
File:Swiftness Potion.png|A [[MCD:Swiftness Potion|Swiftness Potion]], as depicted in Minecraft Dungeons.
File:Potion of Water Breathing (MCD).png|A [[MCD:Potion of Water Breathing|Potion of Water Breathing]], as it appears in Minecraft Dungeons.
File:Bottle Lamp.jpg|An officially licensed bottle LED desk lamp.
File:Potion Bottle Bottle.jpg|A water bottle depicting many potions.
</gallery>

==See also==
*{{ItemLink|Glass Bottle}}
*{{ItemLink|Medicine}}
*{{ItemLink|Splash Potion}}
*{{ItemLink|Lingering Potion}}

==Notes==
<references group="note" />

==References==
{{reflist}}

==External links==
*[https://www.minecraft.net/en-us/article/taking-inventory--potion Taking Inventory: Potion] – Minecraft.net on May 11, 2022
*[http://potioncraft.net Minecraft Potions - A Visual Guide] (version 1.9)

{{items}}
{{effects}}

[[Category:Food]]

[[de:Trank]]
[[es:Poción]]
[[fr:Potion]]
[[hu:Bájital]]
[[it:Pozione]]
[[ja:ポーション]]
[[ko:물약]]
[[nl:Dranken]]
[[pl:Mikstury]]
[[pt:Poção]]
[[ru:Зелья]]
[[uk:Зілля]]
[[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>[[Bleach|Bleach]]<br/>{{education feature}}
{{Item
| image = Bleach.png
| renewable = No
| stackable = Yes (64)
}}

'''Bleach''' is an [[item]] used to [[dye]] things white. It is a [[compound]], as it is made using a [[lab table]].

== Obtaining ==
=== Lab Table ===

Bleach is not obtainable in the [[creative inventory]] or {{cmd|give}}. The only way to obtain it is using a [[lab table]].

{| class="wikitable"
! Result
! Materials Needed
|-
!rowspan=2|{{slot|Bleach}}<br>[[Bleach]]
|{{slot|Water (compound)|link=Compound}}{{slot|Water (compound)|link=Compound}}{{slot|Water (compound)|link=Compound}}{{slot|Sodium Hypochlorite|link=Compound}}{{slot|Sodium Hypochlorite|link=Compound}}{{slot|Sodium Hypochlorite|link=Compound}}
|-
|<center>[[Water (compound)|Water]] x3, [[Compound|Sodium Hypochlorite]] x3</center>
|}

== Usage ==
=== Crafting ingredient ===

{{crafting usage}}

== Sounds ==
{{Sound table
|type=bedrock
|sound=Fire.ogg
|source=sound
|description=When bleach is created by a lab table
|id=lt.reaction.fire
|volume=6.0
|pitch=0.7/0.9
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bleach
|spritetype=item
|nameid=bleach
|id=596
|form=item
|foot=1}}

== History ==
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:Bleach BE1.png|32px]] Added bleach.}}

{{History|education}}
{{History||1.0.27|[[File:Bleach BE1.png|32px]] Added bleach.}}
{{History|foot}}

== Trivia ==
*[[File:Bleach (compound).png|32px]] There is an [[History of textures/Unused textures#Unused compounds|unused bleach texture]] in the compounds folder of the chemistry resource pack, which is slightly different from the one used in the game.

== Issues ==

{{issue list}}

{{Items}}
{{Education Edition}}

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

[[de:Bleichmittel]]
[[es:Lejía]]
[[ja:漂白剤]]
[[ko:표백제]]
[[pl:Wybielacz]]
[[pt:Alvejante]]
[[zh:漂白剂]]
[[lzh:素精]]</li><li>[[Magenta Dye|Magenta Dye]]<br/>{{Item
| image = Magenta Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Magenta dye''' is a [[Dye#Quasi-Primary|quasi-primary color dye]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showdescription=1
  |showname=0
  |Allium
  |Output=Magenta Dye
  |type=Material
}}
{{Crafting
  |Lilac
  |Output=Magenta Dye,2
  |type=Material
}}
{{Crafting
  |Purple Dye
  |Pink Dye
  |Output=Magenta Dye,2
  |type=Material
}}
{{Crafting
  |Blue Dye
  |Red Dye
  |Pink Dye
  |Output=Magenta Dye,3
  |type=Material
}}
{{Crafting
  |Lapis Lazuli
  |Red Dye
  |Pink Dye
  |Output=Magenta Dye,3
  |type=Material
  |description={{only|bedrock|education}}
}}
{{Crafting
  |Blue Dye
  |Red Dye
  |Red Dye
  |White Dye
  |Output=Magenta Dye,4
  |type=Material
}}
{{Crafting
  |Lapis Lazuli;Lapis Lazuli;Blue Dye
  |Red Dye;Red Dye;Red Dye
  |Red Dye;Red Dye;Red Dye
  |Bone Meal;White Dye;Bone Meal
  |Output=Magenta Dye,4
  |type=Material
  |description={{only|bedrock|education}}
  |foot=1
}}

=== Trading ===

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

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Magenta Dye
|spritetype=item
|nameid=magenta_dye
|aliasid=dye / 13
|id=408
|form=item
|translationkey=item.dye.magenta.name
|foot=1}}

== Video ==
{{yt|IkaIFDQJNUU}}

== History ==

{{History|java beta}}
{{History||1.2|[[File:Magenta Dye JE1 BE1.png|32px]] Added magenta 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|Magenta 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||1.7.2|snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added [[shulker box]]es, which can be dyed.}}
{{History||1.12|snap=17w15a|Added 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|Magenta dye is now crafted using [[blue dye]] and [[white dye]], instead of [[lapis lazuli]] and [[bone meal]].
|[[File:Magenta Dye JE2 BE2.png|32px]] The texture of magenta dye has now been changed.}}
{{History|||snap=18w44a|Magenta dye can now change the text color on [[sign]]s to magenta.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells magenta dye.}}
{{History|||snap=19w11a|Magenta dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Magenta dye can now be used to craft [[magenta candle]]s.}}
{{History|||snap=21w19a|Magenta dye can no longer be used to craft magenta candles.}}
{{History|||snap=Pre-release 1|Magenta dye can now once again be used to craft magenta candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Magenta dye can now change the text color on [[hanging sign]]s to magenta.}}

{{History|pocket alpha}}
{{History||v0.3.0|[[File:Magenta Dye JE1 BE1.png|32px]] Added magenta dye. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Magenta dye is now craftable with one [[lapis lazuli]], two [[rose red]]s, and one [[bone meal]].
|Magenta dye can now be used to craft magenta wool.}}
{{History||v0.6.0|Magenta dye can now be used to dye [[sheep]].}}
{{History||v0.8.0|snap=build 1|Magenta dye can now additionally be crafted with one [[purple dye]] and one [[pink dye]], or with one [[lapis lazuli]], one [[rose red]], and one pink dye.}}
{{History||v0.9.0|snap=build 11|Magenta dye can now be used to craft colored [[terracotta]].}}
{{History||v0.11.0|snap=build 1|Magenta dye can now be used to dye tamed [[wolf]] collars.}}
{{History||v0.14.0|snap=build 1|Magenta dye can now be used to dye [[water]] in [[cauldron]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Magenta dye can now be used to dye [[shulker]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Magenta 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|Magenta 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|Magenta dye can now be used to craft [[balloon]]s and [[glow stick]]s.}}
{{History||1.8.0|snap=beta 1.8.0.8|Magenta dye can now be used to dye tamed [[cat]] collars.}}
{{History||1.10.0|snap=beta 1.10.0.3|Magenta dye is now [[trading|sold]] by [[wandering trader]]s.
|Magenta dye can now be used to dye white [[carpet]]s and regular [[glass pane]]s.
|[[File:Magenta Dye JE2 BE2.png|32px]] The texture of magenta dye has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Magenta dye can now be [[trading|sold]] to shepherd [[villager]]s.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of magenta dye has been changed from <code>dye/13</code> to <code>magenta_dye</code>.}}

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

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

== Issues ==
{{issue list}}

== References ==
{{reflist}}

{{Items}}

[[Category:Dyes]]

[[cs:Purpurové barvivo]]
[[de:Magenta Farbstoff]]
[[es:Tinte magenta]]
[[fr:Teinture magenta]]
[[hu:Bíborvörös festék]]
[[ja:赤紫色の染料]]
[[ko:자홍색 염료]]
[[nl:Magenta kleurstof]]
[[pl:Karmazynowy barwnik]]
[[pt:Corante magenta]]
[[ru:Сиреневый краситель]]
[[zh:品红色染料]]
[[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>[[Item Frame|Item Frame]]<br/>{{redirect|Frame}}
{{ItemEntity
| group = Item Frame
| 1-1 = Item Frame.png
| 1-2 = Item Frame (item).png
| group2 = Glow Item Frame
| 2-1 = Glow Item Frame.png
| 2-2 = Glow Item Frame (item).png
| extratext = [[#Renders|View all renders]]
| renewable = Yes
| stackable = Yes (64)
| drops = {{ItemLink|Item Frame}} (1)<br> 
or
{{ItemLink|Glow Item Frame}} (1)<br>{{EnvSprite|items}} The item it contains.
}}

An '''item frame''' is an [[entity]]{{only|java|short=y}} or [[block entity]]{{only|bedrock|short=y}} that displays the item or block that is inside it.

A '''glow item frame''' keeps itself and the item inside it illuminated, even in the dark.

== Obtaining ==

=== Breaking ===

{{IN|je}}, an empty item frame can be broken simply by punching it. If the item frame contains an item, punching it drops the item, leaving the frame on the wall.

Because item frames are [[entities]] {{in|java}}, they can be broken in [[Adventure]] mode. They will also be targeted by commands using the @e selector.{{only|java}}

=== Natural generation ===

An item frame containing a pair of [[elytra]] generates in each [[end ship]].
[[File:BoatElytra.png|thumb|An item frame naturally generating in an end ship.]]

=== Crafting ===
{{Crafting
|head=1
|A1= Stick |B1= Stick   |C1= Stick
|A2= Stick |B2= Leather |C2= Stick
|A3= Stick |B3= Stick   |C3= Stick
|Output= Item Frame
|type= Decoration block
}}
{{Crafting
|foot=1
|Glow Ink Sac
|Item Frame
|Output= Glow Item Frame
|type= Decoration block
}}

=== Trading ===
Expert-level [[Trading#Cartographer|cartographer]] [[villager]]s have a chance to sell an item frame for 7 [[emerald]]s.

== Usage ==

=== Item display ===

[[File:Item Frame (map filled partial).png|thumb|150px|Item frame with partially filled map]]
Item frames can be placed on the sides of [[cactus]] blocks, [[pressure plate]]s, [[fence]]s, [[tree]]s, [[slab]]s, [[cobblestone wall]]s, [[chest]]s, [[door]]s, and all [[solid block]]s. They can also be placed on the top and bottom of these blocks. To place on chests and doors, the player needs to be [[sneaking]]. As item frames are an entity, multiple item frames can occupy the same block, although on different faces. It also allows non-solid blocks to occupy the same space.{{only|java}}

Players can place items in the frame by {{control|using}} the item. If a [[map]] is placed in an item frame, it enlarges to show the map in the size of a full block, with the item frame's location displayed as a green pointer on the map, pointing in the direction the item frame is facing. If this is done in the Nether, the green cursor spins around similar to the white cursor (players). If an item in an item frame has been renamed using an [[anvil]], it displays its custom name when the cursor is over the item frame. If the player places a block inside the frame, it is displayed in miniature half in, half out of the block. This can be most notably seen on stairs or slabs.

{{control|Pick block}} may be used on item frames by players in creative mode only, the control has no effect for players in Survival or Adventure mode. When the item frame is displaying an item, {{control|pick block}} picks the displayed item instead of the item frame.

Item frames can be placed on the lid of a [[shulker box]] that is positioned horizontally, but pop off when the lid is opened.{{only|java}}

=== Rotation ===
The displayed item can then be rotated by right-clicking the frame. Items displayed in the item frame can turn 45° diagonally, with a total of 8 possibilities (90° and 4 possibilities if it is a map), and the frame outputs a [[Mechanics/Redstone/Circuit#Power level|redstone signal]] depending on the rotation phase that can be interpreted by a [[redstone comparator]] (note that this rotation value is separate from the clock or compass rotation). As long as the frame remains placed, it remembers the orientation of the last item it held, and uses it for the next item it holds.{{only|java}}

=== Glow item frames ===
[[File:Item Frames Comparison.png|thumb|260px|Comparison between ordinary item frame and glow item frame in the dark.]]

When an item is placed inside a glow item frame, it appears to glow, even though it does not emit any [[light level]].

== Sounds ==
Item frames and glow item frames share the same sounds.
=== Generic ===
{{Edition|Bedrock}}:<!--Item frames are blocks in BE, so they get the generic section.-->
{{Sound table/Block/Item frame/BE}}
=== Unique ===
{{Edition|Java}}:
{{Sound table
|rowspan=2
|sound=Item Frame add item1.ogg
|sound2=Item Frame add item2.ogg
|soumd3=Item Frame add item3.ogg
|sound4=Item Frame add item4.ogg
|subtitle=Item Frame fills
|source=neutral
|description=When an item is placed in an item frame
|id=entity.item_frame.add_item
|translationkey=subtitles.entity.item_frame.add_item
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Glow Item Frame fills
|source=neutral
|description=When an item is placed in a glow item frame
|id=entity.glow_item_frame.add_item
|translationkey=subtitles.entity.glow_item_frame.add_item
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Item Frame break1.ogg
|sound2=Item Frame break2.ogg
|sound3=Item Frame break3.ogg
|subtitle=Item Frame breaks<ref group=sound name=breaks>{{bug|MC-194948}}</ref>
|source=neutral
|description=When an item frame is broken or pops off
|id=entity.item_frame.break
|translationkey=subtitles.entity.item_frame.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Glow Item Frame breaks<ref group=sound name=breaks/>
|source=neutral
|description=When a glow item frame is broken or pops off
|id=entity.glow_item_frame.break
|translationkey=subtitles.entity.glow_item_frame.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Item Frame place1.ogg
|sound2=Item Frame place2.ogg
|sound3=Item Frame place3.ogg
|sound4=Item Frame place4.ogg
|subtitle=Item Frame placed
|source=neutral
|description=When an item frame is placed
|id=entity.item_frame.place
|translationkey=subtitles.entity.item_frame.place
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Glow Item Frame placed
|source=neutral
|description=When a glow item frame is placed
|id=entity.glow_item_frame.place
|translationkey=subtitles.entity.glow_item_frame.place
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Item Frame remove item1.ogg
|sound2=Item Frame remove item2.ogg
|sound3=Item Frame remove item3.ogg
|sound4=Item Frame remove item4.ogg
|subtitle=Item Frame empties
|source=neutral
|description=When an item is removed from an item frame
|id=entity.item_frame.remove_item
|translationkey=subtitles.entity.item_frame.remove_item
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Glow Item Frame empties
|source=neutral
|description=When an item is removed from a glow item frame
|id=entity.glow_item_frame.remove_item
|translationkey=subtitles.entity.glow_item_frame.remove_item
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Item Frame rotate item1.ogg
|sound2=Item Frame rotate item2.ogg
|sound3=Item Frame rotate item3.ogg
|sound4=Item Frame rotate item4.ogg
|subtitle=Item Frame clicks
|source=neutral
|description=When an item is rotated in an item frame
|id=entity.item_frame.rotate_item
|translationkey=subtitles.entity.item_frame.rotate_item
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Glow Item Frame clicks
|source=neutral
|description=When an item is rotated in an item frame
|id=entity.glow_item_frame.rotate_item
|translationkey=subtitles.entity.glow_item_frame.rotate_item
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Item Frame add item1.ogg
|sound2=Item Frame add item2.ogg
|soumd3=Item Frame add item3.ogg
|sound4=Item Frame add item4.ogg
|source=block
|description=When an item is placed in an item frame
|id=block.itemframe.add_item
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Item Frame remove item1.ogg
|sound2=Item Frame remove item2.ogg
|sound3=Item Frame remove item3.ogg
|sound4=Item Frame remove item4.ogg
|source=block
|description=When an item is removed from an item frame
|id=block.itemframe.remove_item
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Item Frame rotate item1.ogg
|sound2=Item Frame rotate item2.ogg
|sound3=Item Frame rotate item3.ogg
|sound4=Item Frame rotate item4.ogg
|source=block
|description=When an item is rotated in an item frame
|id=block.itemframe.rotate_item
|volume=1.0
|pitch=1.0
|foot=1}}

== Achievements ==
{{load achievements|Map room}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Item Frame
|spritetype=item
|nameid=item_frame
|form=item}}
{{ID table
|displayname=Glow Item Frame
|spritetype=item
|nameid=glow_item_frame
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Item Frame
|spritetype=entity
|nameid=item_frame}}
{{ID table
|displayname=Glow Item Frame
|spritetype=entity
|nameid=glow_item_frame
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item Frame
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=item-frame
|spritetype=item
|nameid=frame
|id=513
|form=item}}
{{ID table
|displayname=Block
|spritename=item-frame
|spritetype=block
|nameid=frame
|id=199
|form=block
|translationkey=-
|itemform=item.frame}}
{{ID table
|displayname=Item
|spritename=glow-item-frame
|spritetype=item
|nameid=glow_frame
|id=623
|form=item}}
{{ID table
|displayname=Block
|spritename=glow-item-frame
|spritetype=block
|nameid=glow_frame
|form=block
|id=594
|itemform=item.glow_frame
|translationkey=-
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=item-frame
|spritetype=block
|nameid=ItemFrame}}
{{ID table
|displayname=Block entity
|spritename=glow-item-frame
|spritetype=block
|nameid=GlowItemFrame
|foot=1}}

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

{{/BS}}<br />
===Item data===
{{el|java}}:{{main|Player.dat format}}<div class="treeview">
*{{nbt|compound|tag}}'''<span data-ve-ignore="true" class="nowrap"> tag</span>''': The item's '''tag''' tag.
{{:Player.dat_format/Entity Spawners}}Unlike spawn eggs, cannot change the type of entity created using the <code>id</code> tag. Data that item frames do not normally use (see below) has no effect. 
</div>
===Entity data===
{{main|Entity format}}

{{IN|java}}, item frames have entity data that define various properties of the entity.

{{/ED}}

===Block data===

{{IN|bedrock}}, an item frame has a block entity associated with it that holds additional data about the block.

See [[Bedrock Edition level format/Block entity format]].

== Video==

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

==History==
{{History|java}}
{{History||August 15, 2012|link={{tweet|Dinnerbone|235724805196877824}}|[[File:Item Frame (pre-release).png|32px]] [[Dinnerbone]] showed the first image of item frames.}}
{{History||August 15, 2012|link={{tweet|Dinnerbone|235742974271700993}}|[[File:Item Frame (item) (pre-release).png|32px]] Dinnerbone showed item frame in item form.}}
{{History||August 15, 2012|link={{tweet|jeb_|235746335368814592}}|[[File:Item Frame (pre-release 2).png|32px]] [[Jeb]] showed the item frames with new model.}}
{{History||August 16, 2012|link={{tweet|Dinnerbone|236062188555624448}}|[[File:Item Frame (item) JE1 BE1.png|32px]] Dinnerbone showed the item frame in item form with new texture.}}
{{History||1.4.2|snap=12w34a|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames. 
|There is currently a bug where attempting to place an item frame in [[multiplayer]] causes an internal server error, as well as other bugs.}}
{{History|||snap=12w34b|The multiplayer item frame bug has been fixed.}}
{{History|||snap=12w38a|Item frames no longer despawn when the [[player]] moves 20 [[block]]s away.}}
{{History||1.7.2|snap=13w36a|Items renamed using an [[anvil]] now display their name when looked at up close.}}
{{History|||snap=13w38a|[[Map]]s placed in an item frame now cover the whole block face, allowing seamless tiling of adjacent maps. This makes undiscovered areas of maps invisible.}}
{{History|||snap=13w43a|[[File:Item Frame (map) JE1 BE1.png|32px]] Incomplete maps placed in item frames now display the item frame texture underneath.}}
{{History||1.8|snap=14w04a|[[Item]]s and [[block]]s displayed in the item frame now rotate 45 degrees when rotated instead of 90 degrees, and a [[comparator]] outputs a [[redstone]] signal depending on the rotation phase.}}
{{History|||snap=14w10a|Multiple item frames can no longer be placed on the same block face.}}
{{History||1.9|snap=15w41a|An item frame now generates in the treasure room of [[end ship]]s, above the [[shulker]] that guards the treasure. It holds [[elytra]].}}
{{History|||snap=15w49a|Item frames are no longer destroyed by [[lightning]] bolts.}}
{{History|||snap=15w50a|Added [[sound]]s to item frames: <code>entity.itemframe.add_item</code>, <code>entity.itemframe.break</code>, <code>entity.itemframe.place</code>, <code>entity.itemframe.remove_item</code>, and <code>entity.itemframe.rotate_item</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID of item frames has been changed from <code>ItemFrame</code> to <code>item_frame</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 389.}}
{{History|||snap=17w50a|Item frames can now be put on floors and ceilings.}}
{{History||1.14|snap=18w43a|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}}
{{History|||snap=19w11a|Item frames are now [[trading|sold]] by cartographer [[villager]]s.}}
{{History||1.15|snap=19w38a|[[File:Item Frame 19w38a.png|32px]] [[File:Item Frame Map 19w38a.png|32px]] Item frames now appear dark, same as suffocating [[mob]]s.<ref>{{bug|mc-161283|||Fixed}}</ref>}}
{{History|||snap=19w39a|Item frames are now colored correctly.}}
{{History||1.16|snap=20w10a|The NBT <code>Invisible</code> and <code>Fixed</code> have been added to item frames.}}
{{History||1.17|snap=21w03a|[[File:Glow Item Frame JE1 BE3.png|32px]] [[File:Glow Item Frame (map) JE1 BE3.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Added glow item frames.}}
{{History|||snap=21w10a|Added new [[subtitles]] for glow item frames.}}
{{History||1.18|snap=21w41a|[[File:Item Frame (item) JE3.png|32px]] [[File:Glow Item Frame (item) JE2.png|32px]] The textures of item frames and glow item frames as item have been changed.}}
{{History||1.19|snap=22w15a|Item frames now adjusts its hitbox to account for the larger size of a framed [[map]].}}
{{History|||snap=Pre-release 3|Reverted the change in 22w15a.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (map) JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames.
|Item frames are considered as a [[block entity]] instead of an [[entity]].<ref>{{tweet|_tomcc|690127591525728257|Let's create some drama: ItemFrames in MCPE will behave like signs and won't be placeable in blocks, and can't put many in the same block.|21 Jan 2016}}</ref>}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|An item frame containing [[elytra]] now generates in [[end city]] ships.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Item frames can now be [[trading|bought]] from cartographer [[villager]]s.}}
{{History||1.13.0|snap=beta 1.13.0.9|Item frames can now be placed on the top and bottom of [[block]]s.}}
{{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed, item frames are now offered by expert-level cartographer villager.}}
{{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.210.59|[[File:Item Frame.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Added glow item frames.
|Has the default item frame block texture.}}
{{History|||snap=beta 1.16.210.60|Temporarily removed glow item frames due to a crash.}}
{{History|||snap=beta 1.16.220.50|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Glow Item Frame (item) JE1 BE1.png|32px]] Re-added glow item frames.}}
{{History|||snap=beta 1.16.220.52|[[File:Glow Item Frame BE2.png|32px]] [[File:Glow Item Frame (map) BE2.png|32px]] Glow Item Frame block texture uses update block texture due to a bug.}}
{{History||1.17.0|snap=beta 1.16.230.52|[[File:Item Frame.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] The glow item frame block textures have been reverted back to the previous one.}}
{{History|||snap=beta 1.17.0.50|[[File:Glow Item Frame JE1 BE3.png|32px]] [[File:Glow Item Frame (map) JE1 BE3.png|32px]] The textures of glow item frames have been changed to match Java Edition.
|Now produces [[redstone]] signals.}}
{{History|||snap=beta 1.17.0.52|Maps now glow in glow item frames.
|Glow Item Frames are no longer available only through [[Experimental Gameplay]].}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Item Frame (item) JE3.png|32px]] [[File:Glow Item Frame (item) JE2.png|32px]] The textures of item frames and glow item frames as item have been changed.}}

{{History|console}}
{{History||xbox=TU9|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Item Frame LCE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames.}}
{{History||xbox=TU11|The limit for item frames in a world has been increased. A message is now displayed when the maximum number of item frames are reached.}}
{{History||xbox=TU12|[[File:Item Frame JE1 BE1.png|32px]] The entity texture of item frames has been changed.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|[[Item]]s and [[block]]s displayed in the item frame now rotate 45 degrees when rotated instead of 90 degrees, and a [[redstone comparator|comparator]] now outputs a [[redstone]] signal depending on the rotation phase.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for item frames.}}
{{History||xbox=TU56|xbone=CU47|ps=1.55|wiiu=Patch 26|switch=1.0.6|If the [[item]] in the item frame has a name (from an [[anvil]]) it now shows as if there is a name tag on the item frame.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Item Frame JE2 BE2.png|32px]] [[File:Item Frame (map) JE2 BE2.png|32px]] [[File:Item Frame (item) JE2 BE2.png|32px]] The textures of item frames have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Item Frame JE1 BE1.png|32px]] [[File:Item Frame (map) JE1 BE1.png|32px]] [[File:Item Frame (item) JE1 BE1.png|32px]] Added item frames.}}
{{History|foot}}

== Issues==

{{issue list}}

== Trivia==

*The item frame is based upon a suggestion on [[wikipedia:Reddit|Reddit]], like the [[ender chest]] and [[flower pot]].<ref>{{Tweet|dinnerbone|235747041286975488}}</ref>
*The item frame is the only entity to reference a block [[model]].{{only|java|short=1}} Because of this, the texture of the frame border is the same as the birch planks texture.
*Item frame is the '''only''' placeable item that can interfere with other non-full block entities.
*Due to the way layer textures are displayed in Minecraft, maps float on item frames, similar to how icons float on the map itself.

== Gallery ==
=== Renders ===
<gallery>
Item Frame.png | Item Frame
Item Frame (map).png | Map Item Frame
Glow Item Frame.png | Glow Item Frame
Glow Item Frame (map).png | Map Glow Item Frame
Item Frame with Item.png | With item
Item Frame with rotated Item.png | With rotated item
Item Frame with Block.png | With block
Item Frame with rotated Block.png | With rotated block
</gallery>

=== Screenshots ===
<gallery>
Slab Frame.png|An item frame on the side of a slab.
ItemFrameBoxed.png|Four item frames in a one-block space.{{only|java}} 
Item Frames Woodbase.png|The frame itself uses the texture of birch planks.
Item Frame rotation.gif|The rotation of an item in an item frame.
Front-back-itemframe.png|The front and back of an item frame are the same.
Big skills right there.png|A glow item frame inside a glow item frame.
Frame fireplace.png|An image of a fireplace retweeted by Dinnerbone.
11 Framed.png|[[11]] in an item frame.
</gallery>

=== Development images ===
<gallery>
Suggestion for itemframes.png|Original Reddit image suggesting item frames and flower pots.
Item frame2.png|Dinnerbone's first screenshot showing armor and weapons.
Item frame3.png|Dinnerbone's second screenshot showing a map, a compass, and two diamond swords.
Item frame4.png|Dinnerbone's third screenshot showing a golden sword in all directions, the item frame item itself, and a working clock.
Item frame1.png|Jeb's screenshot of the item frame.
FlowerPot.png|Snapshot showing plant pots and item frames.
Item frame5.png|Snapshot image of an ender pearl in an item frame.
SOATPC.png|An image tweeted by Dinnerbone showing how hovering over an item frame containing a renamed item shows a name tag.
Pocket Edition Item Frames.jpg|First image of item frames in ''Bedrock Edition''.
</gallery>

== See also ==

*{{ItemLink|Painting}}

== References ==

{{Reflist}}

{{Blocks|Utility}}
{{items}}
{{entities}}

[[Category:Block entities]]
[[Category:Utility blocks]]
[[Category:Manufactured blocks]]
[[Category:Generated structure blocks]]
[[Category:Storage]]

[[cs:Rámeček]]
[[de:Rahmen]]
[[es:Marco]]
[[fr:Cadre]]
[[hu:Eszköz keret]]
[[it:Cornice]]
[[ja:額縁]]
[[ko:아이템 액자]]
[[nl:Voorwerplijst]]
[[pl:Ramka na przedmiot]]
[[pt:Moldura]]
[[ru:Рамка]]
[[th:กรอบโชว์สิ่งของ]]
[[zh:物品展示框]]</li><li>[[Pickaxe|Pickaxe]]<br/>{{Dungeons hatnote|type=weapon}}
{{Redirect|Diamond Pickaxe|the ''Minecraft Dungeons'' weapon|MCD:Diamond Pickaxe}}
{{Redirect|Pick|the block|Sea Pickle|the control|Controls#Pick Block|the joke block|Pickaxe Block}}
{{Item
| image = <gallery>
Wooden Pickaxe.png | Wooden
Stone Pickaxe.png | Stone
Iron Pickaxe.png | Iron
Golden Pickaxe.png | Golden
Diamond Pickaxe.png | Diamond
Netherite Pickaxe.png | Netherite
</gallery>
|rarity = Common
|renewable =
* '''Netherite''': No
* '''Others''': Yes
|durability =
Java Edition:
* Wood: 59
* Stone: 131
* Iron: 250
* Golden: 32
* Diamond: 1,561
* Netherite: 2,031

Bedrock Edition:
* Wood: 60
* Stone: 132
* Iron: 251
* Golden: 33
* Diamond: 1,562
* Netherite: 2,032
| stackable = No
}}

A '''pickaxe''' is a [[tools|tool]] required to mine [[ore]]s, [[rock|rocks]], rock-based blocks and metal-based [[block]]s quickly and obtain them as items. A pickaxe mines faster and can obtain more block types as items depending on the material it is made from.

== Obtaining ==
=== Crafting ===
Pickaxes are crafted using 2 [[stick]]s and 3 identical units of tool material.

{{crafting |showdescription=1 |showname=0 |head=1
  |name=[[Pickaxe]]
  |A1={Any Planks};  Iron Ingot; Gold Ingot; Diamond
  |B1={Any Planks};  Iron Ingot; Gold Ingot; Diamond
  |C1={Any Planks};  Iron Ingot; Gold Ingot; Diamond
  |B2=Stick
  |B3=Stick
  |Output=Wooden Pickaxe; Iron Pickaxe; Golden Pickaxe; Diamond Pickaxe
  |type=Tool
}}
{{Crafting
  |name=[[Stone Pickaxe]]
  |A1=Any stone-tier block |B1=Any stone-tier block |C1=Any stone-tier block
  |B2=Stick
  |B3=Stick
  |Output=Stone Pickaxe
  |description=Can use cobblestone and its other variants interchangeably.
  |type=Tool
}}
{{crafting |foot=1 |ignoreusage=1
  |name=[[Pickaxe]]
  |ingredients=Matching Damaged [[Pickaxe]]s
  |Damaged Wooden Pickaxe; Damaged Stone Pickaxe; Damaged Iron Pickaxe; Damaged Golden Pickaxe; Damaged Diamond Pickaxe; Damaged Netherite Pickaxe
  |Damaged Wooden Pickaxe; Damaged Stone Pickaxe; Damaged Iron Pickaxe; Damaged Golden Pickaxe; Damaged Diamond Pickaxe; Damaged Netherite Pickaxe
  |Output=Wooden Pickaxe; Stone Pickaxe; Iron Pickaxe; Golden Pickaxe; Diamond Pickaxe; Netherite Pickaxe
  |description=The durability of the two pickaxes is added together, plus an extra 5% of the tool type's total durability.
  |type=Tool
}}

=== Upgrading ===

{{Smithing
|head=1
|Netherite Upgrade
|Diamond Pickaxe
|Netherite Ingot
|Netherite Pickaxe
|tail=1
}}

=== Repairing ===
==== Grinding ====

{{grinding
|showdescription=1
|ingredients=Matching Damaged [[Pickaxe]]s
|Damaged Wooden Pickaxe; Damaged Stone Pickaxe; Damaged Iron Pickaxe; Damaged Golden Pickaxe; Damaged Diamond Pickaxe; Damaged Netherite Pickaxe
|Damaged Wooden Pickaxe; Damaged Stone Pickaxe; Damaged Iron Pickaxe; Damaged Golden Pickaxe; Damaged Diamond Pickaxe; Damaged Netherite Pickaxe
|Wooden Pickaxe; Stone Pickaxe; Iron Pickaxe; Golden Pickaxe; Diamond Pickaxe; Netherite Pickaxe
|description=The durability of the two pickaxes is added together, plus an extra 5% durability.
}}

==== Unit repair ====
{{main|Anvil mechanics#Unit repair}}
Pickaxes can be repaired in an [[anvil]] by adding units of the [[tiers|tier's]] repair material, with each repair material restoring 25% of the pickaxe's maximum durability, rounded down.

=== Natural generation ===
{{LootChestItem|wooden-pickaxe,stone-pickaxe,iron-pickaxe,level-enchanted-iron-pickaxe,random-enchanted-golden-pickaxe,level-enchanted-diamond-pickaxe,random-enchanted-diamond-pickaxe,damaged-random-enchanted-diamond-pickaxe}}

=== Trading ===
{{IN|bedrock}}, novice-level toolsmith [[Villager|villagers]] have a 25% chance to sell stone pickaxes for one [[emerald]], Journeyman-level toolsmith villagers have a 25% chance to sell enchanted iron pickaxes for 3 emeralds, and master-level toolsmith villagers always sell enchanted diamond pickaxes for 13 emeralds.

{{IN|java}}, novice-level toolsmith villagers have a 40% chance to sell a stone pickaxe for one emerald, journeyman-level toolsmith villagers have a 40% chance to sell an enchanted iron pickaxe for 7–22 emeralds, and a master-level toolsmith always sells an enchanted diamond pickaxe for 18–35 emeralds.

The enchantments are the same as the ones obtained from an [[enchantment table]] at levels 5–19.

=== Villager gifts ===

{{IN|JE}}, toolsmith [[villager]]s throw stone pickaxes at players under the [[Hero of the Village]] effect.

=== Mob loot ===
{{IN|BE}}, [[pillager]]s and [[vindicator]]s have a chance of dropping a damaged iron pickaxe when killed during a [[raid]]. The pickaxe has a 50% chance of being enchanted with random enchantment(s).

== Usage ==
=== Mining ===
A pickaxe is used to break stone and metal-based materials faster. Breaking a block with a pickaxe consumes one use (one durability point). No durability is consumed for blocks that break instantly. Pickaxes have different amounts of uses based on the type:
* Wooden: 60
* Stone: 132
* Iron: 251
* Golden: 33
* Diamond: 1562
* Netherite: 2032

Different qualities of pickaxe are required to successfully harvest certain ores and blocks. For example, while [[stone]] can be mined with any pickaxe, [[gold ore]] must be mined with an [[iron]], [[diamond]], or [[netherite]] pickaxe, or else the player harvests no ore. Different pickaxes also mine many materials at different speeds:

==== Speed ====
The following table shows the time it takes to break each type of block.
* A <span style="background-color:#FFC7CE;color:#9C0006;">red</span> background indicates that the block cannot be harvested with that type of pickaxe.
* A <span style="background-color:#FFFFDD;color:#8A7600;">yellow</span> background indicates that the block cannot be harvested with that type of pickaxe, but still drops something.
* A <span style="background-color:#C6EFCE;color:#006100;">green</span> background indicates that the block can be harvested with that type of pickaxe.
<!-- Table is sorted by hardness (mining time with diamond shows well), then by name -->
{|class="wikitable collapsible collapsed" data-description="Mining time by block" style="background-color: transparent;"
! Times to break blocks by pickaxe
|-
|
{{breaking row|sort=1|simple=1|Obsidian|Diamond}}
{{breaking row|Crying Obsidian|Diamond}}
{{breaking row|Respawn Anchor|Diamond}}
{{breaking row|Block of Netherite|Diamond}}
{{breaking row|Ancient Debris|Diamond}}
{{breaking row|Ender Chest|Wood}}
{{breaking row|Anvil|Wood}}
{{breaking row|Bell|Wood}}
{{breaking row|Block of Coal|Wood}}
{{breaking row|Block of Diamond|Iron}}
{{breaking row|Block of Emerald|Iron}}
{{breaking row|Block of Iron|Stone}}
{{breaking row|Block of Raw Copper|Stone}}
{{breaking row|Block of Raw Gold|Iron}}
{{breaking row|Block of Raw Iron|Stone}}
{{breaking row|Block of Redstone|Wood}}
{{breaking row|Chain|Wood}}
{{breaking row|Enchantment Table|Wood}}
{{breaking row|Iron Bars|Wood}}
{{breaking row|Iron Door|Wood|item=1|link=Door}}
{{breaking row|Iron Trapdoor|Wood|link=Trapdoor}}
{{breaking row|Monster Spawner|Wood}}
{{breaking row|Deepslate Coal Ore|Wood}}
{{breaking row|Deepslate Copper Ore|Wood}}
{{breaking row|Deepslate Diamond Ore|Wood}}
{{breaking row|Deepslate Emerald Ore|Wood}}
{{breaking row|Deepslate Gold Ore|Wood}}
{{breaking row|Deepslate Iron Ore|Wood}}
{{breaking row|Deepslate Lapis Lazuli Ore|Wood}}
{{breaking row|Deepslate Redstone Ore|Wood}}
{{breaking row|Blast furnace|Wood}}
{{breaking row|Cobbled Deepslate|Wood}}
{{breaking row|Chiseled Deepslate|Wood}}
{{breaking row|Deepslate Bricks|Wood}}
{{breaking row|Deepslate Tiles|Wood}}
{{breaking row|Polished Deepslate|Wood}}
{{breaking row|Dispenser|Wood}}
{{breaking row|Dropper|Wood}}
{{breaking row|Furnace|Wood}}
{{breaking row|Lantern|wood}}
{{breaking row|Lodestone|Wood}}
{{breaking row|Smoker|Wood}}
{{breaking row|Stonecutter|Wood}}
{{breaking row|Conduit}}
{{breaking row|Block of Gold|Iron}}
{{breaking row|Block of Lapis Lazuli|Stone}}
{{breaking row|Coal Ore|Wood}}
{{breaking row|Copper Ore|Wood}}
{{breaking row|Copper Blocks|Wood}}
{{breaking row|Cut Copper|Wood}}
{{breaking row|Cut Copper Slab|Wood}}
{{breaking row|Cut Copper Stairs|Wood}}
{{breaking row|Deepslate|Wood}}
{{breaking row|Dragon Egg
 |note=<ref group="note">The dragon egg can be mined directly only when there aren't any air blocks available for it to teleport to. However, the dragon egg can be collected by other means.</ref>}}
{{breaking row|Diamond Ore|Iron}}
{{breaking row|Emerald Ore|Iron}}
{{breaking row|End Stone|Wood}}
{{breaking row|Gold Ore|Iron}}
{{breaking row|Hopper|Wood}}
{{breaking row|Iron Ore|Stone}}
{{breaking row|Lightning Rod|Wood}}
{{breaking row|Lapis Lazuli Ore|Stone}}
{{breaking row|Nether Quartz Ore|Wood}}
{{breaking row|Nether Gold Ore|Wood}}
{{breaking row|Observer|Wood}}
{{breaking row|Redstone Ore|Iron}}
{{breaking row|Blue Ice|drop=0}}
{{breaking row|Compound Creator|Wood|drop=1|note=<ref group="note" name="Chemtable">Chemistry tables are slow to break by hand, similar to blocks that require a pickaxe to mine. However, they still drop as items.</ref>}}
{{breaking row|Heat Block|Wood}}
{{breaking row|Grindstone|Wood}}
{{breaking row|Bone Block|Wood}}
{{breaking row|Brick Stairs|Wood|link=Stairs}}
{{breaking row|Bricks|Wood}}
{{breaking row|Cauldron|Wood}}
{{breaking row|Cobblestone|Wood}}
{{breaking row|link=Stairs|Cobblestone Stairs|Wood}}
{{breaking row|Cobblestone Wall|Wood}}
{{breaking row|Mossy Cobblestone|Wood}}
{{breaking row|Nether Bricks|Wood}}
{{breaking row|Nether Brick Fence|Wood}}
{{breaking row|link=Stairs|Nether Brick Stairs|Wood}}
{{breaking row|Red Nether Bricks|Wood}}
{{breaking row|Polished Blackstone|Wood}}
{{breaking row|link=Slab|Stone Slabs|sprite=all-slabs|Wood}}
{{breaking row|Smooth Stone|Wood}}
{{breaking row|Shulker Box}}
{{breaking row|Concrete|Wood}}
{{breaking row|Andesite|Wood}}
{{breaking row|Dark Prismarine|Wood}}
{{breaking row|Diorite|Wood}}
{{breaking row|Dripstone Block|Wood}}
{{breaking row|Granite|Wood}}
{{breaking row|Mud Bricks|Wood}}
{{breaking row|Pointed Dripstone}}
{{breaking row|Prismarine|Wood}}
{{breaking row|Prismarine Bricks|Wood}}
{{breaking row|Purpur block|Wood}}
{{breaking row|Purpur pillar|Wood}}
{{breaking row|Stone|Wood}}
{{breaking row|Stone Bricks|Wood}}
{{breaking row|Tuff|Wood}}
{{breaking row|link=Stairs|Stone Brick Stairs|Wood}}
{{breaking row|Amethyst Bud|drop=0}}
{{breaking row|Amethyst Cluster|drop=0}}
{{breaking row|Blackstone|Wood}}
{{breaking row|Block of Amethyst|Wood}}
{{breaking row|Budding Amethyst|drop=0}}
{{breaking row|Chiseled Polished Blackstone|Wood}}
{{breaking row|Polished Blackstone Bricks|Wood}}
{{breaking row|Gilded Blackstone|Wood}}
{{breaking row|Glazed Terracotta|Wood}}
{{breaking row|Terracotta|Wood}}
{{breaking row|Basalt|Wood}}
{{breaking row|Smooth Basalt|Wood}}
{{breaking row|Polished Basalt|Wood}}
{{breaking row|Packed Mud}}
{{breaking row|Block of Quartz|Wood}}
{{breaking row|Quartz Stairs|Wood|link=Stairs}}
{{breaking row|Red Sandstone|Wood}}
{{breaking row|Red Sandstone Stairs|Wood|link=stairs}}
{{breaking row|Sandstone|Wood}}
{{breaking row|Sandstone Stairs|Wood|link=stairs}}
{{breaking row|Calcite|Wood}}
{{breaking row|Rail}}
{{breaking row|Brewing Stand|Wood}}
{{breaking row|Stone Button|any}}
{{breaking row|Ice|drop=0}}
{{breaking row|Magma Block|Wood}}
{{breaking row|Packed Ice|drop=0}}
{{breaking row|Frosted Ice|drop=0}}
{{breaking row|Stone Pressure Plate|Wood}}
{{breaking row|Netherrack|Wood}}
{{breaking row|sprite=crimson-nylium|Nylium|Wood|foot=1}}
|}

=== Weapon ===
Hitting a mob with a pickaxe is a stronger attack than using fists. Pickaxes lose 2 durability when used as a weapon.

==== Java Edition ====
Pickaxes have an attack speed modifier of −2.8, meaning they take about 0.83 seconds to [[Damage#Attack cooldown|recover]]. All pickaxes have an attack speed of 1.2 hits per second. They deal different damage based on the type:

{|class="wikitable" style="text-align:center" data-description="Attack damage"
! Pickaxe type
! Attack damage
! Damage per<br> second (DPS)
|-
|{{ItemLink|Wooden Pickaxe}} ||rowspan=2 |{{hp|2}} ||rowspan=2 |2.4
|-
|{{ItemLink|Golden Pickaxe}}
|-
|{{ItemLink|Stone Pickaxe}} ||{{hp|3}} ||3.6
|-
|{{ItemLink|Iron Pickaxe}} ||{{hp|4}} ||4.8
|-
|{{ItemLink|Diamond Pickaxe}} ||{{hp|5}} ||6
|-
|{{ItemLink|Netherite Pickaxe}} ||{{hp|6}} ||7.2
|}

==== Bedrock Edition ====
{{IN|bedrock}}, pickaxes always attack instantly and do the following damage:

{|class="wikitable" style="text-align:center" data-description="Attack damage"
! Pickaxe type
! Attack damage
|-
|{{ItemLink|Wooden Pickaxe}}<br />{{ItemLink|Golden Pickaxe}} ||{{hp|3}}
|-
|{{ItemLink|Stone Pickaxe}} ||{{hp|4}}
|-
|{{ItemLink|Iron Pickaxe}} ||{{hp|5}}
|-
|{{ItemLink|Diamond Pickaxe}} ||{{hp|6}}
|-
|{{ItemLink|Netherite Pickaxe}} ||{{hp|7}}
|}

=== Enchantments ===
A pickaxe can receive the following [[enchantment]]s:
{|class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Efficiency]]
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Fortune]]<ref group=note name=note1>Fortune and Silk Touch are mutually exclusive.</ref>
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Silk Touch]]<ref group=note name=note1/>
|I
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|}

{{Notelist}}

=== Fuel ===
Wooden pickaxes can be used as a fuel in [[furnace]]s, smelting 1 item per wooden pickaxe.

=== Smelting ingredient ===
{{Smelting|showname=1|Iron Pickaxe;Golden Pickaxe|Iron Nugget;Gold Nugget|0,1}}
===Piglins===
If a {{EntityLink|Piglin}} see a golden pickaxe, it will set off to reach it, then stare at it for 120 — 160 ticks, putting it in their inventory, and continue to perform the action it was taking before being attracted by the golden pickaxe.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a pickaxe's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Random break.ogg
|source=player
|description=When a shovel's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Wooden Pickaxe
|spritetype=item
|nameid=wooden_pickaxe
|form=item}}
{{ID table
|displayname=Stone Pickaxe
|spritetype=item
|nameid=stone_pickaxe
|form=item}}
{{ID table
|displayname=Iron Pickaxe
|spritetype=item
|nameid=iron_pickaxe
|form=item}}
{{ID table
|displayname=Diamond Pickaxe
|spritetype=item
|nameid=diamond_pickaxe
|form=item}}
{{ID table
|displayname=Golden Pickaxe
|spritetype=item
|nameid=golden_pickaxe
|form=item}}
{{ID table
|displayname=Netherite Pickaxe
|spritetype=item
|nameid=netherite_pickaxe
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wooden Pickaxe
|spritetype=item
|nameid=wooden_pickaxe
|id=310
|form=item}}
{{ID table
|displayname=Stone Pickaxe
|spritetype=item
|nameid=stone_pickaxe
|id=314
|form=item}}
{{ID table
|displayname=Iron Pickaxe
|spritetype=item
|nameid=iron_pickaxe
|id=297
|form=item}}
{{ID table
|displayname=Diamond Pickaxe
|spritetype=item
|nameid=diamond_pickaxe
|id=318
|form=item}}
{{ID table
|displayname=Golden Pickaxe
|spritetype=item
|nameid=golden_pickaxe
|id=324
|form=item}}
{{ID table
|displayname=Netherite Pickaxe
|spritetype=item
|nameid=netherite_pickaxe
|id=606
|form=item
|foot=1}}

== Achievements ==
{{Load achievements|Time to mine!;Getting an Upgrade;MOAR Tools ;Oooh, shiny!}}

== Advancements ==
{{load advancements|Getting an Upgrade;Isn't It Iron Pick;Stone Age;Oh Shiny}}

== Video ==
{{yt|G_HTViy2JTo}}

== History ==
{{History|java indev}}
{{History||0.31|snap=20100110|[[File:Iron Pickaxe JE1.png|32px]] Added iron pickaxes.
|A pickaxe is used to gather [[stone]] materials 400% faster than by hand.
|When starting in a new world, the [[player]] is given one of each [[tool]].}}
{{History|||snap=20100124|A complete tool set is no longer given to the player on starting a new world. Instead, there are multiple [[chest]]s in the later called "[[Indev House]]" containing a stack of most accessible [[blocks]]/[[items]] including [[tools]].}}
{{History|||snap=20100128|[[File:Wooden Pickaxe JE1 BE1.png|32px]] [[File:Stone Pickaxe JE1 BE1.png|32px]] [[File:Diamond Pickaxe JE1 BE1.png|32px]] Tools now have tiers. Wooden, stone, and diamond pickaxes have been added.|[[File:Iron Pickaxe JE2 BE1.png|32px]] The texture of iron pickaxes has been changed.
|A pickaxe held by the [[player]] is now rendered to appear more 3D.|They cannot be crafted yet, but have been added to the item chest in the Indev house.}}
{{History|||snap=20100129|Wood, stone, iron, and diamond pickaxes can now be [[craft]]ed.}}
{{History|||snap=20100130|[[File:Golden Pickaxe JE1.png|32px]] Pickaxes can now be made out of [[gold]].}}
{{History|||snap=20100201-1|Tools, including pickaxes, now take [[damage]] when being used. |Better tools, including pickaxes, now last longer.}}
{{History|||snap=20100201-2|Better pickaxes are now required to mine harder materials.}}
{{History||20100206|[[File:Golden Pickaxe JE2 BE1.png|32px]] The texture of golden pickaxes has been changed.}}
{{History|java beta}}
{{History||1.2|Before, the pickaxe had much less [[item durability|durability]] (usually half as much).
|Gold pickaxes now [[breaking|mine]] certain materials much faster.}}
{{History||1.8|snap=Pre-release|Iron pickaxes are now found in the new [[stronghold]] storeroom [[chest]]s, and in the new [[mineshaft]] chests.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Iron pickaxes can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History|||snap=RC1|Pickaxes and other [[tool]]s now make a [[sound]] when they break.}}
{{History||1.1|snap=12w01a|Iron pickaxes are now found in the new [[village]] blacksmith chests.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden pickaxes.}}
{{History||1.3.1|snap=12w16a|Wooden and stone pickaxes are now found in the new [[bonus chest]]s.}}
{{History|||snap=12w18a|Wooden pickaxes can now be used as fuel in a [[furnace]].}}
{{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] 1 diamond pickaxe for 10–11 [[emerald]]s, and 1 iron pickaxe for 7–8 emeralds.}}
{{History||1.6.1|snap=13w21a|Instead of replacing the barehanded [[damage]] ({{hp|1}}), pickaxes now add their damage onto the barehanded damage, which results in all pickaxes doing {{hp|1}} more damage than before.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden pickaxes.}}
{{History||1.8|snap=14w02a|Tool smith villagers now [[trading|sell]] 1 [[enchanting|enchanted]] diamond pickaxe for 12–15 emeralds, and 1 enchanted iron pickaxe for 9–11 emeralds. 
|Unenchanted pickaxes are no longer sold by [[villager]]s.}}
{{History||1.9|snap=15w31a|Enchanted iron and diamond pickaxes can now be found in the [[end ship]] [[chest]]s in [[end city|end cities]].}}
{{History|||snap=15w34a|Pickaxes now use the "attack strength" combat mechanic meter. The time it takes for the meter to fill up for a pickaxe is 0.8 seconds.}}
{{History|||snap=15w34c|Pickaxes now do less [[damage]], but recover quicker.}}
{{History|||snap=15w35a|Pickaxes now recover more slowly.}}
{{History|||snap=15w44a|The average yield of wood and stone pickaxes in [[bonus chest]]s has been decreased.
|The average yield of iron pickaxes in [[mineshaft]] [[chest]]s has been increased.}}
{{History||1.11.1|snap=16w50a|Golden and iron pickaxes can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 270, 274, 257, 278 and 285.}}
{{History||1.14|snap=18w43a|[[File:Wooden Pickaxe JE2 BE2.png|32px]] [[File:Stone Pickaxe JE2 BE2.png|32px]] [[File:Iron Pickaxe JE3 BE2.png|32px]] [[File:Golden Pickaxe JE3 BE2.png|32px]] [[File:Diamond Pickaxe JE2 BE2.png|32px]] The textures of all pickaxes have been changed.}}
{{History|||snap=18w50a|Iron pickaxes can now be found in chests in [[village]] toolsmith houses.}}
{{History|||snap=19w11a|Toolsmith [[villager]]s now [[trading|sell]] stone pickaxes.}}
{{History|||snap=19w13a|Toolsmith villagers now give stone pickaxes to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Pickaxe JE1.png|32px]] Added netherite pickaxes.
|Netherite pickaxes are obtained by combining one diamond pickaxe and one netherite ingot in a crafting table.
|[[Crimson planks]] and [[warped planks]] can now be used to craft wooden pickaxes.}}
{{History|||snap=20w09a|[[File:Wooden Pickaxe JE3 BE3.png|32px]] [[File:Golden Pickaxe JE4 BE3.png|32px]] [[File:Diamond Pickaxe JE3 BE3.png|32px]] [[File:Netherite Pickaxe JE2 BE1.png|32px]] The textures of wooden, golden, diamond, and netherite pickaxes have been changed.}}
{{History|||snap=20w10a|[[File:Netherite Pickaxe JE3.png|32px]] Changed a pixel of the texture of netherite pickaxes.
|Netherite pickaxes can no longer be crafted.
|Netherite pickaxes are now obtained by combining one diamond pickaxe and one netherite ingot in a smithing table.}}
{{History|||snap=20w15a|Stone pickaxes can now be crafted using [[blackstone]].}}
{{History|||snap=20w16a|Golden pickaxes now generate randomly enchanted in [[ruined portal]] chests.}}
{{History||1.16.2|snap=20w30a|Randomly enchanted diamond pickaxes can now be found in [[bastion remnant]] chests.}}
{{History||1.17|snap=21w08a|Stone pickaxe can now be crafted using [[cobbled deepslate]].}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden pickaxes.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond pickaxes to netherite pickaxes now requires the netherite upgrade [[smithing template]].}}

{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|[[Wandering trader]]s now have a chance to sell an enchanted iron pickaxe.}}
{{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed for all pickaxes has been increased to 2.5.
|The [[damage]] for all pickaxes has been increased by {{hp|1}}.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Stone Pickaxe JE1 BE1.png|32px]] Added stone pickaxes.}}
{{History||v0.3.0|[[File:Wooden Pickaxe JE1 BE1.png|32px]] Added wooden pickaxes.
|Survival players no longer start out with an infinite durability stone pickaxe in the inventory.}}
{{History||v0.3.2|[[File:Iron Pickaxe JE2 BE1.png|32px]] [[File:Golden Pickaxe JE2 BE1.png|32px]] [[File:Diamond Pickaxe JE1 BE1.png|32px]] Added iron, gold, and diamond pickaxes.}}
{{History||v0.4.0|Removed stone pickaxes from the creative inventory.}}
{{History||v0.11.0|snap=build 11|All pickaxes are now available in the [[creative]] inventory.}}
{{History|||snap=build 12|All pickaxes have been removed from creative.}}
{{History|||snap=build 13|Pickaxes have been re-added to creative mode.}}
{{History||v0.14.0|snap=build 1|Iron pickaxes can now be found inside [[minecart with chest]]s in [[mineshaft]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[Enchanting|Enchanted]] iron pickaxes and enchanted diamond pickaxes can now be found in [[end city|end cities]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Toolsmith [[villager]]s now [[trading|sell]] enchanted diamond pickaxes for 12-15 emeralds as their last tier trades and enchanted iron pickaxes for 9-11 [[emerald]]s as their second tier trades.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden pickaxes are now [[smelting|smeltable]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Wooden and stone pickaxes can now be found inside [[bonus chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Iron pickaxes can now be found in [[plains]] [[village]] weaponsmith houses.
|[[File:Wooden Pickaxe JE2 BE2.png|32px]] [[File:Stone Pickaxe JE2 BE2.png|32px]] [[File:Iron Pickaxe JE3 BE2.png|32px]] [[File:Golden Pickaxe JE3 BE2.png|32px]] [[File:Diamond Pickaxe JE2 BE2.png|32px]] The textures of all pickaxes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron pickaxes can now be found in [[village]] toolsmiths [[chest]]s and in [[savanna]], [[taiga]], [[snowy taiga]] and [[desert]] village weaponsmith chests.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has been changed, toolsmith [[villager]]s now have a 25% chance to [[trading|sell]] an [[enchanting|enchanted]] iron pickaxe for 3 [[emerald]]s as part of their third tier trades, and an enchanted diamond pickaxe now costs 13 emeralds.
|Stone pickaxes can now be bought from toolsmith villagers.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Pickaxe JE2 BE1.png|32px]] Added netherite pickaxes.|Netherite pickaxes are obtained by combining one diamond pickaxe and one netherite ingot in a crafting table.
|[[File:Wooden Pickaxe JE3 BE3.png|32px]] [[File:Golden Pickaxe JE4 BE3.png|32px]] [[File:Diamond Pickaxe JE3 BE3.png|32px]] The textures of wooden, golden, and diamond pickaxes have been changed.}}
{{History|||snap=beta 1.16.0.57|Netherite pickaxes can no longer be crafted.
|Netherite pickaxes are now obtained by combining one diamond pickaxe and one netherite ingot in a smithing table.
|Stone pickaxes can now be crafted using [[blackstone]].
|Golden pickaxes now generate randomly enchanted in [[ruined portal]] chests.
|Netherite pickaxe now generate randomly enchanted in [[bastion remnant]] chest.}}
{{History||1.17.10|snap=beta 1.17.10.20|[[File:Netherite Pickaxe JE3.png|32px]] Changed a pixel of the texture of netherite pickaxes to match ''Java Edition''.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Wooden Pickaxe JE1 BE1.png|32px]] [[File:Stone Pickaxe JE1 BE1.png|32px]] [[File:Iron Pickaxe JE2 BE1.png|32px]] [[File:Golden Pickaxe JE2 BE1.png|32px]] [[File:Diamond Pickaxe JE1 BE1.png|32px]] Added pickaxes (all five types).}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden pickaxes are now [[smelting|smeltable]].}}
{{History|Ps4}}
{{History||1.90|[[File:Wooden Pickaxe JE2 BE2.png|32px]] [[File:Stone Pickaxe JE2 BE2.png|32px]] [[File:Iron Pickaxe JE3 BE2.png|32px]] [[File:Golden Pickaxe JE3 BE2.png|32px]] [[File:Diamond Pickaxe JE2 BE2.png|32px]] The textures of all pickaxes have been changed.}}

{{History|New Nintendo 3DS Edition}}
{{History||0.1.0|[[File:Wooden Pickaxe JE1 BE1.png|32px]] [[File:Stone Pickaxe JE1 BE1.png|32px]] [[File:Iron Pickaxe JE2 BE1.png|32px]] [[File:Golden Pickaxe JE2 BE1.png|32px]] [[File:Diamond Pickaxe JE1 BE1.png|32px]] Added pickaxes.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*The golden pickaxe is the only pickaxe that is unable to harvest the material it is made from.
*The pickaxe is the only block-breaking tool without a {{control|use}} (right-click) function.

=== Publicity ===
*Plastic diamond pickaxes are official ''[[Minecraft]]'' merchandise.<ref>https://shop.minecraft.net/products/minecraft-pickaxe?_pos=3&_psq=pickaxe&_ss=e&_v=1.0</ref>
*In the game [[wikipedia:Naughty Bear: Panic in Paradise|''Naughty Bear: Panic in Paradise'']], the player can buy a diamond pickaxe which, according to the game, is made by "Kick it up a Notch Pickaxes", referring to [[Notch]].
*In mobile game ''[https://play.google.com/store/apps/details?id=br.com.tapps.vloggergoviral Vlogger Go Viral]'' clicker game, after buying the figurine shelf, there is a model of a diamond pickaxe stuck to a [[grass block]].
*In the game [[wikipedia:The Elder Scrolls V: Skyrim|''The Elder Scrolls V: Skyrim'']], the player can find a pickaxe called the "Notched Pickaxe", evidently an [[easter egg]].
*In the game [[wikipedia:Offensive Combat|''Offensive Combat'']], a stone pickaxe can be used as a melee weapon with the name of "The Notch Carver".
*In the game [[wikipedia:The Binding of Isaac (video game)|''The Binding of Isaac'']], an obtainable item named "Notched Axe", also with a drawn 8-bit look, can be used to destroy rocks. The Notched Axe also makes a return in the game's remake, [[wikipedia:The Binding of Isaac: Rebirth|''The Binding of Isaac: Rebirth'']].
*In the game [[wikipedia:Borderlands 2|''Borderlands 2'']], the player can find a secret area hidden away by blocks resembling Minecraft [[dirt]], also once inside the player can fight Creeper and the Mother Creeper to get rare Minecraft-related skins.
*In the game [[wikipedia:Octodad: Dadliest Catch|''Octodad: Dadliest Catch'']], the supermarket level has a "Mintcraft" display, an obvious parody of Minecraft, even including toy pickaxes and a creeper head.
*In the game [[wikipedia:Transformice|''Transformice'']], a diamond pickaxe can be found in the shop.

== Gallery ==
<gallery>
File:Pickaxe in Mineshaft Chest.png|A naturally generated pickaxe.
Live in Your World JINX.jpg|Official T-shirt artwork "Live in Your World" featuring an iron pickaxe made by [https://www.jinx.com JINX].
Pickaxe JINX.jpg|Official T-shirt artwork of a pickaxe made by JINX.
Stone Pickaxe SDGP.png|Stone pickaxe in the [[Super Duper Graphics Pack]].
Iron Pickaxe SDGP.png|Iron pickaxe in the [[Super Duper Graphics Pack]].
</gallery>

=== Enchanted pickaxes ===
<gallery>
Enchanted Wooden Pickaxe.gif
Enchanted Stone Pickaxe.gif
Enchanted Iron Pickaxe.gif
Enchanted Golden Pickaxe.gif
Enchanted Diamond Pickaxe.gif
Enchanted Netherite Pickaxe.gif
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-pickaxe Taking Inventory: Pickaxe] – Minecraft.net on May 10, 2018

{{items}}
[[Category:Combat]]

[[cs:Krumpáč]]
[[de:Spitzhacke]]
[[es:Pico]]
[[fr:Pioche]]
[[hu:Csákány]]
[[it:Piccone]]
[[ja:ツルハシ]]
[[ko:곡괭이]]
[[nl:Houweel]]
[[pl:Kilof]]
[[pt:Picareta]]
[[ru:Кирка]]
[[th:อีเต้อ]]
[[uk:Кайло]]
[[zh:镐]]</li></ul>
20w17aAdded text component font.
Added argument contents for hoverEvent. value is now deprecated but still supported.
Componet color can now contain RGB value prefixed by #.
Bedrock Edition
1.9.0
{{Extension DPL}}<ul><li>[[Elytra|Elytra]]<br/>{{Item
| image = Elytra.png
| rarity = Uncommon
| renewable = No
| durability = 432
| stackable = No
}}
'''Elytra''' ({{Audio|ElytraPronunciation.mp3|/ˈɛl ɪ trə/|link2=''ᴇʟ-i-trə''}}<ref>“Elytron.” ''Merriam-Webster.com Dictionary'', Merriam-Webster, https://www.merriam-webster.com/dictionary/elytron. Accessed 22 May. 2022.</ref>)<!--"Elytra" is the plural of "elytron," a single half of a beetle's protective wing covers. Verbs should agree accordingly (e.g. "Elytra allow flight"). https://www.merriam-webster.com/dictionary/elytron--> are rare wings found in [[end ship]]s that are a source of flight in [[Survival]] mode.

== Obtaining ==
=== Natural generation ===
Elytra are found only in [[end city|end cities]] in [[item frame|item frames]] in the treasure room of the [[end ship]]. A [[shulker]] guards the elytra and the ship's two loot chests.

=== Repairing ===

Elytra can be enchanted with [[Mending]] so that they get [[Item repair|repaired]] as the player collects [[experience]] orbs while wearing/holding them.

Elytra can also be repaired in the player crafting grid, by combining two damaged pairs of elytra together. 

{{crafting
|showname=0
|showdescription=1
|ignoreusage=1
|Damaged Elytra
|Damaged Elytra
|Output= Elytra
|description= The durability of the two pairs is added together, plus an extra 5% durability, but removes any enchantments.
|type= Transportation
}}

Similarly, two damaged elytra pairs can be combined on a [[grindstone]].

{{Grinding
|showdescription=1
|ingredients=2x Damaged [[Elytra]]
|Damaged Elytra
|Damaged Elytra
|Elytra
|description=The durability of the two pairs is added together, plus an extra 5% durability, but removes any enchantments.
}}

Elytra can also be repaired at an anvil using [[phantom membrane]]s, which has the advantage that it preserves [[enchantments]] on elytra. Each phantom membrane restores 108 durability points, exactly 25% of the elytra's total durability. 

{| class="wikitable" data-description="Repairing elytra"
! scope="col" style="width:64px;" | Name
! Ingredients
! [[Anvil]] usage
|-
! scope="row" style="text-align: center;" | '''Elytra'''
| [[Elytra]] +<br>[[Phantom Membrane]]
| style="width: 260px; padding: 1px;" | {{Anvil| title = Elytra|Input1=Damaged Elytra|Input2=Phantom Membrane, 2|Output=Elytra}}
|-
|}
Each repair on the anvil, however, also increases the [[Anvil mechanics|prior work]] penalty for the Elytra, making every subsequent repair increasingly expensive and eventually reaching an upper limit where repairs are no longer allowed because they are "too expensive" (even if the player has many xp levels to spare). However, the prior work penalty can be reset to 0 for an enchanted elytra pair when it is disenchanted on a grindstone. Unenchanted elytra cannot be used on the grindstone alone.

== Usage ==
[[File:Steve in elytra.png|75px]] [[File:Alex in elytra.png|75px]]

Elytra are equipped in the [[chestplate]] slot, either by placing the item directly in the slot, by pressing {{ctrl|use item}} while [[hotbar|held in hand]], or by firing a point-blank [[dispenser]] at a target. They are gray in color by default, but they adopt the design of any [[cape]] the player is wearing. They maintain their in-world texture design even when they're [[#Repair|broken]] or [[enchanted]].

=== Flying ===
To fly, the player must press the {{ctrl|jump}} key while falling, and the elytra spread apart like a beetle's elytra. The player can aim their view around to turn or adjust their pitch. Losing altitude increases speed, and gaining altitude decreases speed. [[Firework rocket]]s can be used to increase speed. Additionally, speed is quickly lost from sharp changes in direction.

Directly hitting any surface while gliding too fast causes damage to the player and their armor proportional to flight speed (although this may be calculated from another factor). When a player dies in this way, they receive the [[death messages|death message]] "'''<player> experienced kinetic energy'''". The player does not take [[fall damage]] from colliding at a shallow angle or a low enough speed. The critical, damaging angle is about 50° with the collision surface, and the calculation for damage seems to be as if the player had fallen from their maximum potential glide height to the height of the struck surface. 

A safe and simple cruise with the highest travel distance can be achieved by aiming directly at the horizon while at the glide's altitude limit. The player's speed is slow enough to allow them time to do other things during a long flight, like sort out their inventory.

In [[Creative]] mode or when the "mayfly" [[ability]] has been given, the player can alternatively hold the {{ctrl|jump}} key to fly up,{{only|bedrock}} or double press the jump key to move around freely. 

Flight can be stopped by pressing the [[jump]] key.{{only|bedrock}} 

==== Speed and altitude ====
Elytra have a minimum speed of about 7.2 m/s (obtained by gliding at the altitude cap with a strong upward pitch of 30°). If the diver drops to 0 speed, they quickly get accelerated back up to at least this minimum. The diver can increase speed by choosing to descend faster, but afterward, they do not regain nearly as much altitude. In the real world, drag increases with speed, and drag, in turn, slows the aircraft; Minecraft mimics this. To glide from cliff to cliff, a player's best bet is to aim slightly above the horizon.

Sharp turns are a fast way to lose speed. Quicker turns cause greater losses, while gentle movements have small effects. Making a hairpin turn can actually be used for making high-speed landings safe as well as for precise landings on small targets like rooftops. The player aims to glide just above the target, then as they're right over it they immediately reverse directions, then they make readjustments as necessary.

The lowest rate of altitude loss is about 1.5 m/sec, obtained by gliding at the altitude cap with a slight upward pitch (12° or 15°).

To get the best possible glide ratio (and thus the furthest distance out of their altitude), the diver pilot should aim directly at the horizon. This ratio is about 9.47 to 1.

[[Slow Falling]] potions greatly decrease the player's vertical (fall) speed, which also greatly decreases their ''horizontal'' speed (clearly, it depends on the vertical fall rate, as one might expect from flight modeling). The net result is that the player flies extremely slowly - but their Elytra still takes durability damage at the usual rate (1 durability per second without Unbreaking, etc.). Due to this combination, Elytra plus Slow Falling is largely a novelty that most players won't use. The [[Feather Falling]] enchantment does not affect Elytra speed and does not reduce fall damage from hitting things with elytra.

It is possible to calculate the glide range by dividing the altitude by tan of the glide angle (altitude/tan(glide angle)). For example, if the player glides from an altitude of 64 blocks above ground with a glide angle of 15 degrees, they can glide for 237 blocks (assume that they are on superflat), since floor(64 / tan(15)) is 237.

==== Stalling ====
Trying for too high a pitch reduces the player's lift. At a pitch of 30° above the horizon, the player has the lowest possible airspeed of 7.2 m/sec. Above that, the player might be considered to be in a stall. Increasing the pitch gets closer to a free-fall, and stalled flight at 60° is enough to cause fall damage. Stalling at 90° is a true free-fall.

Recovering from a stall is done by readjusting to any safe pitch as quickly as the player likes. This can be just changing to look at the horizon.

==== Powered flight ====
{{fakeImage|{{invSprite|Firework Rocket}}|Firework rockets are used for speed boosts while gliding.}}

[[Firework rocket]]s can be used for propulsion during flight by placing it in either hand and {{ctrl|using}}. Using a firework rocket while gliding quickly maximizes the player's speed for a time similar to the rocket's flight duration.

If the rocket is equipped with [[firework star]]s, it explodes at the end of its flight, inflicting damage based on the number of stars.

It is possible to gain altitude during powered flight. This makes it possible to glide for extreme distances and had been used extensively by [[far lands]]/[[World Border]] challenges.

=== Durability and Repair ===
{{fakeImage|{{invSprite|Broken Elytra}}|A broken pair of elytra.}}

[[Durability]] decreases by one point each second when gliding. A pair of elytra has 432 durability, allowing 7 minutes and 12 seconds of gliding time without enchantments, providing more than 10,000 blocks of transport distance. It is possible to apply the [[Unbreaking]] enchantment using an [[anvil]] and an [[enchanted book]], which affects the elytra, in the same way it does to [[tool]]s. Unbreaking III increases elytra's flight time to about four seconds per durability point, a total of 28 minutes and 44 seconds.

When the durability reaches 1, elytra stop working until they are repaired, adopting a tattered texture in the inventory. The damage ends at durability 1, so they can never fully break. A pair may be repaired by either using the [[Mending]] enchantment, combining two pairs in a [[grindstone]], or combining it in an anvil with [[phantom membrane]]s. In an anvil, each piece of membrane repairs elytra by 108 durability points, requiring 4 pieces to fully repair them.

Each repair on the anvil will also increase the [[Anvil mechanics|prior work]] penalty for the Elytra, making every subsequent repair increasingly expensive, with an upper limit where repairs are no longer allowed because they are "too expensive". However, the prior work penalty can be reset to 0 for an enchanted elytra pair when it is disenchanted on a grindstone (by adding nothing to it). Unenchanted elytra cannot be used on the grindstone alone.

=== Enchantments ===
Elytra can receive the following [[enchantments]] by combining in an anvil:
{| class="wikitable sortable"
|-
! Enchantment 
! Max Level
![[Enchanting|Method]]
|-
| [[Unbreaking]]
| III
|{{Inventory slot|Anvil}}
|-
| [[Mending]]
| I
|{{Inventory slot|Anvil}}
|-
| [[Curse of Vanishing]] 
| I
|{{Inventory slot|Anvil}}
|-
| [[Curse of Binding]] 
| I
|{{Inventory slot|Anvil}}
|}
{{notelist|columns=1}}

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|subtitle=Elytra rustles
|source=player
|description=When a pair of elytra is equipped
|id=item.armor.equip_elytra
|translationkey=subtitles.item.armor.equip_elytra
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Elytra loop.ogg
|subtitle=MC-177084
|source=player
|description=While flying with a pair of elytra
|id=item.elytra.flying
|translationkey=-
|volume=0.0-1.0 <ref group=sound>Is a quarter of the player's velocity. If flying for less than 1 second, it is 0.0; otherwise, if flying for less than 2 seconds, it is between 0.0 and a quarter of the player's velocity (scaling up with time until 2 seconds)</ref>
|pitch=1.0 <ref group=sound>If the volume is greater than 0.8, 0.8-volume is added to the pitch</ref>
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=dependent
|description=When a pair of elytra's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Equip leather1.ogg
|sound2=Equip leather2.ogg
|sound3=Equip leather3.ogg
|sound4=Equip leather4.ogg
|sound5=Equip leather5.ogg
|sound6=Equip leather6.ogg
|source=player
|description=When a pair of elytra is equipped
|id=armor.equip_leather
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Elytra loop.ogg
|source=player
|description=While flying with a pair of elytra
|id=elytra.loop
|volume=''Depends'' {{checkthecode}}
|pitch=1.0}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a pair of elytra's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Elytra
|spritetype=item
|nameid=elytra
|id=564
|form=item
|foot=1}}

== Achievements ==
{{Load achievements|Super Sonic}}

== Advancements ==
{{load advancements|Sky's the Limit}}

== History ==
{{History|java}}
{{History||1.9|snap=October 5, 2015|slink=https://twitter.com/_tomcc/status/651042141397979136|[[Tommaso Checchi]] tweets that [[Jeb]] is working on a secret feature for Minecraft Java Edition, saying "it's like [[W:c:Mario:Super Mario 64|Mario 64]]."}}
{{History|||snap=October 6, 2015|slink=https://twitter.com/jeb_/status/651416814791081984|[[Jeb]] tweets a [https://web.archive.org/web/20230820173231/https://gfycat.com/serpentinehighlevelamurminnow-minecraftsuggestions-ethoslab animated GIF] revealing a [[player]] gliding around an [[end city]]. Elytra have a dragon-wing texture.}}
{{History|||snap=October 6, 2015|slink=https://twitter.com/jeb_/status/651419480187346944|Jeb tweets an [https://web.archive.org/web/20230219045525/https://i.imgur.com/LBgZCyW.png image] of folded wings, which replace the cape the player is wearing.}}
{{History|||snap=October 6, 2015|slink=https://twitter.com/jeb_/status/651423700777074688|Jeb tweets another [https://web.archive.org/web/20230820083025/https://gfycat.com/leadingindolentgangesdolphin animated GIF] of his character with Mojang-themed elytra, gliding along a [[river]] through a [[taiga]] forest.}}
{{History|||snap=15w41a|[[File:Elytra JE1 BE1.png|32px]] <br>[[File:Elytra (item) JE1 BE1.png|32px]] [[File:Broken Elytra (item) JE1 BE1.png|32px]] Added elytra.
|Elytra are currently repaired with [[leather]] when using [[anvil]].}}
{{History|||snap=15w42a|Elytra now spread slightly when the [[player]] crouches.
|The player can now take [[damage]] from gliding into walls, and crashing into a wall now has its own [[Health#Death messages|death message]].
|When flying with elytra, players are only 0.6 blocks tall. They, therefore, can now fit through 1-block gaps while gliding.
|The [[player]] can no longer go higher than the starting point of the glide.}}
{{History|||snap=15w43a|The player's point of view now shifts while gliding.}}
{{History|||snap=16w06a|Elytra now recognize the [[player]]'s [[cape]] and adopt a different elytron design for every official cape (see [[#Gallery|Gallery]]). In addition, Jeb is working on a feature to allow players to change the elytron design like regular player skins.}}
{{History|||snap=16w07a|Elytra are now activated by jumping mid-air. The player no longer glides automatically when falling.
|The cape option in the [[options|options menu]] now also disables custom elytra textures.
|Added the [[game rule]] {{cd|disableElytraMovementCheck}}.}}
{{History||1.9.1|snap=pre1|[[Sound]]s while gliding with elytra have been added.}}
{{History||1.11|snap=16w32a|Elytra can now be placed on [[armor stand]]s, just like any other [[chestplate]].}}
{{History|||snap=16w38a|Elytra are now visible on [[zombie]]s, [[skeleton]]s, and armor stands.}}
{{History|||snap=16w41a|Elytra now have their own [[sound]] when equipped.}}
{{History||1.11.1|snap=16w50a|Elytra can now be propelled through the [[air]] by using [[firework rocket]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 443.}}
{{History|||snap=18w14a|Elytra now require [[phantom membrane]] to be repaired, instead of [[leather]].}}
{{History||1.14|snap=18w43a|[[File:Elytra JE2 BE2.png|32px]] <br>[[File:Elytra (item) JE2 BE2.png|32px]] [[File:Broken Elytra (item) JE2 BE2.png|32px]] The textures of the elytra have been changed.}}
{{History||1.15|snap=19w39a|The deployment animation of elytra causes [[player]] blinks when the deployment events has overlapped.}}
{{History|||snap=19w42a|The deployment and folding animations of elytra have been improved and become smoother.
|Elytra can now start to glide immediately after a jump, not only during falls.}}
{{History||1.18|snap=experimental snapshot 7|Elytra no longer use up durability when gliding regularly. Durability is now only consumed when a [[firework rocket]] is used.
|Speed boosts from firework rockets are slightly weaker.
|Now break when the item reaches 0 durability.}}
{{History|||snap=21w37a|The elytra changes in experimental snapshot 7 have been reverted.}}
{{History||1.19|snap=Pre-release 1|Equipping elytra through the inventory now plays a sound.<ref>{{bug|MC-94060||Equipping armor/elytra through inventory or dispenser doesn't play sounds|Fixed}}</ref>}}
{{History||1.19.4|snap=23w05a|Equipping elytra while held with an item already in the chestplate slot now swaps the two items.}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Elytra JE1 BE1.png|32px]] <br>[[File:Elytra (item) JE1 BE1.png|32px]] [[File:Broken Elytra (item) JE1 BE1.png|32px]] Added elytra. In-game, they are known as ''elytra wings''.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Elytra can now be propelled through the [[air]] by using [[firework rocket]]s.}}
{{History||1.2.3|snap=beta 1.2.3.3|''Elytra Wings'' have been renamed to ''Elytra''.}}
{{History||1.6.0|snap=beta 1.6.0.5|Elytra can now be repaired in an [[anvil]] using [[phantom membrane]], instead of [[leather]].}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Elytra JE2 BE2.png|32px]] <br>[[File:Elytra (item) JE2 BE2.png|32px]] [[File:Broken Elytra (item) JE2 BE2.png|32px]] The textures of elytra have been changed.}}

{{History|console}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|switch=1.0.1|[[File:Elytra JE1 BE1.png|32px]] <br>[[File:Elytra (item) JE1 BE1.png|32px]] [[File:Broken Elytra (item) JE1 BE1.png|32px]] Added elytra.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Elytra can now be propelled through the [[air]] by using [[firework rocket]]s.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|Elytra are now repaired on the [[anvil]] using [[phantom membrane]] instead of [[leather]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Elytra JE2 BE2.png|32px]] <br>[[File:Elytra (item) JE2 BE2.png|32px]] [[File:Broken Elytra (item) JE2 BE2.png|32px]] The textures of elytra have been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Elytra JE1 BE1.png|32px]] <br>[[File:Elytra (item) JE1 BE1.png|32px]] [[File:Broken Elytra (item) JE1 BE1.png|32px]] Added elytra.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* The singular form of elytra is an {{w|elytron}}.
* In reality, elytra are not used for flight. They are the tough forewings of beetles and earwigs that cover the wings they actually use for flight. However, like ''Minecraft'' elytra, in beetles they can be used for gliding.
* A flying player has a shorter hitbox than usual: A 0.6 block cube centered on the player's feet.
* It is possible to glide while on a [[ladder]], by pressing {{key|shift}} followed by {{key|space}}, causing the player to fall with a speed determined by the player's visual angle. This means that the player can descend fast on a ladder, but if the speed is too fast when hitting the ground, they can take fatal fall damage. Using a [[firework rocket]] can also speed up the player's descent. 
* {{IN|java}} if the player glides into deep [[water]] with elytra equipped, the animation does not stop, giving it the appearance of a [[swimming]] animation.<ref name="MC-97190">{{bug|MC-97190||While gliding into water or lava, player continues gliding|WAI}}</ref> The animation stops once the player touches the ground. Additionally, [[firework rocket]]s can be used with elytra underwater with a short boost duration.
* Elytra do not deactivate when the player flies into [[lava]].<ref name="MC-97190"/>
* Elytra can be equipped onto some [[mob]]s using [[command]]s. This has no effect unless the mob has the {{cd|FallFlying}} tag set to {{cd|1b}}. Mobs glide forward, unable to control the movement before landing, at which time they regain their AI. 
** Exceptions to this are [[squid]]s as the squid's AI causes it to attempt swimming in midair, making it fall straight down because it conflicts with the elytra mechanics.
**Because [[chicken]]s fall slowly, they can move more distance.
** [[Enderman|Endermen]], tamed [[wolf|wolves]] and tamed [[cat]]s that are not sitting cannot teleport until they hit the ground.
** Because mobs do not regain control until they hit the ground, [[vex]]es fall until they die or despawn as they cannot touch the ground. 
** Mobs capable of flying, such as [[parrot]]s or vexes can steer in air, though they cannot travel up or down. Dolphins also have this ability.
* [[4J Studios]] created an elytron-centered tutorial map for console edition when elytra were first introduced to this platform, this map is themed as "ruins of an ancient civilization of ''[[Minecraft]]'' worshipers" and showcases the new amplified terrain generation. This map can be seen behind the scenes.<ref>{{Mcnet|learning-fly|Learning To Fly}}</ref> On 28 March 2017, 4J Studios added an elytron-themed [[Mini Games]] for console edition called "Glide;" it consists of Time Attack and Score Attack mode.<ref>{{Mcnet|glide-mini-game-consoles-tomorrow|Glide Mini Game on Consoles Tomorrow|March 23, 2017}}</ref><ref>{{Mcnet|mini-game-masters-glide-console|Mini Game Masters Glide onto Console|March 28, 2017}}</ref>
* A player who jumps with both elytra and the [[Slow Falling]] effect travels slightly upward, which is a cheap but time-consuming alternative to [[fireworks]] and [[Riptide]]-enchanted [[trident]]s.
* On May 5, 2019, [[Mojang]] tweeted '[[The End]] never yields enough adequate resources, sadly,' along with a sad emoji.<ref>{{tweet|Minecraft|1125053038757068802|The End never yields enough adequate resources, sadly. 😔}}</ref> The first letter of each word spells 'T E n y e a r s' (Ten Years). Attached was a picture of [[player|Steve and Alex]] wearing both a [[chestplate]] and elytra. The next day, they tweeted, "Have you noticed something ''suspic10us'' here lately?"<ref>{{tweet|Minecraft|1125415169495064576|Have you noticed something suspic10us here lately?}}</ref>
* Mojang has considered the suggestion of combining elytra with a chestplate, but eventually decided against it, stating that elytra taking up armor is an intentional decision of game balancing.<ref>
{{cite
|url=https://feedback.minecraft.net/hc/en-us/articles/360005029872-Previously-Considered-Suggestions
| title = Part of the tradeoff of having an Elytra is it takes up half your armor.
|website=Minecraft Feedback
|date=July 12, 2018}}
</ref>

== Gallery ==
<gallery>
ElytraFlight.gif|The first image of elytra, tweeted by [[Jeb]]. Click to play.
FoldedWings.png|Folded elytra, which resembles the [[cape]] the user is wearing.
Minecon2015Alternative.png|The minecon 2015 cape elytra.
Dinnerbone Elytra.png|[[Dinnerbone]] flying upside down.
ElytraEnd.png|Elytra in an [[end ship]].
PlayerElytraBack.png|A [[player]] wearing elytra.
PlayerElytraFront.png|A player using elytra.
Broken Elytra.png|Elytra with only 1 [[item durability|durability]].
UpcomingElytras.jpg|Elytra designs fitting to the official capes, posted by Jeb on {{w|Reddit}}.
FlyBlock.png|A player gliding while blocking with a [[shield]].
Suspic10us.jpg|An image of players using elytra.
Steve Gliding with Elytra.png|Steve gliding with elytra.
Alex Gliding with Elytra.png|Alex gliding with elytra.
Enchanted Elytra (item).gif|A pair of  enchanted elytra.
</gallery>

=== Console exclusive ===
<gallery>
Glide Score Cavern 2.png|Screenshot of Glide mini-games.
Glide Time Cavern 2.png|Another screenshot of Glide mini-games.
GLIDE Official.jpg|''Glide'' launch poster.
Elytra Tutorial Map.jpg|Official elytra themed tutorial map.
</gallery>(These maps can be found for a price on the Microsoft Store)

=== Designs when wearing capes ===
<blockquote>Designs that are not listed here have default elytron texture or don't have any.</blockquote><gallery>
File:Mojang employees Elytra.png|Old [[Mojang]] cape
File:Mojang employees 2015 Elytra.png|New Mojang cape
File:Mojang Studios employees 2021 Elytra.png|Mojang Studios cape
File:Crowdin Translator Elytra.png|[[Crowdin]] Translator cape
File:DannyBstyle's Elytra.png|dannyBstyle's cape
File:JulianClark's Elyrtra.png|JulianClark's cape
File:Millionth Customer Elytra.png|Millionth Customer cape
File:MINECON 2011 Attendees Elytra.png|[[MINECON 2011]] Attendees cape
File:MINECON 2012 Attendees Elytra.png|[[MINECON 2012]] Attendees cape
File:MINECON 2013 Attendees Elytra.png|[[MINECON 2013]] Attendees cape
File:MINECON 2015 Attendees Elytra.png|[[MINECON 2015]] Attendees cape
File:MINECON 2016 Attendees Elytra.png|[[MINECON 2016]] Attendees cape
File:MINECON LIVE 2019 Founder's Elytra.png|[[MINECON Live 2019]] Founder's cape
File:Mojira Moderator Elytra.png|[[bug tracker|Mojira]] Moderator cape
File:MrMessiah's Elytra.png|MrMessiah's cape
File:Prismarine Elytra.png|[[Prismarine]] cape
File:Realms Mapmaker Elytra.png|[[Realms]] mapmaker's cape
File:Cobalt Elytra.png|[[Cobalt (game)|Cobalt]] cape
File:Scrolls Elytra.png|[[Scrolls]] cape
File:Turtle Elytra.png|[[Turtle]] cape
File:PancapeElyR.png|Pancape cape
File:MSCapeElyR.png|Migrator cape
File:Gr8 Escape's elytra.png|Gr8_Escape's cape
File:Valentine Elytra.png|Valentine cape
File:Vanilla Cape Elytra JE.png|Vanilla cape{{only|java}}
File:Vanilla cape elytra BE.png|Vanilla cape{{only|bedrock}}
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--elytra Taking Inventory: Elytra] – Minecraft.net on December 14, 2019

{{Items}}

[[de:Elytren]]
[[es:Élitros]]
[[fr:Élytres]]
[[ja:エリトラ]]
[[ko:겉날개]]
[[nl:Dekschild]]
[[pl:Elytry]]
[[pt:Élitros]]
[[ru:Элитры]]
[[tr:Elitra]]
[[zh:鞘翅]]
[[Category:Non-renewable resources]]</li><li>[[Painting|Painting]]<br/>{{ItemEntity
|title=Painting
|image=Painting JE2 BE2.png
|extratext=View [[#Renders|all renders]]
|renewable=Yes
|stackable=Yes (64)
|drops=1 {{ItemLink|Painting}}
}}
'''Paintings''' are decorative [[entity|entities]] that hang on walls.

== Obtaining ==
=== Crafting ===
{{Crafting
|A1= Stick |B1= Stick    |C1= Stick
|A2= Stick |B2= Any Wool |C2= Stick
|A3= Stick |B3= Stick    |C3= Stick
|Output= Painting
|type= Decoration block
}}

Paintings can be crafted with any color of [[wool]]. The color of the wool used does not influence the picture chosen when the painting is placed.
Once placed, it displays a random painting.

=== Breaking ===
To remove a painting from a wall, the player can {{control|attack}} it, break one of its supporting blocks, cover one square of it with a block, hit it with an arrow, egg, ender pearl, snowball, or fire charge, or subject it to an explosion. The painting then drops as an item. Arrows that hit paintings disappear.

=== Trading ===
Master-level shepherd [[villager]]s sell 3 paintings for 2 [[emerald]]s.

== Usage ==
=== Placement ===
Paintings can be placed on the sides of [[solid block]]s, [[sign]]s, [[banner]]s, or [[sculk vein]]s . A small gap is visible between the painting and attachment surface. There are several different sizes of paintings (see below). When placed, a painting checks for the largest amount of space it has. It then chooses a random painting of that size. The player can add blocks around the painting to ensure it is the size wanted. When the supporting blocks are removed, the painting breaks after 20 game [[tick]]s (1 second) if no supporting blocks are replaced during that interval.

=== Properties ===
Being an entity, paintings can simultaneously exist in the same space as blocks such as water or torches. Specifically, they can share the space with any block whose collision box does not intersect its hitbox.

Players and mobs are able to walk through paintings, as long as the blocks supporting the painting allow it. Secret doorways can be created this way. [[Light]] propagates through paintings as well.

If a player is concealed behind a painting, the player's name is also concealed from other players.{{verify|Is this true in Bedrock?}}

Paintings are non-flammable.

== Canvases ==
There are 26 paintings in the game. These are mostly based on paintings by [[Kristoffer Zetterstrand]], who also created the ''Minecraft'' versions.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:150px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:3em" |Original
! style="min-width:3em" |Name
! style="min-width:3em;max-width:4.5em" |[[Resource location]]
! style="min-width:10em" |Description
! Java Edition version added
|-
! [[File:Alban (texture).png|64px]]
| rowspan="7" | 1×1 blocks<br>16×16 pixels || [https://zetterstrand.com/work/pictures/archive/alban.jpeg "Albanian"] || Albanian || <code>alban</code> || A man wearing a fez next to a house and a bush. As the name of the painting suggests, it may be a landscape in [[Wikipedia:Albania|Albania]]. || rowspan="9" | [[Indev 20100223]]
|-
! [[File:Aztec (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/2aztbig.jpg "de_aztec"]|| de_aztec || <code>aztec</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Aztec2 (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/11aztec_for_print.jpg "de_aztec"]|| de_aztec || <code>aztec2</code> || [[Wikipedia:Noclip mode|Free-look]] perspective of the map [[w:c:counterstrike:Aztec|de_aztec]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]''. 
|-
! [[File:Bomb (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/12bomb.jpg "Target successfully bombed"]|| Target Successfully Bombed || <code>bomb</code> || The map [[w:c:counterstrike:Dust II|de_dust2]] from the video game ''[[Wikipedia:Counter-Strike (video game)|Counter-Strike]]'', named “target successfully bombed" in reference to the game. 
|-
! [[File:Kebab (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/kebab2.jpg "Kebab med tre pepperoni"] || Kebab med tre pepperoni || <code>kebab</code> || A kebab with three green chili peppers. 
|-
! [[File:Plant (texture).png|64px]]
|[https://zetterstrand.com/work/pictures/archive/paradistrad.jpeg "Paradisträd"] || Paradisträd || <code>plant</code> || Still life of two plants in pots. "Paradisträd" is Swedish for "[[Wikipedia:Crassula ovata|money tree]]", which is a common name for the depicted species in Scandinavia. 
|-
! [[File:Wasteland (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Wasteland_1920.jpg "Wasteland"]|| Wasteland || <code>wasteland</code> || A view of some wastelands; a small animal (presumably a rabbit) is sitting on the window ledge. 
|-
! [[File:Courbet (texture).png|128px]]
| rowspan="5" | 2×1 blocks<br>32×16 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bonjourmonsieurcourbet_BIG.jpg "Bonjour monsieur Courbet"]|| Bonjour Monsieur Courbet || <code>courbet</code> || Two hikers with pointy beards seemingly greeting each other. Based on Gustave Courbet's painting ''[[Wikipedia:La rencontre|The Meeting or "Bonjour, Monsieur Courbet"]]''. 
|-
! [[File:Pool (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/thepool_1920.jpg "The pool"]|| The Pool || <code>pool</code> || Some men and women skinny-dipping in a pool over a cube of sorts. Also there is an old man resting in the lower-right edge. 
|-
! [[File:Sea (texture).png|128px]]
| rowspan=2 |[https://zetterstrand.com/eventz/wp-content/uploads/SeaSide_1920.jpg "Seaside"]
| Seaside
| <code>sea</code>
| Mountains and a lake, with a small photo of a mountain and a bright-colored plant on the window ledge. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Creebet (texture).png|128px]]
| Creebet || <code>creebet</code> || Mountains and a lake, with a small photo of a mountain and a creeper looking at the viewer through a window. || [[Alpha v1.1.1]]
|-
! [[File:Sunset (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/sunset_dense.jpg "sunset_dense"]|| sunset_dense || <code>sunset</code> || A view of mountains at sunset. || [[Indev 20100223]]
|-
! [[File:Graham (texture).png|64px]]
| rowspan="2" | 1×2 blocks<br>16×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/graham.jpg "Graham"]|| Graham || <code>graham</code> || King Graham, the player character in the video game series ''[[Wikipedia:King's Quest|King's Quest]]''. The original is based on ''[[Wikipedia:File:Sánchez_Cotán_(Bodegón_con_membrillo,_repollo,_melón_y_pepino).jpg|Still Life with Quince, Cabbage, Melon, and Cucumber]]'' by Juan Sánchez Cotán.|| [[Alpha v1.1.1]]
|-
! [[File:Wanderer (texture).png|64px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/wanderer_1920.jpg "Wanderer"]|| Wanderer || <code>wanderer</code> || A version of Caspar David Friedrich's famous painting ''[[Wikipedia:Wanderer above the Sea of Fog|Wanderer above the Sea of Fog]]''. || rowspan="4" | [[Indev 20100223]]
|-
! [[File:Bust (texture).png|128px]]
| rowspan="6" | 2×2 blocks<br>32×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/bust_1915.jpg "Bust"]|| Bust || <code>bust</code> || A bust of [[Wikipedia:Marcus Aurelius|Marcus Aurelius]] surrounded by fire. 
|-
! [[File:Match (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/Match_rgb_1918.jpg "Match"]|| Match || <code>match</code> || A hand holding a match, causing fire on a white cubic gas fireplace. 
|-
! [[File:Skull and Roses (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/moonlight-installation_1920.jpg "Moonlight Installation"]|| Skull and Roses || <code>skull_and_roses</code> || A skeleton at night with red flowers in the foreground. The original painting was different, depicting a woman sitting in a couch, while the skull is in the middle of a body of glacial water of sorts. 
|-
! [[File:Stage (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/The-stage-is-set-1.jpg "The stage is set"]
| The Stage Is Set
| <code>stage</code>
| Scenery from ''[[Wikipedia:Space Quest I|Space Quest I]]'', with the character Graham from the video game series ''[[Wikipedia:King's Quest|King's Quest]]'' appearing twice. || [[Indev 20100223]] / [[Alpha v1.1.1]]
|-
! [[File:Void (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/the-void_1920.jpg "The Void"]|| The void || <code>void</code> || An angel praying into a void with fire below. || [[Indev 20100223]]
|-
! [[File:Wither (painting texture).png‎|128px]]
| – || Wither || <code>wither</code> || The creation of a [[wither]]. 
This is the only painting not based on a real painting. Made by Jens Bergensten.<ref>{{Citation|url=https://www.youtube.com/watch?v=kK5Y4k-vVXc|title=Who Made Minecraft’s LAST Painting?!|author=AntVenom|website=YouTube|date=29 October 2022}}</ref><ref>https://www.reddit.com/r/Minecraft/comments/1tzav2/comment/cedagcy/</ref>
|| [[Java Edition 1.4.2]] ([[12w36a]])
|-
! [[File:Fighters (texture).png|128px]]
| 4×2 blocks<br>64×32 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/fighters.jpg "Fighters"]|| Fighters || <code>fighters</code> || Two men poised to fight. Paper versions of fighters from the game ''[[Wikipedia:International Karate +|International Karate +]]''. || [[Indev 20100223]]
|-
! [[File:Donkey Kong (texture).png|128px]]
| rowspan="2" | 4×3 blocks<br>64×48 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/kong.jpg "Kong"]|| Kong || <code>donkey_kong</code> || A paper-looking screenshot of the level [https://www.mariowiki.com/100m 100m] from the arcade game ''[[Wikipedia:Donkey Kong (arcade game)|Donkey Kong]]''. || rowspan="2" | [[Alpha v1.1.1]]
|-
! [[File:Skeleton (painting texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/mortal_coil.jpg "Mortal Coil"]|| Mortal Coil || <code>skeleton</code> || [[w:c:grim-fandango:Bruno Martinez|Bruno Martinez]] from the adventure game ''[[Wikipedia:Grim Fandango|Grim Fandango]]''. 
|-
! [[File:Burning Skull (texture).png‎|128px]]
| rowspan="3" | 4×4 blocks<br>64×64 pixels ||[https://zetterstrand.com/eventz/wp-content/uploads/skull_on_fire_framed_c_1910.jpg "Skull on Fire"]|| Skull On Fire || <code>burning_skull</code> || A Skull on fire; in the background there is a moon in a clear night sky.<br>This painting is based on a Minecraft screenshot,<ref>{{Citation|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|website=Imgur|date=22 August 2020|title=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH}}</ref> with the grass block and a 3D skull added on top.<ref>{{Citation|url=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|title=https://web.archive.org/web/20200906184721/https://imgur.com/AwqQFS6|website=Imgur|date=23 August 2020}}</ref>
(See the [[:en:Painting#Trivia|trivia]] section for more info.)
| [[Java Edition Beta 1.2 01|Beta 1.2_01]] / [[Java Edition Beta 1.3|Beta 1.3]]
|-
! [[File:Pigscene (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/rgb_1914.jpg "RGB"]|| Pigscene || <code>pigscene</code> <!-- yes, without an underscore --> || A girl pointing to a pig on a canvas. In the original version, the canvas showed red, green and blue blocks, representing the three colors of the [[Wikipedia:RGB color model|RGB color model]] that is typically used by computer displays. It is based on the painting ''[[Wikipedia:File:Jacob van Oost (I) - The Artist's Studio - WGA16654.jpg|The Artist's Studio]]'' by Jacob van Oost.|| [[Alpha v1.1.1]]
|-
! [[File:Pointer (texture).png|128px]]
|[https://zetterstrand.com/eventz/wp-content/uploads/pointer_1920.jpg "Pointer"]|| Pointer || <code>pointer</code> || The main character of the game ''[[Wikipedia:International Karate +|International Karate +]]'' in a fighting stance touching a large hand. It could also be interpreted as a play on Michelangelo's famous painting ''[[Wikipedia:The Creation of Adam|The Creation of Adam]]''. || [[Indev 20100223]]
|}

=== Unused paintings ===
In [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]], with the addition of paintings to Pocket Edition, four unused 32×32 paintings were present in <samp>[[kz.png]]</samp> which remained unused. See {{slink|Bedrock Edition unused features|Paintings}} for more information. They were also added to Java Edition in snapshot [[Java Edition 22w16a|22w16a]]. They cannot be placed by default, but can be summoned by [[commands]] (such as {{cmd|/summon painting ~ ~ ~ {variant:"water"} }}) or through a [[datapack]].

According to [[Helen Zbihlyj]],<ref>https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 ([https://web.archive.org/web/20220422115723/https://old.reddit.com/r/Minecraft/comments/u8hpnx/thoughts_on_the_new_paintings/i5olue6/?context=3 archived])</ref> these paintings were originally added "as part of a Pocket Edition promo map" (no footage found) which was planned to be a part of [[Pocket Edition]] promotion at [[MINECON 2012]] [[MINECON 2013|or 2013]] and have never been used in game. The artist of these paintings remains unknown.

{| class="wikitable stikitable" style="text-align: center" data-description="Paintings"
! style="min-width:100px" |Canvas
! style="min-width:3em;max-width:4em" |Size
! style="min-width:6em" |Name
! style="min-width:10em" |[[Resource location]]
! style="min-width:10em" |Description
! style="min-width:5em;max-width:10em" |Bedrock Edition version added
! style="min-width:5em;max-width:8em" |Java Edition version added
|-
! [[File:Earth (texture) BE2.png|128px]]
| rowspan="4" | 2×2 blocks<br>32×32 pixels || Earth || <code>earth</code> || One of the four {{Wikipedia|Classical element|classical elements}}: Earth. || rowspan="4" | [[Pocket Edition v0.5.0 alpha|v0.5.0 alpha]] || rowspan="4" | [[Java Edition 22w16a|22w16a]]
|-
! [[File:Fire (texture) BE2.png|128px]]
| Fire || <code>fire</code> || One of the four classical elements: Fire. 
|-
! [[File:Water (texture) BE2.png|128px]]
| Water || <code>water</code> || One of the four classical elements: Water. 
|-
! [[File:Wind (texture) BE2.png|128px]]
| Wind || <code>wind</code> || One of the four classical elements: Air. 
|}

==Sounds==
{{Edition|Java}}:
{{Sound table
|sound=Painting break1.ogg
|sound2=Painting break2.ogg
|sound3=Painting break3.ogg
|subtitle=Painting breaks<ref>{{Cite bug|MC|194948|Painting, item frame and lead breaking subtitles inconsistent with block breaking subtitle|date=July 14, 2020}}</ref>
|source=neutral
|description=When a painting is broken or pops off
|id=entity.painting.break
|translationkey=subtitles.entity.painting.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Painting place1.ogg
|sound2=Painting place2.ogg
|sound3=Painting place3.ogg
|sound4=Painting place4.ogg
|subtitle=Painting placed
|source=neutral
|description=When a painting is placed
|id=entity.painting.place
|translationkey=subtitles.entity.painting.place
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Item Frame break1.ogg
|sound2=Item Frame break2.ogg
|sound3=Item Frame break3.ogg
|source=block
|description=When a painting is broken or pops off
|id=block.itemframe.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Item Frame add item1.ogg
|sound2=Item Frame add item2.ogg
|soumd3=Item Frame add item3.ogg
|sound4=Item Frame add item4.ogg
|source=block
|description=When a painting is placed
|id=block.itemframe.add_item
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=item
|nameid=painting
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Painting
|spritetype=entity
|nameid=painting
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=item
|nameid=painting
|id=357
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Painting
|spritetype=entity
|nameid=painting
|id=83
|foot=1}}

=== Entity data ===

Paintings have entity data that defines various properties of the entity.

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

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

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

== History ==
{{History|java indev}}
{{History||20100223|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 19 canvases, which can be viewed at [[Java Edition history of textures/Paintings]].
|The [[crafting]] recipe of paintings uses eight [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Oak Planks
  |B1=Oak Planks
  |C1=Oak Planks
  |A2=Oak Planks
  |B2=Light Gray Wool
  |C2=Oak Planks
  |A3=Oak Planks
  |B3=Oak Planks
  |C3=Oak Planks
  |Output=Painting
}}
{{!}}}
|Painting textures are currently stored on a [[texture atlas]] called <samp>[[kz.png]]</samp>.}}
{{History|java infdev}}
{{History||20100227-1|The [[crafting]] recipe has of paintings has been changed, so that it now uses [[stick]]s, rather than [[planks]].
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1=Stick
  |B1=Stick
  |C1=Stick
  |A2=Stick
  |B2=Light Gray Wool
  |C2=Stick
  |A3=Stick
  |B3=Stick
  |C3=Stick
  |Output=Painting
}}
{{!}}}
}}
{{History|java alpha}}
{{History||v1.1.1|Added five more painting canvases, for a total of 24.
|The textures of two paintings have been changed.}}
{{History|java beta}}
{{History||1.2_01|Added a new painting, although it uses an untextured part of <samp>kz.png</samp> due to the painting texture not yet being implemented.}}
{{History||1.3|The texture of the new painting, has been added to the part of <samp>kz.png</samp> displayed by the new painting.}}
{{History||April 27, 2011|link=https://web.archive.org/web/20201111211000/https://notch.tumblr.com/post/4988431144/the-maps|Custom paintings are mentioned by [[Notch]].}}
{{History||1.7.3|Paintings pushed by [[piston]]s now pop off.}}
{{History|java}}
{{History||1.4.2|snap=12w36a|Added new painting canvas 'Wither'.
|Paintings can now be placed overlapping one another.}}
{{History||1.8|snap=14w10a|Paintings can no longer be placed directly inside of each other.}}
{{History||1.9|snap=15w49a|Paintings can no longer be destroyed by [[lightning]].}}
{{History|||snap=15w50a|Added [[sound]]s for placing and breaking paintings: <code>entity.painting.place</code> and <code>entity.painting.break</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID for paintings has been changed from <code>Painting</code> to <code>painting</code>.}}
{{History||1.12|snap=17w06a|Paintings now have a more intuitive placement system. When placed, a painting always uses the maximum possible amount of available space.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 321.}}
{{History|||snap=18w02a|Paintings now use a [[resource location]] for their motive.}}
{{History||1.14|snap=18w43a|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History|||snap=19w07a|Paintings are now stored as individual image files instead of parts of a single large image file, and now support animations.}}
{{History|||snap=19w11a|Shepherd [[villager]]s now [[trading|sell]] paintings.}}
{{History||1.17|snap=21w11a|The painting back texture has been updated to be in line with the texture update.}}
{{History||1.19|snap=22w16a|Added the four unused paintings from Bedrock Edition: "Earth", "Wind", "Fire", and "Water".|These paintings can only be added through a [[data pack]], or with the {{cmd|summon}} command.}}
{{History||1.19.4|snap=23w06a|Added [[painting]] variants to "Functional Blocks" tab.|Paintings with pre-defined variant will now display author, title and size in description when hovered over.|The "Operator Utilities" tab now contains the four paintings that are not available in Survival mode.}}

{{History|pocket alpha}}
{{History||v0.5.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Bedrock Edition history of textures/Paintings]].}}
{{History||v0.8.0|snap=build 3|A new painting rendering has been added.{{info needed|What exactly changed?}}}}
{{History||v0.12.1|snap=build 1|Paintings are no longer available from the [[nether reactor]].}}
{{History||v0.15.0|snap=build 1|Paintings now have [[sound]]s when placed and broken.}}
{{History|pocket}}
{{History||1.0.7|Added new painting canvas 'Wither'.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Paintings can now be [[trading|bought]] from shepherd [[villager]]s.}}
{{History||1.17.0|snap=beta 1.17.0.50|The painting back texture has been updated to be in line with the texture update.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[Legacy Console Edition history of textures/Paintings]].}}
{{History||xbox=TU11|The limit for paintings in a world has been increased. 
|A message is now displayed when the maximum paintings are reached.}}
{{History||xbox=TU14|ps=1.04|Added new painting canvas 'Wither'.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for paintings.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Painting JE2 BE2.png|32px]] The [[item]] texture of paintings has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Painting JE1 BE1.png|32px]] Added paintings.
|There are currently 25 canvases, which can be viewed at [[New Nintendo 3DS Edition history of textures/Paintings]].}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* On April 26, 2011, Notch stated that the automapping code can be used to share custom paintings and books in the future.<ref>{{tweet|notch|62970142207913984|The auto mapping code can be used to share custom paintings and books in the future. There's a hard cap on 65536 of each/world, though|April 26, 2011}}</ref>
* The texture on the back of a painting is the same as the wooden planks texture, but with a yellowish color similar to that of [[chests]] (but slightly darker).
* The "Skull on Fire" painting contains a Minecraft world in the background, which is based on a screenshot taken by the artist in [[Java Edition Alpha v1.1.2 01|Alpha 1.1.2_01]] (or earlier) on October 12, 2010, at 13:22:49 (UTC+2).<ref>{{cite|url=https://web.archive.org/web/20220928041338/https://imgur.com/HVhrbnH|title=The original (never publicly shared before) screenshot that Kristoffer Zetterstrand took and based his painting on.|website=Imgur}}</ref>
**The seeds for this world are -1044887956651363087 and -6984854390176336655 (both are the same), standing at X=-249.65, Y=91, Z=-29.04.<ref>https://pastebin.com/fzAY9ES4</ref><ref>https://www.reddit.com/r/Minecraft/comments/iqg3ey/the_original_screenshot_seed_of_the_minecraft/</ref>
* The "Skull on Fire" painting's texture was added in [[Java Edition Beta 1.3|Beta 1.3]]. However, the code for paintings to randomly display the part of the [[Kz.png]] texture that was to be occupied by the Burning Skull painting was added earlier, in [[Java Edition Beta 1.2_01|Beta 1.2_01]]. As there was nothing on this part of the texture except for a purple background grid, this is what would be displayed if the painting was randomly chosen, until the Burning Skull painting texture was actually added.
* The original "Skull on Fire" painting was given to the winner of an official texture pack competition by Mojang.<ref>https://web.archive.org/web/20110110003612/http://www.webhallen.com:80/minecraft/</ref>

== Gallery ==
<gallery>
File:Notch Painting Screenshot.png|The first image of paintings released by [[Notch]].
File:Skull on Fire world.jpg|The original screenshot behind the "Skull on Fire" painting.
File:Burning Skull Render.jpg|A render of the "Skull on Fire" painting that [[Kristoffer Zetterstrand]] used as a reference image.
File:Skull on Fire IRL.jpg|The original "Skull on Fire" painting being painted.
File:Burning Skull JE1.png|The "Skull on Fire" painting as it appeared between versions [[Java Edition Beta 1.2_01|Beta 1.2_01]] and [[Java Edition Beta 1.2_02|Beta 1.2_02]], prior to its texture being added in [[Java Edition Beta 1.3|Beta 1.3]].
</gallery>

=== Renders ===
<gallery>
Alban.png | Albanian
Aztec.png | de_aztec
Aztec2.png | de_aztec
Bomb.png | Target Successfully Bombed
Kebab.png | Kebab med tre pepperoni
Plant.png | Paradisträd
Wasteland.png | Wasteland
Courbet.png | Bonjour Monsieur Courbet
Creebet.png | Creebet
Pool.png | The Pool
Sea.png | Seaside
Sunset.png | sunset_dense
Graham.png | Graham
Wanderer.png | Wanderer
Bust.png | Bust
Match.png | Match
Skull and Roses.png | Skull and Roses
Stage.png | The Stage Is Set
Void.png | The void
Wither (painting).png | Wither
Fighters.png | Fighters
Donkey Kong.png | Kong
Skeleton (painting).png | Mortal Coil
Burning Skull.png | Skull On Fire
Pigscene.png | Pigscene
Pointer.png | Pointer
Earth BE2.png | Earth
Fire BE2.png | Fire
Water BE2.png | Water
Wind BE2.png | Wind
</gallery>

== See also ==
* [[Item Frame]]
* [[Bedrock Edition unused features#Paintings|Unused paintings]]
* [[Kz.png]]
* [[Kristoffer Zetterstrand]]

== References ==
{{reflist}}

== External links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-painting Taking Inventory: Painting] – Minecraft.net on January 18, 2019

{{items}}
{{entities}}

[[cs:Obraz]]
[[de:Gemälde]]
[[es:Cuadro]]
[[fr:Tableau]]
[[hu:Festmény]]
[[it:Quadro]]
[[ja:絵画]]
[[ko:그림]]
[[nl:Schilderij]]
[[pl:Obraz]]
[[pt:Quadro]]
[[ru:Картина]]
[[th:ภาพวาด]]
[[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

Advertisement