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

NBT format

Revision as of 16:47, 2 January 2020 by Blobs2 (talk | contribs) (→‎Uses: Marked as stub)
Sign in to edit
This article is about the NBT file format. For using NBT in commands, see Tutorials/Command NBT tags.

The Named Binary Tag format is used by Minecraft for the various files in which it saves data. The format is described by Notch in a very brief specification. The format is designed to store data in a tree structure made up of various tags. All tags have an ID and a name. The original known version was 19132 as introduced in Beta 1.3, and since then has been updated to 19133 with Anvil, with the addition of the Int Array tag. The NBT format dates all the way back to Indev with tags 0 to 10 in use.

Another more user-friendly format of NBT is in plain string, as used in commands. This format is referred to as SNBT, short for stringified NBT. It is different from the JSON format; hence, any JSON used in NBT, such as raw json text, must be enclosed within a string tag.

TAG definition

Add more columns [discuss]
This section might benefit of the addition of the "prefix and/or suffix in SNBT" column.

A tag is an individual part of the data tree. The first byte in a tag is the tag type (ID), followed by a two byte big-endian unsigned integer for the length of the name, then the name as a string in UTF-8 format (Note TAG_End is not named and does not contain the extra 2 bytes; the name is assumed to be empty). The name of tags may contain spaces, although Minecraft itself never saves tags with spaces in the names. Finally, depending on the type of the tag, the bytes that follow are part of that tag's payload. This table describes each of the 13 known tags in version 19133 of the Named Binary Tag format:

ID Icon Tag Type Payload SNBT Format‌[JE only] Description Storage Capacity
0 TAG_End None. - Used to mark the end of compound tags. This tag does not have a name, so it is only ever a single byte 0. It may also be the type of empty List tags. N/A
1 TAG_Byte 1 byte / 8 bits, signed <number>b or <number>B A signed integral type. Sometimes used for booleans. Full range of -(27) to (27 - 1)
(-128 to 127)
2 TAG_Short 2 bytes / 16 bits, signed, big endian <number>s or <number>S A signed integral type. Full range of -(215) to (215 - 1)
(-32,768 to 32,767)
3 TAG_Int 4 bytes / 32 bits, signed, big endian <number> A signed integral type. Full range of -(231) to (231 - 1)
(-2,147,483,648 to 2,147,483,647)
4 TAG_Long 8 bytes / 64 bits, signed, big endian <number>l or <number>L A signed integral type. Full range of -(263) to (263 - 1)
(-9,223,372,036,854,775,808 to 9,223,372,036,854,775,807)
5 TAG_Float 4 bytes / 32 bits, signed, big endian, IEEE 754-2008, binary32 <number>f or <number>F A signed floating point type. Precision varies throughout number line;
See Single-precision floating-point format. Maximum value about 3.4*1038
6 TAG_Double 8 bytes / 64 bits, signed, big endian, IEEE 754-2008, binary64 <decimal number>, <number>d or <number>D A signed floating point type. Precision varies throughout number line;
See Double-precision floating-point format. Maximum value about 1.8*10308
7 TAG_Byte_Array TAG_Int's payload size, then size TAG_Byte's payloads. [B;<byte>,<byte>,...] An array of bytes. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.
8 TAG_String TAG_Short's payload length, then a UTF-8 string with size length. <a-zA-Z0-9 text>, "<text>" (" within needs to be escaped to \"), or '<text>' (' within needs to be escaped to \') A UTF-8 string. It has a size, rather than being null terminated. 32,767 bytes interpretable as UTF-8 (see UTF-8 format; most commonly-used characters are a single byte).
9 TAG_List TAG_Byte's payload tagId, then TAG_Int's payload size, then size tags' payloads, all of type tagId. [<value>,<value>,...] A list of tag payloads, without repeated tag IDs or any tag names. Due to JVM limitations and the implementation of ArrayList, the maximum number of list elements is (231 - 9), or 2,147,483,639. Also note that List and Compound tags may not be nested beyond a depth of 512.
10 TAG_Compound Fully formed tags, followed by a TAG_End. {<tag name>:<value>,<tag name>:<value>,...} A list of fully formed tags, including their IDs, names, and payloads. No two tags may have the same name. Unlike lists, there is no hard limit to the number of tags within a Compound (of course, there is always the implicit limit of virtual memory). Note, however, that Compound and List tags may not be nested beyond a depth of 512.
11 TAG_Int_Array TAG_Int's payload size, then size TAG_Int's payloads. [I;<integer>,<integer>,...] An array of TAG_Int's payloads. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.
12 TAG_Long_Array TAG_Int's payload size, then size TAG_Long's payloads. [L;<long>,<long>,...] An array of TAG_Long's payloads. Maximum number of elements ranges between (231 - 9) and (231 - 1) (2,147,483,639 and 2,147,483,647), depending on the specific JVM.

The List and Compound tags can be and often are recursively nested. It should also be noted that, in a list of lists, each of the sub-lists can list a different kind of tag.

