Minecraft Wiki
Advertisement

Template:BlockTileEntity

This article is about the storage block. For the hostile End city mob, see Shulker. For the item that drops from the mob, see Shulker Shell.

A shulker box is a block that can store and transport items.

Obtaining

Breaking

Shulker Boxes can be mined with any tool or by hand, but using a pickaxe is the quickest method.

Block Shulker Box
Hardness 2
Tool
Breaking time[A]
Default 3
Wooden 1.5
Stone 0.75
Iron 0.5
Diamond 0.4
Netherite 0.35
Golden 0.25
  1. Times are for unenchanted tools as wielded by players with no status effects, measured in seconds. For more information, see Breaking § Speed.

Crafting

Name Ingredients Crafting recipe
Shulker Box Shulker Shell +
Chest

Shulker Box Any Shulker Box +
Matching Dye


Creative

When instantly mined in creative mode, shulker boxes will drop as an item if there are items stored within.

Usage

Unlike other storage units, such as chests, shulker boxes keep their items when broken, which can be retrieved when placed again. Shulker boxes will drop as an item if pushed by pistons, and can be placed using dispensers. When holding a shulker box with items inside, the items will be listed as properties.

Item propertiesofficial

Items inside the shulker box are listed below the block type properties.

Shulker boxes can be stored in other containers, though they cannot be stored in other shulker boxes.

A shulker box has 27 inventory slots, the same number as a chest.

By default, the GUI of a shulker box is labeled "Shulker Box", but this name can be customized by naming it in an anvil before placing it, or by changing the CustomName tag using the /blockdata command.

Data values

Block state

See also: Block states

Java Edition:

Name Default value Allowed values Description
facingupdown
east
north
south
up
west
The direction the shulker box is pointing.
The opposite from the direction the player faces while placing the shulker box.

Bedrock Edition:
Dyed shulker box:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
color
(Deprecated)
0x1
0x2
0x4
0x8
white white0White Shulker Box
orange1Orange Shulker Box
magenta2Magenta Shulker Box
light_blue3Light Blue Shulker Box
yellow4Yellow Shulker Box
lime5Lime Shulker Box
pink6Pink Shulker Box
gray7Gray Shulker Box
silver8Light Gray Shulker Box
cyan9Cyan Shulker Box
purple10Purple Shulker Box
blue11Blue Shulker Box
brown12Brown Shulker Box
green13Green Shulker Box
red14Red Shulker Box
black15Black Shulker Box

Block entity

A shulker box has a block entity associated with it that identifies its contents. The block's block entity ID is shulker_box.

  • Block entity data
    • Tags common to all block entities
    •  CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
    •  Items: List of items in this container.
      • : An item, including the slot tag. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
        • Tags common to all items
    •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.
    •  LootTable: Optional. Loot table to be used to fill the shulker box when it is next opened, or the items are otherwise interacted with.[note 1]
    •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted uses a random seed.[note 1]
  1. a b Both loot table tags are removed once the items have been generated.

Item data

Shulker boxes, as items, use an NBT tag BlockEntityTag to indicate the contents and details of the box when it is placed.

The following NBT structure is provided to show how the BlockEntityTag tag is organized, and is not comprehensive above the tag tag. The full NBT for an item can be found here.

  • Entity data
    •  Item: The item
      •  tag: Additional information about the item. This tag is optional for most items.
        •  BlockEntityTag: The details of the shulker box
    •  CustomName: Optional. The name of this container in JSON text component, which appears in its GUI where the default name ordinarily appears.
    •  Lock: Optional. When not blank, prevents the container from being opened unless the opener is holding an item whose name matches this string.

Chunk format/Items

            • : An item, including the slot tag. Shulker box slots are numbered 0–26, 0 starts in the top left corner.
              • Tags common to all items
          •  LootTable: Optional. Loot table to be used to fill the shulker box when it is next opened, or the items are otherwise interacted with.[note 1]
          •  LootTableSeed: Optional. Seed for generating the loot table. 0 or omitted will use a random seed.[note 1]
  1. a b Both loot table tags will be removed once the items have been generated.

History

release
1.11
{{Extension DPL}}<ul><li>[[Fermented Spider Eye|Fermented Spider Eye]]<br/>{{Item
| image = Fermented Spider Eye.png‎
| renewable = Yes
| stackable = Yes (64)
}}

A '''fermented spider eye''' is a [[brewing]] ingredient.

== Obtaining ==

=== Crafting ===

{{Crafting
|Brown Mushroom
|Sugar
|Spider Eye
|Output= Fermented Spider Eye
|type= Brewing
}}

== Usage ==
They can be used to brew [[potion]]s with negative effects, as well as the [[Potion of Invisibility]]. 

=== Brewing ingredient ===
{{brewing
  |showname=1
  |head=1
  |Fermented Spider Eye
  |Potion of Weakness
  |base=Water Bottle
}}
{{brewing
  |Fermented Spider Eye
  |Potion of Harming
  |base=Potion of Poison;Potion of Healing
}}
{{brewing
  |Fermented Spider Eye
  |Potion of Slowness
  |base=Potion of Swiftness;Potion of Leaping
}}
{{brewing
  |foot=1
  |Fermented Spider Eye
  |Potion of Invisibility
  |base=Potion of Night Vision
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Fermented Spider Eye
|spritetype=item
|nameid=fermented_spider_eye
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Fermented Spider Eye
|spritetype=item
|nameid=fermented_spider_eye
|id=428
|form=item
|foot=1}}

== Video ==

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

== History ==
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|[[File:Fermented Spider Eye JE1 BE1.png|32px]] Added fermented spider eyes.}}
{{History|||snap=Beta 1.9 Prerelease 3|Fermented spider eyes can now be [[brewing|brewed]] in a [[water bottle]] to create a [[potion of Weakness]].
|Fermented spider eyes now corrupt potions of [[Swiftness]] and [[Fire Resistance]] into potions of [[Slowness]], for both normal and extended types.
|Fermented spider eyes now corrupts potions of [[Healing]] and [[Poison]] into potions of [[Harming]], as well as Healing II and extended Poison into extended Harming.}}
{{History||1.4.2|snap=12w34a|Fermented spider eyes now change potions of [[Night Vision]] into the new potions of [[Invisibility]], for both normal and extended types.}}
{{History||1.7.2|snap=13w36a|Fermented spider eyes now corrupt the new [[potion of Water Breathing]] into a potion of Harming.}}
{{History||1.8|snap=14w27a|Fermented spider eyes now corrupt the new [[potion of Leaping]] into a potion of Slowness.}}
{{History||1.9|snap=15w31a|[[Potions of Weakness]] can no longer be made using a [[thick potion]], [[mundane potion]], [[awkward potion]], [[potion of Regeneration]], or [[potion of Strength]].
|[[Potions of Slowness]] can no longer be made using a [[potion of Fire Resistance]].
|[[Potions of Harming]] can no longer be made using a [[potion of Water Breathing]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 376.}}
{{History||1.14|snap=18w50a|[[File:Fermented Spider Eye JE2 BE2.png|32px]] The texture of fermented spider eyes has been changed.}}
{{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 fermented spider eye from the player.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Fermented Spider Eye JE1 BE1.png|32px]] Added fermented spider eyes.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Fermented Spider Eye JE2 BE2.png|32px]] The texture of fermented spider eyes has been changed.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Fermented Spider Eye JE1 BE1.png|32px]] Added fermented spider eyes.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Fermented Spider Eye JE2 BE2.png|32px]] The texture of fermented spider eyes has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Fermented Spider Eye JE1 BE1.png|32px]] Added fermented spider eyes.}}
{{History|foot}}

== Issues ==
{{issue list}}

{{items}}

[[Category:Renewable resources]]

