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

Raw JSON text format

Revision as of 18:27, 22 April 2020 by Kappascopezz (talk | contribs) (Added confirmation request for 1.16 color format.)
Sign in to edit
For raw JSON text in Bedrock Edition, see Bedrock Edition raw JSON text format.

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.[needs testing]‌[upcoming: JE 1.16]
      Technically, "bold", "italic", "underlined", "strikethrough", and "obfuscated" are also accepted, but it is better practice to use the tags below for such formatting.
    •  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 you were 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 SNBT 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

Main article: Bedrock Edition raw JSON text format

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).

History

Java Edition
1.7.2
{{Extension DPL}}<ul><li>[[Blaze Powder|Blaze Powder]]<br/>{{Item‎
| image = Blaze Powder.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Blaze powder''' is an item made from a [[blaze rod]], which is dropped by a [[blaze]] when killed. Its main uses are to fuel [[brewing stand]]s, to brew [[strength]] [[potions]], and to make [[eyes of ender]] to take the player to [[the End]].

== Obtaining ==

=== Crafting ===
{{Crafting
|Blaze Rod
|Output= Blaze Powder,2
|type= Brewing
}}

== Usage ==

=== Crafting Ingredient ===

{{crafting usage}}

=== Brewing stand fuel ===
In addition to being a [[brewing]] ingredient, blaze powder is needed to fuel a [[brewing stand]]. Each piece of blaze powder can brew up to 20 batches of [[Potion|potions]].

=== Brewing ingredient ===
{{brewing
  |showname=1
  |head=1
  |Blaze Powder
  |Mundane Potion
  |base=Water Bottle
}}
{{brewing
  |foot=1
  |Blaze Powder
  |Potion of Strength
}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Blaze Powder
|spritetype=item
|nameid=blaze_powder
|id=429
|form=item
|foot=1}}

== Video ==

{{Video note|This video does not mention that blaze powder must be used to fuel [[brewing stand]]s.|minor}}

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

==History==
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Blaze Powder JE1.png|32px]] Added blaze powder.
|Blaze powder can be used to craft [[eyes of ender]] and [[magma cream]].}}
{{History|||snap=Beta 1.9 Prerelease 3|Blaze powder can now be [[brewing|brewed]] in a [[water bottle]] to create a [[mundane potion]], or in an [[awkward potion]] to create a [[potion of Strength]].}}
{{History||1.2.1|snap=12w04a|Blaze powder can now be used to craft [[fire charge]]s.}}
{{History||1.3.1|snap=1.3|[[File:Blaze Powder JE2 BE1.png|32px]] The texture of blaze powder has been changed.}}
{{History||1.9|snap=15w42a|Blaze powder is now required to operate a [[brewing stand]].}}
{{History|||snap=15w43a|Blaze powder now [[fuel]]s 20 operations rather than 30.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 377.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Blaze Powder JE2 BE1.png|32px]] Added blaze powder.
|Blaze powder can be used to craft [[magma cream]].
|Blaze powder is used as an ingredient to brew [[potion]]s.}}
{{History||v0.15.0|snap=build 1|Blaze powder is now used to craft [[fire charge]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Blaze powder is now used to craft [[eyes of ender]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Blaze powder is now required to operate a [[brewing stand]].}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Blaze Powder JE2 BE1.png|32px]] Added blaze powder.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|Blaze powder is now required to operate a [[brewing stand]].}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Blaze Powder JE2 BE1.png|32px]] Added blaze powder.}}
{{History|foot}}

== Issues ==
{{issue list}}

== See also ==
* [[The Nether]]
* [[Potions]]

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--blaze-powder Taking Inventory: Blaze Powder] – Minecraft.net on November 25, 2021

{{Items}}

[[Category:Renewable resources]]

[[cs:Ohnivý prach]]
[[de:Lohenstaub]]
[[es:Polvo de blaze]]
[[fr:Poudre de Blaze]]
[[hu:Őrlángpor]]
[[ja:ブレイズパウダー]]
[[ko:블레이즈 가루]]
[[nl:Blazepoeder]]
[[pl:Płomienny proszek]]
[[pt:Pó de blaze]]
[[ru:Огненный порошок]]
[[th:ผงปีศาจไฟ]]
[[zh:烈焰粉]]</li><li>[[Shulker Shell|Shulker Shell]]<br/>{{Item
| image = Shulker Shell.png
|type=
|renewable = Yes
| stackable =  Yes (64)
}}

{{about|the item that drops from the mob|the mob |Shulker|the storage block|Shulker Box}}

'''Shulker shells''' are [[item]]s dropped by [[shulker]]s that are used solely to craft [[shulker box]]es.

== Obtaining ==
=== Mob loot ===
{{IN|bedrock}}, [[shulker]]s drop 0-1 shulker shells. The maximum can be increased by 1 per level of [[Looting]], which is 0-4 shells with Looting III.

{{IN|java}}, shulkers have a 50% chance of dropping a shulker shell when killed. This is increased by 6.25% per level of [[Looting]], for a maximum of 68.75% with Looting III.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Shulker Shell
|spritetype=item
|nameid=shulker_shell
|id=566
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||1.11|snap=16w39a|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 450.}}
{{History||1.14|snap=18w43a|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}
{{History||1.17|snap=20w45a|When a shulker is hit by a shulker bullet, the shulker can spawn another shulker depending on the amount of shulkers in the area, making shulker shells [[renewable resource|renewable]].}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 1.0.0.1|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.
|Shulker shells currently have no purpose as [[shulker box]]es haven't been implemented yet.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Shulker shells can now be used to [[crafting|craft]] shulker boxes.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}
{{History||1.18.30|snap=beta 1.18.30.22|Shulkers now have a chance to spawn another shulker when hit by a shulker projectile, making shulker shells [[renewable resource|renewable]].}}

{{History|console}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History|foot}}

== Issues ==
{{Issue list}}

{{Items}}

[[de:Shulkerschale]]
[[es:Caparazón de shulker]]
[[fr:Carapace de Shulker]]
[[it:Guscio di shulker]]
[[ja:シュルカーの殻]]
[[ko:셜커 껍데기]]
[[nl:Shulkerschelp]]
[[pl:Skorupa Shulkera]]
[[pt:Casco de shulker]]
[[ru:Панцирь шалкера]]
[[th:เปลือกชัลเกอร์]]
[[zh:潜影壳]]</li></ul>
13w37aAdded /tellraw, the raw JSON text used to support this command.
1.8
{{Extension DPL}}<ul><li>[[Book|Book]]<br/>{{For}}
{{Item
| image = Book.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Books''' are items used in [[enchanting]] and [[crafting]].

== Obtaining ==

=== Block loot ===

Three books are dropped when a [[bookshelf]] is mined without [[Silk Touch]] or destroyed by an [[explosion]].

=== Crafting ===
{{crafting
|Paper
|Paper
|Paper
|Leather
|Output= Book
|type= Miscellaneous
}}

=== Chest loot ===

{{LootChestItem|book}}

=== Grindstones ===

Disenchanting an [[enchanted book]] at a [[grindstone]] yields a normal book and a small amount of experience.

=== Villager gifts ===

{{in|java}}, librarian [[villagers]] throw books at players under the [[Hero of the Village]] effect.

== Usage ==

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

=== Chiseled bookshelf ===
{{control|Use|text=Using}} the [[chiseled bookshelf]] while having a book in the main hand will put the book inside the chiseled bookshelf.

=== Enchanting ===
Books can be made into [[enchanted book]]s by enchanting them on [[enchanting table]]s.

=== Trading ===

Librarian [[villager]]s can buy a single book as part of an [[enchanted book]] trade.

Apprentice-level Librarian villagers have a {{frac|2|3}} chance to buy 4 books for an [[emerald]] {{in|java}}, and always offer the trade {{in|bedrock}}.

== Achievements ==
{{load achievements|Librarian;Enchanter}}


== Advancements ==
{{load advancements|Enchanter;The Power of Books}}

== Sounds ==
{{edition|java}}:
{{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 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 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}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Chiseled bookshelf insert1.ogg
|sound2=Chiseled bookshelf insert2.ogg
|sound3=Chiseled bookshelf insert3.ogg
|sound4=Chiseled bookshelf insert4.ogg
|source=block
|description=When a book is placed in a chiseled bookshelf
|id=insert.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound name=insertvaries>Can be 1.0, 0.85, or 1.1 for each sound</ref>}}
{{Sound table
|sound=Chiseled bookshelf pickup1.ogg
|sound2=Chiseled bookshelf pickup2.ogg
|sound3=Chiseled bookshelf pickup3.ogg
|source=block
|description=When a book is removed from a chiseled bookshelf
|id=pickup.chiseled_bookshelf
|volume=0.8
|pitch=''varies'' <ref group=sound name=pickupvaries>Can be 1.0, 0.8, or 1.1 for each sound</ref>
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Book
|spritetype=item
|nameid=book
|id=387
|itemtags=minecraft:bookshelf_books</code>
|form=item
|foot=1}}

== Video ==

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

== History ==

{{History|java alpha}}
{{History||v1.0.11|[[File:Book JE1 BE1.png|32px]] Added books.
|The only use of books is crafting [[bookshelves]], which are only used as a purely decorative [[block]] until [[Beta 1.9 Prerelease 3]].}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|Books are now found in the new [[stronghold]] library [[chest]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Books are now used to craft [[enchantment table]]s, gaining their first functional usage outside of decoration.}}
{{History||1.3.1|snap=12w17a|The crafting recipe is now shapeless, so books can now be crafted in the player's 2×2 [[crafting]] area, although the recipe now requires [[leather]]. Before this version, books were crafted with three [[paper]] sheets in a single column.
|A book can now be crafted into a [[book and quill]], which can be used to create [[written book]]s.}}
{{History|||snap=12w21a|Librarian [[villager]]s now [[trading|buy]] 11–12 books for 1 [[emerald]].}}
{{History|||snap=12w22a|Librarian villagers now [[trading|sell]] [[enchanted book]]s for 5–64 emeralds and 1 book.}}
{{History||1.4.6|snap=12w49a|Books can now be enchanted into [[enchanted book]]s, and then combined together in an [[anvil]] with a [[tool]] to then enchant it.}}
{{History||1.8|snap=14w02a|Librarian villagers now buy 8–10 books for 1 [[emerald]].}}
{{History||1.9|snap=15w43a|Average yield of books in [[stronghold]] library chests has been substantially increased.}}
{{History||1.12|snap=17w13a|Added the [[knowledge book]], a green-colored book that grants the [[player]] a recipe for [[crafting]].
|The recipe tab on the [[crafting table]] GUI uses a red-colored book.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 340.}}
{{History|||snap=18w11a|Books now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Book JE2 BE2.png|32px]] The texture of books has been changed.}}
{{History|||snap=18w48a|Books can now be obtain by disenchanting non-curse [[enchanted book]]s in a grindstone.|Books can now be found in chests in [[plains]] [[village]] houses.}}
{{History|||snap=18w50a|Books can now be found in chests in [[desert]] village houses.}}
{{History|||snap=19w13a|Librarian villagers now give books to players under the [[Hero of the Village]] effect.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Books now generate in [[ancient city]] chests.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Books can now interact with [[chiseled bookshelves]].}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Book JE1 BE1.png|32px]] Added books. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.0|Books can be used to craft [[bookshelves]].}}
{{History||v0.5.0|Books can now be obtained after activating the [[nether reactor]].}}
{{History||v0.12.1|snap=build 1|The crafting recipe for books now requires [[leather]]. Before this version, books were crafted with three [[paper]] sheets in a single column.
|Books are now used to craft [[enchanting table]]s.
|Books can now be enchanted into [[enchanted book]]s, and then combined together in an [[anvil]] with a [[tool]] to then enchant it.
|Books are no longer available from the [[nether reactor]].}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|Librarian villagers now [[trading|buy]] 8–10 books for 1 [[emerald]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|A book can now be crafted into a [[book and quill]], which can be used to create [[written book]]s.}}
{{History||1.4.0|snap=beta 1.2.14.2|Books can now be found inside of the map room [[chest]] in [[shipwreck]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Books can now be found in [[plains]] [[village]] chests.
|[[File:Book JE2 BE2.png|32px]] The texture of books has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Librarian [[villager]]s now [[trading|buy]] 4 books for an [[emerald]].}}
{{History||Wild Update<br>(Experimental)|link=Bedrock Edition 1.18.30|snap=beta 1.18.30.32|Books now generate in [[ancient city]] chests.}}
{{History||1.20<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|Books can now interact with [[chiseled bookshelves]].}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Book JE1 BE1.png|32px]] Added books.}}
{{History||xbox=TU14|ps=1.04|The crafting recipe for books now requires [[leather]]. Before this version, books were crafted with three [[paper]] sheets in a single column.}}
{{History|PS4}}
{{History||1.90|[[File:Book JE2 BE2.png|32px]] The texture of books has now been changed.}}

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