File Format

An NBT file is a GZip'd Compound tag, name and tag ID included. Some of the files utilized by Minecraft may be uncompressed, but in most cases the files follow Notch's original specification and are compressed with GZip. In the Legacy Console Edition, chunks are compressed with XMemCompress, a variation of an LZX compression algorithm. There is no header to specify the version or any other information - only the level.dat file specifies the version.

As used in Minecraft

Minecraft's use of the NBT format is odd at times. In some instances, empty lists may be represented as a list of Byte tags rather than a list of the correct type, or as a list of End tags in newer versions of Minecraft, which can break some older NBT tools. Additionally, almost every root tag has an empty name string and encapsulates only one Compound tag with the actual data and a name. For instance:

  • The root tag for most Minecraft NBT structures.
    •  SomeName: The only tag contained within the root tag - it has a name and contains all the actual data.

Another noticeable oddity is that, although the original specification by Notch allows for spaces in tag names, and even the example uses spaces in the tag names, Minecraft has no known files where any tags have spaces in their names. There is also inconsistent use of letter case, mostly either camelCase or PascalCase, but sometimes even in all lowercase.

Uses

Dark Oak Sapling
This article is a stub. 
You can help by expanding it.
Instructions: 4

Software

Mojang has provided sample Java NBT classes for developers to use and reference as part of the source code for the McRegion -> Anvil converter. Since 1.13, Minecraft includes a builtin converter between SNBT format and compressed NBT format. It comes with the client and the official server.[1]

Official

See also: Tutorials/Running the Data Generator

The data generator from Minecraft is able to convert uncompressed Stringified NBT files with .snbt extension in an input folder to GZip compressed NBT format files with .nbt extension in an output folder, and vice versa.

The vanilla data generator can convert any GZip compressed NBT format to SNBT format. You can simply change the file extension of a file, such as level.dat to level.nbt and put it in the input folder, and the generator will decode the GZip compressed NBT data.

Third-Party

The community has developed programs to view and modify compressed and uncompressed NBT files:

Name NBT Version Description Screenshot
CL-NBT 19132 CL-NBT is an NBT implementation in Common Lisp that can read and write NBT files and load and save McRegion files. Anvil format works with slight modification.
MineBack Ultimate 19133 MineBack Ultimate provides a full NBT editor supporting all available types of NBT format file (Map, Level, World etc.). It comes with a modern GUI and many helper functions. File:MineBackNBTEditor.png
NBT for Python 19133 Library to parse & write NBT files, both standalone or in region files, in the Python scripting language. Provided with application examples for inspecting & editing the Minecraft data files (block / chest / mobs statistics and simple world mapping). Supports old McRegion, pre-flattened and latest Anvil formats.
NBTEdit 19132 Allows for viewing and modifying NBT files via a Windows tree control. It is outdated not only from being an NBT version behind, but because it does not support multiple tags with the same name and it forces incorrect ranges on some types, and it lacks support for uncompressed NBT files. File:NBTEdit Level.Dat.png
NBTExplorer - Forum Post 19133 Inspired by and based on NBTEdit, this program allows viewing and editing of NBT files via a Windows tree control. It supports compressed and uncompressed NBT files, and allows for direct editing of the NBT structures in MCRegion and Anvil files, level.dat, etc. File:NBTExplorer.png
NBT grammar for Synalyze It! 19132 Using this grammar Synalyze It! displays a color-coded hex dump along with the parsed tag tree. Currently only uncompressed files are supported. File:Synalyze-It-NBT-decoded.png
NEINedit 19132 NBT editor for mac with a text-based tree structure. File:NEINedit.png
NBT2YAML 19133 nbt2yaml presents a command line interface for reading and editing Minecraft NBT files using a custom YAML format. It also includes a Python API for parsing and writing NBT files to/from a simple Python data structure.
webNBT 19133 webNBT is an NBT-editor that runs in modern browsers without requiring the user to download an application or use third-party browser plugins (like Flash or Java).

History

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

'''Gunpowder''' is an item that is used for [[explosion]]-related recipes, and as an ingredient in potions.

== Obtaining ==

=== Mob loot ===

==== Creepers ====

[[Creeper]]s can drop 0-2 pieces of gunpowder upon death. [[Looting]] can increase this by one per level, with a maximum of 5 gunpowder.

==== Ghasts ====

[[Ghast]]s can drop 0-2 pieces of gunpowder upon death. Looting can increase this by one per level, with a maximum of 5 gunpowder.

==== Witches ====

[[Witch]]es can drop 0-6 pieces of gunpowder upon death. Looting can increase this by three per level, with a maximum of 15 gunpowder.
<!--
=== Crafting ===

{{Crafting
|showdescription=1
|description= {{only|bedrock|education}}
|Coal; Charcoal
|Sulfur
|Bone Meal
|Output= Gunpowder, 3
|type= Miscellaneous
}}
-->
=== Trading ===

<!--Wandering trader always offer one of the 5 item (one of them is gunpowder)-->