[[cs:Zkvašené pavoučí oko]]
[[de:Fermentiertes Spinnenauge]]
[[es:Ojo de araña fermentado]]
[[fr:Œil d'araignée fermenté]]
[[it:Occhio di ragno fermentato]]
[[ja:発酵したクモの目]]
[[ko:발효된 거미 눈]]
[[nl:Gefermenteerd spinnenoog]]
[[pl:Sfermentowane oko pająka]]
[[pt:Olho de aranha fermentado]]
[[ru:Приготовленный паучий глаз]]
[[th:ตาแมงมุมดอง]]
[[uk:Оброблене павуче око]]
[[zh:发酵蛛眼]]</li><li>[[Footprint|Footprint]]<br/>{{about|the joke item|the unused particle|Java Edition unused features#Footprint particle}}
{{Joke feature}}
{{Item
| image = Footprint (item).png
| renewable = No
| stackable = Yes (64)
}}

The '''Footprint''' was a joke item from [[Java Edition 20w14∞]], found only in the {{code|missing}} dimension.

== Appearance ==
This item is semi-transparent with a grey colour scheme.

== Obtaining ==

=== Dimension ===
Footprints were obtained only from a chest in the {{Code|missing}} dimension. Only existing in 2020 April fools snapshot 20w14∞, it cannot exist in any non-April Fool's joke versions and April Fool's joke versions before or after 20w14∞. There is a maximum of 2 footprints that can be obtained legitimately in any given world.

=== Cheats/Creative Mode ===
Despite these footprints not being available in the creative inventory, it is still possible to acquire them via the command {{Code|code=give <target> minecraft:footprint <amount>}} or duplicating them by holding down middle-click whilst in creative mode.

== Usage ==
As of snapshot 20w14∞, this item cannot be placed or used in any way other than a trophy. This item can be inserted and/or rotated inside of an item frame, and it has a stack limit of 64.

== Data values ==
=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=Footprint
|spritetype=item
|nameid=footprint
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||20w14∞|[[File:Footprint (item).png|32px]] Added the footprint item.}}
{{History|foot}}

== Gallery ==
<gallery>
File:Missing biome.png|The Easter Egg dimension that the item spawns in.
</gallery>

== Trivia ==
* This is a reference to the removed "Footstep" particle, hence in the "missing" dimension.
** This item is intended as a joke directed towards the commands' community where the "Footstep" particle is commonly requested.<ref>https://gist.github.com/boq/8e65cb85badc75765eeb8956af78aaa5</ref>

== References ==
{{reflist}}

{{Items}}
{{Jokes}}

[[Category:Non-renewable resources]]
[[Category:Joke items]]

[[es:Footprint]]
[[pt:Pegada]]</li></ul>
16w39aShulker box added.
16w39cSilver shulker boxes are now called light gray, in keeping with naming consistencies across dyed blocks.
upcoming
1.12
{{Extension DPL}}<ul><li>[[Knowledge Book|Knowledge Book]]<br/>{{exclusive|java}}
{{Item
| image = Knowledge Book.png
| renewable = No
| stackable = No
| rarity = Epic
}}
A '''knowledge book''' is a utility item that reveals available [[crafting]] recipes to the player when {{control|used|use}}.

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

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

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

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

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

{{Items}}

[[Category:Non-renewable resources]]

[[de:Buch des Wissens]]
[[es:Enciclopedia]]
[[fr:Livre des connaissances]]
[[ja:知恵の本]]
[[ko:지식의 책]]
[[lzh:天工開物]]
[[pl:Księga wiedzy]]
[[pt:Enciclopédia]]
[[ru:Книга знаний]]
[[zh:知识之书]]</li><li>[[Map|Map]]<br/>{{about|the craftable map|maps showing the locations of certain structures|Explorer Map|other uses|Map (disambiguation)}}
{{distinguish|World}}
{{Item
| image = Map Zoom 4.png
| renewable = Yes
| stackable = Yes (64)
}}

A '''map''' is an [[item]] used to view explored [[Chunk|terrain]] and mark landmarks.

==Obtaining==
===Crafting===
{{crafting
|head=1
|showname=0
|showdescription=1
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Compass
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description=This variation is called an "empty locator map" {{in|bedrock}}, or an "empty map" {{in|java}}.

When the player first creates a map, it is blank. It needs to be activated by holding it and pressing ''{{Control|use item}}''. after which it records terrain and location markers as the player travels within (or close to) the area it maps.
}}
{{crafting
|A1= Paper
|B1= Paper
|C1= Paper
|A2= Paper
|B2= Paper
|C2= Paper
|A3= Paper
|B3= Paper
|C3= Paper
|Output= Empty Map
|type= Miscellaneous
|description={{only|bedrock}}

This variation is called an "empty map". It does not show location markers. It is intended for cloning and zooming locator maps without having to consume an additional [[compass]] (thereby saving [[iron ingot]]s and [[redstone dust]]), but it can also be {{Control|use|text=activated}} and later converted to a locator map by combining it with a compass on an [[anvil]], [[crafting table]], or [[cartography table]].
|foot=1
}}

=== Natural generation ===
==== Chest loot ====
{{LootChestItem|empty-map,map 
}}

=== Cartography table ===
A map can also be created using a single paper on a [[cartography table]] to create an empty map, or a paper with a compass for an empty locator map.{{only|bedrock}}

=== Starting map ===
{{exclusive|bedrock|section=1}}
When creating a new world {{in|bedrock}}, the player can enable the "Starting Map" option to spawn with an empty locator map in the hotbar. The map's zoom scale is 1:8. The map is updated only while the player holds it.

=== Trading ===
Novice-level cartographer [[Villager|villagers]] sell a single empty map for 7 [[Emerald|emeralds]] as their trades.

{{IN|java}}, cartographer villagers may give players with the [[Hero of the Village]] effect an empty map.

== Usage ==
{{See also|Tutorials/Mapping}}

=== Mapping ===

Crafting a map creates an empty map. The map is drawn for the first time when it is held and used (with ''{{control|use item}}''). This map can then be adjusted to different zoom levels. After conversion to a drawn map item, it starts to draw a top-down view of the player's surroundings, with North pointing to the top of the map. A pointed oval pointer indicates the player's position on the map, and moves in real-time as the player moves across the terrain shown on the map. The map does ''not'' center on the player when created, rather, the world is broken up into large invisible grid squares, and the map displays the area of whichever grid square it is in when it is first used. For example, if a player uses a new map in a certain grid square, and then moves a distance away and uses another fresh map but is still within the same grid square, both maps appear identical. To make a map that is not identical to the first one, the player would have to move outside of the edges of the first map (because then they would be in a new grid square). This way, no two maps of the same size can ever partially overlap and every map can display only a fixed area.

To record the world on a map, that specific map must be held in the player's hands while the player moves around the world. The world is recorded as-is during exploration, meaning that if the world is modified, a player must revisit the area while holding the map to update the map's view. Maps can also be [[Map#Cloning|cloned]]. If a player holds a map whose clone is on display in an item frame, then that map updates while holding its clone. 

Other players are displayed on the map only if they have a map in their inventory cloned from the one being looked at. When placing a map into an [[item frame]], the map displays with a green pointer shown at the location of the item frame. This is to help the player see where they are in relation to the area that the map is showing. If the player leaves a map in an item frame and views a clone of it, the green pointer remains in the spot of the framed copy. This can be used to set up waypoints. Unexplored areas are transparent, making the item frame visible.

When the player leaves the area shown on a specific map, the player pointer transforms into a white dot on that map. The marker shrinks to a smaller white dot if the player is far from the map's center: the area is 320 by 320 blocks per scale factor. The dot moves along the edge of the map to show the relative location of the player. However {{in|bedrock}}, the pointer remains as an arrow but shrinks until the player is near the area shown on the map.

While maps in [[the Nether]] work, they show only the red-and-gray pattern, regardless of the blocks placed. The only useful function is finding where the player is in relation to placed framed maps, which show as green pointers.  Additionally, the player pointer rapidly spins and is not a good indicator of direction. Placing a [[banner]] in [[the Nether]] still shows it on the map as usual.  Having a smaller map image while riding a [[strider]] in the Nether can help one to see one's footing while traveling over [[lava]].

{{IN|java}}, when using a map from another dimension, the map shows the player's position and direction when they were last in the dimension of the map. {{IN|bedrock}}, however, the player can use maps from one dimension while in another dimension. For locator maps, the place marker changes color depending on the dimension that the player is currently in (white for the Overworld, red for [[the Nether]], and magenta for [[the End]]). An Overworld map in the Nether shows the player's corresponding location and direction in the Overworld.<ref name=multiverse>{{ytl|EpP1diZdEdI}}</ref> Similarly, a Nether Map in the Overworld shows the player's corresponding location in the Overworld, but the place marker spins, just like a Nether map in the Nether. An Overworld map in the End shows the world spawn.<ref name=multiverse/> A Nether map cannot be used in the End — the map appears, but the place marker is not shown anywhere — and similarly, an End map cannot be used in the Overworld or the Nether.

A player can make a large piece of pixel art (128×128) facing upward, center a map on it, and place that map in an [[item frame]] to create a custom picture. Locking is recommended. See [[Map item format#Map Pixel Art]] for details on the techniques.

Maps display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the map is full-sized only when held in the dominant hand with both hands free.

=== Map content ===
{{Main|Map item format}}

Maps consist of square pixels arranged like pixels in a 128×128 square pattern, with each pixel representing a square portion of land. {{IN|java}}, the [[Map item format#Color table|color of a map pixel]] generally matches the color of the most common [[opaque]] block in the corresponding area, as seen from the sky. 'Minority blocks' in the target area have no effect on the color of the pixel, thus small features tend to be undetectable on zoomed-out maps.

{{IN|bedrock}}, the [[Map item format#Color table|color of a map pixel]] instead matches the single top-most opaque block in a grid sized by the map magnification pixel size (see the table in the "Player marker and pointer" section below). For example, a 3/4 magnification map has a pixel size of 8x8 blocks; this means the map will read only the top-most opaque blocks at the 0,0 coordinate, the 8,0 coordinate, the 0,8 coordinate, etcetera, ignoring all other blocks in the area. This means that {{in|bedrock}}, map pixel art requires only one block per pixel regardless of map magnification.

{{IN|bedrock}}, grass, foliage and water colors that are biome-dependent are represented accurately on a map.

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Map Zoom 4.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Map item BE.png|216px]]
|-
| Biome colors on ''Java Edition''.
| Biome colors on ''Bedrock Edition''.
|-
|}

Maps also show ground up to about 15 blocks below the surface of the water in oceans as slightly lighter blue, to show where the ground rises. This is not true with land above water. Higher elevations in the world mean lighter colors on the map. The map records the surface even as the player moves below the surface.

A standard map represents 128x128 blocks (1 block per pixel, 8x8 [[chunks]]) but maps can be zoomed-out to represent up to 2048x2048 blocks (16 square blocks per pixel, 128x128 [[chunks]]).

Some relevant distances: 64 blocks (4 chunks) is the update radius from a player in the Overworld and the End. However, it is half this (32 blocks) in the Nether. Also, 1024 blocks is the minimum Overworld distance from a [[nether portal]], at which players can build another portal and expect to reach a new location in the Nether. This is the distance across a 1:8 map, and also from a 1:16 map's center to its edge.

=== Player marker and pointer ===
{{IN|java}}, every map contains a marker that marks the position of the player, and points in the same direction as the player. When a player moves out of a map, a big white dot appears and moves relative to the player's position. The pointer either disappears when the player moves away a certain distance from the border of the map or, in case of [[explorer map]]s, the big white dot changes to a smaller white dot. The distance required for the small white dot to appear(explorer maps) or for the big dot to vanish (normal maps) changes with the scaling of the map.
* '''Level 0/4 :''' 128×128 blocks (each map pixel represents 1 block)
* '''Level 1/4 :''' 256×256 blocks (2×2 blocks per map pixel)
* '''Level 2/4 :''' 512×512 blocks (4×4 blocks per map pixel)
* '''Level 3/4 :''' 1024×1024 blocks (8×8 blocks per map pixel)
* '''Level 4/4 :'''  2048×2048 blocks  (16×16 blocks per map pixel)
{{IN|bedrock}}, a map can be crafted with or without this marker, and a map without a position marker can add one later by adding a compass to the map.  When a map is crafted without a compass, it's simply called an "empty map", but when crafted with a compass, it's called an "empty locator map". The marker also turns red if the player enters the Nether with an Overworld map and shows the player's Overworld location relative to the Nether location. A map created in the End has a purple marker showing the player's location. If an Overworld map is used in the End, a magenta dot appears on the player's spawn point.{{/BE|position}}
{{crafting
|name=Map<br>(with marker)
|ingredients=[[Map]] or Empty Map +<br>[[Compass]]
|showdescription=1
|Map (no markers);Empty Map 
|Compass
|Output= Locator Map;Empty Locator Map
|type= Miscellaneous
|description={{el|be}} only.
Maps crafted from only paper do not show the location marker; to add it, a compass must be added to the map.
|foot=1
}}

{{IN|bedrock}}, a cartography table can also be used to add a pointer to create a locator map or empty locator map. This can be done by adding a compass to paper, or to an empty map or map.

=== Zooming out ===
[[File:Cartography table UI zoom.png|thumb|300px|{{IN|java}}, cartography table's UI, showing the map is being zoomed out.]]

A [[cartography table]] can also be used to zoom out, taking only one piece of paper per zoom level.

A blank map can not be zoomed out. A map has to have something already marked on it for the zooming to be possible.

{{Crafting
  |A1= Paper |B1= Paper |C1= Paper
  |A2= Paper |B2= Map;Locator Map   |C2= Paper
  |A3= Paper |B3= Paper |C3= Paper
  |Output= Map;Locator Map
  |showdescription=1
  |description=Locator Map {{el|be}} only.
}}
{{/BE|zoom}}

==== Zoom details ====
The zooming function starts from when the map is created (zoom level 0) up to its fourth zoom step (zoom level 4).

{| class="wikitable" style="text-align: center" data-description="Zoom levels"
! colspan="2" | 
! Zoom step 0  
! Zoom step 1  
! Zoom step 2  
! Zoom step 3  
! Zoom step 4
|-
! colspan="2" |
| [[File:Map Zoom 0.png|116px|Zoom step 0, 1:1]]
| [[File:Map Zoom 1.png|116px|Zoom step 1, 1:2]]
| [[File:Map Zoom 2.png|116px|Zoom step 2, 1:4]]
| [[File:Map Zoom 3.png|116px|Zoom step 3, 1:8]]
| [[File:Map Zoom 4.png|116px|Zoom step 4, 1:16]]
|-
! colspan="2" | Zoom level
| 0/4
| 1/4
| 2/4
| 3/4
| 4/4
|-
! colspan="2" | 1 map pixel represents
| 1 block
| 2×2 blocks
| 4×4 blocks
| 8×8 blocks
| 16×16 blocks<br>(1×1 chunk)
|-
! colspan="2" | Scaling ratio
| 1:1
| 1:2
| 1:4
| 1:8
| 1:16
|-
! rowspan="2" colspan="2" | Map covers an area of
| 128×128 blocks
| 256×256 blocks
| 512×512 blocks
| 1024×1024 blocks
| 2048×2048 blocks
|-
| 8×8 chunks
| 16×16 chunks
| 32×32 chunks
| 64×64 chunks
| 128×128 chunks
|-
! colspan="2" | Smallest discernible features
| Blocks
| Trees, Paths
| Lakes, Buildings
| Mountains, Rivers
| Biomes, Mountain Ranges
|-
! colspan="2" | Use cases
| Pixel art, Base plans
| Base surroundings
| Structure mapping
| Landscape mapping
| Biome mapping
|-
! rowspan="2" | Total paper needed to zoom out from Level 0
! in anvil{{only|bedrock|short=1}} or crafting table
| -
| {{ItemSprite|Paper}} 8
| {{ItemSprite|Paper}} 16
| {{ItemSprite|Paper}} 24
| {{ItemSprite|Paper}} 32
|-
! in cartography table
| -
| {{ItemSprite|Paper}} 1
| {{ItemSprite|Paper}} 2
| {{ItemSprite|Paper}} 3
| {{ItemSprite|Paper}} 4
|}

Maps are always aligned to a grid at all zoom levels. That means zooming out any different map in a specific area covered by that map always has the same center. As such, maps are aligned by map width (1024 blocks for a level 3 maps) minus 64. A level 3 map generated at spawn covers X and Z coordinates from -64 to 959. All maps generated in this area zoom out to the same coordinates, guaranteeing that they are always 'aligned' on a map wall. For a zoomed-out map to cover a new area, it must start with a base (level 0) map that is in that area.

At zoom level 0, a map created on the point (0,0) has (0,0) at the center of the map. At higher zoom levels of the same map, the coordinate (0,0) is in the top left square of the map.

{{IN|java}}, zoom level can be seen on a map by turning on Advanced Tooltips (a [[Debug screen#More debug keys|debug screen]] option that can be toggled by using the key combination {{key|F3+H}}). The tooltip of the map then shows the zoom level, scaling factors, and map ID.

=== Cloning ===
[[File:Cartography table UI clone.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being cloned.]]

A mix of empty maps and empty locator maps may be used. Whether the cloned maps show position markers is dependent only on the input map.

A [[cartography table]] can also be used to clone a map.

The parts of the world that have already been explored and mapped are copied, and newly explored areas appear on both instances. If one of the maps is later zoomed out, then the maps lose their connection to each other and function as completely separate maps that have to be individually filled by exploring.

In Creative mode, a map in an item frame may be cloned by using {{control|pick block}} on it, as long as that map is not also in the player's inventory.

It doesn't matter if the map to be cloned is at a higher zoom level (made of more paper) than the blank map. Upon copying the map, both resulting maps have the same magnification as the starting map.

{{/BE|clone}}

=== Crafting ingredient ===

{{crafting usage|Map, Empty Map}}

=== Marking points ===
{{IN|java}} the player has the ability to mark spots on a map. To do this, {{control|use}} a map on a placed-down [[banner]], and the spot of the banner gets marked on the map. The mark takes the color of whatever the base color is for the banner, and if the banner has a name, the mark shows that name. Banner marks on a map are always oriented with their top facing north, regardless of the banner's actual orientation. If the banner is destroyed, the mark of the banner remains at first, but if the player gets closer to where the banner previously was, it disappears as the area is updated on the map.

If a map is mounted on an item frame and is within the area it depicts, the mounted map displays its current location with a green indicator rotated to match its orientation.

[[File:Map Marker Bedrock on Item frame.png|thumb|181x181px|{{IN|bedrock}} this is what a map lying on an item frame looks like, while showing markers.]]
{{IN|bedrock}} the player can place copies of locator maps in [[item frame]]s in order to create a land mark. The marker is a green dot that resembles the shape of the player's marker, but in green color. The position the marker points at depends on the direction the item frame is facing. It is worth noting that the markers work only on copies of the same map. Other maps of the same area do not show the existing markers that the player(s) had placed.

If a player has a cloned map in their inventory, their pointer appears white when viewed on the same map held by another player. Hence, if all players have the same cloned map in their inventory, all markers would appear white when the clone map is viewed. 

{| class="wikitable"
|-
! style="width: 300px;" | {{el|je}}
! style="width: 300px;" | {{el|be}}
|-
| style="text-align: center;" | [[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|216px]]
| style="text-align: center;" | [[File:Tracking map with markers bedrock.png|216px]]
|-
| How every banner appears {{IN|java}} on a map, including named banners.
| {{IN|bedrock}} this is how a locator map shows map markers while held by a player.
|-
|}

===Locking===
[[File:Cartography table UI lock.png|thumb|300px|{{IN|Java}}, cartography table's UI, showing the map is being locked.]]

Maps can be locked when using a [[glass pane]] in a [[cartography table]]. This creates a new map containing the same data and locks it. All copies of this new map are also locked. A locked map never changes, even when the depicted terrain changes. {{IN|Be}}, locked maps have a unique texture.

{| class="wikitable" style="text-align: center;"
|-
! Condition
! style="width: 200px;" | Newly created map
! style="width: 200px;" | Map after terrain alteration
|-
! Unlocked map
| [[File:Map Zoom 0.png|174px]] || [[File:Unlocked Map.png|174px]]
|-
! Locked map
| [[File:Map Zoom 0.png|174px]] || [[File:Map Zoom 0.png|174px]]
|-
|}

{{-}}

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

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|rowspan=2
|sound=Drawmap1.ogg
|sound2=Drawmap2.ogg
|sound3=Drawmap3.ogg
|source=block
|description=When a map is drawn<wbr>{{Upcoming|BE 1.20.20.20}}
|id=ui.cartography_table.take_result|idnote={{Verify|Could be block.cartography_table.use}}
|volume=0.8
|pitch=1.0}}
{{Sound table
|type=bedrock
|source=block
|description=When a map is edited using a cartography table
|id=ui.cartography_table.take_result
|volume=0.8
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=map
|form=item}}
{{ID table
|displayname=Map
|spritetype=item
|nameid=filled_map
|form=item
|translationkey=item.minecraft.filled_map, filled_map.buried_treasure, filled_map.explorer_jungle{{upcoming|java 1.20.2}}, filled_map.explorer_swamp{{upcoming|java 1.20.2}}, filled_map.mansion, filled_map.monument, filled_map.unknown, filled_map.village_desert{{upcoming|java 1.20.2}}, filled_map.village_plains{{upcoming|java 1.20.2}}, filled_map.village_savanna{{upcoming|java 1.20.2}}, filled_map.village_snowy{{upcoming|java 1.20.2}}, filled_map.village_taiga{{upcoming|java 1.20.2}}
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Empty Map
|spritetype=item
|nameid=empty_map
|aliasid=emptymap
|id=515
|form=item
|translationkey=item.emptyMap.name, item.emptyLocatorMap.name}}
{{ID table
|displayname=Map
|spritetype=item
|spritename=map-be
|nameid=filled_map
|aliasid=map
|id=420
|form=item
|translationkey=item.map.name, item.map.exploration.mansion.name, item.map.exploration.monument.name, item.map.exploration.treasure.name
|foot=1}}

=== Metadata ===
{{see also|Bedrock Edition data values}}
{{IN|bedrock}}, maps use the following data values:

{{/DV}}

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

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

=== Map icons ===
{{see also|Player.dat format|Map item format|map_icons.png}}
Map icons are 8×8 in ''Java Edition'', but 16×16 in Bedrock Edition. As such, there are minor misalignment issues in ''Java Edition''.<ref>{{bug|MC-214649|||WF}}</ref>
[[File:Map icons.png|thumb|128px|Map icons texture {{in|Java}}]]
[[File:Map icons BE.png|thumb|128px|Map icons texture {{in|Bedrock}}]]

{| class="wikitable"
|-
! Java ID !! Bedrock ID !! Text ID !! Appearance !! Purpose !! Shown in item frames?
|-
| 0 ||  ||<code>player</code> || [[File:Player (texture) JE1 BE1.png|16px]] [[File:Player (texture) BE2.png|16px]] White marker || Players (on map) || No
|-
| 1 || 1 ||<code>frame</code> || [[File:Green Marker (texture) JE1 BE1.png|16px]] [[File:Green Marker (texture) BE2.png|16px]] Green marker || The current map in an item frame || Yes
|-
| 2 ||  ||<code>red_marker</code> || [[File:Red Marker (texture) JE1 BE1.png|16px]] [[File:Red Marker (texture) BE2.png|16px]] Red marker || Position converted to Overworld when opening Overworld map in the Nether{{Only|bedrock}} || No
|-
| 3 ||  ||<code>blue_marker</code> || [[File:Blue Marker (texture) JE1 BE1.png|16px]] [[File:Blue Marker (texture) BE2.png|16px]] Blue marker || Other players || No
|-
| 4 ||  ||<code>target_x</code> || [[File:Target X (texture) JE1 BE1.png|16px]] White X || Unused || Yes
|-
| 5 ||5
|<code>target_point</code> || [[File:Target Point (texture) JE1 BE1.png|16px]] [[File:Target Point (texture) BE2.png|16px]] Red triangle || Unused || Yes
|-
| 6 || 6 ||<code>player_off_map</code> || [[File:Player Off Map (texture) JE1 BE1.png|16px]] Large white dot || Players off map, nearby{{only|java}} || No
|-
| 7 || 13 ||<code>player_off_limits</code> || [[File:Player Off Limits (texture) JE1.png|16px]] [[File:Player Off Limits (texture) BE.png|16px]] Small white dot || Players off map, far away{{only|java}} || No
|-
| 8 ||14
|<code>mansion</code> || [[File:Mansion (texture) JE1.png|16px]] [[File:Mansion (Texture) BE2.png|frameless|16x16px]] Woodland mansion || Woodland mansion || Yes
|-
| 9 || 15 ||<code>monument</code> || [[File:Monument (texture) JE1.png|16px]] [[File:Monument Texture BE2.png|frameless|16x16px]] Ocean monument || Ocean monument || Yes
|-
| 10 - 25 ||  ||<code>{{tooltip|banner_*|banner_white, banner_orange, banner_magenta, banner_light_blue, banner_yellow, banner_lime, banner_pink, banner_gray, banner_light_gray, banner_cyan, banner_purple, banner_blue, banner_brown, banner_green, banner_red, banner_black}}</code> || [[File:Banner White (texture) JE1.png|16px]] [[File:Banner Light Gray (texture) JE1.png|16px]] [[File:Banner Gray (texture) JE1.png|16px]] [[File:Banner Black (texture) JE1.png|16px]] [[File:Banner Brown (texture) JE1.png|16px]] [[File:Banner Red (texture) JE1.png|16px]] [[File:Banner Orange (texture) JE1.png|16px]] [[File:Banner Yellow (texture) JE1.png|16px]] [[File:Banner Lime (texture) JE1.png|16px]] [[File:Banner Green (texture) JE1.png|16px]] [[File:Banner Cyan (texture) JE1.png|16px]] [[File:Banner Light Blue (texture) JE1.png|16px]] [[File:Banner Blue (texture) JE1.png|16px]] [[File:Banner Magenta (texture) JE1.png|16px]] [[File:Banner Purple (texture) JE1.png|16px]] [[File:Banner Pink (texture) JE1.png|16px]]<br>Banners in all 16 wool colors{{only|java}}|| Banner markers || Yes
|-
| 26 ||4
|<code>red_x</code> || [[File:Red X (texture) JE1.png|16px]] [[File:Target X (texture) BE2.png|16px]] Red X || Buried treasure || Yes
|-
| || 8 || || [[File:Magenta Marker (texture) BE1.png|16px]] Magenta marker
| Position converted to Overworld when opening Overworld map in the End{{Only|bedrock}} || No 
|-
| || 9 || || [[File:Orange Marker (texture) BE1.png|16px]] Orange marker{{more info}}
|Other players
|Yes
|-
| || 10 || || [[File:Yellow Marker (texture) BE1.png|16px]] Yellow marker
| Other players || No
|-
| || 11 || || [[File:Cyan Marker (texture) BE1.png|16px]] Cyan marker
| Other players || No
|- 
| -
|12
| || [[File:Green Point (texture) BE1.png|16px]] Green Triangle
| Other structure such as stronghold, fortress, end city, etc. when used as explorer map destination{{Only|bedrock}} || Yes
|}
It should be noted that even if the player used a NBT editor to add an additional icon on the map, ''Minecraft'' shows only the first one listed when the player loads up their world.

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

== History ==
{{see also|section=24|map_icons.png|Java Edition history of textures#Map icons}}
{{more images|section=24|{{bug|MC-72962}}}}
{{History||April 27, 2011|link=https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps|[[Notch]] unveiled screenshots of the map.}}
{{History||April 28, 2011|link={{tweet|notch|63500114005721088}}|[[Notch]] said that he would try to make maps place-able on [[wall]]s.}}
{{History|java beta}}
{{History||1.6|snap=Test Build 3|[[File:Map (item) JE1 BE1.png|32px]] Added maps.}}
{{History||1.6.6|The ability to auto-craft maps using shift-click has been disabled.}}
{{History||1.8|snap=Pre-release|Maps can now be found in library chests in the brand-new [[stronghold]]s.
|Auto crafting maps has been restored. Map cloning, therefore, is unavailable for a period of time.}}
{{History||1.8.1|Maps now work both while walking and flying.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 5|Prior to this update, the [[sun]] in ''[[Minecraft]]'' rose in the North, which threw off many [[player]]s and led to a common misconception that ''Minecraft'' maps/[[world]]s were oriented with East at the top. The sun now rises in the east and sets in the west, making navigation much more intuitive.
|Before the change in sun position, it was commonly said that ''Minecraft'' maps/worlds are oriented with East at the top; sunrise, by definition, occurs at the East, which means it is certainly true that the maps were oriented "East" since the Sun rose from the top (North). However, [[Jeb]] asserted (and [[Notch]] agreed) that the sun rose in the north.<ref>{{Tweet|jeb|87815841160237056}}</ref><ref>{{Tweet|notch|88155424880201728}}</ref> Most mods and map-making tools, however, used the terms East and North consistent with their actual definitions (e.g. a [[Programs and editors/Cartograph|Cartograph]]-generated map with North at the top is rotated 90 degrees from the in-game map).}}
{{History||1.4.2|snap=12w34a|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now creates an empty map. The map is drawn for the first time when it is held and right clicked, and is centered near the location of the [[player]] when clicked (not as before where it was centered on the location it was crafted.)
|Previously, in order to map a new area, the map had to be ''crafted'' in that area (rather than carrying a previously-crafted map to the new area). The point where a map is crafted becomes its permanent center, and could never be changed. 
|The pointer no longer disappears when leaving the map, but transforms into a white dot, indicating on what side of the map the player is located.
|Maps now align to a grid, making it easier to create adjacent maps.
|Maps can now be zoomed out (but not zoomed in).
|Maps can now be cloned and scaled.}}
{{History||1.4.2|snap=12w34b|Maps now have a ''zoom level'', which was fixed at 1:8 prior to snapshot [[Java Edition 12w34a|12w34a]],<ref name="mapinfo">https://web.archive.org/web/0/http://notch.tumblr.com/post/4988431144/the-maps</ref> but  now starts at 1:1 and can be increased up to 1:16 by re-crafting an existing map.
|Maps are no longer numbered on the top-left corner and is labeled through the tooltip.}}
{{History|||snap=12w36a|New maps are now crafted at a scale factor of 1:1. A zoomed in map can be zoomed out by re-crafting it with another 8 sheets of [[paper]] on a [[crafting table]]. Each time this is done, the scale increases - 1:1, 1:2, 1:4, 1:8, 1:16 with a map scale of 1:16 being the current maximum.}}
{{History||1.7.2|snap=13w38a|The map size has been increased when placed on a [[wall]] using the [[item frame]].
|More colors have been added to maps for different [[block]]s.<ref name="infodump2">https://web.archive.org/web/0/https://www.mojang.com/2013/10/minecraft-1-7-the-update-that-changed-the-world</ref>}}
{{History||1.8|snap=14w31a|Zoomed maps now conform to an expanded grid based on their zoom level. Previously, careful considerations would need to be taken to creating a wall of adjoining maps.}}
{{History||1.8.1|snap=pre1|Some colors have been changed on maps to more accurately represent their respective [[block]].}}
{{History||1.9|snap=15w31a|Maps now display as a mini-map when held in the off-hand, or if the off-hand slot is occupied; the (old) large version is visible only when held in the dominant hand with the secondary hand free.}}
{{History|||snap=15w34a|New maps can now be [[crafting|crafted]] at a scale factor of 1:4.
|A crafting recipe has been added for zooming in maps.}}
{{History|||snap=15w43a|The average yield of empty maps from [[stronghold]] library [[chest]]s has been doubled.}}
{{History|||snap=15w45a|New maps are once again [[crafting|crafted]] at a scale factor of 1:1, as they had been before snapshot [[15w34a]].
|The [[crafting]] recipe, that was introduced in 15w34a, for zooming in maps has been removed.}}
{{History|||snap=15w49a|Map making now uses armor equipping sounds.}}
{{History||1.11|snap=16w39a|Maps now work in [[the End]].
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s as their tier 3 [[trading|trade]].
|Added [[explorer map]]s, sold by cartographers as their tier 4 trades.}}
{{History||1.12|snap=17w17a|Maps now have separate colors for colored [[terracotta]] blocks from other colored blocks.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 358 and 395.
|Maps now use additional NBT to specify which map they contain. Prior to this version, they used the [[damage]] value instead.
|Map IDs are no longer limited to 32,768.}}
{{History|||snap=17w50a|Maps can now be placed on floor and ceiling [[item frame]]s.}}
{{History|||snap=18w10a|Spots on maps can now be marked using [[banner]]s.}}
{{History|||snap=18w11a|Empty maps can now generate in [[shipwreck]] [[chest]]s.}}
{{History|||snap=pre7|Maps have been changed slightly, in regard to which [[block]]s are shown and which blocks are not.}}
{{History||1.14|snap=18w43a|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History|||snap=18w48a|Empty maps can now be found in chests in [[village]] cartographer houses.}}
{{History|||snap=19w02a|Maps can now be cloned and zoomed out (extended) by using a [[cartography table]].
|Maps can now be locked by using a [[glass pane]] with a cartography table.
|The recipes for cloning and zooming out maps have been removed.}}
{{History|||snap=19w06a|Map making is now silent again.}}
{{History|||snap=19w13a|Cartographer villagers now give empty maps to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w21a|Map making sounds are now the same as when using a cartography table.}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Empty Map JE1 BE1.png|32px]] [[File:Map (item) JE1 BE1.png|32px]] Added maps.
|Maps are crafted using nine [[paper]], one for every slot of the [[crafting]] grid.
|Maps must be combined with a [[compass]] using an [[anvil]] in order to show the [[player]]'s position.
|Maps can be zoomed using an anvil.}}
{{History|||snap=build 3|New maps are now [[crafting|crafted]] at full zoom.
|Empty maps now have a "Create Map" button to initialize them.}}
{{History|||snap=build 7|New maps are now crafted at a scale factor of 1:1.}}
{{History||v0.15.0|snap=unknown|Maps can now be crafted either with 8 pieces of [[paper]] and a [[compass]] ''or'' 9 pieces of paper, to get a map with or without a position marker.}}
{{History||v0.16.0|snap=build 1|Different colors have been added to maps for different [[biome]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=?|[[Windows 10 Edition]] can now use the [[anvil]] as well as the [[crafting table]] to clone, zoom and apply markers, just as [[Pocket Edition]] in general could.
|Maps can now be found inside [[stronghold]] library [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Empty maps with direction markers built-in are now called "locator maps".}}
{{History|||snap=alpha 1.1.0.3|"Locator maps" are now called "empty locator maps".
|Empty maps are now [[trading|sold]] by cartographer [[villager]]s for 7-11 [[emerald]]s as their tier 3 [[trading|trade]].}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Maps can now be found inside map room [[chest]]s in [[shipwreck]]s.}}
{{History||?|The texture of the filled map overlay has been changed.}}
{{History||?|Maps now function in dimensions other than the dimension in which they were created.}}
{{History||1.10.0|snap=beta 1.10.0.3|Maps can now be found in cartographer house [[chest]]s in [[village]]s.
|[[File:Empty Map JE2 BE2.png|32px]] The texture of empty maps has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Empty maps can now be created from 1 [[paper]] in [[cartography table]]s.
|Maps can now be zoomed, cloned, renamed, and have pointers added in cartography tables.}}
{{History|||snap=beta 1.11.0.4|Cartographer [[villager]]s now [[trading|sell]] empty map for an [[emerald]] as their first tier [[trading|trades]].
|Empty locator maps can now be [[trading|bought]] from cartographer villagers.}}
{{History||1.13.0|snap=beta 1.13.0.1|[[File:Map (item) BE3.png|32px]] [[File:Locked Map (item) BE2.png|32px]] Filled maps and locked maps now have unique inventory icons.}}
{{History||1.16.0|snap=beta 1.16.0.57|Trading has been changed, novice-level cartographer now sell an empty map for 7 emeralds. Cartographer villager no longer sell empty locator map.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of maps have been changed from <code>emptymap</code> to <code>empty_map</code> and <code>map</code> to <code>filled_map</code>.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.00|wiiu=Patch 1|switch=1.0.1|[[File:Map (item) JE1 BE1.png|32px]] Added maps. 
|The [[player]] spawns with a free map. 
|Maps are available only as zoom step 3 maps centered at coordinates 0,0. Biome colors do not appear on maps.}}
{{History||xbox=none|xbone=CU1|ps=1.0|wiiu=none|Larger sized worlds on Xbox One, Playstation 4, and Nintendo Switch have zoom step 3 maps aligned to a grid with maps centered at 0, 1024, or 2048 on the X or Z coordinates.}}
{{History||xbox=TU21|xbone=CU9|ps=1.14|wiiu=Patch 1|[[File:Empty Map JE1 BE1.png|32px]] [[Crafting]] a map now produces an empty map.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|The outer end islands appear on different maps; even on Xbox 360, Playstation 3, Vita, and Wii U editions.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Empty Map JE2 BE2.png|32px]] [[File:Map (item) JE2 BE2.png|32px]] The textures of maps have been changed.}}
{{History||ps=1.91|Maps can now be created and used in [[cartography table]]s.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Use of the {{key|F1}} key can allow the player to hold a map without blocking their view at all.
* In ''Java Edition'', a map created using {{cmd|give}} can be any map by using the Map parameter to specify the map number desired. E.g. {{cmd|give [player] minecraft:filled_map{map:5<nowiki>}}} gives the specified player map_5. If no data value is supplied it defaults to map_0. If map_0 has not ever been crafted, it is centered on x=0, z=0.
* The maps are stored separately as their own data (<code>.dat</code>) file as <code>map_x.dat</code> with (x) being the map number, see [[map item format]] for more info. By manipulating this number, players can organize their maps to suit them, or if they accidentally create a map in the same location, they can delete their extra map so as to save the number they make.
* Certain programs can be used to make customized maps with images or text on them instead of actual maps, many people use these in adventure maps to show pictures or to tell a story.
* Since all copies of a map are links to the same file, copying an unfinished map keeps it synchronized with the copy as the player fills it in. Thus, a copy stored in a chest can act as a remote backup.
* A map that is in an item frame does not update itself until a player picks it up, lets it reload, and places it back again. However, if a player holds a clone of the map, both maps update.
* Filled maps are the only items that make 90 degree rotations in item frames, and also the only items that can expand the item frame into full block wide.
* On [[Legacy Console Edition]], the player always spawns with a map in their inventory after creating a world. This was later added to Bedrock Edition as an optional feature in the world creation menu.
* Maps on Legacy Console Edition always show the player's current coordinates, as a substitute for the optional [[Coordinates|coordinate display]] in other editions.
* A map cannot be created on [[New Nintendo 3DS Edition]]. Instead, the map is always displayed on the bottom screen along with the coordinates. Biome colors do not appear on maps.

== Gallery ==
<gallery>
MapItem1.png|A fully zoomed map.
MapRotation.png|Having a map in hand does not stop the ability to see ahead.
MapItem3.png|A world being recorded onto a map.
Mcmap4.png|Nearly fully explored map.
Zoomed Map.png|A map edited to the scale of 1.
Sky Map.png|A map mapping the [[Sky Dimension]].
MapOfVillage.png|A village and how it is represented on a map.
Pumpkin map.png|A map containing a custom image made by placing a large number of blocks.
Complete Map.png|A completely explored map.
MapZooms.png|A diagram showing how maps zoomed out before [[Java Edition 1.8]]. Notice how the larger maps have borders made of half and quarter small maps.
Map18zooms.png|From 1.8, zoomed maps are aligned to this grid exactly.
Large Biome Map.png|A map of a [[Large Biomes]] world.
Map0140-0160.png|A comparison of maps between versions in Pocket Edition Alpha [[Pocket Edition Alpha 0.14.0|0.14.0]] and [[Pocket Edition Alpha 0.16.0|0.16.0]].
Mycelium Map.png|A map view of a mushroom biome, showing that mycelium appears purple on a map.
MiniMap.png|Maps held in the off-hand or in either hand while [[dual wielding]] appear as mini-maps.
Partly filled treasure map.png|Partly filled treasure map with an odd area at the bottom left. Normally a partly filled map would look striped (as in the top left), but this map seems to be bugged and is possibly showing caves, or something, in the bottom left.
Partly filled ocean explorer map.png|Partly filled ocean explorer map. Updating the game from an older version (in this case the area was first generated before 1.18) and buying a map after updating (in this case in 1.19.4) can result in the map displaying rivers and terrain where there is really a frozen sea.
Map Stained Glass 1.png|Stained glasses' appearances on maps before and after 1.13.
Map Stained Glass 2.png|Stained glasses' appearances on maps before and after 1.13.
Map Various Blocks 1.png|Various blocks' appearances on maps before and after 1.13.
Map Various Blocks 2.png|Various blocks' appearances on maps before and after 1.13.
Better Together Map.jpg|Holding a map in the offhand in ''Bedrock Edition''.
Better Together Map Icon.jpg|Holding a map in both hands in ''Bedrock Edition''.
</gallery>

=== The Nether ===
<gallery>
Nethermap.png|A map in [[the Nether]].
Maponnether.png|A map in the Nether; the arrow turns around itself, like in [[compass]].
</gallery>

=== The End ===
<gallery>
Jeb End Map.png|The first image of a map in [[the End]].
Endmap.png|A map in the End.
</gallery>

=== Maps in item frames ===
<gallery>
FramedMap.png|A map displayed on an item frame, as it looked before [[Java Edition 1.7.2]].
Structure Map Collection.png|Multiple maps in item frames. Notice a [[village]], two [[desert temple]]s and a lava lake.
Minecraft maps 3by3.png|A collection of 9 connected full maps.
Full Map.png|A combination of 25 maps pasted together as one map.
Map wall BE.png|A map wall on ''Bedrock Edition'', showing large areas of biome colors for each biome.
Map's in item frames.png|Maps can be placed into [[item frame]]s so they can be viewed together.
Comparing Maps.png|The comparison between 3 zooms of maps.
SuperflatMap.png|A map in a [[Superflat]] world, with some [[village]]s.
MapWallWithMarkers.png|A 3x3 map wall with banner markers.
HEYYEYAAEYAAAEYAEYAA.png|He-Man map art.
Map Player Icons 1.png|First image of player icons on maps.
Map Player Icons 2.png|Second image of player icons on maps.
</gallery>

== See also ==
* [[Explorer Map]]
* [[Clock]]
* [[Tutorials/Navigation|Navigation]]

== References ==
{{Reflist}}

{{Items}}

[[cs:Mapa]]
[[de:Karte]]
[[es:Mapa]]
[[fr:Carte (objet)]]
[[hu:Térkép (tárgy)]]
[[ja:地図]]
[[ko:지도]]
[[nl:Kaart]]
[[pl:Mapa]]
[[pt:Mapa]]
[[ru:Карта]]
[[tr:Harita]]
[[th:แผนที่]]
[[uk:Мапа]]
[[zh:地图]]
[[Category:Renewable resources]]</li></ul></nowiki>
17w16aShulker boxes recolored.
17w17aReverted color of purple shulker boxes (and by extension, the shulker mob).
Pocket Edition
1.0
{{Extension DPL}}<ul><li>[[Gold Nugget|Gold Nugget]]<br/>{{About|the nugget|the block that can drop nuggets|Gilded Blackstone|the ore|Gold Ore|the ingot form|Gold Ingot|the mineral block|Block of Gold}}
{{Item
| image = Gold Nugget.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Gold nuggets''' are items used to make [[gold ingot]]s and other various golden items. One gold nugget is effectively worth one-ninth of a gold ingot.

== Obtaining ==

=== Mob loot ===

[[Zombified Piglin|Zombified piglin]]s, when killed, may drop 0-1 gold nuggets. When killed using a weapon enchanted with [[Looting]], they may drop an additional gold nugget per level of Looting used, up to a maximum of 4.

=== Crafting ===

{{Crafting
|Gold Ingot
|Output= Gold Nugget, 9
|type= Material
}}

=== Smelting ===

{{Smelting
|Golden Sword; {Any golden tools}; {Any golden armor}; Golden Horse Armor
|Gold Nugget
|0,25
}}

=== Chest loot ===

{{LootChestItem|gold-nugget}}

=== Mining ===

[[Nether gold ore]] mined using a [[pickaxe]] drops 2-6 gold nuggets. If the pickaxe is enchanted with [[Fortune]], it has a 33.3% chance to multiply the drops by 2, Fortune II has a 25% chance to multiply the drops by 2 or 3 and Fortune III has a 20% chance each to multiply the drops by 2, 3, or 4 for a maximum possible drop of 24 golden nuggets. The average drop rate for a Fortune III pickaxe is 8.8, while the drop rate for a [[Silk Touch]] pickaxe is a single ingot, or a flat rate of 9. It is slightly more efficient to mine with a Silk Touch pickaxe. 

[[Gilded Blackstone|Gilded blackstone]] mined using a pickaxe has a 10% chance to drop 2-5 gold nuggets. If the pickaxe is enchanted with Fortune I, the chance gold nuggets drop is increased 14.29%, Fortune II increases the drop chance to 25%, and Fortune III guarantees the drop.

== Usage ==

Gold nuggets can be used to craft a [[golden carrot]] or [[glistering melon]] for brewing. Also, gold nuggets can be combined with gunpowder and dye to create a [[firework star]] that bursts in a star-shaped explosion. 

[[Piglin]]s instantly pick up any gold nuggets that are within 1 [[block]] of them. Unlike other gold-related items, they do not intentionally seek out gold nuggets to pick up and only pick them up if they walk near it. Unlike gold ingots, gold nuggets picked up are dropped upon the piglin's death. 

=== Crafting ingredient ===

{{crafting usage}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Gold Nugget
|spritetype=item
|nameid=gold_nugget
|id=425
|form=item
|foot=1}}

== History ==

{{History|Java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|[[File:Gold Nugget JE1.png|32px]] Added gold nuggets.
|Gold nuggets are [[drops|dropped]] by [[zombie pigmen]].
|Gold nuggets can be used to craft [[gold ingot]]s.
|Gold nuggets currently do not have a mouseover name.}}
{{History|||snap=Beta 1.9 Prerelease 2|Gold nuggets now have a mouseover name.}}
{{History|||snap=Beta 1.9 Prerelease 4|Gold nuggets are now used to craft [[glistering melon]]s.
|Gold nuggets can now be [[crafting|crafted]] from a single [[gold ingot]].}}
{{History||1.1|snap=release|Normal [[golden apple]]s are now crafted with gold nuggets.}}
{{History||1.3.1|snap=1.3|[[File:Gold Nugget JE2 BE1.png|32px]] The texture of gold nuggets has been changed.}}
{{History||1.4.2|snap=12w34a|Gold nuggets are now used to craft [[golden carrot]]s.}}
{{History||1.4.6|snap=12w49a|Gold nuggets can now be used to craft a [[firework star]] for a star shaped effect on a [[firework rocket|firework]].}}
{{History||1.6.1|snap=13w23a|Gold nuggets can no longer be used to [[crafting|craft]] a [[golden apple]].}}
{{History||1.9|snap=15w43a|Gold nuggets may now be found among the loot in [[igloo]] basement [[chest]]s.}}
{{History||1.11.1|snap=16w50a|Gold nuggets can now be [[smelting|smelted]] from golden [[tool]]s and [[armor]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 371.}}
{{History|||snap=18w09a|Gold nuggets can now be found in [[underwater ruins]] loot [[chest]]s.}}
{{History|||snap=18w11a|Gold nuggets now generate in the chests of [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Gold Nugget JE3 BE2.png|32px]] The texture of gold nuggets has been changed.}}
{{History|||snap=18w48a|Gold nuggets can now be found in chests in [[plains]] [[village]] houses.}}
{{History|||snap=18w49a|Gold nuggets can now be found in chests in [[savanna]] village houses.}}
{{History||1.16|snap=20w12a|[[Nether gold ore]] now [[drops]] 2-6 gold nuggets, affected by [[Fortune]].}}
{{History|||snap=20w15a|[[Gilded blackstone]] now has 10% chance to drop 2-5 gold nuggets. Only the drop chance is affected by [[Fortune]].}}
{{History|||snap=20w16a|Gold nuggets now generate in [[bastion remnant]]s and [[ruined portal]] chests.}}
{{History|||snap=Pre-release 1|Gold nuggets can now be used to distract [[piglin]]s.}}
{{History|||snap=Pre-release 3|Gold nuggets can no longer be used to distract [[piglin]]s.}}
{{History||1.20|snap=23w12a|Gold nuggets can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Gold nuggets no longer generate in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], gold nuggets are now common loot.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Gold Nugget JE2 BE1.png|32px]] Added gold nuggets. |Gold nuggets can be used to craft [[glistering melon]]s, [[gold ingot]]s and [[golden carrot]]s.|[[Gold ingot]]s can now be [[crafting|crafted]] into 9 gold nuggets.|[[Zombie pigmen]] now [[drops|drop]] gold nuggets upon being killed.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Gold nuggets can now be found inside [[igloo]] basement [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Gold nuggets can now be [[smelting|smelted]] from golden [[tool]]s and [[armor]].}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Gold nuggets can now be used to craft [[firework star]]s.}}
{{History||1.4.0|snap=beta 1.2.14.2|Gold nuggets can now be found in some [[shipwreck]] [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Gold nuggets can now be found in [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|The gold nugget can now be found in [[plains]] [[village]] house chests.|[[File:Gold Nugget JE3 BE2.png|32px]] The texture of gold nuggets has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|The gold nugget can now be found in [[savanna]] village house [[chest]]s.}}
{{History||1.16.0|snap=beta 1.16.0.57|[[Nether gold ore]] now [[drops]] 2-6 gold nuggets.|[[Gilded blackstone]] now has 10% chance to drop 2-5 gold nuggets.}}
{{History||1.16.100|snap=beta 1.16.100.50|Gold nuggets can now be used as fuel for a [[furnace]].<ref>{{bug|MCPE-114216}}</ref>}}
{{History||1.18.30|snap=beta 1.18.30.26|Gold nuggets can no longer be used as fuel for a furnace.}}

{{History|Legacy Console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Gold Nugget JE2 BE1.png|32px]] Added gold nuggets.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Gold nuggets can now be [[smelting|smelted]] from golden [[tool]]s and [[armor]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Gold Nugget JE3 BE2.png|32px]] The texture of gold nuggets has been changed.}}

{{History|3DS}}
{{History||0.1.0|[[File:Gold Nugget JE2 BE1.png|32px]] Added gold nuggets.}}
{{History||1.9.19|Gold nuggets can now be [[smelting|smelted]] from golden [[tool]]s and [[armor]].}}
{{History|foot}}

== Issues ==

{{issue list}}

== See also ==

* [[Iron Nugget]]
* [[Gold]]

{{Items}}

[[cs:Zlatý nuget]]
[[de:Goldklumpen]]
[[es:Pepita de oro]]
[[fr:Pépite d'or]]
[[hu:Aranyrög]]
[[it:Pepita d'oro]]
[[ja:金塊]]
[[ko:황금 조각]]
[[nl:Goudklompje]]
[[pl:Bryłka złota]]
[[pt:Pepita de ouro]]
[[ru:Кусочек золота]]
[[uk:Золотий самородок]]
[[zh:金粒]]
[[Category:Renewable resources]]</li><li>[[Boat|Boat]]<br/>{{ItemEntity
|image=Oak Boat.png
|image2=Oak Boat (item) JE6.png
|extratext = [[#Gallery|View all renders]]
|stackable=No
|renewable=Yes
|flammable=Yes
|size='''{{IN|Java}}:'''<br>
Height: 0.5625 Blocks<br>Width: 1.375 Blocks<br>
'''{{IN|Bedrock}}:'''<br>
Height: 0.455 Blocks<br>Width: 1.4 Blocks
|networkid='''[[JE]]''': 1
}}
{{for|other kinds of boats|Boat (disambiguation)}}
A '''boat''' is a drivable vehicle [[entity]] used primarily for fast transport of players and passenger mobs over bodies of water. '''Bamboo rafts''' look different, but function almost identically to other boats.

== Obtaining ==
Boats can be crafted with any Overworld planks; crimson and warped planks cannot be used to make boats.<ref>{{bug|MC-170868|||Invalid}}</ref>

Boats can be retrieved by repeatedly hitting them until they drop as an item.

[[Tool]]s and [[weapon]]s that deal more than {{Health|4}} damage will instantly destroy a boat in one hit.{{only|Java}}

=== Crafting ===
{{Crafting
|head=1
|showname=0
|A2= Matching Overworld Planks
|C2= Matching Overworld Planks
|A3= Matching Overworld Planks
|B3= Matching Overworld Planks
|C3= Matching Overworld Planks
|Output= Matching Boat
|type= Transportation
|foot=1
}}

== Usage ==
Boats can be used for the transportation of [[player]]s and [[mob]]s, sold for emeralds, or [[Smelting|burnt]] as fuel.

=== Crafting ===
{{Crafting usage|match=end|Boat, Bamboo Raft}}

=== Trading ===
Master-level fisherman [[villager]]s always offer to buy a boat for an [[emerald]]. The type of boat depends on the biome outfit type of the villager; [[plains]] villagers offer to buy oak boats, [[taiga]] and [[Snowy Tundra|snowy]] villagers offer to buy spruce boats, [[savanna]] villagers offer to buy acacia boats, [[desert]] and [[jungle]] villagers offer to buy jungle boats, and [[swamp]] villagers offer to buy dark oak boats.

=== Fuel ===
A boat used as fuel in a [[furnace]] lasts 60 seconds, smelting up to 6 items.

=== Transportation ===
{{see also|Transportation|Riding}}
==== Entering ====

A player enters a boat by {{control|using}} it, if the boat is not fully occupied (boats can hold two entities). Unlike [[bed]]s, there is no message above the hotbar for attempting to enter a fully occupied boat.<ref>{{bug|MC-161251}} - resolved as “Works as Intended”</ref>

==== Exiting ====
A boat can be exited by {{control|sneaking}} or, {{in|BE}}, pressing down the right analog stick on a controller, tapping the "Leave Boat" button when using touch controls, or {{control|jumping}}. When exiting a boat, the player is placed in the direction the player is facing, or, if facing directly up or down, the player is placed in front of the boat. The exiting player is placed on land if possible from the dismounting position.

==== Motion ====
Boats do not turn with mouse-look. 

With a keyboard or gamepad, boats are controlled using the {{control|forward}}, {{control|left}} (turns left), {{control|right}} (turns right), and {{control|backward}} keys. Using the {{control|sprint}} key increases the field of vision, but does not increase speed as if [[sprinting]].

With touchscreen controls, two buttons for steering appear. The right button or key steers to the left, and the left button or key steers to the right. Pressing both buttons or keys moves the boat forward.

{{IN|Java}}, boats can be ridden against a current, but cannot be ridden upstream to a higher elevation. A boat lift, usually made from tripwire, pistons, and optionally a slime block, can be used to move a boat up. Bubble columns created with soul sand can also be used to push boats upward. These mechanisms can also be used {{in|bedrock}} but are usually unnecessary because boats can be ridden upward in descending water, as well as [[Tutorials/Water-powered boat transportation|follow upward stair-step currents]].

== Behavior ==
=== Speed ===
Boats move according to the player's control or water currents, with speed affected by the surface traversed. Boats move extremely quickly on ice,<ref name="MC-97803">{{bug|MC-97803||Boats going faster on ice than in water|WAI}}</ref> allowing for the construction of fast transportation systems in any dimension.
{| class="wikitable"
|+
!Substance
!Speed
|-
|[[Water]]
|8.0 blocks/s
|-
|[[Ice]], [[Frosted Ice]], [[Packed Ice]]
|40 blocks/s
|-
|[[Blue Ice]]
|72.7 blocks/s
|-
|Land
|2.0 blocks/s
|}

=== Floatation ===
[[File:Oak Boat shake.gif|thumb|right|The animation of an oak boat when atop a [[Bubble Column|bubble column]].]]
A boat floats atop still or flowing water. {{IN|java}}, a boat sinks if it enters a waterfall.<ref>{{bug|MC-91206|||WAI}}</ref> {{IN|bedrock}}, a boat does not sink when submerged but floats up. This feature lets a player contrive stepped uphill water flows to [[Tutorials/Water-powered boat transportation#Floating uphill|propel a boat uphill]] using only flowing water.

When a boat moves over a bubble column, it begins to shake. If the bubbles are caused by a [[Magma Block|magma block]], all passengers are expelled and the boat sinks.

{{IN|java}}, a sunken boat cannot be re-floated until a bubble column pushes it up or it is broken by the player. {{IN|bedrock}}, a boat resumes floating when it emerges from the currents keeping it down, or when the bubble column is blocked or removed.

[[Dolphin]]s chase players riding a boat in motion, occasionally bumping the boat, causing it to shake briefly.

=== Destruction ===
As boats are [[Entity|entities]], they have [[health]]. Boats effectively have just over {{hp|4}} (exactly 4 damage is not quite enough to destroy a boat), and regenerate {{frac|1|10}} per game tick. 

Boats can be destroyed by explosions, fire and lava (but not magma blocks), cactus, and by being punched by mobs, such as [[Drowned]]. Boats made invulnerable with commands cannot be broken by any of these, but they still cannot be used to travel on lava because they sink.

When a boat is destroyed under normal conditions, it drops itself in item form. In certain conditions, such as when falling for exactly 12, 13, 49, 51, 111, 114, 198, 202, 310, or 315 blocks,<ref name="MC-119369">{{bug|MC-119369}}</ref> it drops two [[stick]]s and three [[planks]] upon being destroyed.

=== Passengers ===
[[File:Multiple mobs in 2 boats.png|alt=|thumb|Multiple mobs in 2 types of boats.]]
Boats can support two riders, including [[mob]]s. Except for [[Enderman|endermen]] {{in|bedrock}}, a mob cannot exit a boat and is trapped until the boat gets destroyed, or until the player uses a [[Fishing Rod|fishing rod]] or [[lead]] to remove the mob. This can be used to transport mobs, although hostile mobs still attack while in boats. Mobs riding a boat don't despawn{{only|java}} and don't count toward the mob cap.<ref>{{bug|MC-182897|resolution=WAI}}</ref>

A player cannot both move (row) and use items at the same time. It is still possible to initialize item use (e.g. start eating) and row the boat while the item is still in the middle of the use animation. Although the rowing animation overrides the item use animation, the item can still be successfully consumed. This does not work with items that are triggered by the ''release'' of the use button (such as [[Bow|bows]] and [[Trident|tridents]]).{{only|Java}}

Being in a boat limits the player's mouse-look to the forward 210° arc {{in|java}} and 180° {{in|bedrock}}.

Underwater boat cannot be ridden. When the boat is underwater, all passengers in it are expelled.

=== Damage prevention ===
Riding a boat does not deplete [[hunger]], making it an efficient way to travel.

Boats can completely nullify [[fall damage]] for themselves and any players/mobs inside, making them useful for travel through mountains or through the Nether.<ref>{{bug|MC-105103|resolution=WAI}}</ref><ref>{{bug|MCPE-149490|resolution=WAI}}</ref> However {{in|java}}, due to a bug, boats can break when falling from certain heights, and the riders take fall damage.<ref name="MC-119369"></ref>

=== Collision ===
A boat has a solid collision box, which means players and other entities can't go through it even with high speed. Falling blocks are also blocked by boats.

{{IN|java}}, a boat falling on top of an entity stops on top of the entity. {{In|bedrock}}, a falling boat can go through other entities.

Riding a boat over a [[Lily Pad|lily pad]] causes the lily pad to drop, although the boat's speed stutters a bit.

=== Mobs ===
Most mobs can ride boats. Mobs cannot exit the boat unless the boat is destroyed, sinks, or moves over a bubble column. However, {{in|bedrock}}, [[endermen]] are able to teleport out of boats.

Mobs can be picked up into the boat when they collide with the side of the boat. A mob cannot control the boat. {{IN|java}}, a boat being ridden by a player cannot pick up a mob. {{IN|bedrock}}, mobs can be picked up by a boat being ridden by a player.

Mobs wider than the width of a boat cannot be picked up by a boat. [[Warden]]s, and [[wither]]s cannot be picked up by a boat. {{IN|java}}, baby [[sniffer]]s cannot be picked up either.

=== Lead ===
{{IN|java}}, leads cannot be attached to boats. {{IN|bedrock}}, leads can be attached to boats, though the lead can break when stretched too far due to boats moving much slower on land.

== Sounds ==
{{Edition|Java}}:<br>
Boats use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Boat paddle land1.ogg
|sound2=Boat paddle land2.ogg
|sound3=Boat paddle land3.ogg
|sound4=Boat paddle land4.ogg
|sound5=Boat paddle land5.ogg
|sound6=Boat paddle land6.ogg
|subtitle=Rowing
|source=neutral
|description=While a boat is rowed on land
|id=entity.boat.paddle_land
|translationkey=subtitles.entity.boat.paddle_land
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Boat paddle water1.ogg
|sound2=Boat paddle water2.ogg
|sound3=Boat paddle water3.ogg
|sound4=Boat paddle water4.ogg
|sound5=Boat paddle water5.ogg
|sound6=Boat paddle water6.ogg
|sound7=Boat paddle water7.ogg
|sound8=Boat paddle water8.ogg
|subtitle=Rowing
|source=neutral
|description=While a boat is rowed in water
|id=entity.boat.paddle_water
|translationkey=subtitles.entity.boat.paddle_water
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Swim1.ogg
|sound2=Swim2.ogg
|sound3=Swim3.ogg
|sound4=Swim4.ogg
|source=player
|description=While a boat is rowed in water
|id=random.swim
|pitch=0.6-1.4
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Oak Boat
|spritetype=item
|spritename=oak-boat
|nameid=oak_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Spruce Boat
|spritetype=item
|spritename=spruce-boat
|nameid=spruce_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Birch Boat
|spritetype=item
|spritename=birch-boat
|nameid=birch_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Jungle Boat
|spritetype=item
|spritename=jungle-boat
|nameid=jungle_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Acacia Boat
|spritetype=item
|spritename=acacia-boat
|nameid=acacia_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Dark Oak Boat
|spritetype=item
|spritename=dark-oak-boat
|nameid=dark_oak_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Mangrove Boat
|spritetype=item
|spritename=mangrove-boat
|nameid=mangrove_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Cherry Boat
|spritetype=item
|spritename=cherry-boat
|nameid=cherry_boat
|itemtags=boats
|form=item}}
{{ID table
|displayname=Bamboo Raft
|spritetype=item
|spritename=bamboo-raft
|nameid=bamboo_raft
|itemtags=boats
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Boat
|generatetranslationkeys=y
|displayname=Entity
|spritetype=entity
|spritename=boats
|nameid=boat
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showitemtags=y
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Oak Boat
|spritetype=item
|nameid=oak_boat
|aliasid=boat / 0
|id=375
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.oak.name}}
{{ID table
|displayname=Spruce Boat
|spritetype=item
|nameid=spruce_boat
|aliasid=boat / 1
|id=378
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.spruce.name}}
{{ID table
|displayname=Birch Boat
|spritetype=item
|nameid=birch_boat
|aliasid=boat / 2
|id=376
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.birch.name}}
{{ID table
|displayname=Jungle Boat
|spritetype=item
|nameid=jungle_boat
|aliasid=boat / 3
|id=377
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.jungle.name}}
{{ID table
|displayname=Acacia Boat
|spritetype=item
|nameid=acacia_boat
|aliasid=boat / 4
|id=379
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.acacia.name}}
{{ID table
|displayname=Dark Oak Boat
|spritetype=item
|nameid=dark_oak_boat
|aliasid=boat / 5
|id=380
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.big_oak.name}}
{{ID table
|displayname=Mangrove Boat
|spritetype=item
|nameid=mangrove_boat
|aliasid=boat / 6
|id=643
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.mangrove.name}}
{{ID table
|displayname=Cherry Boat
|spritetype=item
|nameid=cherry_boat
|aliasid=boat / 8
|id=657
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.cherry.name}}
{{ID table
|displayname=Bamboo Raft
|spritetype=item
|nameid=bamboo_raft
|aliasid=boat / 7
|id=661
|form=item
|itemtags=minecraft:boats
|translationkey=item.boat.bamboo.name
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Form
|shownumericids=y
|generatetranslationkeys=y
|displayname=Entity
|spritetype=entity
|spritename=boats
|nameid=boat
|id=90
|foot=1}}

===Entity data===
Boats have entity data associated with them that contain various properties of the entity.

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

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

==Achievements==
{{load achievements|Whatever Floats Your Goat}}

==Advancements==
{{load advancements|Whatever Floats Your Goat!}}

==History==
{{History|java alpha}}
{{History||v1.0.6|[[File:Oak Boat JE1.png|32px]] [[File:Oak Boat (item) JE1.png|32px]] Added boats. 
|Initially, boats broke upon being placed outside water, and on impact with land.}}
{{History||v1.0.6_01|Boats now only break on impact with land at high speeds. 
|Boats no longer break upon being placed outside water.
|Boat turning has been made smoother.}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|It is now possible to score a [[Damage#Critical hit|critical hit]] against a boat.}}
{{History|java}}
{{History||1.3.1|snap=12w15a|Boats can now be shot out from [[dispenser]]s.}}
{{History|||snap=1.3|[[File:Oak Boat (item) JE2 BE1.png|32px]] The texture of the oak boat [[item]] has been changed.}}
{{History|||snap=12w21a|Boats no longer take [[damage]] when colliding with [[lily pad]]s. Instead, the lily pads themselves break.}}
{{History|||snap=12w23a|Boats can now accelerate to faster than previous speeds, and are now easier to control.}}
{{History|||snap=12w27a|Boats now drop their [[item]] instead of 3 [[planks|oak wood planks]] and 2 [[stick]]s if broken by a [[player]].|Instead, it needs to fall certain heights to drop 3 oak wood planks and 2 sticks.}}
{{History||1.6.1|snap=13w16b|New boat physics with lower inertia, but {{control|left}}, {{control|back}} and {{control|right}} controls have been removed.
|Boats now take [[damage]] and break when colliding with many lily pads in a short time.}}
{{History||1.7.2|snap=13w36a|[[Player]]s can now {{cmd|summon}} [[mob]]s riding boats, though mobs cannot control boats.}}
{{History|||snap=13w43a|Boats no longer inflict fall [[damage]] when running aground.
|Boats being broken by lily pads has been slightly improved.
|{{control|Left}}, {{control|back}} and {{control|right}} controls added again.}}
{{History||1.8|snap=14w06a|[[Mob]]s riding boats can now control them, so that they can chase or flee enemies, move toward food, move about randomly, or whatever they would do on land. The exceptions are the [[ghast]] and [[bat]], both of which cannot control boats.}}
{{History||1.8.2|snap=pre2|Boats can now survive crashes at higher speeds.<!-- They have to be going 0.2975 now, rather than only 0.2. -->}}
{{History||1.9|snap=15w41a|[[File:Oak Boat JE2 BE1.png|32px]] [[File:Spruce Boat JE1 BE1.png|32px]] [[File:Birch Boat JE1 BE1.png|32px]] [[File:Jungle Boat JE1 BE1.png|32px]] [[File:Acacia Boat JE1 BE1.png|32px]] [[File:Dark Oak Boat JE1 BE1.png|32px]]<br>
[[File:Oak Boat (item) JE3 BE2.png|32px]] [[File:Spruce Boat (item) JE1 BE2.png|32px]] [[File:Birch Boat (item) JE1 BE2.png|32px]] [[File:Jungle Boat (item) JE1 BE2.png|32px]] [[File:Acacia Boat (item) JE1 BE2.png|32px]] [[File:Dark Oak Boat (item) JE1 BE2.png|32px]] Boats have been overhauled to match the boats from [[Pocket Edition v0.11.0 alpha|Pocket Edition Alpha 0.11.0]]. They now have oars for paddling and are more durable and now allows passengers to board.
|[[Mob]]s can now board boats, though they can no longer control them.
|A new set of controls have been introduced: it includes holding down the {{control|right}} and {{control|left}} keys to move forward, and using the {{control|right}} key to move the right oar, turning the boat to the left (and vice-versa). Mouse movement no longer turns boats, and the {{control|forward}} and {{control|back}} keys no longer have any effect. 
|[[Player]]s can no longer {{control|use}} [[item]]s or {{control|attack}} from boats unless they were at a complete stop.
|The [[crafting]] recipe for boats has been changed to require a wooden [[shovel]] as shown below.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Recipe"
! Recipe
{{!}}-
{{!}}
{{Crafting
|A2= Oak Planks |B2= Wooden Shovel        |C2= Oak Planks
|A3= Oak Planks |B3= Oak Planks |C3= Oak Planks
|Output= Oak Boat
|ignoreusage=1
}}
{{!}}}
|The NBT [[tag]] {{code|Type}} (string) have now added for the boat [[entity]], taking values {{code|oak}}, {{code|spruce}}, {{code|birch}}, {{code|jungle}}, {{code|acacia}} and {{code|dark_oak}}.
|Boats no longer break [[snow|snow layers]] they run into.}}
{{History|||snap=15w42a|The new boats are now comparable in speed to the old boats (slightly faster than sprinting), though with less momentum.
|Players can now {{control|use}} items and {{control|attack}} immediately after they stop rowing.}}
{{History|||snap=15w43c|The texture of boats has been remapped, so that they now have a separate texture per oar and per side of the boat.}}
{{History|||snap=15w51a|Boats now [[drops|drop]] their corresponding [[planks]] when broken.}}
{{History|||snap=16w04a|Boats are now faster and now move forward and backward using the {{control|forward}} and {{control|backward}} keys respectively, and steer left and right using the {{control|left}} and {{control|right}} keys respectively. The rowing mechanism introduced in [[Java Edition 15w41a|15w41a]], holding the {{control|right}} and {{control|left}} keys, is removed and no longer moves the boat forward. The controls are now more similar to boats before the overhaul.
|Boats now sink when underwater, or within flowing water of any depth.
|The crafting recipe of boats has been restored to the original recipe, no longer requiring a wooden [[shovel]] as it has since 15w41a (though matching wood [[planks]] is still required).
|Riding a boat no longer subjects [[water]]-sensitive [[mob]]s to being damaged by water, and no longer protects sunlight-sensitive mobs from being damaged by sunlight.
|Dismounting in a boat now attempts to place the [[player]] on land.}}
{{History|||snap=16w05a|Boats now travel extremely fast on [[ice]], [[Packed Ice|packed ice]] and [[Frosted Ice|frosted ice]].<ref name="MC-97803"/>}}
{{History|||snap=16w06a|Riding [[entity|entities]] such as boats are now run by the client rather than by the server.}}
{{History||1.11|snap=16w32a|The entity ID has been changed from {{code|Boat}} to {{code|boat}}.
|The player's [[hunger]] bar is now visible when riding in a boat.}}
{{History|||snap=16w33a|Boats can now be used to fuel [[furnace]]s.}}
{{History|||snap=16w39c|Boats placed by dispensers now face the same way as the dispenser, instead of toward the dispenser.<ref>{{bug|MC-90074|||Fixed}}</ref>}}
{{History||1.12|snap=17w17a|A boat paddles [[sound]] has been added.}}
{{History||1.13|snap=17w47a|The oak boat ID has been changed from {{code|boat}} to {{code|oak_boat}}.
|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 333, 444, 445, 446, 447 and 448.}}
{{History|||snap=18w15a|Added [[Blue Ice|blue ice]], which allows boats to travel even faster on it.}}
{{History||1.14|snap=18w43a|[[File:Oak Boat JE3.png|32px]] [[File:Spruce Boat JE2.png|32px]] [[File:Birch Boat JE2.png|32px]] [[File:Jungle Boat JE2.png|32px]] [[File:Acacia Boat JE2.png|32px]] [[File:Dark Oak Boat JE2.png|32px]]<br>
[[File:Oak Boat (item) JE4 BE3.png|32px]] [[File:Spruce Boat (item) JE2 BE3.png|32px]] [[File:Birch Boat (item) JE2 BE3.png|32px]] [[File:Jungle Boat (item) JE2 BE3.png|32px]] [[File:Acacia Boat (item) JE2 BE3.png|32px]] [[File:Dark Oak Boat (item) JE2 BE3.png|32px]] The textures of all boats have been changed.}}
{{History||1.14|snap=18w50a|[[File:Oak Boat JE4 BE2.png|32px]] [[File:Spruce Boat JE3 BE2.png|32px]] [[File:Birch Boat JE3 BE2.png|32px]] [[File:Jungle Boat JE3 BE2.png|32px]] [[File:Acacia Boat JE3 BE2.png|32px]] [[File:Dark Oak Boat JE3 BE2.png|32px]] The textures of all boats have been changed to match the new [[planks]].}}
{{History|||snap=19w11a|Fisherman [[villager]]s now [[trading|buy]] boats.}}
{{History||1.15|snap=19w37a|Boats as fuel now [[smelting|smelt]] 6 [[item]]s in a [[furnace]] instead of 1.}}
{{History||1.16|snap=20w18a|Mobs in boats no longer [[Spawn#Despawning|despawn]].}}
{{History||1.19|snap=22w11a|[[File:Mangrove Boat JE1 BE1.png|32px]] [[File:Mangrove Boat (item) JE1 BE1.png|32px]] Added mangrove boats.}}
{{History|||snap=22w12a|Boats can now be used to craft boats with chests.
|[[File:Oak Boat (item) JE5.png|32px]] [[File:Spruce Boat (item) JE3 BE5.png|32px]] [[File:Birch Boat (item) JE3 BE4.png|32px]] [[File:Jungle Boat (item) JE3 BE4.png|32px]] [[File:Acacia Boat (item) JE3 BE4.png|32px]] [[File:Dark Oak Boat (item) JE3 BE4.png|32px]] The textures of all boat items (except mangrove) have been changed.<ref>{{bug|MC-94161|||Fixed}}</ref>}}
{{History|||snap=22w14a|Due to the addition of the [[mangrove tree]] and [[mangrove swamp]], mangrove boats are now obtainable and renewable.}}
{{History|||snap=22w15a|[[File:Oak Boat (item) JE6.png|32px]] [[File:Spruce Boat (item) JE4.png|32px]] [[File:Birch Boat (item) JE4.png|32px]] [[File:Jungle Boat (item) JE4.png|32px]] [[File:Acacia Boat (item) JE4.png|32px]] [[File:Dark Oak Boat (item) JE4.png|32px]] [[File:Mangrove Boat (item) JE2.png|32px]] The textures of all boat item textures have been changed.}}
{{History||October 15, 2022|link={{ytl|yZRXmHiEh7U&t}}|[[File:Bamboo Raft JE1 BE1.png|32px]] Bamboo rafts were announced at [[Minecraft Live 2022]].}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|[[File:Bamboo Raft JE1 BE1.png|32px]] [[File:Bamboo Raft (item) JE1.png|32px]] Added bamboo rafts behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History|||snap=22w45a|[[File:Bamboo Raft (item) JE2 BE2.png|32px]] The item texture of the bamboo raft has been changed.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Cherry Boat JE1.png|32px]] [[File:Cherry Boat (item) JE1.png|32px]] Added cherry boats behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History||1.20|snap=23w12a|Bamboo rafts and cherry boats are now available without using the "Update 1.20" experimental datapack.}}

{{History|pocket alpha}}
{{History||September 19, 2014|link={{tweet|_tomcc|512935629026770944}}|[[Tommaso Checchi]] tweeted a picture of a [[player]] riding a boat, stating that the most important thing is to "get the paddling right."
|[[File:Minecart JE2 BE1.png|32px]] The model used by boats is currently a [[minecart]].}}
{{History||January 26, 2015|link={{tweet|_tomcc|559697958728654848}}|Tommaso Checchi tweets a screenshot of multiple riders in a single boat.
|[[File:Boat (pre-release).png|32px]] The model used by boats is now a minecart which has been squished vertically, and tinted brown.}}
{{History||February 20, 2015|link={{tweet|_tomcc|568844305491730432}}|Tommaso Checchi tweets a screenshot of multiple boats with only mobs in them.
|Boats now have a proper model with paddles.}} 
{{History||v0.11.0|snap=build 1|[[File:Oak Boat JE2 BE1.png|32px]] [[File:Spruce Boat JE1 BE1.png|32px]] [[File:Birch Boat JE1 BE1.png|32px]] [[File:Jungle Boat JE1 BE1.png|32px]] [[File:Acacia Boat JE1 BE1.png|32px]] [[File:Dark Oak Boat JE1 BE1.png|32px]]<br>
[[File:Oak Boat (item) JE2 BE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] Added boats. Each wood type has its own respective variant, though they share the same sprite as [[item]]s.
|Boats can support two riders, including [[mob]]s.
|Boats are larger in size than {{in|java}}.
|Boats are more resistant to crashing against land than {{in|java}}.}}
{{History|||snap=build 12|Projectiles can now be shot from boats.}}

{{History||v0.12.1|snap=build 1|Added all boat variants to the [[Creative]] [[inventory]].
|[[File:Oak Boat (item) JE3 BE2.png|32px]] [[File:Spruce Boat (item) JE1 BE2.png|32px]] [[File:Birch Boat (item) JE1 BE2.png|32px]] [[File:Jungle Boat (item) JE1 BE2.png|32px]] [[File:Acacia Boat (item) JE1 BE2.png|32px]] [[File:Dark Oak Boat (item) JE1 BE2.png|32px]] New [[inventory]] icons for boats have been added. The sprite now includes paddles and represents their respective wood color.}}
{{History||v0.13.0|snap=build 1|Boats are now slightly faster than sprinting, and no longer deplete [[hunger]].
|[[Player]]s can now {{control|use}} [[item]]s and {{control|attack}} immediately after they stop rowing.}}
{{History|||snap=build 3|Boats now stack on top of each other.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.22|Boats now move faster on [[ice]].}}
{{History||1.5.0|snap=beta 1.5.0.0|The steering of boats has been changed when using keyboard and mouse - W now moves the boat forward and S reverses it.}}
{{History|||snap=beta 1.5.0.4|Boats can now sink or float on [[Bubble Column|bubble column]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Oak Boat JE4 BE2.png|32px]] [[File:Spruce Boat JE3 BE2.png|32px]] [[File:Birch Boat JE3 BE2.png|32px]] [[File:Jungle Boat JE3 BE2.png|32px]] [[File:Acacia Boat JE3 BE2.png|32px]] [[File:Dark Oak Boat JE3 BE2.png|32px]]<br>
[[File:Oak Boat (item) JE4 BE3.png|32px]] [[File:Spruce Boat (item) JE2 BE3.png|32px]] [[File:Birch Boat (item) JE2 BE3.png|32px]] [[File:Jungle Boat (item) JE2 BE3.png|32px]] [[File:Acacia Boat (item) JE2 BE3.png|32px]] [[File:Dark Oak Boat (item) JE2 BE3.png|32px]] The textures of all boats have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|Boats can now be [[trading|bought]] from fisherman [[villager]]s.}}
{{History||1.16.0|snap=beta 1.16.0.57|[[Trading]] has been changed, master-level fisherman villagers now offer to [[trading|buy]] boats based on their villager [[biome]] outfit.
|Due to trading changes, birch boats can no longer be [[trading|sold]] to fisherman villagers.}}
{{History||1.16.100|snap=beta 1.16.100.51|Custom named boats now save their name after placing and breaking.}}
{{History|||snap=beta 1.16.100.56|The item ID {{code|boat}} has been split up into {{code|<type>_boat}}.}}
{{History||1.18.10|snap=beta 1.18.10.27|[[File:Oak Boat (item) BE4.png|32px]] [[File:Spruce Boat (item) BE4.png|32px]] [[File:Birch Boat (item) JE3 BE4.png|32px]] [[File:Jungle Boat (item) JE3 BE4.png|32px]] [[File:Acacia Boat (item) JE3 BE4.png|32px]] The item sprites of all boats have been changed. The paddles now represent their respective wood color (except spruce) and the inside rims of the boats are darker.
|[[File:Dark Oak Boat (item) JE3 BE4.png|32px]] An updated item sprite for dark oak boat has been added to the game files, but it's currently unused.<ref>{{bug|MCPE-151667}}</ref>}}
{{History||1.18.30|snap=beta 1.18.20.25|[[File:Spruce Boat (item) JE3 BE5.png|32px]] An updated item sprite for spruce boat has been added to the game files, but it's currently unused.<ref>{{bug|MCPE-152262}}</ref>}}
{{History|||snap=beta 1.18.20.27|Spruce and dark oak boats now correctly use their updated item sprites.}}
{{History||1.19.0|snap=beta 1.19.0.20|[[File:Mangrove Boat JE1 BE1.png|32px]] [[File:Mangrove Boat (item) JE1 BE1.png|32px]] Added mangrove boats.}}
{{History|||snap=beta 1.19.0.26|[[File:Oak Boat (item) JE6.png|32px]] [[File:Spruce Boat (item) JE4.png|32px]] [[File:Birch Boat (item) JE4.png|32px]] [[File:Jungle Boat (item) JE4.png|32px]] [[File:Acacia Boat (item) JE4.png|32px]] [[File:Dark Oak Boat (item) JE4.png|32px]] [[File:Mangrove Boat (item) JE2.png|32px]] Changed all boat item textures.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|[[File:Bamboo Raft JE1 BE1.png|32px]] [[File:Bamboo Raft (item) BE1.png|32px]] Added bamboo rafts behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.60.20|[[File:Bamboo Raft (item) JE2 BE2.png|32px]] The item texture of the bamboo raft has been changed to match ''[[Java Edition]]''.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.80|snap=beta 1.19.80.20|[[File:Cherry Boat JE1.png|32px]] [[File:Cherry Boat (item) JE1.png|32px]] Added cherry boats behind the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.}}
{{History||1.20.0|snap=beta 1.20.0.21|Bamboo rafts and cherry boats are now available without using the "Next Major Update" experimental toggle.}}
{{History||1.20.10|snap=beta 1.20.10.20|The [[wooden shovel]] in the crafting recipe has been removed for all boat types except the bamboo raft.}}
{{History|||snap=beta 1.20.10.21|The bamboo raft recipe no longer needs a wooden shovel.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Oak Boat JE1.png|32px]] [[File:Oak Boat (item) JE2 BE1.png|32px]] Added boats.}}
{{History||xbox=TU12|The maximum number of boats in a world has been increased to 40.
|Boats now break when they hit land hard.}}
{{History||xbox=TU14|ps=1.04|Boats are no longer broken by [[Lily Pad|lily pad]]s anymore, instead they run straight through the lily pad now, breaking and sometimes dropping it.
|When boats crash, they can now sometimes [[drops|drop]] themselves as [[item]]s.
|Boats are now less glitchy and more responsive now.
|The maximum speed of boats has been increased.
|When exiting, [[player]]s now move from the boat.
|When broken by a player, they [[drops|drop]] a boat now.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|[[File:Oak Boat JE2 BE1.png|32px]] [[File:Spruce Boat JE1 BE1.png|32px]] [[File:Birch Boat JE1 BE1.png|32px]] [[File:Jungle Boat JE1 BE1.png|32px]] [[File:Acacia Boat JE1 BE1.png|32px]] [[File:Dark Oak Boat JE1 BE1.png|32px]]<br>
[[File:Oak Boat (item) JE3 BE2.png|32px]] [[File:Spruce Boat (item) JE1 BE2.png|32px]] [[File:Birch Boat (item) JE1 BE2.png|32px]] [[File:Jungle Boat (item) JE1 BE2.png|32px]] [[File:Acacia Boat (item) JE1 BE2.png|32px]] [[File:Dark Oak Boat (item) JE1 BE2.png|32px]] Boats have been overhauled to match [[Pocket Edition v0.11.0 alpha|Pocket Edition Alpha 0.11.0]] boats.}}
{{History||xbox=TU57|xbone=CU49|ps=1.56|wiiu=Patch 27|switch=1.0.7|The [[crafting]] recipe of boats has been changed to require a wooden [[shovel]].}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Oak Boat JE4 BE2.png|32px]] [[File:Spruce Boat JE3 BE2.png|32px]] [[File:Birch Boat JE3 BE2.png|32px]] [[File:Jungle Boat JE3 BE2.png|32px]] [[File:Acacia Boat JE3 BE2.png|32px]] [[File:Dark Oak Boat JE3 BE2.png|32px]]<br>
[[File:Oak Boat (item) JE4 BE3.png|32px]] [[File:Spruce Boat (item) JE2 BE3.png|32px]] [[File:Birch Boat (item) JE2 BE3.png|32px]] [[File:Jungle Boat (item) JE2 BE3.png|32px]] [[File:Acacia Boat (item) JE2 BE3.png|32px]] [[File:Dark Oak Boat (item) JE2 BE3.png|32px]] The textures of all boats have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Oak Boat JE2 BE1.png|32px]] [[File:Spruce Boat JE1 BE1.png|32px]] [[File:Birch Boat JE1 BE1.png|32px]] [[File:Jungle Boat JE1 BE1.png|32px]] [[File:Acacia Boat JE1 BE1.png|32px]] [[File:Dark Oak Boat JE1 BE1.png|32px]]<br>
[[File:Oak Boat (item) JE3 BE2.png|32px]] [[File:Spruce Boat (item) JE1 BE2.png|32px]] [[File:Birch Boat (item) JE1 BE2.png|32px]] [[File:Jungle Boat (item) JE1 BE2.png|32px]] [[File:Acacia Boat (item) JE1 BE2.png|32px]] [[File:Dark Oak Boat (item) JE1 BE2.png|32px]] Added boats.}}
{{History|foot}}

==Issues ==
{{issue list}}

==Trivia== 
*[[Sand]], [[Sand|red sand]], [[Concrete Powder|concrete powder]], [[gravel]], [[anvil]]s, and [[Dragon Egg|dragon egg]]s drop as [[Item (entity)|items]] when they fall onto a boat that is in water.
*A [[chest]] is short enough that a boat falls onto it rather than crashes into it.
*{{IN|console}}, holding the movement stick to the side in a boat on [[Blue Ice|blue ice]] causes the player to spin quickly. If a passenger is in the boat while this occurs, when the player exits the boat after it reaches maximum velocity (attained after about three seconds), for most mobs, the mob's head may spin uncontrollably. For some mobs, however, nothing happens (such as [[slime]]s and [[ghast]]s). The mob may also get its head stuck at an angle. Thorough testing was done on Minecraft: Wii U Edition, although the glitch was originally discovered on the Xbox 360 Edition.

==Gallery==
<gallery>
Oak Boat.png|Oak
Spruce Boat.png|Spruce
Birch Boat.png|Birch
Jungle Boat.png|Jungle
Acacia Boat.png|Acacia
Dark Oak Boat.png|Dark oak
Mangrove Boat.png|Mangrove
Cherry Boat.png|Cherry
Bamboo Raft.png|Bamboo raft
Oak Boat (item).png|Oak
Spruce Boat (item).png|Spruce
Birch Boat (item).png|Birch
Jungle Boat (item).png|Jungle
Acacia Boat (item).png|Acacia
Dark Oak Boat (item).png|Dark oak
Mangrove Boat (item).png|Mangrove
Cherry Boat (item).png|Cherry
Bamboo Raft (item).png|Bamboo raft
</gallery>

=== Screenshots ===
<gallery>
AllBoats.png|All types of boats next to each other.
Screenboat.png|The old boat floating.
BoatStackingFun.png|A bunch of pre-1.9 boats stacked up.
Boats boats boats boats!!.jpg|First image of boats in BE development.
I guess it's getting there.png|Second image of boats in BE development.
All aboard the hype boat!.png|Image of the completed Bedrock Edition boats.
Boatglitche.png|A trail of boats after a game crash while riding a boat.
BoatDock.png|A dock with many boats.
Minescape.png|A third-person perspective of a boat in [[Java Edition Alpha v1.0.6]].
</gallery>

=== Development Images ===
<gallery>
Jappa Boat.jpg|Jappa texturing a boat.
Nekofresa Making Bamboo Raft in Blockbench.png|Nekofresa making the bamboo raft in Blockbench.
Chiwi Boats 1.png|Boat item textures.
Chiwi Boats 2.png|Boat item textures.
Chiwi Boats 3.png|Boat item textures.
Chiwi Boats 4.png|Boat item textures.
</gallery>

=== Concept Art ===
<gallery>
Bamboo Raft Concept Art.png|Bamboo raft concept art.
Bamboo Raft and Raft with Chest Concept Art.png|Ditto.
</gallery>

=== Artwork ===
<gallery>
Sunny-boat.gif|Official artwork of [[Sunny]] riding a mangrove boat.
Mobile Adventure 640x960.png|Official artwork of [[Alex]] in a boat at sea with an [[Allay]].
File:Zuri Raft.jpg
Zuri on Bamboo Raft Pixel Art.png|Pixel art of [[Zuri]] on a bamboo raft with a baby [[panda]].
File:Cutout Blossom (Trails & Tales Event).png|Cutout of Zuri and [[Efe]] on bamboo rafts, featured in the [[Trails & Tales Event]].
File:This or That.jpg
File:Croc Ad 1.jpg|An oak boat as it appears in an advertisement for ''Crocs''.<ref> https://www.youtube.com/shorts/e1AJo7jU5MI</ref>
</gallery>

==See also==
*[[Transportation]]

==References==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--boat Taking Inventory: Boat] – Minecraft.net on October 4, 2019

{{Items}}
{{Entities}}

[[cs:Člun]]
[[de:Boot]]
[[es:Barca]]
[[fr:Bateau]]
[[hu:Csónak]]
[[it:Barca]]
[[ja:ボート]]
[[ko:보트]]
[[nl:Boot]]
[[pl:Łódka]]
[[pt:Bote]]
[[ru:Лодка]]
[[th:เรือ]]
[[uk:Човен]]
[[zh:船]]</li></ul>
build 4Shulker shells added, but not shulker boxes.
pocket upcoming
1.1
{{Extension DPL}}<ul><li>[[Debug fourj item|Debug fourj item]]<br/>{{DISPLAYTITLE:<samp>debug_fourj_item</samp>}}
{{exclusive|Legacy Console}}{{Unobtainable||edition=console|section=}}{{Item
| image = Barrier (held) JE1 BE1.png
| renewable = No
| stackable = Yes (64)
| rarity = Common
| title = <samp>debug_fourj_item</samp>
}}
<samp>'''debug_fourj_item'''</samp> is an unobtainable item exclusive to the [[Legacy Console Edition]] and can only be obtained through modding the game. It has the texture of a [[barrier]], no "What's this?" hint and no display name.

==Obtaining==
The only way to obtain this item is via inventory editors and other external tools.

==Usage==
The purpose of this item is unknown, and it cannot be placed. Although the ID<ref name="r">[https://youtu.be/IscH0rUw_20 "マインクラフト WiiU 全面の木、偽バリアブロックのアイテムID公開"] - YouTube, March 26, 2019</ref> suggests that it was used for debugging and testing purposes.

==Data values==
===ID===
{{ID table|displayname=[No displayed name]
|showforms=y|form=item|nameid=debug_fourj_item|id=2255<ref group="note">Numerical IDs aren't supported on the Legacy Console Edition anymore.</ref><ref name="r"/>|shownumericids=y|translationkey=item.debug_fourj_item.name|generatetranslationkeys=y|foot=1}}
<references group="note" />

==History==
{{History|console}}
{{History||xbox=unknown|xbone=unknown|ps=unknown|wiiu=unknown|switch=unknown|[[File:Barrier (held) JE1 BE1.png|32px]] Added <samp>debug_fourj_item</samp>.}}
{{History|foot}}

== Gallery ==
<gallery>
Debug fourj item in inventory.png|<samp>debug_fourj_item</samp> as it appears in one's inventory
</gallery>

==See also==

*[[Debug Stick]]

==References==
<references />

{{Items}}
{{Unused features}}
[[Category:Articles missing historical information]]</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>
build 1Added shulker boxes.
build 7Updated color palette for shulker boxes.
Legacy Console Edition
TU53CU53 1.49 Patch 23Patch 3Added shulker boxes.


Shulker box colors before 1.12

Issues

Issues relating to "Shulker Box" are maintained on the bug tracker. Report issues there.

Trivia

  • When opened with an entity on top, they will rise up half a block. This stretch also occurs to the box's hitbox.
  • When destroyed by an explosion, the block will always drop as an item.

Gallery

Advertisement