== Issues ==

{{issue list}}

== See also ==

* [[Enchanted Book]]
* [[Knowledge Book]]

{{Items}}

[[Category:Renewable resources]]

[[cs:Kniha]]
[[de:Buch]]
[[es:Libro]]
[[fr:Livre]]
[[hu:Könyv]]
[[it:Libro]]
[[ja:本]]
[[ko:책]]
[[nl:Boek]]
[[pl:Książka]]
[[pt:Livro]]
[[ru:Книга]]
[[th:หนังสือ]]
[[uk:Книга]] 
[[zh:书]]</li><li>[[Hopper|Hopper]]<br/>{{About|the block|the crash utility|Hopper (crash utility)}}
{{Block
|image=<gallery>
Hopper (D).png|Java
Hopper (D) BE.png|Bedrock
</gallery>
|extratext = View [[#Gallery|all renders]]
|transparent=Yes
|light=No
|tool=wooden pickaxe
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}
A '''hopper''' is a low-capacity storage [[block]] that can be used to collect [[item (entity)|item entities]] directly above it, as well as to transfer [[item]]s into and out of other containers. A hopper can be locked with [[Redstone Dust|redstone power]] to stop it from moving items into or out of itself.

== Obtaining ==
=== Breaking ===
To obtain a hopper, {{control|mine}} it with a [[pickaxe]]. Using any other item to mine a hopper drops only its contents.
{{breaking row|horizontal=1|Hopper|Pickaxe|Wood|foot=1}}

===Crafting===
A hopper can be crafted from 5 iron ingots and a chest.
{{Crafting
|A1= Iron Ingot
|C1= Iron Ingot
|A2= Iron Ingot
|B2= Chest
|C2= Iron Ingot
|B3= Iron Ingot
|Output= Hopper
|type= Redstone
}}

==Usage==
{{see also|Tutorials/Hopper}}
[[File:Hopper aligment.png|Hoppers can face down or sideways.|thumb]]

A hopper can be used as a container, as a crafting ingredient, and as a redstone component.

A hopper has an "output" tube at its bottom that can face down or sideways and provides a visual indication of which block the hopper is set up to drop its items into, if that block has an inventory. To place a hopper, use the {{control|Place Block}} control while aiming at the surface to which its output should face (Hoppers ''do not'' orient themselves automatically). To place a hopper directly on the face of an already interactable block, the player can {{control|sneak}} while placing the hopper. Attempting to place a hopper aimed on the bottom face of a block instead faces downward. With some blocks, such as the [[furnace]] and [[brewing stand]], the hopper has multiple uses. A hopper does not change direction after placement, and it is not attached to the container it faces; the container can be removed or replaced, and the hopper remains unchanged.

Hoppers cannot be moved by [[piston]]s.{{only|java}} Despite not being a solid block, attached blocks such as [[rail]]s, [[lever]]s, [[tripwire]] and [[redstone]] dust can be placed on top of hoppers, but not on their sides.

===Container===
[[File:Hopper GUI.png|thumb|176px|Hopper GUI showing the hopper's five slots of inventory at the top and the player's inventory below.]]

A hopper can be used as a container and has 5 slots of inventory space.

To open the hopper GUI, use the {{control|use item|text=Use Item/Place Block}} [[control]]. To move items between the hopper inventory and the player inventory or hotbar while the hopper GUI is open, drag or shift-click the items. To exit the hopper GUI, use the {{key|Esc}} key, B button or circle button, depending on the device.

By default, the GUI of a hopper is labeled "Item Hopper". A hopper's GUI label can be changed by naming the hopper in an [[anvil]] before placing it, or, {{in|java}}, by using the [[Commands#data|data]] command (for example, to label a hopper at (0,64,0) "Steve's Hopper", use <code>/data merge block 0 64 0 {CustomName:'"Steve's Hopper"'}</code>).

{{IN|java}}, a hopper's GUI can be "locked" (or subsequently unlocked) by setting the hopper's <code>Lock</code> tag with the [[Commands#data|data]] command. If a hopper's <code>Lock</code> tag is not blank, the hopper cannot be accessed except by players holding an item with the same name as the <code>Lock</code> tag's text. For example, to lock a hopper at (0,64,0) so that only players holding an item named "Steve's Key" can access the hopper, use <code>/data merge block 0 64 0 {Lock:"Steve's Key"}</code>.

===Crafting ingredient===
A hopper can be used to craft a [[minecart with hopper]].
{{crafting usage}}

===Redstone component===
{{see also|Redstone circuit|Redstone components#Hopper}}
[[File:Hopper logic flowchart.png|thumb|Flowchart of hopper logic]]

While a hopper is ''not'' powered by redstone signals, it operates with three functions:

*'''Collect''' [[Item (entity)|item entities]] (free-floating items in the world) into its inventory from the space above it
*'''Pull''' a single item into its inventory from a container above it
*'''Push''' a single item from its own inventory into a container it faces

A hopper first attempts to push any items inside it. Afterward, it checks if the block above it is a type of container. If so, it attempts to pull from it. Otherwise, the hopper attempts to collect item entities. Notably, hoppers can push to and pull from other hoppers, forming '''hopper pipes''' or '''hopper chains''', which allow transporting items across several blocks and are further discussed below.

====Redstone signals====
When a hopper receives a redstone signal (and is considered to be "activated"), all three functions stop. To avoid confusion over the terms "activated" and "deactivated", powered hoppers are often described as being '''locked''' and unpowered hoppers described as being '''unlocked'''. Hoppers can be powered by [[Redstone_mechanics#Power|soft powered]] blocks, meaning a [[redstone dust]] trail pointing into a block touching the hopper locks it just as effectively as a [[redstone block]] or any other [[Redstone components#Power components|power component]] touching the hopper. When the hopper is unlocked during a redstone tick, it does not push or pull/collect during the same tick, but has a delay of 1 redstone tick instead.

While a locked hopper does not push or pull/collect items, it may still receive items from [[dispenser]]s, [[dropper]]s and other hoppers, and may have its items pulled out by another hopper beneath it. Hence, the item flow in a horizontal hopper pipe may be stopped by locking just one of the hoppers, but stopping a vertical hopper pipe requires locking two adjacent hoppers at the same time, such that both the pushing of the top one and the pulling of the bottom one are stopped.  

A hopper does not output any redstone signals by itself, but its fullness can be read using a [[Redstone Comparator|redstone comparator]], which needs to be placed next to it and facing away from it. An empty hopper outputs a signal strength of 0 and a completely full hopper outputs a signal strength of 15. Notably, a single stackable item (16 or 64) outputs a signal strength of 1 and a single non-stackable item outputs a signal strength of 3.  

{{IN|Java}}, if the hopper being read is part of a horizontal hopper pipe, the comparator can individually read each item passing through the chain, because items are pushed through the hoppers one by one at a speed that is manageable by the comparator. If there is an uninterrupted stream of items, the comparator does not switch off in between items. On the other hand, in a vertical hopper pipe, some of the hoppers may never produce a reading above 0, even with a continuous stream of items, because pushes and pulls both occur in the same game tick: The hoppers' items get pulled out a single game tick after they're pushed in and this isn't measurable by a comparator, because comparators need measurements lasting at least 1.5 redstone ticks to produce a reading.  

====Collecting items====
A hopper collects items dropped on top of it if the space above the hopper not occupied by a storage block. Items are gathered from the entire 1 block space above the hopper, meaning that items sitting on partial blocks such as [[soul sand]] directly above a hopper can be collected.<ref>https://bugs.mojang.com/browse/MCPE-55824</ref> It is also possible for a hopper to collect items from inside a full, solid block, a situation that might come from items rising up through solid blocks or being [[commands/summon|summoned]]. Item entities are not collected when they are outside of the collection area however; for example, items on top of a stone block directly above a hopper are not collected. Collected items are placed in the leftmost empty slot of a hopper's inventory.

{{IN|java}}, if there is no container above the hopper, then the hopper collects dropped items in the order in which they landed on the hopper. This order is remembered even while a hopper is locked. For instance, if a hopper is locked under a carpet while a fully equipped [[armor stand]] is broken above it, then it always collects items in this order when it is unlocked: [[armor stand]], [[boots]], [[leggings]], [[chestplates]], [[helmets]]. This is due to the order in which these items land.{{Verify|Wouldn't this be due to the order in which the game creates the item entities that drop drop from the armor stand?}} {{IN|Bedrock}}, hoppers do not remember the order in which items land on the hopper. Instead, hoppers with multiple dropped items above them collect the items in the order in which they entered the chunk in which the hopper is located. Items that drop from a broken armor stand are collected in a random order.<ref>https://bugs.mojang.com/browse/MCPE-120586</ref>

Hoppers usually check for dropped items every [[game tick]] and they can collect items even before they are picked up by a [[player]]{{Verify|Does this happen always, or sometimes, and in Java only or also in Bedrock?}} or destroyed by [[lava]]. However, {{In|Bedrock}} hoppers have a "collection cooldown" time. After collecting an item (or stack of items), a hopper waits {{tooltip|4 redstone ticks|8 game ticks}} (0.4 seconds, barring lag) before attempting to collect again.

Hoppers collect groups of items all at once rather than collecting them as single items one at a time. As a result, hoppers can collect item entities much faster than they can pull items from a container. Pulling from a moving [[minecart with chest]] or [[minecart with hopper]] is even slower, since the minecart is not always above the hopper.

====Pushing and pulling items====
A hopper with a storage container above it (such as a [[furnace]], [[chest]], [[dropper]], [[composter]], or another hopper) attempts to pull from the container instead of checking for floating items above it, and hence can not collect items.  A hopper always tries to push or pull items using the leftmost available slot. When a hopper is removing items from a chest, the items disappear from left to right. Similarly, when filling up a chest, the chest fills up from left to right. Hoppers prioritize pulling from the first slot of a container over pulling into the first hopper slot. If a hopper has stone in its first slot and nothing in its second while the container it is pulling from has chicken in its first slot but stone in the second, the hopper pulls the chicken from the first slot of the container into its empty second slot. However, if the hopper is unable to pull the chicken, such as if all slots are filled with stone, the hopper pulls the stone from the second slot of the container instead. Similarly, hoppers prioritize pushing from their first slot over pushing into the first slot of a container. If a hopper has stone in its first slot and chicken in its second while the container it is pushing to has chicken it its first slot but stone in the second, the hopper pushes stone from its first slot into the second slot of the container.

In [[Java Edition]] the checks done by a hopper while pulling generally require less processing than the checks done by a hopper attempting collection. Therefore, a chain of hoppers topped with storage containers rather than air/solid blocks has better performance (measured as milliseconds of processing per tick) and lower potential for processing lag. <ref name=":0">https://www.youtube.com/watch?v=LC3ZOOI1Rf0</ref> The performance improvement achieved is correlated with the number of storage slots the container has. Placing composters (with no storage slots but still with custom output logic) on top of hoppers provide the greatest efficiency, while double chests actually degrade performance, even when sharing each double chest across two hoppers.<ref name=":0" /> In [[Bedrock Edition]] a chain of hoppers with air or non-container blocks on top has better performance than a chain of hoppers topped by container blocks.<ref>https://cdn.discordapp.com/attachments/715523208530362389/890030941282631741/Redstone_MSPT_measure.xlsx</ref> This may be because, even though hoppers with containers on top do not check for items, they do check for hopper-minecarts and chest-minecarts to pull from, and that involves scanning the chunk entity list.<ref>{{bug|MCPE-109449}}</ref>

{{Schematic|caption='''Push then Pull'''
Chest A is full of items while the hopper and Chest B are empty.
|ch-$+A||-
|ho-$e|ch-$+B
}}

Item pushes and pulls are processed in the same game tick, but pushes are processed before pulls. In the schematic, the empty hopper first pulls an item from chest A as it cannot push anything into chest B. After the cooldown, the hopper first pushes its item into chest B before pulling another item from chest A, both pushing and pulling in the same tick, and the process repeats. The hopper stops pulling when A is empty, and stops pushing when B becomes full.

Hoppers also have a "transfer cooldown" time. After pulling and/or pushing items, a hopper waits {{tooltip|4 redstone ticks|8 game ticks}} (0.4 seconds, barring lag) before pulling or pushing again (a transfer rate of 2.5 items per second, barring lag). A hopper that has an item pushed into it from another hopper also starts a 4 tick cooldown period, regardless of whether it pushed or pulled items itself. Item entities can be collected at any time without affecting the transfer cooldown time. The transfer cooldown and the Bedrock Edition collection cooldown are independent of each other.

====Container interactions====
Some [[container]]s interact with hoppers in specific ways:

:;{{BlockLink|Composter}}
::Hoppers above composters can push compostable items into the composter's top face with a chance of increasing the level of the composter as if the player used the item on the composter. Items that are not compostable cannot be pushed into the composter. Hoppers below the composter can pull [[bone meal]] when the composter is in stage 8, emptying the composter and resetting it to stage 0. Hoppers to the side of a composter do not interact with it.

:;{{BlockLink|Brewing Stand}}
::A working hopper on the top face of a brewing stand deposits only into the ingredient slot and it can push only valid [[brewing]] ingredients. A hopper on side face of a brewing stand can deposit only [[blaze powder]] or filled bottles into the three brew slots. A hopper underneath a brewing stand always extracts from the three brew slots, whether brewing is finished or not—The hopper must be locked to allow potions to finish brewing.

:;{{BlockLink|Chest}}
:;{{BlockLink|Trapped Chest}}
::Large chests and large trapped chests are treated as a single container: A hopper depositing into a large chest fills up the entire chest and a hopper underneath a large chest empties the entire chest. Trapped chests being accessed by a player lock any adjacent hoppers, per the standard behavior of a hopper next to an active power source.

:;{{BlockLink|Furnace}}
:;{{BlockLink|Blast Furnace}}
:;{{BlockLink|Smoker}}
::A working hopper pointing into top of a furnace deposits only into the ingredient slot. It can push any item, including items that can't be smelted by the furnace. A hopper pointing into the side of a furnace deposits into the fuel slot, and only items that are usable as fuel. A hopper below a furnace pulls everything from the output slot and empty [[bucket]]s from the fuel slot left over from using [[lava bucket]]s as fuel. When a hopper removes items from a furnace, the experience points are 'stored' in the furnace until a player removes at least one smelted item, or the furnace block is broken.

:;{{BlockSprite|Hopper}} Hopper
::A sequence of three or more hoppers, each pushing items into the next, is called a '''hopper pipe'''. Working horizontal hopper pipes simply push items into each other at the expected rate of 2.5 items per second, but vertical hopper pipes are more complicated, as the hoppers are trying both to pull and to push. When a vertical pipe pulls from a single container, it simply transfers items at 2.5 items per second because the transfer rate is limited by the first hopper pulling items from the container. If a ''stack of items'' is in a vertical pipe, the items can be transferred twice as fast, because the hopper with the item stack is pushing items down while the hopper below it is also pulling items down.

:;{{EntityLink|Minecart with Chest}}
:;{{EntityLink|Minecart with Hopper}}
::Unlocked hoppers fill chest minecarts and hopper minecarts if any part of the entity's hitbox is within the hopper's target block-space. Hopper minecarts try to pull items from the hopper at high speed. Hoppers can pull items from minecarts above them so rails can be placed directly on the top faces of a hoppers. If a [[detector rail]] is in the right position, it could lock the hopper per standard redstone-hopper behavior.

:;{{BlockLink|Jukebox}}
::Hoppers can insert [[music disc]]s into jukeboxes, and extract the music discs after they finish playing.

:;{{BlockLink|Shulker Box}}
::Hoppers cannot put shulker boxes into other shulker boxes. This allows for the creation of certain [[Tutorials/Hopper#Potions and shulker boxes|item filters]].
::Otherwise, hoppers interact with shulker boxes normally.

:;{{BlockLink|Lectern}}
::Hoppers cannot remove or place books on lecterns. The redstone pulse emitted from a lectern when a page is turned can temporarily lock hoppers.

:;{{BlockLink|Ender Chest}}
::Hoppers cannot interact with ender chests in any way.

:;{{BlockLink|Barrel}}
:;{{BlockLink|Dispenser}}
:;{{BlockLink|Dropper}}
:;{{EntityLink|Boat with Chest}}
::Hoppers interact normally with barrels, dispensers, droppers, and boats with chests.

:;{{BlockLink|Chiseled Bookshelf}}
::Hoppers and minecart with hoppers can insert and remove books from the bookshelf. As with any other container, items are taken from the first slot that has an item that can fit in the hopper and are inserted into the first empty slot.

==Sounds==
===Generic===
{{Sound table/Block/Metal}}
===Unique===
{{Edition|Java}}:
{{Sound table
|sound=Door close.ogg
|sound2=Door open.ogg
|subtitle=Chest locked<ref group=sound name=lock>{{Bug|MC-98316||Wrong subtitles caused by missing distinction}}</ref>
|source=block
|description=When a player attempts to open a hopper locked using the {{nbt|string|Lock}} tag
|id=block.chest.locked|idnote=<ref group=sound name=lock/>
|translationkey=subtitles.block.chest.locked|translationkeynote=<ref group=sound name=lock/>
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}: ''None''

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Hopper
|spritetype=block
|nameid=hopper
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=hopper
|spritetype=block
|nameid=hopper
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Hopper
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=hopper
|spritetype=block
|nameid=hopper
|id=154
|form=block
|itemform=item.hopper}}
{{ID table
|displayname=Item
|spritename=hopper
|spritetype=item
|nameid=hopper
|id=527
|form=item
|translationkey=tile.hopper.name
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=hopper
|spritetype=block
|nameid=Hopper
|foot=1}}

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

{{/BS}}

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

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

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

==Achievements==
{{load achievements|Freight Station;Smelt Everything}}

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

==History==
{{History|java}}
{{History||1.5|snap=13w01a|[[File:Hopper (D) JE1.png|32px]] [[File:Hopper (N) JE1.png|32px]] [[File:Hopper (E) JE1.png|32px]] [[File:Hopper (S) JE1.png|32px]] [[File:Hopper (W) JE1.png|32px]] [[File:Hopper (U) JE1.png|32px]] Added hoppers.
|Hoppers with the [[damage]] value of 1, which are obtainable only through world editing, visually point in no direction. They functionally push items upward, however the behavior is inconsistent.
|[[File:Hopper (item) JE1.png|32px]] There is currently a temporary "work in progress" sprite for hoppers in the [[inventory]].
|Hoppers can be [[crafting|crafted]] from a [[chest]] and [[stone]] blocks with the following recipe:
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |A1= Stone
  |C1= Stone
  |A2= Stone
  |B2= Chest
  |C2= Stone
  |B3= Stone
  |Output= Hopper
}}
{{!}}}
}}
{{History|||snap=13w01b|[[Rail]]s can now be placed on top of hoppers. 
|Hoppers no longer load [[item]]s into [[minecart]]s without [[chest]]s.}}
{{History|||snap=13w02a|[[File:Hopper (item) JE2 BE1.png|32px]] The [[inventory]] sprite of hoppers has been changed.
|[[File:Hopper (item) 13w02a.png|32px]] However, the [[item]] of hoppers appears bugged if [[drops|dropped]] or placed in an [[item frame]].<ref>{{bug|MC-6737}}</ref> This may be due to the game attempting to pull the item sprite from the hopper's equivalent spot in <samp>[[stitched_terrain.png]]</samp> (compare files: [[:File:13w02a stitched terrain.png|terrain]], [[:File:13w02a stitched items.png|items]]), a region which contains parts of the oak planks, end stone and iron bars textures.
|Applying a [[redstone]] signal to a hopper now deactivates the hopper until the signal is removed.
|Hoppers can no longer be used as [[fuel]] in a [[furnace]].
|Hoppers are now [[crafting|crafted]] using 5 [[iron ingot]]s rather than 5 [[stone]] blocks.
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting
|A1= Iron Ingot
|C1= Iron Ingot
|A2= Iron Ingot
|B2= Chest
|C2= Iron Ingot
|B3= Iron Ingot
|Output= Hopper
}}
{{!}}}
|Hoppers now pull only from the output slot of [[furnace]]s.
|Hoppers now output 1 signal strengh per 1/3 of a stack (21 [[item]]s) when interacting with a [[redstone comparator]].
|[[File:Hopper (D) JE2.png|32px]] [[File:Hopper (N) JE2.png|32px]] [[File:Hopper (E) JE2.png|32px]] [[File:Hopper (S) JE2.png|32px]] [[File:Hopper (W) JE2.png|32px]] [[File:Hopper (U) JE2.png|32px]] The texture of hoppers has been given a unique texture. Hoppers no longer use the [[cauldron]] texture. Note that the top texture does not rotate with facing direction.
|The preferred tool is now a pickaxe, rather than the axe.}}
{{History|||snap=13w02b|Hoppers now treat large [[chest]]s properly, no longer needing two hoppers connected to them to fill up the entire [[inventory]].
|Hoppers no longer take [[item]]s from containers when powered via a [[redstone]] current.
|Hoppers now display correctly as a [[drops|dropped]] or [[item frame|frame]] [[item]].}}
{{History|||snap=13w03a|Hoppers are now used to [[crafting|craft]] a [[minecart with hopper]].
|Hoppers can now empty a [[minecart with hopper]].}}
{{History|||snap=13w04a|The transfer rate of hoppers has been changed from 7 to 8 [[game tick]]s per [[item]] (2.5 items per second).}}
{{History||1.5.1|snap=pre|Hoppers now take empty [[bucket]]s out of furnace fuel slots.}}
{{History||1.7.2|snap=release|[[File:Hopper (D) JE3.png|32px]] [[File:Hopper (N) JE3.png|32px]] [[File:Hopper (E) JE3.png|32px]] [[File:Hopper (S) JE3.png|32px]] [[File:Hopper (W) JE3.png|32px]] [[File:Hopper (U) JE3.png|32px]] The UV of all blocks is broken on certain sides as a result of {{bug|MC-37106}} (few cases are listed on the wiki so far - this is a future project). This includes hoppers.}}
{{History||1.7.4|snap=13w47a|[[File:Hopper (D) JE4.png|32px]] [[File:Hopper (N) JE4.png|32px]] [[File:Hopper (E) JE4.png|32px]] [[File:Hopper (S) JE4.png|32px]] [[File:Hopper (W) JE4.png|32px]] [[File:Hopper (U) JE4.png|32px]] MC-37106 has been fixed, reverting hoppers to their pre-1.7.2 appearences.}}
{{History|||snap=13w48a|This version fixed {{bug|MC-190}}, which hoppers were allegedly subject to since their introduction. However, a comparison of hopper UV in 13w02a and 14w08a failed to reveal any visible differences, even accounting for the example images on the ticket. More research is needed on this matter.}}
{{History||1.8|snap=?|Hoppers no longer generate [[multiplayer]] lag when idle.}}
{{History|||snap=14w10a|[[File:Hopper (D) JE5.png|32px]] [[File:Hopper (N) JE5.png|32px]] [[File:Hopper (E) JE5.png|32px]] [[File:Hopper (S) JE5.png|32px]] [[File:Hopper (W) JE5.png|32px]] [[File:Missing Model JE2.png|32px]] Hoppers now use block models rather than having a hardcoded shape. This brings multiple changes: the inside texture now rotates with the hopper rather than being constant, the inside planes of hoppers are now shaded/have ambient occlusion, and some minor UV changes have occurred, notably on the smallest cuboid. The directionless hopper also [[Missing model|no longer has a model]].}}
{{History|||snap=14w26a|The directionless hopper has been removed.}}
{{History|||snap=14w31a|Hoppers now no longer use wood [[sound]]s.<ref>{{bug|MC-5991}}</ref>}}
{{History||1.9|snap=15w33c|A hopper now generates as a part of the [[end ship]] in the [[end city|end cities]].}}
{{History|||snap=15w41a|End ships no longer contain a hopper.}}
{{History|||snap=15w43a|[[Loot table]]s have been added; hoppers can now use loot tables.}}
{{History|||snap=15w43c|[[File:Hopper (D) JE6.png|32px]] [[File:Hopper (N) JE6.png|32px]] [[File:Hopper (E) JE6.png|32px]] [[File:Hopper (S) JE6.png|32px]] [[File:Hopper (W) JE6.png|32px]] The UV on the hopper model has changed, resulting in minor differences, particularly to the smallest cuboid. This is likely due to the fix for {{bug|MC-73401}}.}}
{{History|||snap=15w44a|[[File:Hopper (D) JE7.png|32px]] [[File:Hopper (N) JE7.png|32px]] [[File:Hopper (E) JE7.png|32px]] [[File:Hopper (S) JE7.png|32px]] [[File:Hopper (W) JE7.png|32px]] A mapping issue introduced in the previous snapshot for the sides of the large funnel region has been fixed. This may be due to the fix for {{bug|MC-50344}}.}}
{{History||1.9.1|snap=pre1|A hopper can now push into and pull [[item]]s from a blocked [[chest]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[block]]'s numeral ID was 154.}}
{{History||1.14|snap=18w43a|[[File:Hopper (D) JE8.png|32px]] [[File:Hopper (N) JE8.png|32px]] [[File:Hopper (E) JE8.png|32px]] [[File:Hopper (S) JE8.png|32px]] [[File:Hopper (W) JE8.png|32px]]<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History|||snap=19w03c|Hoppers now use correct cullface arguments, and some redundant faces have also been deleted.}}
{{History||1.19|snap=22w13a|Hoppers no longer drop when breaking a [[minecart with hopper]].}}
{{History||1.19.4|snap=23w07a|Hoppers can now interact with jukeboxes.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers. Upward hoppers also exist.}}
{{History||v0.15.0|snap=build 1|Hoppers can now be moved by [[piston]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Hopper (D) BE.png|32px]] [[File:Hopper (N) BE.png|32px]] [[File:Hopper (E) BE.png|32px]] [[File:Hopper (S) BE.png|32px]] [[File:Hopper (W) BE.png|32px]] [[File:Hopper (U) BE.png|32px]]<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History||1.19.70|snap=beta 1.19.70.20|Hoppers can now collect items through all blocks that have a lower height than a full block.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Hopper (D) JE8.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE3 BE2.png|32px]] The textures of hoppers have been changed.}}
{{History||ps=1.91|Hoppers can now fill [[composter]]s.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Hopper (D) JE2.png|32px]]{{verify|Is this model correct?}}<br>[[File:Hopper (item) JE2 BE1.png|32px]] Added hoppers.}}
{{History|foot}}

==Issues==
{{Issue list}}

==Trivia==
* A [[wikipedia:Hopper (particulate collection container)|real-world hopper]] is a large, pyramidal or cone-shaped container used in industrial processes to hold particulate matter, like dust, gravel, nuts, seeds, etc., and can then dispense them from the bottom.
* A hopper can transfer 9000 items per hour, or 150 items per minute.

==Gallery==
=== Renders ===
<gallery>
Hopper (N).png
Hopper (E).png
Hopper (S).png
Hopper (W).png
</gallery>
<gallery>
Hopper (N) BE.png
Hopper (E) BE.png
Hopper (S) BE.png
Hopper (W) BE.png
</gallery>

=== Screenshots ===
<gallery>
File:Hopper screenshot 1.png|In snapshot 13w01a, the hopper item uses a 'WIP' sprite, though the item still read "Hopper".
File:13w02a Banner.png|The 13w02a Banner includes a [[minecart with TNT]]  and a hopper.
</gallery>

==References==
{{Reflist}}

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

[[Category:Mechanisms]]
[[Category:Redstone mechanics]]
[[Category:Mechanics]]
[[Category:Storage]]
[[Category:Utility blocks]]
[[Category:Manufactured blocks]]
[[Category:Block entities]]

[[cs:Násypka]]
[[de:Trichter]]
[[el:Hopper]]
[[es:Tolva]]
[[fr:Entonnoir]]
[[it:tramoggia]]
[[ja:ホッパー]]
[[ko:호퍼]]
[[nl:Trechter]]
[[pl:Lej]]
[[pt:Funil]]
[[ru:Загрузочная воронка]]
[[uk:Лійка]]
[[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>[[Glass Bottle|Glass Bottle]]<br/>{{about|the empty bottle||Bottle}}

{{Item
| image = Glass Bottle.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''glass bottle''' is an [[item]] that can hold [[water]], [[potion]]s, [[Honey Bottle|honey]], or [[dragon's breath]].

== Obtaining ==

Glass bottles can be obtained by crafting, drinking from bottles, [[fishing]], or from [[witch]] drops.

=== Crafting ===

{{Crafting
|A2= Glass
|C2= Glass
|B3= Glass
|Output= Glass Bottle,3
|type= Brewing
}}

=== Drinking ===

Drinking a [[potion]] or [[Honey Bottle|honey bottle]] returns the empty glass bottle. Throwing a splash potion or a lingering potion does not return a glass bottle, but brewing a lingering potion gives back a glass bottle.

=== Mob loot ===

[[Witch]]es have a chance of dropping 0–6 glass bottles upon death. This is increased by 3 per level of [[Looting]], for a maximum of 0–15 glass bottles.

=== Mud ===

{{control|Using}} a [[water bottle]], [[splash water bottle]] or [[lingering water bottle]] on [[dirt]], [[coarse dirt]] or [[rooted dirt]] will transforming it into a [[mud]] block, at the same time leaving the player with an empty glass bottle.

=== Cauldrons ===

{{control|Using}} a water bottle (or, {{in|bedrock}}, a potion, splash potion, or lingering potion) on a [[cauldron]] that is not yet full adds that liquid to the cauldron, leaving the player with an empty glass bottle.

== Usage ==

Glass bottles can be filled to make [[water bottle]]s, which can then be used to [[brew]] items with a [[brewing stand]]. Glass bottles are also used to hold the resulting [[potion]].

=== Collecting liquids ===

==== Water ====
A bottle may be filled with water by holding it in the hand and {{control|using}} it on a [[water]] source block or a [[cauldron]] that has water in it. It can also be filled using a waterlogged block.{{only|java}}<ref>{{bug|MCPE-83420}}</ref>

Also, a bottle may be filled by powering a [[dispenser]] containing a bottle and pointed at a water source block. This does not work with cauldrons.<ref>{{bug|MC-165196|||Invalid}}</ref>

If filled via a water source, the water is unaffected. If filled via a cauldron, {{frac|1|3}} of the water in the cauldron is removed. Therefore, using a cauldron to fill water bottles is inefficient, except in [[the Nether]] where it is normally the only way to fill bottles.

==== Potion ====
{{IN|bedrock}}, a bottle may be filled with potion by {{control|using}} it on a [[cauldron]] containing potion. When the bottle is filled, {{frac|1|3}} of the cauldron's potion is removed.

==== Honey ====
If a [[beehive|bee nest]] or [[beehive]] is full, the player can {{control|use}} a glass bottle on the block, or may power a [[dispenser]] that contains a bottle and is pointed at the block, which empties the block and creates a [[honey bottle]]. Honey bottles can also be emptied by using them in crafting recipes (such as [[sugar]] or [[honey block]]). However, a lingering potion use on tipped arrow recipe does not give the bottle back.

==== Dragon's breath ====
{{control|Using}} a glass bottle in clouds emitted when the [[ender dragon]] breathes or shoots a [[dragon fireball]] fills the bottle with [[dragon's breath]].

When put 2 or more dragon's breath in the brewing stand, after the brewing process, a glass bottle will drop as an [[Item (entity)|entity]]. However, if put only 1 dragon's breath in the brewing stand, after the brewing process, the glass bottle is consumed and cannot be retrieved.<ref>{{bug|MC-259583}}</ref>

=== Trading ===

Expert-level cleric [[villager]]s have a 50% chance to buy 9 glass bottles for one [[emerald]] as part of their trade.{{only|bedrock}}

Expert-level cleric villagers have a {{frac|2|3}} chance to buy 9 glass bottles for one emerald.{{only|java}}

=== Crafting ingredients ===
{{Crafting usage|Glass Bottle}}

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|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 bottle is filled with a liquid from a cauldron, or honey from a bee nest or beehive
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with water from a water source
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=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 dragon breath1.ogg
|sound2=Bottle fill dragon breath2.ogg
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with dragon's breath
|id=item.bottle.fill_dragonbreath
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|java}}:
{{Sound table
|type=bedrock
|rowspan=4
|sound=Water Splash Old.ogg
|source=block
|description=When water from a bottle is placed in a cauldron<wbr><ref group=sound name=potionsplash>{{Bug|MCPE-174867}}</ref>
|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
|source=block
|description=When a bottle is filled with a potion from a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.fillpotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|source=block
|description=When a potion bottle is emptied into a cauldron<wbr><ref group=sound name=potionsplash/>
|id=cauldron.takepotion
|volume=0.1
|pitch=1.0}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|source=sound<!--bottle-->
|description=When a bottle 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 bottle is filled<wbr>{{Upcoming|BE 1.20.40}}
|id=bottle.fill
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|source=block
|description=When a bottle is filled with honey from a bee nest or beehive<wbr><ref group=sound>{{Bug|MCPE-53881}}</ref>
|id=bucket.fill_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Bottle fill dragon breath1.ogg
|sound2=Bottle fill dragon breath2.ogg
|source=sound
|description=When a bottle is filled with dragon's breath
|id=bottle.dragonbreath
|volume=0.7<wbr>{{Until|BE 1.20.40}}<br>1.0<wbr>{{Upcoming|BE 1.20.40}}
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Glass Bottle
|spritetype=item
|id=427
|nameid=glass_bottle
|form=item
|foot=1}}

== Achievements ==

{{Load achievements|You Need a Mint;Local Brewery;Bee Our guest}}

== Advancements ==
{{load advancements|Local Brewery;You Need a Mint;Bee Our Guest}}

== History ==
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History|||snap=Beta 1.9 Prerelease 3|[[File:Water Bottle JE1 BE1.png|32px]] Glass bottles have been given their sole function of picking up [[water]] for the [[brewing]] of [[potion]]s.}}
{{History||1.4.2|snap=12w38b|[[Witch]]es now have a chance of [[drops|dropping]] glass bottles upon [[death]].}}
{{history||1.9|snap=15w33a|[[File:Dragon's Breath JE1 BE1.png|32px]] Glass bottles can now be used to obtain [[dragon's breath]].}}
{{history|||snap=15w43a|A glass bottle can be found in the [[brewing stand]] in an [[igloo]] basement.}}
{{history|||snap=15w43c|The glass bottle has been removed from igloo basements.}}
{{History|||snap=15w50a|Added [[sound]]s: <code>item.bottle.fill</code> and <code>item.bottle.fill_dragonbreath</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 374.}}
{{History||1.14|snap=18w43a|[[File:Glass Bottle JE2 BE2.png|32px]] [[File:Water Bottle JE2 BE2.png|32px]] [[File:Dragon's Breath JE2 BE2.png|32px]] The textures of glass bottles, [[water bottle]]s and [[dragon's breath]] have been changed.}}
{{History|||snap=19w11a|Cleric [[villager]]s now [[trading|buy]] glass bottles.}}
{{History||1.15|snap=19w34a|[[File:Honey Bottle JE1.png|32px]] Glass bottles can now be used to collect [[Honey Bottle|honey]].
|[[Dispenser]]s may now use glass bottles to collect [[water]] and honey.}}
{{History|||snap=19w46a|Using glass bottles to collect honey now unlocks the [[Bee Our Guest]] advancement.}}
{{History||1.19|snap=22w11a|Converting [[dirt]], [[coarse dirt]] or [[rooted dirt]] into [[mud]] using a [[water bottle]], [[splash water bottle]] or [[lingering water bottle]] now leaves the player with an empty glass bottle.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History||v0.14.0|snap=build 1|Glass bottles can now be used to empty [[cauldron]]s filled with [[water]] or [[potion]]s.
|Glass bottles can now be dropped by [[witch]]es.
|Potions and [[splash potion]]s can now be used to fill cauldrons, which turns them into glass bottles.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Dragon's Breath JE1 BE1.png|32px]] Glass bottles can now be used to obtain [[dragon's breath]].
|[[Lingering potion]]s can now be used to fill [[cauldron]]s, which turns them into glass bottles.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Glass Bottle JE2 BE2.png|32px]] The texture of glass bottles has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Glass bottles can now be [[trading|sold]] to cleric [[villager]]s.}}
{{History||1.14.0|snap=beta 1.14.0.1|[[File:Honey Bottle BE1.png|32px]] Glass bottles can now be used to collect [[Honey Bottle|honey]].
|[[Dispenser]]s may now use glass bottles to collect [[water]] and honey.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History|PS4}}
{{History||1.90|[[File:Glass Bottle JE2 BE2.png|32px]] The texture of glass bottles has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Glass Bottle JE1 BE1.png|32px]] Added glass bottles.}}
{{History||1.7.10|[[File:Dragon's Breath JE1 BE1.png|32px]]  Glass bottles can now be used to obtain [[dragon's breath]].}}
{{history|foot}}

== Issues ==
{{issue list}}

==References==
{{Reflist}}

{{Items}}

[[cs:Lahvička]]
[[de:Glasflasche]]
[[es:Frasco de cristal]]
[[fr:Fiole]]
[[hu:Üvegpalack]]
[[it:Ampolla]]
[[ja:ガラス瓶]]
[[ko:유리병]]
[[nl:Glazen fles]]
[[pl:Szklana butelka]]
[[pt:Frasco]]
[[ru:Колба]]
[[zh:玻璃瓶]]
[[Category:Renewable resources]]</li><li>[[Super Fertilizer|Super Fertilizer]]<br/>{{education feature}}
{{Item
| image = Super Fertilizer.png
| renewable = No
| stackable = Yes (64)
}}
'''Super fertilizer''' is a powerful form of [[bone meal]] that is created using ammonia and phosphorus.

== Obtaining ==

=== Lab table ===
{| class="wikitable"
! Result
! Materials Needed
|-
!rowspan=2|{{slot|Super Fertilizer}}<br>[[Super Fertilizer]]
|{{slot}}{{slot|Ammonia|link=Compound}}{{slot|Phosphorus|link=Element}}{{slot}}
|-
|<center>[[Compound|Ammonia]], [[Element|Phosphorus]]</center>
|}

== Usage ==

Super fertilizer can be used in the same way as normal bone meal. It produces more flowers in a larger area when used on [[grass block]]s compared to bone meal. When super fertilizer is used on a [[sapling]], a tree is instantly grown after one use, instead of multiple uses as with bone meal. Super fertilizer matures crops with just one single use.

Note that super fertilizer doesn't instantly a hanging [[mangrove propagule]], likely due to a bug.

== Sounds ==
{{Sound table
|type=bedrock
|sound=Gravel hit1.ogg
|sound2=Gravel hit2.ogg
|sound3=Gravel hit3.ogg
|sound4=Gravel hit4.ogg
|source=player
|description=When super fertilizer is created by a [[lab table]]
|id=step.gravel
|volume=1.0
|pitch=0.2/0.4}}
{{Sound table
|sound=Bonemeal1.ogg
|sound2=Bonemeal2.ogg
|sound3=Bonemeal3.ogg
|sound4=Bonemeal4.ogg
|sound5=Bonemeal5.ogg
|description=When super fertilizer is successfully used
|source=Blocks
|id=item.bone_meal.use
|foot=1}}

== Data values ==
=== ID ===
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Super Fertilizer
|spritetype=item
|nameid=rapid_fertilizer
|id=597
|form=item
|foot=1}}

== History ==
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:Super Fertilizer BE1.png|32px]] Added super fertilizer.}}

{{History|education}}
{{History||1.0.27|[[File:Super Fertilizer BE1.png|32px]] Added super fertilizer.}}
{{History|foot}}

{{items}}
{{Education Edition}}

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

[[de:Superdünger]]
[[ja:スーパー肥料]]
[[ko:슈퍼 비료]]
[[lzh:神肥]]
[[pl:Supernawóz]]
[[pt:Super fertilizante]]
[[uk:Супердобриво]]
[[zh:超级肥料]]</li></ul>
17w16aAdded text component keybind.
1.13
{{Extension DPL}}<ul><li>[[Melon Slice|Melon Slice]]<br/>{{Dungeons hatnote|type=consumable|Melon}}
{{Item
| title = Melon Slice
|typeimage=Melon Slice.png
| renewable = Yes
| heals = {{hunger|2}}
| stackable = Yes (64)
}}
A '''melon slice'''{{efn|Known as '''Melon Slice''' {{in|java}} and '''Melon''' {{in|bedrock}}.}} is a [[food]] item that can be eaten by the [[player]].

== Obtaining ==

=== Block loot ===

{{see also|Tutorials/Pumpkin and melon farming|title1 = Pumpkin and melon farming}}

Melon slices can be obtained by breaking (harvesting) [[melon]]s using any [[tool]] or by hand. [[Axe]]s, followed by [[sword]]s, are the fastest tools for harvesting melons.  A melon drops 3–7 melon slices, when broken; by hand, using a [[tool]], or after being broken by the movement of a [[piston]], with an average of 4.64 slices per melon.

Breaking a melon with a tool enchanted with [[Fortune]] increases the potential number of drops by 1 slice per level, up to a maximum of 9 slices.

== Usage ==

=== Food ===
{{see also|Tutorials/Hunger management|title1=Hunger management}}

To eat a melon slice, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|2}} [[hunger]] and 1.2 hunger 
[[Hunger#Mechanics|saturation]].

=== Crafting ingredient ===

{{crafting usage}}

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

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

== Data values ==

=== ID ===

{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Melon Slice
|spritetype=item
|nameid=melon_slice
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|spritename=melon-slice
|displayname=Melon
|spritetype=item
|nameid=melon_slice
|aliasid=melon
|id=272
|form=item
|translationkey=item.melon.name
|foot=1}}

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

== History ==
{{History|java beta}}
{{History||1.8|snap=Pre-release|[[File:Melon Slice JE1 BE1.png|32px]] Added melons.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 4|Melons are now used in the [[crafting]] recipe of [[glistering melon]]s.}}
{{History|||snap=Beta 1.9 Prerelease 5|Melons once again drop the correct number of slices.}}
{{History||1.3.1|snap=12w21a|Melons can now be [[trading|bought]] from farmer [[villager]]s, at 5–8 melon slices for 1 [[emerald]].}}
{{History||1.7.2|snap=13w37a|Block ID 105, [[melon stem]], has been removed from the {{cmd|give}} [[commands|command]].}}
{{History||1.8|snap=14w02a|[[Villager]]s no longer [[trading|sell]] melons. They now buy [[melon]]s instead.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 360.}}
{{History|||snap=18w20b|"Melon" has been renamed to "Melon Slice."
|The ID of melon slices has been changed from <code>melon</code> to <code>melon_slice</code>.}}
{{History||1.14|snap=18w43a|[[File:Melon Slice JE2 BE2.png|32px]] The texture of melon slices has been changed.}}
{{History|||snap=19w03a|Placing a melon slice into the new [[composter]] has a 20% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Melon slices now have a 50% chance of increasing the compost level in a composter by 1.}}

{{History|pocket alpha}}
{{History||v0.5.0|[[File:Melon Slice JE1 BE1.png|32px]] Added melons. 
|Melons restore {{health|2}} each, rather than {{hunger|2}}.}}
{{History||v0.12.1|snap=?|Added Melon slice to the Creative inventory.}}
{{History|||snap=build 1|Melons now restores [[hunger]] instead of [[health]].
|Melons can no longer be obtained from [[nether reactor]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.3|[[Breaking]] a [[melon]] with [[shears]] now always yields 9 melons.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Melon Slice JE2 BE2.png|32px]] The texture of melons has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Melons can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|Melons can now be [[trading|sold]] to farmer [[villager]]s.}}
{{History||1.16.0|snap=beta 1.16.0.57|[[Trading]] has been changed, melon slices can no longer be sold to farmer villagers.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of melon slices has been changed from <code>melon</code> to <code>melon_slice</code>.}}

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

{{History|new 3ds}}
{{History||0.1.0|[[File:Melon Slice JE1 BE1.png|32px]] Added melons.}}
{{History|foot}}

== Issues ==
{{issue list}}

== See also ==
* [[Pumpkin]]
* [[Glistering Melon Slice]]

== Notes ==
{{fnlist}}

{{Items}}

[[Category:Plants]]

[[cs:Meloun]]
[[de:Melone]]
[[es:Rodaja de sandía]]
[[fr:Tranche de pastèque]]
[[hu:Dinnye Szelet]]
[[ko:수박]]
[[nl:Meloenschijf]]
[[pl:Arbuz]]
[[pt:Fatia de melancia]]
[[ru:Ломтик арбуза]]
[[zh:西瓜片]]
[[Category:Food]]
[[Category:Renewable resources]]</li><li>[[Shulker Shell|Shulker Shell]]<br/>{{Item
| image = Shulker Shell.png
|type=
|renewable = Yes
| stackable =  Yes (64)
}}

{{about|the item that drops from the mob|the mob |Shulker|the storage block|Shulker Box}}

'''Shulker shells''' are [[item]]s dropped by [[shulker]]s that are used solely to craft [[shulker box]]es.

== Obtaining ==
=== Mob loot ===
{{IN|bedrock}}, [[shulker]]s drop 0-1 shulker shells. The maximum can be increased by 1 per level of [[Looting]], which is 0-4 shells with Looting III.

{{IN|java}}, shulkers have a 50% chance of dropping a shulker shell when killed. This is increased by 6.25% per level of [[Looting]], for a maximum of 68.75% with Looting III.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Shulker Shell
|spritetype=item
|nameid=shulker_shell
|id=566
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||1.11|snap=16w39a|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 450.}}
{{History||1.14|snap=18w43a|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}
{{History||1.17|snap=20w45a|When a shulker is hit by a shulker bullet, the shulker can spawn another shulker depending on the amount of shulkers in the area, making shulker shells [[renewable resource|renewable]].}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 1.0.0.1|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.
|Shulker shells currently have no purpose as [[shulker box]]es haven't been implemented yet.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Shulker shells can now be used to [[crafting|craft]] shulker boxes.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}
{{History||1.18.30|snap=beta 1.18.30.22|Shulkers now have a chance to spawn another shulker when hit by a shulker projectile, making shulker shells [[renewable resource|renewable]].}}

{{History|console}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Shulker Shell JE2 BE2.png|32px]] The texture of the shulker shell has now been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Shulker Shell JE1 BE1.png|32px]] Added shulker shells.}}
{{History|foot}}

== Issues ==
{{Issue list}}

{{Items}}

[[de:Shulkerschale]]
[[es:Caparazón de shulker]]
[[fr:Carapace de Shulker]]
[[it:Guscio di shulker]]
[[ja:シュルカーの殻]]
[[ko:셜커 껍데기]]
[[nl:Shulkerschelp]]
[[pl:Skorupa Shulkera]]
[[pt:Casco de shulker]]
[[ru:Панцирь шалкера]]
[[th:เปลือกชัลเกอร์]]
[[zh:潜影壳]]</li></ul>
18w01aNow supports the custom names.
18w05aAdded /bossbar, The argument <name> supported by raw JSON text.
1.14
{{Extension DPL}}<ul><li>[[Torchflower Seeds|Torchflower Seeds]]<br/>{{wip}}
{{Block
| image = <gallery>
Torchflower Age 0.png| Age 0
Torchflower Age 1.png| Age 1
Torchflower Age 2.png| Age 2
</gallery>
| image2 = Torchflower Seeds JE1.png
| transparent = Yes
| light = No
| tool = N/A
| renewable = Yes
| stackable = Yes (64)
| rarity = Common
|flammable=No
|lavasusceptible=No
}}

'''Torchflower seeds''' are seeds that have a chance to be dropped by [[Sniffer|sniffers]] when they finish digging.

== Obtaining ==
[[Sniffer]]s will occasionally bury their nose in the ground and start digging. Once the sniffer has finished digging, one torchflower seed will have a chance to be dropped on the floor as an item.

Sniffers can only dig for torchflower seeds in the following blocks:
*{{BlockLink|Dirt}}
*{{BlockLink|Grass Block}}
*{{BlockLink|Podzol}}
*{{BlockLink|Coarse Dirt}}
*{{BlockLink|Rooted Dirt}}
*{{BlockLink|Moss Block}}
*{{BlockLink|Mud}}
*{{BlockLink|Muddy Mangrove Roots}}
They cannot dig for torchflower seeds on [[mycelium]], which is intended.<ref>{{bug|MC-260259||Sniffers cannot dig nor find seeds on mycelium|WAI}}</ref>

== Usage ==
=== Crop ===
{{main|Tutorials/Crop farming|title1=Crop farming}}

Torchflower seeds can be {{control|placed}} on [[farmland]], where they grow through three stages. Breaking the torchflower crop before it matures drops the seed, while breaking the final stage produces one [[torchflower]] and does not yield the seed.

Crops break if pushed by a [[piston]] or if their supporting farmland breaks or turns to dirt (i.e. by being trampled), dropping their usual drops.

Farmer [[villager]]s can plant torchflower seeds, but cannot harvest them after they have fully grown.<ref>{{bug|MC-263382|||WAI}}</ref>

=== Feeding ===
Torchflower seeds can be used to breed [[sniffer]]s and [[chicken]]s and reduce the remaining growth duration of snifflets and chicks by 10%. Also, if some torchflower seeds were fed to an injured sniffer, it will heal it by {{hp|2}} health points.

=== Taming ===
Torchflower seeds can be used to tame [[parrot]]s.

=== Composting ===
Placing torchflower seeds into a [[composter]] has a 30% chance of raising the compost level by 1.

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Torchflower Crop
|spritetype=block
|nameid=torchflower_crop
|form=block
|blocktags=bee_growables, crops}}
{{ID table
|displayname=Torchflower Seeds
|spritetype=item
|nameid=torchflower_seeds
|form=item
|itemtags=villager_plantable_seeds
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Torchflower Crop
|spritetype=block
|nameid=torchflower_crop
|id=-567
|form=block
|translationkey=-}}
{{ID table
|displayname=Torchflower Seeds
|spritetype=item
|nameid=torchflower_seeds
|id=296
|form=item
|foot=1}}

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

{{/BS}}

== Achievements ==
{{Load achievements|Planting The Past}}

== Advancements ==
{{load advancements|A Seedy Place;Planting The Past;Little Sniffs}}

== History ==
{{History|java}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Torchflower Seeds JE1.png|32px]] Added torchflower seeds behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History|||snap=1.19.4 Pre-release 1|Torchflower seeds can now be used to breed [[chicken]]s and tame [[parrot]]s.<ref>{{bug|MC-260035|||Fixed}}</ref>|Torchflower seeds are now next to other seeds in the [[Creative inventory]].|Placing torchflower seeds in farmland now gives the player the "A Seedy Place" [[advancement]].}}
{{History||1.20|snap=23w12a|[[Sniffer]]s can now be obtained in Survival, making torchflower seeds [[renewable]].|Torchflower seeds are now available without using the "Update 1.20" experimental datapack.}}
{{History|||snap=23w14a|Torchflower seeds can now be picked up by farmer [[villager]]s.|[[Sniffer]]s can now be tempted with torchflower seeds.}}
{{History|||snap=23w16a|[[Villager]]s can now plant torchflower seeds.}}
{{History|||snap=23w17a|The player now get the [[advancement]] "Little sniffs" when they feed a [[snifflet]] using torchflower seeds, "Planting the past" when they plant torchflower seeds on [[farmland]].}}

{{History|bedrock}}
{{History||Sniffer<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|[[File:Torchflower Seeds JE1.png|32px]] Added torchflower seeds behind the "[[Bedrock Edition 1.20.0|Sniffer]]" [[experimental]] toggle.}}
{{History||1.20.0|snap=beta 1.20.0.20|Torchflower seeds are now available without using the "Sniffer" experimental toggle.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* The final growth stage of the torchflower crop uses the same ID as the actual torchflower. This causes some side effects, such as the plant becoming offset and randomly jumping to the side.<ref>{{bug|MC-260472|resolution=wai}}</ref>
 
== Gallery ==
<gallery>
Torchflower Seeds stages.png|All the growth stages of torchflower seeds.
</gallery>

== Notes ==
{{notelist}}

== References ==
{{reflist}}

{{Blocks|upcoming}}
{{Items}}
[[Category:Plants]]
[[Category:Non-solid blocks]]

[[de:Fackelliliensamen]]
[[es:Semillas de plantorcha]]
[[ja:トーチフラワーの種]]
[[pt:Sementes de plantocha]]
[[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>[[Tropical Fish (item)|Tropical Fish (item)]]<br/>{{Item
| title = Tropical Fish
| image = Tropical Fish.png
| renewable = Yes
| heals = {{hunger|1}}
| stackable = Yes (64)
}}
'''Tropical fish''' is a [[food]] item that cannot be cooked.

== Obtaining ==

=== Fishing ===

Tropical fish 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).

Tropical fish cannot be caught when fishing in [[jungle]] biome and variants.{{only|bedrock}}
<!--1-6 exp-->

=== Mob drops ===

[[Guardian]]s and [[elder guardian]]s have a 2.5% chance of dropping a random fish upon death. This has a 2% chance of being tropical fish. The chance of getting the fish drop can be increased by 1% per level of [[Looting]], but the type of fish is not affected.

[[Tropical fish]] always drop 1 tropical fish in its item form when killed. This drop is not affected by Looting.<ref>{{bug|MC-212795||Salmon & Fish mobs are not affected by Looting}}</ref>

== Usage ==

=== Food ===

Tropical fish restores {{hunger|1}} [[hunger]] and 0.2 [[Hunger#Mechanics|saturation]].

=== Trading ===

Expert-level fisherman [[villager]]s have a {{frac|1|7}} chance to buy a single tropical fish for one [[emerald]].{{only|bedrock}}

Expert-level fisherman villagers always offer to buy 6 tropical fish for an emerald.{{only|java}}

=== Wolves ===
{{IN|Bedrock}}, tropical fish can be used to feed [[wolves]], healing them by {{hp|1|mob=1}}. However, unlike other wolf food, tropical fish cannot be used to breed or speed up the growth of baby wolves. Tropical fish can be fed only to a wolf that is 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=Tropical Fish
|spritetype=item
|nameid=tropical_fish
|itemtags=fishes, axolotl_tempt_items
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showaliasids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Tropical Fish
|spritetype=item
|nameid=tropical_fish
|aliasid=clownfish
|id=266
|form=item
|translationkey=tile.clownfish.name
|foot=1}}

== Achievements ==

{{load achievements|Lion Hunter}}

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

== History ==
{{History|java}}
{{History||1.7.2|snap=13w36a|[[File:Tropical Fish JE1 BE1.png|32px]] Added clownfish.}}
{{History||1.8|snap=14w25a|Clownfish are now obtainable as a rare [[drops|drop]] from [[guardian]]s and [[elder guardians]].}}
{{History||1.13|snap=17w47a|The different data values for the <code>fish</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 349.}}
{{History|||snap=18w08b|[[Tropical fish]] have been added as [[mob]]s, which [[drops|drop]] clownfish as their [[item]] form when killed.
|[[File:Tropical Fish JE2 BE2.png|32px]] The texture of clownfish has been changed.}}
{{History|||snap=18w19a|"Clownfish" has been renamed to "Tropical Fish".}}
{{History|||snap=pre5|The [[item]] ID has now been changed to <code>tropical_fish</code>.}}
{{History||1.14|snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] tropical fish.}}
{{History||1.17|snap=20w51a|Tropical fish can be used to [[breeding|breed]] the new [[axolotl]]s.
|Tropical fish can be used to make axolotls attack drowned and guardians.}}
{{History|||snap=21w20a|Axolotls can no longer be bred using tropical fish, but instead can only be bred with [[Bucket of aquatic mob|buckets of tropical fish]].}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Tropical Fish JE1 BE1.png|32px]] Added clownfish.}}
{{History||v0.12.1|snap=build 1|Clownfish now restore [[hunger]] instead of [[health]].}}
{{History||v0.16.0|snap=build 1|Clownfish can now be [[drops|dropped]] by [[guardian]]s and [[elder guardian]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|"Clownfish" has been renamed to "Tropical Fish".
|[[Tropical fish]] have been added as [[mob]]s, which [[drops|drop]] tropical fish as their [[item]] form when killed.
|[[File:Tropical Fish JE2 BE2.png|32px]] The texture of tropical fish has been changed.}}
{{History||1.8.0|snap=beta 1.8.0.8|Tropical fish can now be used to fed [[ocelot]] to gain their trust.}}
{{History||1.11.0|snap=beta 1.11.0.4|Tropical fish can now be [[trading|sold]] to fisherman [[villager]]s.}}

{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|[[File:Tropical Fish JE1 BE1.png|32px]] Added clownfish.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|"Clownfish" has been renamed to "Tropical Fish".
|[[File:Tropical Fish JE2 BE2.png|32px]] The texture of tropical fish has been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Tropical Fish JE1 BE1.png|32px]] Added clownfish.}}
{{History|foot}}

== Issues ==

{{issue list}}

== See also ==

* [[Fishing]]

== References ==
{{reflist}}

{{items}}

[[de:Tropenfisch (Nahrung)]]
[[es:Pez tropical (objeto)]]
[[ja:熱帯魚 (アイテム)]]
[[ko:열대어 (아이템)]]
[[it:Pesce tropicale (oggetto)]]
[[ru:Тропическая_рыба_(предмет)]]
[[zh:热带鱼（物品）]]
[[Category:Renewable resources]]
[[Category:Food]]</li><li>[[Glow Berries|Glow Berries]]<br/>{{Block
|image=<gallery>
Cave Vines (head).png|Without Berries
Cave Vines (berries).png|With Berries
</gallery>
|image2 = Glow Berries JE1 BE1.png
|extratext=[[#Gallery|View all renders]]
|rarity=Common
|renewable=Yes
|stackable=Yes (64)
|tool=Any
|light=Yes
|transparent=Yes
|heals={{hunger|2}}
|flammable=Yes
|lavasusceptible=No
}}

'''Glow berries''' are a [[food]] [[item]] obtained from cave vines and can be used to plant them.

'''Cave vines''' are a climbable, [[Bone Meal|bonemealable]] plant that hangs off ceilings and grows glow berries. Cave vines with glow berries produce [[light]] and drop glow berries when broken or harvested. Cave vines with no glow berries will not drop anything.

== Obtaining ==

=== Natural generation ===
Cave vines can be found in [[lush caves]], hanging from cave ceilings.

=== Chest loot ===
{{LootChestItem|glow-berries}}

=== Post-generation ===
Glow berries can be collected from a cave vine by {{control|using}} or {{control|breaking}} the vine. This yields one glow berry when the vine is bearing them and nothing when it is not.  A cave vine also breaks if [[water]] runs over its location or if a [[piston]] extends or pushes a block into its location. 

{{IN|bedrock}}, using a tool with [[Silk Touch]] on cave vines always yields a glow berry, even if the vine appears empty.

[[Fortune]] has no effect on the number of glow berries dropped.

== Usage ==
=== Placement ===
Glow berries can be placed on and grown from the bottom of most blocks. They have no specific lighting requirements. When placed, they can be of any length.

=== Growth ===
Placing glow berries on the bottom of a block creates a cave vine that grows downward one block at a time as long as [[air]] is beneath it and its maximum height (2 to 26 blocks) has not been reached. Each newly-grown cave vine block has a 1 in 9 chance of bearing glow berries.  Only this tip can ever naturally grow them.{{only|JE}}{{More info|exact growth rate and chance to bear glow berries}}

{{control|Using}} [[bone meal]] on a cave vine produces glow berries if the vine was not bearing any.

{{IN|Java}}, cave vines stop growing if [[shears]] are {{control|used}} on the tip.

{{IN|bedrock}}, if placing glow berries in the Nether, cave vines are able to grow and produces glow berries.

=== Food ===
To eat glow berries, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|2}} [[hunger]] and 0.4 hunger [[Hunger#Mechanics|saturation]] points, like [[sweet berries]].

=== Light ===
When bearing glow berries, cave vines give off a [[light]] level of 14.

=== Composting ===
Placing glow berries into a [[composter]] by {{control|using}} them on it has a 30% chance of raising the compost level by 1.

=== Breeding ===
Glow berries can be fed to [[fox]]es to [[breeding|breed]] them. Foxes are similar to cats when being fed as a wild animal; a sudden movement by the player may cause the fox to flee even if the player holds glow berries. The resulting baby fox trusts the [[player]] and does not flee.

Glow berries can be {{control|used}} on baby foxes to reduce the time until they grow by 10%.

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

===Cave vines===
====Generic====
{{Sound table/Block/Cave vines}}

==== Unique ====
{{edition|java}}:
{{Sound table
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|subtitle=Berries pop
|source=block
|description=When glow berries are picked
|id=block.cave_vines.pick_berries
|translationkey=subtitles.item.berries.pick
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Shear.ogg
|subtitle=Plant cropped
|source=block
|description=When the tip of cave vines are cropped with [[Shears#Cropping growing plants|shears]]
|id=block.growing_plant.crop
|translationkey=subtitles.block.growing_plant.crop
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Berries pick1.ogg
|sound2=Berries pick2.ogg
|source=block
|description=When glow berries are picked
|id=pick_berries.cave_vines
|volume=1.0
|pitch=0.8-1.2
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Cave Vines
|spritetype=block
|nameid=cave_vines
|blocktags=cave_vines,lush_plants_replaceable
|form=block
}}
{{ID table
|displayname=Cave Vines Plant
|spritetype=block
|nameid=cave_vines_plant
|blocktags=cave_vines,lush_plants_replaceable
|form=block
}}
{{ID table
|displayname=Glow Berries
|spritetype=item
|nameid=glow_berries
|itemtags=fox_food
|form=item
|foot=1}}

{{el|be}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Cave Vines
|nameid=cave_vines
|spritetype=block
|id=577}}
{{ID table
|displayname=Cave Vines Body With Berries
|nameid=cave_vines_body_with_berries
|spritename=lit-cave-vines-plant
|spritetype=block
|id=630}}
{{ID table
|displayname=Cave Vines Head With Berries 
|spritename=lit-cave-vines
|nameid=cave_vines_head_with_berries
|spritetype=block
|id=631}}
{{ID table
|displayname=Glow Berries
|spritetype=item
|nameid=glow_berries
|form=item
|id=638
|foot=1}}

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

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

==History==
{{History||October 3, 2020|link={{ytl|DWZIfsaIgtE|t=1781}}|[[File:Cave Vines Plant JE1 BE1.png|32px]] [[File:Cave Vines Plant (berries) JE1 BE1.png|32px]] [[File:Cave Vines (head) JE1 BE1.png|32px]] [[File:Cave Vines (berries) JE1 BE1.png|32px]] Cave vines (named as glow berries) are shown as part of lush caves at [[Minecraft Live 2020]].}}
{{History|java}}
{{History||1.17|snap=21w05a|[[File:Glow Berries JE1 BE1.png|32px]] Added glow berries.
|[[File:Cave Vines Plant JE1 BE1.png|32px]] [[File:Cave Vines Plant (berries) JE1 BE1.png|32px]] [[File:Cave Vines (head) JE1 BE1.png|32px]] [[File:Cave Vines (berries) JE1 BE1.png|32px]] Added cave vines.}}
{{History|||snap=21w11a|Renamed from "cave vines head" and "cave vines body" to "cave vines" and "cave vines plant", respectively.
|The IDs have also changed.
|Cave vines now always give 14 light, regardless of the type of part.
|Now slow down the player.
|Can now be climbed.}}
{{History|||snap=21w13a|Glow berries now generate as loot in [[mineshaft]] [[Minecart with Chest|chest minecarts]].}}
{{History||1.18|snap=Experimental Snapshot 1|With the implementation of cave biomes including lush caves, caves vines can now generate in normal worlds.}}
{{History|||snap=21w37a|Cave vines stop growing if [[shears]] are used on the tip.}}
{{History|||snap=21w41a|[[File:Cave Vines Plant JE2.png|32px]] [[File:Cave Vines Plant (berries) JE2.png|32px]] Changed cave vines plant texture.}}
{{History||1.19|snap=22w13a|Glow Berries may now be found in [[ancient city]] [[chest]]s.}}

{{History|bedrock}}
{{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.220.52|[[File:Glow Berries JE1 BE1.png|32px]] Added glow berries.
|[[File:Cave Vines Plant JE1 BE1.png|32px]] [[File:Cave Vines Plant (berries) JE1 BE1.png|32px]] [[File:Cave Vines (head) JE1 BE1.png|32px]] [[File:Cave Vines (berries) JE1 BE1.png|32px]] Added cave vines.}}
{{History||1.17.0|snap=beta 1.16.230.54|Glow Berries now generate as loot in [[mineshaft]] [[Minecart with Chest|chest minecarts]].}}
{{History|||snap=beta 1.17.0.52|Glow Berries are now available without enabling [[experimental gameplay]].}}
{{History||1.17.20|snap=beta 1.17.20.20|Cave Vines can now be pollinated by [[bee]]s.}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Cave Vines Plant JE2.png|32px]] [[File:Cave Vines Plant (berries) JE2.png|32px]] Changed cave vines plant texture.}}
{{History||1.19.20|snap=beta 1.19.20.20|Cave vines can now be destroyed by [[ravagers]].}}
{{History|foot}}

<gallery>
Lush_caves_overview_concept_art.jpg|Concept art for the lush caves and vegetation including Glow Berries.
JE_1.17_Development_Lush_Caves.jpg|A view of the lush caves with glow berries from Minecraft Live 2020.
Lushcaves_minecon.png|Lush cave in MINECON.
Cavesworkinprogress.jpg|A view of the lush caves with glow berries, tweeted by LadyAgnes.
Livestream_lush_cave.jpg|Another view of the lush caves with glow berries, in an interview with LadyAgnes.
Glow Berry Fox.jpg|A fox under a glow berry vine.
</gallery>

===Cave vines "item"===
{{:Technical blocks/Cave Vines}}

==Issues==
{{Issue list}}

==Trivia==
*They are the first item to be usable as both a food and a light source.

==Gallery==
<gallery>
Cave Vines (plant).png
Cave Vines (berries, plant).png
Cave Vines (head).png
Cave Vines (berries).png
Cave_Vines_Age2_(Possibility_pattern_1)_JE1.png|A possible pattern of the cave vines at Age 2.
Cave_Vines_Age2_(Possibility_pattern_2)_JE1.png|And another pattern.
</gallery>

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

[[Category:Food]]
[[Category:Plants]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]
[[Category:Light sources]]
[[Category:Flammable blocks]]
[[Category:Climbable blocks]]

[[de:Leuchtbeeren]]
[[es:Bayas luminosas]]
[[fr:Baies lumineuses]]
[[it:Bacche luminose]]
[[ja:グロウベリー]]
[[pt:Bagas brilhantes]]
[[ru:Светящиеся ягоды]]
[[zh:发光浆果]]</li></ul>
19w39aAdded text component storage.
19w41aAdded the action copy_to_clipboard for the text component clickEvent.
Bedrock Edition
1.9.0
{{Extension DPL}}<ul><li>[[Sugar Cane|Sugar Cane]]<br/>{{Block
|image=Sugar Cane.png
|image2=Sugar Cane (item) JE3.png
|extratext = View all [[#Gallery|renders]]
|transparent=Yes
|light=No
|tool=any
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=No
}}
'''Sugar cane''' is a block found as 1–4-block-tall. It plants near water in the [[Overworld]]. As an item, it is an important crafting ingredient.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

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

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

== References ==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Cukrová třtina]]
[[de:Zuckerrohr]]
[[es:Caña de azúcar]]
[[fr:Canne à sucre]]
[[hu:Cukornád]]
[[it:Canna da zucchero]]
[[ja:サトウキビ]]
[[ko:사탕수수]]
[[nl:Suikerriet]]
[[pl:Trzcina cukrowa]]
[[pt:Cana-de-açúcar]]
[[ru:Сахарный тростник]]
[[th:อ้อย]]
[[uk:Цукрова тростина]]
[[zh:甘蔗]]</li><li>[[Armor Stand|Armor Stand]]<br/>{{ItemEntity
| image = Armor Stand.png
| image2 = Armor Stand BE.png
| extratext = View [[#Gallery|all renders]]
| stackable =
* '''[[JE]]:''' Yes (16)
* '''[[BE]]:''' Yes (64)
| renewable = Yes
| flammable = Yes
| size = '''Normal:'''<br>
Width: 0.5 Blocks<br>
Height: 1.975 Blocks<br>
'''Small:'''<br>
Width: 0.25 Blocks<br>
Height: 0.9875 Blocks<br>
| health = {{hp|20}}
}}
An '''armor stand''' is an inanimate [[entity]] that can wear [[armor]]. It can also hold [[Item|items]] and be posed (but these are not possible in [[Survival]] in [[Java Edition]]).

== Obtaining ==
An armor stand can be broken by quickly {{control|attack|text=attacking}} it twice, dropping itself and any armor placed onto it.

=== Crafting ===
{{Crafting
|A1= Stick
|B1= Stick
|C1= Stick  
|B2= Stick
|A3= Stick
|B3= Smooth Stone Slab
|C3= Stick
|Output= Armor Stand
|type=Decoration block
}}

=== Natural generation ===
Two armor stands are found in each taiga [[village]] outdoor armory, one equipped with an [[iron helmet]], the other with an [[iron chestplate]].

== Usage ==
[[Player]]s can use armor stands to hold [[armor]], [[mob head]]s, [[carved pumpkin]]s, and [[elytra]]. [[Commands]] can be used to give them other [[item]]s. The stand does not have a GUI, so players interact with it directly. Armor stands are also able to be placed in different orientations, similar to [[banner]]s or [[sign]]s. Armor stands are [[entity|entities]], allowing them to be pushed by [[piston]]s, moved by flowing [[water]], pulled with [[fishing rod]]s, pushed by players (with knockback), and bounced by [[slime block]]s. 

{{Control|use|text=Using}} armor on the stand places the armor if done on a bare spot. Conversely, clicking on armor with a bare hand removes the armor and places it in the highlighted hotbar slot. It is not possible to take or place items from the armor stand's hands unless playing on Bedrock Edition.

Armor, mob heads, or carved pumpkins can be automatically placed on armor stands with a [[dispenser]].

Armor stands can be customized further to have arms, pose, disobey gravity, dual wield and other things by summoning them using {{cmd|summon}} with [[Chunk format#ArmorStand|NBT tags]].

In maps heavily using [[command blocks]], armor stands can be used to keep [[scoreboard]] objectives that are 'global' to the map, run [[commands]], etc. 

{{IN|bedrock}}, the pose of the armor stand can be changed by interacting with the armor stand (or pressing the {{btn|Pose|be=1}} button on mobile devices) while sneaking, or by using a redstone signal. There are 13 possible poses. Armor stands can also hold items by interacting with the armor stand (or pressing the {{btn|Equip|be=1}} button on mobile devices) while holding an item that cannot be worn.

;<nowiki>Below are the poses:
{| class="wikitable collapsible collapsed"
! No. !! Namespace ID !! Redstone power !! Image
|-
| 0
| {{cd|animation.armor_stand.default_pose}}
| 0
| [[File:Armor Stand Default Pose.png|128px]]
|-
| 1
| {{cd|animation.armor_stand.no_pose}}
| 1
| [[File:Armor Stand No Pose.png|128px]]
|-
| 2
| {{cd|animation.armor_stand.solemn_pose}}
| 2
| [[File:Armor Stand Solemn Pose.png|128px]]
|-
| 3
| {{cd|animation.armor_stand.athena_pose}}
| 3
| [[File:Armor Stand Athena Pose.png|128px]]
|-
| 4
| {{cd|animation.armor_stand.brandish_pose}}
| 4
| [[File:Armor Stand Brandish Pose.png|128px]]
|-
| 5
| {{cd|animation.armor_stand.honor_pose}}
| 5
| [[File:Armor Stand Honor Pose.png|128px]]
|-
| 6
| {{cd|animation.armor_stand.entertain_pose}}
| 6
| [[File:Armor Stand Entertain Pose.png|128px]]
|-
| 7
| {{cd|animation.armor_stand.salute_pose}}
| 7
| [[File:Armor Stand Salute Pose.png|128px]]
|-
| 8
| {{cd|animation.armor_stand.hero_pose}}
| 8, 13 or more
| [[File:Armor Stand Hero Pose.png|128px]]
|-
| 9
| {{cd|animation.armor_stand.riposte_pose}}
| 9
| [[File:Armor Stand Riposte Pose.png|128px]]
|-
| 10
| {{cd|animation.armor_stand.zombie_pose}}
| 10
| [[File:Armor Stand Zombie Pose.png|128px]]
|-
| 11
| {{cd|animation.armor_stand.cancan_a_pose}}
| 11
| [[File:Armor Stand Cancan A Pose.png|128px]]
|-
| 12
| {{cd|animation.armor_stand.cancan_b_pose}}
| 12
| [[File:Armor Stand Cancan B Pose.png|128px]]
|}

== Behavior ==

Because armor stands are entities, they obey gravity, allowing them to fall and rest on non-full [[block]]s such as [[enchanting table]]s, [[snow layer]]s and [[slab]]s.

Any [[armor]] on the stand drops when the stand is broken. Armor stands can display [[enchanting|enchanted]] and all forms of [[dye]]d armor. The effects of most enchanted armor have no effect when on an armor stand, with three exceptions: 
* [[Frost Walker]] creates [[frosted ice]] blocks on [[water]] as usual if an armor stand is pushed with a [[piston]].
* [[Depth Strider]] slows the movement of the armor stand when being pushed with water. 
* A [[player]] may take damage from hitting an armor stand that holds armor enchanted with [[Thorns]].

Armor stands are not damaged by [[cacti]] but can be broken by [[arrow]]s. An armor stand destroyed by an explosion or a firework does not drop as an [[item (entity)|item]]. Armor stands in water and [[lava]] at the same time are not consumed by the lava.

{{IN|be}}, armor stands can be affected by [[status effect]]s. They can be 'killed' by [[Harming]] and [[Decay]] [[splash potion|splash]]/[[lingering potion]]s, lava, [[fire]], and [[campfire]]s, and they play the player death sound and fall to their side and disappear, yielding no armor stand item. If an armor stand is equipped with an item or armor, that item or armor is considered as "naturally-spawned equipment" with an 8.5% chance of dropping when the armor stand "dies" from the [[Instant Damage]] or the [[Wither (status effect)|Wither]] status effect. If the dropped item is any form of [[weapon]], [[tool]] or armor, it drops in a badly damaged state because the game considers it as "naturally-spawned equipment".<ref>{{Bug|MCPE-24341}}</ref>

The stand wobbles slightly when being hit by the player.

{{IN|java}}, it is possible to create an armor stand with arms using the {{cmd|summon}} [[command]]. It is also possible to change an armor stand without arms into a stand with arms by using the {{cmd|data}} command. The commands are as follows:

* <code>/data merge entity @e[type=armor_stand,sort=nearest,limit=1] {ShowArms:1}</code>, which changes the nearest armor stand into an armor stand with arms.
* <code>/summon minecraft:armor_stand ~ ~ ~ {ShowArms:1}</code>, which summons a new armor stand with arms shown.
*<code>/summon armor_stand ~ ~ ~ {Rotation:[0.0f]}</code>, which summons a new armor stand that faces a desired direction (dependent on changing "0.0f" to other numbers like "90.0f" or "180.0f", otherwise it faces the same way as a default armor stand).

== Sounds ==
{{edition|java}}:<br>
Armor stands use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Armor Stand hit1.ogg
|sound2=Armor Stand hit2.ogg
|sound3=Armor Stand hit3.ogg
|sound4=Armor Stand hit4.ogg
|subtitle=Block breaking
|source=Friendly Creatures
|description=When an armor stand is damaged
|id=entity.armor_stand.hit
|translationkey=subtitles.block.generic.hit
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Armor Stand break1.ogg
|sound2=Armor Stand break2.ogg
|sound3=Armor Stand break3.ogg
|sound4=Armor Stand break4.ogg
|subtitle=Block broken
|source=Friendly Creatures
|description=When an armor stand is destroyed
|id=entity.armor_stand.break
|translationkey=subtitles.block.generic.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Stone dig1.ogg
|sound2=Stone dig2.ogg
|sound3=Stone dig3.ogg
|sound4=Stone dig4.ogg
|subtitle=Block placed
|source=Blocks
|description=When an armor stand is placed
|id=entity.armor_stand.place
|translationkey=subtitles.block.generic.place
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Wood dig1.ogg
|sound2=Wood dig2.ogg
|sound3=Wood dig3.ogg
|sound4=Wood dig4.ogg
|subtitle=Block placed
|source=Friendly Creatures
|description=When an armor stand falls onto a block at a high speed{{Info needed}}
|id=entity.armor_stand.fall
|translationkey=subtitles.entity.armorstand.fall
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Armor Stand hit1.ogg
|sound2=Armor Stand hit2.ogg
|sound3=Armor Stand hit3.ogg
|sound4=Armor Stand hit4.ogg
|source=neutral
|description=When an armor stand is damaged
|id=mob.armor_stand.hit
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Armor Stand break1.ogg
|sound2=Armor Stand break2.ogg
|sound3=Armor Stand break3.ogg
|sound4=Armor Stand break4.ogg
|source=neutral
|description=When an armor stand is destroyed
|id=mob.armor_stand.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Stone dig1.ogg
|sound2=Stone dig2.ogg
|sound3=Stone dig3.ogg
|sound4=Stone dig4.ogg
|source=neutral
|description=When an armor stand is placed
|id=mob.armor_stand.place
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Wood dig1.ogg
|sound2=Wood dig2.ogg
|sound3=Wood dig3.ogg
|sound4=Wood dig4.ogg
|source=neutral
|description=When an armor stand falls onto a block at a high speed{{Info needed}}
|id=mob.armor_stand.land
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Armor Stand
|showforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=armor-stand
|spritetype=item
|nameid=armor_stand
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Armor Stand
|generatetranslationkeys=y
|displayname=Entity
|spritename=armor-stand
|spritetype=entity
|nameid=armor_stand
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Armor Stand
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Item
|spritename=armor-stand
|spritetype=item
|nameid=armor_stand
|id=552
|form=item
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Armor Stand
|shownumericids=y
|generatetranslationkeys=y
|displayname=Entity
|spritename=armor-stand
|spritetype=entity
|nameid=armor_stand
|id=61
|foot=1}}

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: The item's '''tag''' tag.
{{:Player.dat_format/Entity Spawners}}
</div>

{{el|bedrock}}:
: {{IN|bedrock}}, armor stands have no additional item tag.
: See [[Bedrock Edition level format/Item format]].

=== Entity data ===
Armor stands have entity data associated with them that contain various properties of the [[entity]].

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

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

== Video ==
Note: This video is outdated as Zoglins now attack armor stands
<div style="text-align:center">{{yt|tCFkdTfCleQ}}</div>

== History ==
{{History|java}}
{{History||1.8|snap=August 5, 2014|slink={{Tweet|SeargeDP|496666952530538498}}|[[File:Armor Stand (pre-release).png|32px]] [[File:Armor Stand (item) (pre-release).png|32px]] [[Searge]] tweeted a image of an armor stand. The appearance was changed before release.}}
{{History|||snap=August 5, 2014|slink={{Tweet|SeargeDP|496673890148823040}}|Showed crafting recipe and name "[Armor Stand]", both were changed before release.}}
{{History|||snap=14w32a|[[File:Armor Stand JE1.png|32px]] Added armor stands.}}
{{History|||snap=14w32b|[[File:Armor Stand (item) JE1 BE1.png|32px]] The item texture has changed.
|Pick-block can now be used on armor stands.
|Armor stands can now no longer be crafted using [[slabs]] other than stone slabs.}}
{{History|||snap=14w32c|Added a <code>NoBasePlate</code> tag for the armor stand.}}
{{History|||snap=14w33a|Breaking [[particles]] have been added for the armor stand.}}
{{History||1.8.1|snap=pre1|Added <code>Marker</code> tag for armor stands.}}
{{History||1.9|snap=15w31a|Armor stands can now dual wield.
|<code>HandItems</code> and <code>ArmorItems</code> tags added for armor stands, which is intended to replace the <code>Equipment</code> tag.}}
{{History|||snap=15w33a|The <code>Equipment</code> tag has been removed from armor stands.}}
{{History|||snap=15w47a|The armor stand now wobbles when hit by the [[player]].}}
{{History|||snap=16w02a|Marker <code>ArmorStand</code>s now outline their equipment only when glowing.}}
{{History||1.11|snap=16w32a|The entity ID of the armor stand has been changed from <code>ArmorStand</code> to <code>armor_stand</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 416.}}
{{History||1.14|snap=18w43a|[[File:Armor Stand JE2.png|32px]] The texture of armor stands has been changed to the new [[planks|oak planks]] texture.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly changed. (Comparison: [[File:Armor Stand (item) Texture Change 1.13 to 18w43a.gif|32px]])}}
{{History|||snap=18w50a|[[File:Armor Stand JE3.png|32px]] The texture of armor stands has been changed again.
|Armor stands now generate in taiga [[village]]s.}}
{{History||1.15|snap=19w42a|Armor stands can now be placed by [[dispenser]]s.}}
{{History||1.16|snap=20w07a|Armor stands no longer fall through fences and walls when placed.<ref>{{bug|MC-65951}}</ref>}}
{{History|||snap=20w14a|[[Zoglin]]s now attack armor stands.}}
{{History||1.17|snap=20w45a|[[File:Armor Stand 20w45a.png|32px]] The model of the armor stand has been changed.}}
{{History|||snap=20w46a|[[File:Armor Stand JE3.png|32px]] The model of the armor stand has been changed back to how it was in 1.16.}}
{{History||1.18|snap=Pre-release 5|[[File:Armor Stand JE4.png|32px]] Changed smooth stone texture on armor stand.}}
{{History||1.19.4|snap=23w03a|Armor stands now preserve custom names when placed and broken.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|An armor stand now appears in the smithing table GUI; arms are displayed as in Bedrock Edition.
|When an armor stand is placed, its model now changes in effect of the player's facing direction<ref>{{bug|MC-93533}}</ref>.}}
{{History|||snap=23w06a|The model no longer changes when the armory is placed. Also, the head, which tilted slightly to the lower right in the version from 1.8 up to 1.19.3, now faces forward from [[File:Armor Stand JE4.png|32px]] to [[File:Armor Stand JE5.png|32px]].}}
{{History||?|Armor can now be swapped in [[armor stand]]s by {{ctrl|using}} them in the armor stand's slot.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:Armor Stand BE1.png|32px]] [[File:Armor Stand (item) JE1 BE1.png|32px]] Added armor stands.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Armor Stand BE2.png|32px]] The texture of armor stands has been changed.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly 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 shows as being [[dye]]d properly when worn by armor stands.}}
{{History|||snap=beta 1.12.0.3|[[File:Armor Stand wear Chicken.png|x73px]][[File:Armor Stand wear Rabbit.png|x73px]] [[File:Armor Stand wear Salmon.gif|x73px]] [[File:Armor Stand wear Pufferfish.gif|x73px]] [[File:Armor Stand wear Slime.png|x73px]] When armor stands hold a [[raw chicken]], [[raw rabbit]], [[raw salmon]], [[pufferfish]] or a [[slime block]], they now wear these [[mob]] counterparts.<ref>{{bug|mcpe-48629}}</ref>}}
{{History||1.13.0|snap=beta 1.13.0.1|Leather armor now shows as being dyed properly when worn by armor stands.}}
{{History|||snap=beta 1.13.0.4|Armor stands no longer hold certain [[mob]]s if they are holding a [[item]] related to them.
|Armor stands now have a smoother animation when changing poses.}}
{{History||1.16.0|snap=?|Armor stands are now targeted by zoglins.}}
{{History||1.16.210|snap=beta 1.16.210.51|Armor stands are no longer attacked by [[goat]]s.}}
{{History|console}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|[[File:Armor Stand JE1.png|32px]] [[File:Armor Stand (item) JE1 BE1.png|32px]] Added armor stands.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|Added [[sound]]s for armor stands.}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|[[File:Armor Stand BE1.png|32px]] Armor stands now have arms and the [[player]] can now change the pose of the armor stand.}}	
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Armor Stand BE2.png|32px]] The texture of armor stands has been changed.
|[[File:Armor Stand (item) JE2 BE2.png|32px]] The texture of armor stand [[item]]s has been slightly changed.}}
{{History|foot}}

<gallery>
Armour stand 1.png|The first image of the armor stand.
JE 1.8 Dev Armor Stand crafting.png|The first image of armor stand crafting recipe.
The Bountiful Update.png|Armor stands in the [[Java Edition 1.8|1.8]] poster.
Dual Wielding Armor Stand.png|A dual wielding armor stand.
Glowing Armor Stands.png|Armor stands with the [[glowing]] effect.
Armor Stand Chess.jpg|Chess with armor stands.
</gallery>

== Issues ==
{{issue list}}

== Trivia ==
* Equipping armor stands with certain [[block]]s and [[item]]s can cause rendering glitches. According to [[Searge]] this is due to transparent rendering on entities not yet being supported.<ref>{{bug|MC-67415||"Armor Stands with Slime Block rendering entities behind them"}} resolved as "Won't Fix"</ref><ref>{{bug|MC-67674||"Armor Stand wearing a Skull and Holding Stained Glass causes Graphical issues"}} resolved as "Won't Fix"</ref>
* Bedrock Edition has a version exclusive armor stand [[model]], which includes posable arms.
*Using [[redstone]] to change the stands reverse the poses, starting with the can-can pose first.
*Placing the stand within three powered [[redstone dust]] always changes its pose to the honor pose. [[Redstone Repeater|Repeaters]] also switch the stand to the honor pose if not set four blocks from one.
*Using external tools, armor stand spawners can be placed.
*Secret signatures for [[Jasper Boerstra|JAPPA]], Chi Wong, and [[Michael Stoyke|Searge]] can be found at the bottom of the armor stand texture.

== Gallery ==
=== Renders ===
; Armor (Java Edition)
<gallery>
Armor Stand Leather.png
Armor Stand Golden.png
Armor Stand Chainmail.png
Armor Stand Iron.png
Armor Stand Diamond.png
Armor Stand Netherite.png
</gallery>

; Armor (Bedrock Edition)
<gallery>
Armor Stand with Leather Armor BE.png
Armor Stand with Golden Armor BE.png
Armor Stand with Chain Armor BE.png
Armor Stand with Iron Armor BE.png
Armor Stand with Diamond Armor BE.png
Armor Stand with Netherite Armor BE.png
</gallery>

; Poses
<gallery>
Armor Stand Pose 0.png| 
Armor Stand Pose 1.png| 
Armor Stand Pose 2.png| 
Armor Stand Pose 3.png| 
Armor Stand Pose 4.png| 
Armor Stand Pose 5.png| 
Armor Stand Pose 6.png| 
Armor Stand Pose 7.png| 
Armor Stand Pose 8.png| 
Armor Stand Pose 9.png| 
Armor Stand Pose 10.png| 
Armor Stand Pose 11.png| 
Armor Stand Pose 12.png|
</gallery>

=== Screenshots ===
<gallery>
Armor Stand Demo.png|Armor stands in various positions with various [[armor]].
Armor Stand glass and sword.png|Armor stands can wear [[block]]s on their heads. This is accessible with [[command]]s such as {{cmd|item}}.
Bedrock edition armor stand poses.png|All armor stand poses as seen in {{el|be}}.
Netherite to the rescue!.png|An entire set of netherite [[armor]] on an armor stand.
Armor Stand Garage.png|An armor stand in a garage.
</gallery>

== References ==
{{reflist}}

==External Links==
*[https://www.minecraft.net/en-us/article/taking-inventory--armor-stand Taking Inventory: Armor Stand] – Minecraft.net on March 16, 2023

{{Items}}
{{Entities}}

[[Category:Storage]]

[[de:Rüstungsständer]]
[[es:Soporte para armadura]]
[[fr:Porte-armure]]
[[ja:防具立て]]
[[ko:갑옷 거치대]]
[[pl:Stojak na zbroję]]
[[pt:Suporte de armaduras]]
[[ru:Стойка для брони]]
[[th:แท่นวางชุดเกราะ]]
[[uk:Стійка для обладунків]]
[[zh:盔甲架]]</li></ul></nowiki>
beta 1.9.0.0Added /tellraw, the raw JSON text used to support this command.

Notes

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

See also

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

Fan Feed

More Minecraft Wiki