[[Wandering trader]]s have {{frac|1|6}} chance to sell gunpowder for an [[emerald]].

=== Chest loot ===

{{LootChestItem|gunpowder}}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Brewing ingredient ===
{{brewing
  |name=[[Splash Potion]]
  |showname=1
  |Gunpowder
  |Splash Mundane Potion; Splash Potion of Healing; Splash Potion of Fire Resistance; Splash Potion of Harming; Splash Potion of Poison; Splash Potion of Regeneration; Splash Potion of Slowness; Splash Potion of Strength; Splash Potion of Swiftness; Splash Potion of Weakness; Splash Potion of Night Vision; Splash Potion of Invisibility; Splash Potion of Water Breathing; Splash Potion of Leaping
  |base=Any Potion
}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gunpowder
|spritetype=item
|nameid=gunpowder
|id=328
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100130|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder.
|Gunpowder is a [[crafting]] ingredient for [[TNT]]. 
|Gunpowder can be [[drops|dropped]] by any [[mob]].}}
{{History||20100219|Gunpowder now [[drops]] only from [[creeper]]s.}}
{{History|java infdev}}
{{History||20100625-2|Gunpowder can now be found in [[dungeon]] [[chest]]s.}}
{{History|java alpha}}
{{History||v1.2.0|snap=preview|Added [[ghast]]s, which [[drops|drop]] gunpowder upon [[death]].{{needs testing|was their gunpowder dropping present in the preview version, or added later on?|type=untestable}}}}
{{History|java beta}}
{{History||1.0|The item now has a display name: ''Sulphur''.}}
{{History||1.3|''Sulphur'' has been renamed to ''Gunpowder''.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 4|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||1.2.1|snap=12w04a|[[Fire charge]]s are now [[crafting|crafted]] with gunpowder.}}
{{History||1.4.2|snap=12w38b|[[Witch]]es may now [[drops|drop]] gunpowder.}}
{{History||1.4.6|snap=12w49a|Gunpowder can now be used to craft a [[firework star]] and a [[firework rocket]].}}
{{History||1.9|snap=15w44a|Gunpowder now generates in [[desert temple]] [[chest]]s.
|The average yield of gunpowder in [[dungeon]] chests has now doubled.}}
{{History||1.11|snap=16w39a|Gunpowder can now be found in [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 289.}}
{{History|||snap=18w11a|Gunpowder can now generate in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History|||snap=19w05a|Added [[wandering trader]]s, which sell gunpowder.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}
{{History||1.20|snap=23w12a|The probability for the gunpowder to generate in [[suspicious sand]] in [[desert temple]]s has been changed from 1/7 to 1/8.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Gunpowder JE1 BE1.png|32px]] Added gunpowder. It is currently unobtainable and serves no purpose.}}
{{History||v0.3.3|Gunpowder now drops from [[creeper]]s. It is still unobtainable due to creepers not yet spawning naturally.}}
{{History||v0.4.0|Creepers now spawn naturally, making gunpowder obtainable in Survival mode.
|Gunpowder can now be used to craft [[TNT]].}}
{{History||v0.12.1|snap=build 1|Added gunpowder to the [[creative]] [[inventory]].
|Gunpowder is now usable in [[brewing]] to create [[splash potion]]s.}}
{{History||v0.13.0|snap=build 1|Gunpowder can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.14.0|snap=build 1|Gunpowder can now be dropped by [[witch]]es.}}
{{History||v0.15.0|snap=build 1|Gunpowder can now be used to craft [[fire charge]]s.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gunpowder now generates inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gunpowder can now be used to craft [[firework rocket]]s and [[firework star]]s.}}
{{History||1.4.0|snap=beta 1.2.14.2|Gunpowder now generates inside [[shipwreck]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Gunpowder JE2 BE2.png|32px]] The texture of gunpowder has been changed.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Gunpowder now drops when brushing [[suspicious sand]] in [[desert pyramid]]s.}}

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

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

== Issues ==
{{issue list}}

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--gunpowder Taking Inventory: Gunpowder] – Minecraft.net on June 21, 2019

{{Items}}

[[Category:Recipe using Charcoal]]

[[cs:Střelný prach]]
[[de:Schwarzpulver]]
[[es:Pólvora]]
[[fr:Poudre à canon]]
[[hu:Puskapor]]
[[it:Polvere da sparo]]
[[ja:火薬]]
[[ko:화약]]
[[nl:Buskruit]]
[[pl:Proch]]
[[pt:Pólvora]]
[[ru:Порох]]
[[th:ดินปืน]]
[[tr:Barut]]
[[uk:Порох]]
[[zh:火药]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li><li>[[Popped Chorus Fruit|Popped Chorus Fruit]]<br/>{{Item
| image = Popped Chorus Fruit.png
| renewable =  Yes
| stackable = Yes (64)
}}

'''Popped chorus fruit''' is an [[item]] obtained by [[smelting]] [[chorus fruit]], and used to craft [[end rod]]s and [[purpur blocks]]. Unlike raw chorus fruit, the popped fruit is inedible.

== Obtaining ==
=== Smelting ===
{{Smelting
|Chorus Fruit
|Popped Chorus Fruit
|0,1
}}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Popped Chorus Fruit
|spritetype=item
|nameid=popped_chorus_fruit
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Popped Chorus Fruit
|spritetype=item
|nameid=popped_chorus_fruit
|aliasid=chorus_fruit_popped
|id=559
|form=item
|translationkey=item.chorus_fruit_popped.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.9|snap=15w31a|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit. 
|Popped chorus fruit are used to craft [[purpur block]]s.}}
{{History|||snap=15w44b|Popped chorus fruit are now used to craft [[end rod]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 433.}}
{{History|||snap=pre5|The ID of popped chorus fruit has now been changed to <code>popped_chorus_fruit</code>.}}
{{History||1.14|snap=18w43a|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}}

{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of popped chorus fruit has been changed from <code>chorus_fruit_popped</code> to <code>popped_chorus_fruit</code>.}}

{{History|console}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Popped Chorus Fruit JE2 BE2.png|32px]] The texture of popped chorus fruit has now been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Popped Chorus Fruit JE1 BE1.png|32px]] Added popped chorus fruit.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

[[cs:Vypukaný květ chorusu]]
[[de:Geplatzte Chorusfrucht]]
[[fr:Chorus éclaté]]
[[it:Frutto di chorus scoppiato]]
[[ja:焼いたコーラスフルーツ]]
[[ko:튀긴 후렴과]]
[[nl:Gepoft Chorusfruit]]
[[pl:Prażony owoc refrenusu]]
[[pt:Fruta do coro cozida]]
[[ru:Приготовленный плод коруса]]
[[zh:爆裂紫颂果]]
[[Category:Renewable resources]]</li></ul>
September 28, 2011Notch works on "saving arbitrary data with item instances."
1.12
{{Extension DPL}}<ul><li>[[Purple Dye|Purple Dye]]<br/>{{Item
| image = Purple_Dye_JE2_BE2.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Purple dye''' is a [[Dyeing#Secondary colors|secondary dye color]] created by combining [[red dye]] and [[blue dye]] in a crafting grid.

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showname=0
  |Blue Dye
  |Red Dye
  |Output=Purple Dye,2
  |type=Material
}}
{{Crafting
  |foot=1
  |Lapis Lazuli
  |Red Dye
  |Output=Purple Dye,2
  |description={{only|bedrock|education}}
  |type=Material
}}

=== Trading ===

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

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===

Apprentice-level Shepherd villagers have a 20% chance to buy 12 purple dye for an emerald as part of their trades.{{only|bedrock}}

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Purple Dye
|spritetype=item
|nameid=purple_dye
|aliasid=dye / 5
|id=400
|form=item
|translationkey=item.dye.purple.name
|foot=1}}

== Video ==

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

== History ==

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

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

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

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

== Issues ==

{{issue list}}

{{Items}}

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

[[cs:Fialové barvivo]]
[[de:Violetter Farbstoff]]
[[es:Tinte morado]]
[[fr:Teinture violette]]
[[hu:Lila festék]]
[[ja:紫色の染料]]
[[ko:보라색 염료]]
[[nl:Paarse kleurstof]]
[[pl:Fioletowy barwnik]]
[[pt:Corante roxo]]
[[ru:Фиолетовый краситель]]
[[zh:紫色染料]]</li><li>[[Bamboo|Bamboo]]<br/>{{for|the plant feature|Bamboo (feature)}}
{{Distinguish|text = [[Sugar Cane]], which was colloquially known as Bamboo}}
{{Block
| image = <gallery>
Leafless Bamboo.png|Leafless
Small Leaves Bamboo.png|Small
Big Leaves Bamboo.png|Big
Leafless Old Bamboo.png|Leafless Old
Small Leaves Old Bamboo.png|Small Old
Big Leaves Old Bamboo.png|Big Old
</gallery>
| image2 = Bamboo Shoot.png<!--different infobox for this later down the line, like with pistons?-->
| image3 = Bamboo (item) JE1 BE1.png
| transparent = Yes
| light = No
| tool = Sword
| tool2 = Axe
| renewable = Yes
| stackable = Yes (64)
| flammable = '''Bamboo''': Yes (60)<br>'''Shoot''': No
| lavasusceptible = Yes
}}
'''Bamboo''' is a versatile, fast-growing, [[Bone Meal|bonemealable]] [[plant]] found primarily in [[jungle]]s, which is used for [[crafting]] (particularly [[scaffolding]] and [[Block of Bamboo|bamboo wood]]), [[smelting]] and [[breeding]] [[Panda|pandas]]. 

A '''bamboo shoot''' is the initial non-solid sapling form of planted bamboo.

== Obtaining ==
Bamboo shoots cannot be obtained through vanilla means. {{IN|bedrock}}, they can be obtained through [[add-on]]s or inventory editing. {{IN|java}}, they are completely unobtainable.

=== Breaking ===
Bamboo can be mined with any [[tool]], but a [[sword]] breaks the block [[instant mining|instantly]], even with [[Mining Fatigue]]. Flowing [[water]] also breaks bamboo shoots, but not mature bamboo stalks.

{{breaking row|Bamboo|Sword|sword=1|horizontal=1}}
{{notelist}}
=== Natural generation ===
Bamboo generates in widely scattered single shoots within [[jungle]] [[biome]]s. Bamboo generates much more densely in the [[bamboo jungle|bamboo variant]]s of jungles, covering large areas of the landscape. Bamboo does ''not'' generate in [[sparse jungle]]s.<ref>{{bug|MC-156638|||WAI}}</ref>

=== Mob loot ===
{{IN|java}}, a [[panda]] drops 1 bamboo when killed. [[Looting]] does not affect the drop rate.<ref>{{bug|MC-160006}}</ref>

{{IN|bedrock}}, a panda drops 0-2 bamboo when killed. Looting increases the drop by 1 per level.

=== Fishing ===
Bamboo can be found while [[fishing]] in [[jungle]] [[biome]]s as a junk [[item]].

=== Chest loot ===
{{LootChestItem|bamboo}}

== Usage ==
When broken, any bamboo [[block]] placed or grown above it is also broken. A bamboo block drops itself as an [[item]] if a [[piston]] pushes it or moves a block into its space. When bamboo is first placed as a shoot it's not solid and can be destroyed by water flowing into it. After growing at least one block taller it becomes solid and can't be destroyed by water. To transform a bamboo shoot into a solid bamboo block place another bamboo on top of it.

Unlike most plants, bamboo cannot be [[Composter#Composting|composted]].<ref>{{bug|MC-142452|||WAI}}</ref>

=== Farming ===
Bamboo can be planted on [[moss block]]s{{only|java|short=1}}, [[grass block]]s, [[dirt]], [[coarse dirt]], [[rooted dirt]], [[gravel]], [[mycelium]], [[podzol]], [[sand]], [[red sand]], [[suspicious sand]], [[suspicious gravel]], [[mud]], bamboo shoot, or on itself. At default random tick speed (3), each plant grows on average every {{convert|4096|ticks|seconds}}. When [[bone meal]] is {{control|used}} on it, it grows by 1–2 [[blocks]]. Bamboo can grow up to 12–16 blocks tall. The top of a bamboo plant requires a [[light]] level of 9 or above to grow.

Because bamboo breaks in almost the same way as [[sugar cane]]s, [[Tutorials/Sugar cane farming|a sugar cane farm]] can be easily adapted to this use. While water is not needed with such a farm, some spacing is recommended if the harvest is done manually as mature stalks are solid.

=== Pandas ===
Bamboo [[item]]s are eaten by [[panda]]s and can be used to speed up the growth of baby pandas. Bamboo can also be used to breed pandas when at least 8 [[block]]s of bamboo are within 5 blocks of the pandas, making the panda the only animal in the game to have extra breeding requirements. At this point, the [[player]] can feed them bamboo and they [[breeding|mate]] to have a baby.

=== Fuel ===
Bamboo can be used as fuel for [[smelting]]. Each bamboo item smelts 0.25 [[item]]s. Crafting two bamboo into a [[stick]] and using that as fuel is equivalent, smelting 0.5 items. 

Bamboo can be crafted into other items to increase its fuel efficiency.
* By crafting 9 bamboo into 2 [[bamboo planks]], 3 items can be smelted instead of 2.25, a 33.3% increase in efficiency.
** {{IN|bedrock}}, the fuel efficiency can be further doubled by crafting the bamboo planks into twice the amount of [[slab]]s.<ref>{{bug|MCPE-94368||Wooden slabs last for the same amount of time as planks in a furnace}}</ref>
* {{IN|java}}, by crafting 14 bamboo into 3 [[ladder]]s, 4.5 items can be smelted instead of 3.5, a 28.6% increase in efficiency.

=== Flower pots ===
Bamboo can be placed in a [[flower pot]], where it retains the design it has in its item form.

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

== Appearance ==
[[File:Bamboo stages.png|thumb|The different stages of bamboo growth.]]

The appearance of bamboo changes as it grows. When first placed, it takes the form of a small shoot, which has no [[hitbox]]. When it grows one [[block]] taller it grows to 2 pixels in length and width and the top block has leaves coming off it. At 3 blocks, the top 2 blocks have leaves and at 4 blocks the bamboo expands to 3×3 pixels. At 5 blocks tall, the top 3 blocks have leaves on them. As the bamboo grows, the leaves move up and stay at the top 3 blocks. Destroying a block of bamboo does not change the appearance of the blocks below it. Bamboo is oriented at a random position in the block that it is in.

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

=== Bamboo Shoot ===
{{Sound table/Block/Bamboo shoot}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bamboo
|spritetype=block
|nameid=bamboo
|blocktags=bamboo_plantable_on}}
{{ID table
|displayname=Bamboo Shoot
|spritetype=block
|nameid=bamboo_sapling
|blocktags=bamboo_plantable_on
|form=block
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Bamboo
|spritetype=block
|nameid=bamboo
|id=418}}
{{ID table
|displayname=Bamboo Sapling
|spritetype=block
|nameid=bamboo_sapling
|id=419
|form=block
|translationkey=-
|foot=1}}

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

{{/BS}}

== Achievements ==
{{load achievements|Zoologist}}

== History ==
{{History||September 29, 2018|link={{tweet|minecraft|1046096508570009602}}|Bamboo is announced at [[MINECON Earth 2018]].}}
{{History|java}}
{{History||1.14|snap=18w43a|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.
|Added [[bamboo jungle]]s, where bamboo naturally generates.}}
{{History||1.16|snap=20w06a|"Bamboo Sapling" has been renamed to "Bamboo Shoot".}}
{{History|||snap=20w13a|Bamboo 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=21w13a|Bamboo can now be planted on rooted dirt.}}
{{History|||snap=21w16a|Bamboo can now be planted on moss blocks.}}
{{History||1.18|snap=21w39a|Bamboo no longer generates underground.<ref>{{bug|MC-145376}}</ref><ref>{{bug|MC-214894}}</ref>}}
{{History||1.19|snap=22w15a|Bamboo can now be planted on mud.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Bamboo can now be used to craft [[bamboo planks]].}}
{{History|||snap=22w45a|Bamboo can no longer be used to craft bamboo planks.|Bamboo can now be used to craft a [[block of bamboo]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|Bamboo can now be planted on [[suspicious sand]].}}
{{History||1.20|snap=23w14a|Bamboo can now be planted on [[suspicious gravel]].}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.8|[[File:Leafless Bamboo BE1.png|32px]] [[File:Small Leaves Bamboo BE1.png|32px]] [[File:Big Leaves Bamboo BE1.png|32px]] [[File:Leafless Old Bamboo BE1.png|32px]] [[File:Small Leaves Old Bamboo BE1.png|32px]] [[File:Big Leaves Old Bamboo BE1.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.}}
{{History||1.9.0|snap=beta 1.9.0.0|Bamboo can now generate in [[jungle]] [[biome]]s in single shoots.
|Added [[bamboo jungle]]s, where bamboo naturally generates.}}
{{History||1.12.0|snap=beta 1.12.0.3|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] The bamboo texture brightness has been updated to match {{el|je}}.<ref>{{bug|MCPE-42635}}</ref>}}
{{History||1.17.30|snap=beta 1.17.20.20|Swords now break bamboo instantly to match ''Java Edition''.<ref>{{bug|MCPE-64013}}</ref>}}
{{History||1.20.0|link=Bedrock Edition 1.20.0|snap=beta 1.19.50.21|Bamboo can now be used to craft [[bamboo planks]].}}
{{History|||snap=beta 1.19.60.20|Bamboo can no longer be used to craft bamboo planks.|Bamboo can now be used to craft a [[block of bamboo]].}}

{{History|console}}
{{History||xbox=none|xbone=none|ps=1.83|wiiu=none|switch=none|[[File:Leafless Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Bamboo JE1 BE2.png|32px]] [[File:Leafless Old Bamboo JE1 BE2.png|32px]] [[File:Small Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Big Leaves Old Bamboo JE1 BE2.png|32px]] [[File:Bamboo Shoot JE1 BE1.png|32px]] Added bamboo.
|[[File:Bamboo (item) JE1 BE1.png|32px]] Bamboo as an [[item]] can be [[drops|dropped]] by bamboo and planted to grow bamboo.}}
{{History|foot}}

=== Bamboo shoot "item" ===
{{:Technical blocks/Bamboo Shoot}}

== Issues ==
{{Issue list}}

== Trivia ==
* Because bamboo grows quickly (on average 1 growth per 200 seconds), just 500 plants in an automatic farm produce more [[item]]s than a [[hopper]] can collect (2.5 items per second). A single hopper can move only enough items to keep 6.25 [[furnace]]s running.
* Bamboo is the fastest-growing plant in ''[[Minecraft]]'', which reflects its status as the fastest-growing plant known in real life.
* While bamboo cannot be composted in ''Minecraft'', it can be composted in real life.

== Gallery ==
<gallery>
File:PandaMinecon.png|The first image featuring bamboo, from [[MINECON Earth 2018]].
File:PandasEatingMinecon.jpg|A group of [[Panda|pandas]] eating bamboo, shown at [[MINECON Earth 2018]].
File:Growing bamboo BE.png|Planted bamboo growing.
File:Bamboo in tree.png|A bamboo shoot growing through a [[tree]].
File:Bamboo Jungle.png|Bamboo seen in a [[jungle]] [[biome]] variant.
File:Bamboo Jungle in Amplified world.png|Bamboo Jungle in an [[Amplified]] world in 1.19-rc2.
File:Naturalbamboo.png|Multiple naturally generated bamboo stems growing by a river.
File:Tall Bamboo.png|Grown Bamboo with three parts
File:Zuri Chopping Bamboo Pixel Art.png|[[Zuri]] chopping down bamboo for a baby panda.
File:Bamboo Wallpaper.png|Smartphone wallpaper of the aforementioned artwork, showing more of the treetops and bamboo.
File:Panda Packaging.jpg|Packing for the ''Diamond Level Panda'', modeled after bamboo.
</gallery>

==References==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Bambus]]
[[de:Bambus]]
[[es:Bambú]]
[[fr:Bambou]]
[[it:Bambù]]
[[ja:竹]]
[[ko:대나무]]
[[pl:Bambus]]
[[pt:Bambu]]
[[ru:Бамбук]]
[[th:ไม้ไผ่]]
[[zh:竹子]]</li></ul>
?Added long array tags.
1.13
{{Extension DPL}}<ul><li>[[Magma Cream|Magma Cream]]<br/>{{Item
| title = Magma Cream
| image = Magma Cream.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Magma cream''' is an [[item]] used in [[brewing]] to create [[potion]]s of [[Fire Resistance]], and to manually craft [[magma block]]s.

== Obtaining ==

=== Mob loot ===

==== Magma cubes ====

All but tiny-sized [[magma cube]]s drop 0–1 magma cream. The maximum amount of magma cream is increased by 1 per level of [[Looting]], for a maximum of 4 with Looting III.

=== Crafting ===

{{Crafting
|Blaze Powder
|Slimeball
|Output= Magma Cream
|type= Brewing
}}

=== Chest Loot ===
{{LootChestItem|magma-cream}}

== Usage ==

=== Brewing ingredient ===

{{brewing
  |showname=1
  |head=1
  |Magma Cream|Mundane Potion|base=Water Bottle
}}
{{brewing
  |foot=1
  |Magma Cream
  |Potion of Fire Resistance
}}

=== Crafting ingredient ===

{{crafting usage}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Magma Cream
|spritetype=item
|nameid=magma_cream
|id=430
|form=item
|foot=1}}

== History ==

{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Magma Cream JE1.png|32px]] Added magma cream.}}
{{History|||snap=Beta 1.9 Prerelease 3|Magma cream can now be [[brewing|brewed]] in a [[water bottle]] to create a mundane [[potion]], or in an awkward potion to create a potion of [[Fire Resistance]].}}
{{History||1.1|snap=release|[[Magma cube]]s now [[drops|drop]] magma cream.}}
{{History||1.3.1|snap=1.3|[[File:Magma Cream JE2 BE1.png|32px]] The texture of magma cream has been changed.}}
{{History||1.10|snap=16w20a|Magma cream can now be [[crafting|crafted]] into [[magma block]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 378.}}
{{History||1.14|snap=18w43a|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}
{{History||1.16|snap=20w07a|Magma cream has a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 1–3.}}
{{History|||snap=20w09a|Magma cream now has a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w16a|Magma cream now generates in [[bastion remnant]]s chests.}}
{{History||1.16.2|snap=20w28a|Magma cream can no longer be obtained from bartering with piglins.}}
{{History|||snap=20w30a|The average yield of magma cream from bastion remnant chests has been slightly increased.}}

{{History|pocket edition alpha}}
{{History||v0.11.0|snap=build 1|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.
|Magma cream is currently unobtainable.}}
{{History||v0.11.0|snap=build 8|[[Magma cube]]s now [[drops|drop]] magma cream.}}
{{History||v0.12.1|snap=build 1|Added magma cream to the [[Creative]] mode [[inventory]].
|Magma cream can now be [[crafting|crafted]].}}
{{History|pocket}}
{{History||1.1.3|snap=alpha 1.1.3.0|Magma cream can now be crafted into [[magma block]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.57|Magma cream can be obtained from bartering with piglins.
|Magma cream can now be found in [[bastion remnants]] chests.}}
{{History||1.16.100|snap=beta 1.16.100.54|Magma cream can no longer be obtained from [[barter]]ing with [[piglin]]s.}}

{{History|console}} 
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Magma Cream JE3 BE2.png|32px]] The texture of magma cream has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Magma Cream JE2 BE1.png|32px]] Added magma cream.}}
{{history|foot}}

== Issues ==

{{issue list}}

{{items}}

[[Category:Renewable resources]]

[[cs:Lávová pěna]]
[[de:Magmacreme]]
[[es:Crema de magma]]
[[fr:Crème de magma]]
[[hu:Magmakrém]]
[[ja:マグマクリーム]]
[[ko:마그마 크림]]
[[lzh:火漿膏]]
[[nl:Magmacrème]]
[[pl:Magmowy krem]]
[[pt:Creme de magma]]
[[ru:Лавовый крем]]
[[th:ครีมแมกม่า]]
[[uk:Магмовий крем]]
[[zh:岩浆膏]]</li><li>[[Nautilus Shell|Nautilus Shell]]<br/>{{Item
| type =
| stackable = Yes (64)
| renewable = Yes
}}

A '''nautilus shell''' is an item that is used for crafting [[conduit]]s.

==Obtaining==
===Fishing===
{{main|Fishing#Junk and treasure}}
Nautilus shells can be rarely obtained as a treasure item from fishing. The drop chances of nautilus shells slightly increase with each level of [[Luck of the Sea]] on the [[player]]'s [[fishing rod]].

===Mob loot===
[[Drowned]] have a 3%{{only|java|short=1}} or 8%{{only|bedrock|short=1}} chance to spawn with a nautilus shell in their off-hand, and this nautilus shell always drops upon [[death]].

===Trading===
[[Wandering trader]]s may [[trading|sell]] a nautilus shell for 5 [[emerald]]s each, but they only sell 5 of them at a time.

==Usage==
{{IN|bedrock}}, a nautilus shell is one of the few items that can be held in the off-hand.

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

=== Trading ===
Nautilus shells can be given to trident-wielding drowned with a chance for the drowned to pick up the shell and drop the trident.<sup>[''[[Bedrock Edition]] only'']</sup>

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Nautilus Shell
|spritetype=item
|nameid=nautilus_shell
|id=570
|form=item
|foot=1}}

==History==
{{History|java}} 
{{History||1.13|snap=18w15a|[[File:Nautilus Shell JE1 BE2.png|32px]] Added nautilus shells.}}
{{History||1.14|snap=19w05a|Added [[Wandering Trader|wandering trader]]s, which sell nautilus shells.}}

{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.20.1|[[File:Nautilus Shell BE1.png|32px]] Added nautilus shells.}}
{{History|||snap=beta 1.2.20.2|[[File:Nautilus Shell JE1 BE2.png|32px]] The texture of nautilus shells has now been changed.}}
{{History||1.5.0|snap=beta 1.5.0.0|[[Drowned]] now sometimes spawn holding a nautilus shell.
|Nautilus shells are no longer behind [[Experimental Gameplay]].}}
{{History|||snap=beta 1.5.0.1|Nautilus shells can now be used to craft [[conduit]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Nautilus shells can now be obtained from [[trading]] with [[wandering trader]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Nautilus Shell JE1 BE2.png|32px]] Added nautilus shells.}}
{{History||xbox=none|ps=1.91|wiiu=none|Nautilus shells can now be obtained from [[trading]] with [[wandering trader]]s.}}
{{History|foot}}

==Issues==
{{issue list}}

==Trivia==
*[[wikipedia:Nautilus|Nautilus]]es are animals that occupy deep oceans in the real world. However, they are absent in Minecraft and there are currently no plans to add nautilus [[mob]]s into the game.
*Because {{el|bedrock}} allows for Nautilus shells to be held in the off-hand (since drowned hold them), they are the only item in that version that can be put in the off-hand slot without having a specific function.

{{items}}

[[de:Nautilusschale]]
[[es:Caparazón de nautilo]]
[[fr:Coquille de nautile]]
[[it:Conchiglia di nautilus]]
[[ja:オウムガイの殻]]
[[ko:앵무조개 껍데기]]
[[nl:Nautilusschelp]]
[[pl:Muszla łodzika]]
[[pt:Concha de náutilo]]
[[ru:Раковина наутилуса]]
[[th:เปลือกหอยงวงช้าง]]
[[uk:Мушля наутилуса]]
[[zh:鹦鹉螺壳]]
[[Category:Renewable resources]]</li></ul>
18w01aAdded a data generator to both the Minecraft client and the default multiplayer software.
1.14
{{Extension DPL}}<ul><li>[[Blue Dye|Blue Dye]]<br/>{{Item
|image = Blue_Dye_JE1_BE1.png
|renewable = Yes
|stackable = Yes (64)
}}

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

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

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

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

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

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

== History ==

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

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

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

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

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

[[de:Blauer Farbstoff]]
[[es:Tinte azul]]
[[fr:Teinture bleue]]
[[ja:青色の染料]]
[[ko:파란색 염료]]
[[pl: Niebieski barwnik]]
[[pt:Corante azul]]
[[zh:蓝色染料]]</li><li>[[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>
19w08a String tags can now be within single quotes ' besides double quotes ".[2]

References

  1. ↑ https://wiki.vg/Data_Generators#NBT_converters
  2. ↑ "Allow single quote in strings by boq · Pull Request #52" – Mojang/brigadier – GitHub.
Minecraft: Java Edition
Versions
Development
Version history
Technical
.minecraft
Development resources
Legacy development resources
Multiplayer
Game customization
Deutsch Français 日本語 Nederlands Português Русский 中文
Community content is available under CC BY-NC-SA unless otherwise noted.
More Fandoms
Advertisement

Fan Feed

More Minecraft Wiki