Minecraft Wiki
Tag: Mobile edit
(Changed two Wikipedia links to avoid redirects)
(21 intermediate revisions by 13 users not shown)
Line 1: Line 1:
 
{{about|the NBT file format|using NBT in commands|Tutorials/Command NBT tags}}
 
{{about|the NBT file format|using NBT in commands|Tutorials/Command NBT tags}}
The '''Named Binary Tag''' ('''NBT''') format is used by ''Minecraft'' for the various files in which it saves data. The format is described by Notch in a very brief specification.<ref>http://web.archive.org/web/20110723210920/http://www.minecraft.net/docs/NBT.txt specification</ref> The format is designed to store data in a tree structure made up of various ''tags''. All tags have an ID and a name. The original known version was 19132 as introduced in [[Beta 1.3]], and since then has been updated to 19133 with the [[Anvil file format]], whichs adds the {{cd|Int Array}} tag. The NBT format dates all the way back to [[Indev]] with tags 0 to 10 in use.
+
The '''Named Binary Tag''' ('''NBT''') format is used by ''Minecraft'' for the various files in which it saves data. The format is described by [[Notch]] in a brief specification.<ref>http://web.archive.org/web/20110723210920/http://www.minecraft.net/docs/NBT.txt specification</ref> The format is designed to store data in a tree structure made up of various ''tags''. All tags have an ID and a name. The original known version was 19132 as introduced in [[Beta 1.3]], and since then has been updated to 19133 with the [[Anvil file format]], which adds the {{cd|Int Array}} tag. The NBT format dates all the way back to [[Indev]] with tags 0 to 10 in use.
   
 
Another more user-friendly format of NBT is in plain string, as used in [[command]]s. This format is referred to as '''SNBT''', short for '''stringified NBT'''. It is different from the [[JSON]] format; hence, any JSON used in NBT, such as [[Commands#Raw JSON text|raw JSON text]], must be enclosed within a {{nbt|string}} string tag.
 
Another more user-friendly format of NBT is in plain string, as used in [[command]]s. This format is referred to as '''SNBT''', short for '''stringified NBT'''. It is different from the [[JSON]] format; hence, any JSON used in NBT, such as [[Commands#Raw JSON text|raw JSON text]], must be enclosed within a {{nbt|string}} string tag.
Line 62: Line 62:
 
| <code><number>f</code> or <code><number>F</code>
 
| <code><number>f</code> or <code><number>F</code>
 
| A signed floating point type.
 
| A signed floating point type.
| Precision varies throughout number line;<br>See [[wikipedia:Single precision floating-point format|Single-precision floating-point format]]. Maximum value about 3.4*10<sup>38</sup>
+
| Precision varies throughout number line;<br>See [[wikipedia:Single-precision floating-point format|Single-precision floating-point format]]. Maximum value about 3.4*10<sup>38</sup>
 
|-
 
|-
 
| style="text-align:center" | '''6'''
 
| style="text-align:center" | '''6'''
Line 70: Line 70:
 
| <code><decimal number></code>, <code><number>d</code> or <code><number>D</code>
 
| <code><decimal number></code>, <code><number>d</code> or <code><number>D</code>
 
| A signed floating point type.
 
| A signed floating point type.
| Precision varies throughout number line;<br>See [[wikipedia:Double precision floating-point format|Double-precision floating-point format]]. Maximum value about 1.8*10<sup>308</sup>
+
| Precision varies throughout number line;<br>See [[wikipedia:Double-precision floating-point format|Double-precision floating-point format]]. Maximum value about 1.8*10<sup>308</sup>
 
|-
 
|-
 
| style="text-align:center" | '''7'''
 
| style="text-align:center" | '''7'''
Line 83: Line 83:
 
| style="text-align:center" | {{nbt|string}}
 
| style="text-align:center" | {{nbt|string}}
 
| TAG_'''String'''
 
| TAG_'''String'''
| TAG_Short's payload ''length'', then a UTF-8 string with size ''length''.
+
| A TAG_Short-like, but instead unsigned<ref>https://docs.oracle.com/javase/8/docs/api/java/io/DataOutput.html#writeUTF-java.lang.String-</ref> payload ''length'', then a UTF-8 string resembled by ''length'' bytes.
 
| <code><a-zA-Z0-9 text></code>, <code>"<text>"</code> ({{cd|"}} within needs to be escaped to {{cd|\"}}), or <code>'<text>'</code> ({{cd|'}} within needs to be escaped to {{cd|\'}})
 
| <code><a-zA-Z0-9 text></code>, <code>"<text>"</code> ({{cd|"}} within needs to be escaped to {{cd|\"}}), or <code>'<text>'</code> ({{cd|'}} within needs to be escaped to {{cd|\'}})
 
| A UTF-8 string. It has a size, rather than being null terminated.
 
| A UTF-8 string. It has a size, rather than being null terminated.
| 32,767 bytes interpretable as UTF-8 (see [[wikipedia:UTF-8|UTF-8 format]]; most commonly-used characters are a single byte).
+
| 65,535 bytes interpretable as UTF-8 (see [[wikipedia:UTF-8#Modified_UTF-8|modified UTF-8 format]]; most commonly-used characters are a single byte).
 
|-
 
|-
 
| style="text-align:center" | '''9'''
 
| style="text-align:center" | '''9'''
Line 123: Line 123:
   
 
== File format ==
 
== File format ==
An NBT file is a zipped Compound tag, with the name and tag ID included. Some of the files utilized by ''Minecraft'' may be uncompressed, but in most cases the files follow Notch's original specification and are compressed with GZip. In the [[Legacy Console Edition]], [[chunks]] are compressed with XMemCompress, a variation of an LZX compression algorithm. There is no header to specify the version or any other information; only the <samp>[[level.dat]]</samp> file specifies the version.
+
An NBT file is a zipped Compound tag, with the name and tag ID included. The file in the zip must contain the Compound tag that it is as the first bytes. Some of the files utilized by ''Minecraft'' may be uncompressed, but in most cases, the files follow Notch's original specification and are compressed with GZip.
   
 
== Usage ==
 
== Usage ==
Line 134: Line 134:
   
 
=== Uses ===
 
=== Uses ===
{{info needed section|Add Bedrock Edition information}}
+
{{missing information|section|Bedrock Edition NBTs|type=code}}
 
* <samp>[[level.dat]]</samp> is stored in compressed NBT format.
 
* <samp>[[level.dat]]</samp> is stored in compressed NBT format.
 
* <samp>[[Player.dat format|<''player''>.dat]]</samp> files are stored in compressed NBT format.
 
* <samp>[[Player.dat format|<''player''>.dat]]</samp> files are stored in compressed NBT format.
* <samp>[[idcounts.dat]]</samp> is stored in uncompressed NBT format.
+
* <samp>[[idcounts.dat]]</samp> is stored in compressed NBT format.
 
* <samp>[[villages.dat]]</samp> is stored in compressed NBT format.
 
* <samp>[[villages.dat]]</samp> is stored in compressed NBT format.
 
* <samp>[[Map item format|map_<#>.dat]]</samp> files are stored in compressed NBT format.
 
* <samp>[[Map item format|map_<#>.dat]]</samp> files are stored in compressed NBT format.
Line 146: Line 146:
 
* [[Structure block file format|Saved structures]] are stored in compressed NBT format.
 
* [[Structure block file format|Saved structures]] are stored in compressed NBT format.
   
== Software ==
+
== Official software ==
Mojang has provided sample Java NBT classes for developers to use and reference as part of the source code for the MCRegion to Anvil file format converter.<ref>http://www.mojang.com/2012/02/new-minecraft-map-format-anvil/</ref> Since [[Java Edition 1.13]], ''Minecraft'' includes a built-in converter between the SNBT format and compressed NBT format, which comes with both the [[client.jar|client]] and official server.<ref>https://wiki.vg/Data_Generators#NBT_converters</ref>
 
=== Official ===
 
 
{{see also|Tutorials/Running the Data Generator}}
 
{{see also|Tutorials/Running the Data Generator}}
 
Mojang has provided sample Java NBT classes for developers to use and reference as part of the source code for the [[MCRegion]] to [[Anvil file format]] converter.<ref>http://www.mojang.com/2012/02/new-minecraft-map-format-anvil/</ref> Since [[Java Edition 1.13]], ''Minecraft'' includes a built-in converter between the SNBT format and compressed NBT format, which comes with both the [[client.jar|client]] and official server.<ref>https://wiki.vg/Data_Generators#NBT_converters</ref>
  +
 
The data generator from ''Minecraft'' is able to convert uncompressed Stringified NBT files with <samp>.snbt</samp> extension in an input folder to GZip compressed NBT format files with <samp>.nbt</samp> extension in an output folder, and vice versa.
 
The data generator from ''Minecraft'' is able to convert uncompressed Stringified NBT files with <samp>.snbt</samp> extension in an input folder to GZip compressed NBT format files with <samp>.nbt</samp> extension in an output folder, and vice versa.
   
The vanilla data generator can convert any GZip compressed NBT format to SNBT format. You can simply change the file extension of a file, such as [[Level_format#level.dat_format|<samp>level.dat</samp>]] to <samp>level.nbt</samp> and put it in the input folder, and the generator will decode the GZip compressed NBT data.
+
The vanilla data generator can convert any GZip compressed NBT format to SNBT format. The file extension of a file can simply be changed, such as <samp>[[level.dat]]</samp> to <samp>level.nbt</samp> and put in the input folder, and the generator then decodes the GZip compressed NBT data.
=== Third-Party ===
 
The community has developed programs to view and modify compressed and uncompressed NBT files:
 
{| class="wikitable" style="width: 100%" data-description="NBT editing software"
 
|-
 
! Name
 
! NBT Version
 
! Description
 
! Screenshot
 
|-
 
| [https://github.com/terminal625/cl-nbt CL-NBT]
 
| {{tc|no|19132|style=text-align:center}}
 
| CL-NBT is an NBT implementation in Common Lisp that can read and write NBT files and load and save McRegion files. Anvil format works with slight modification.
 
|-
 
| [[Programs and editors/NBTExplorer|NBTExplorer]] - [http://www.minecraftforum.net/topic/840677-nbtexplorer/ Forum Post]
 
| {{tc|yes|19133|style=text-align:center}}
 
| Inspired by and based on NBTEdit, this program allows viewing and editing of NBT files via a Windows tree control. It supports compressed and uncompressed NBT files, and allows for direct editing of the NBT structures in [[MCRegion]] and [[Anvil file format|Anvil]] files, [[level.dat]], etc.
 
| [[File:NBTExplorer.png|128px]]
 
|
 
|}
 
   
 
== History ==
 
== History ==
Line 179: Line 160:
 
{{h||1.12|snap=?|Added {{nbt|long array}} long array tags.}}
 
{{h||1.12|snap=?|Added {{nbt|long array}} long array tags.}}
 
{{h||1.13|snap=18w01a|Added a data generator to both the ''Minecraft'' [[client.jar|client]] and the default multiplayer software.}}
 
{{h||1.13|snap=18w01a|Added a data generator to both the ''Minecraft'' [[client.jar|client]] and the default multiplayer software.}}
{{h||1.14|snap=19w08a|{{nbt|string}} String tags can now be within single quotes {{cd|'}} besides double quotes {{cd|"}}.<ref>{{Link|url=https://github.com/Mojang/brigadier/pull/52|title=Allow single quote in strings by boq · Pull Request #52 |website=Mojang/brigadier – GitHub}}</ref>}}
+
{{h||1.14|snap=19w08a|{{nbt|string}} String tags in SNBT can now be within single quotes {{cd|'}} in addition to double quotes {{cd|"}}.<ref>{{Link|url=https://github.com/Mojang/brigadier/pull/52|title=Allow single quote in strings by boq · Pull Request #52 |website=Mojang/brigadier – GitHub}}</ref>}}
 
{{History|foot}}
 
{{History|foot}}
   
 
== References ==
 
== References ==
 
{{reflist}}
 
{{reflist}}
  +
  +
== External links ==
  +
* [https://wiki.vg/NBT NBT] on wiki.vg
  +
* [http://www.minecraftforum.net/topic/840677-nbtexplorer/ NBTExplorer], a tool for viewing and editing NBT files.
  +
* [http://irath96.github.io/webNBT/ webNBT], an online tool for viewing and editing NBT files.
   
 
{{Java Edition}}
 
{{Java Edition}}

Revision as of 14:33, 8 February 2021

This article is about the NBT file format. For using NBT in commands, see Tutorials/Command NBT tags.

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

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

TAG definition

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

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

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

File format

An NBT file is a zipped Compound tag, with the name and tag ID included. The file in the zip must contain the Compound tag that it is as the first bytes. Some of the files utilized by Minecraft may be uncompressed, but in most cases, the files follow Notch's original specification and are compressed with GZip.

Usage

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

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

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

Uses

This section is missing information about Bedrock Edition NBTs. 
Please expand the section to include this information. Further details may exist on the talk page.

Official software

Mojang has provided sample Java NBT classes for developers to use and reference as part of the source code for the MCRegion to Anvil file format converter.[3] Since Java Edition 1.13, Minecraft includes a built-in converter between the SNBT format and compressed NBT format, which comes with both the client and official server.[4]

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

The vanilla data generator can convert any GZip compressed NBT format to SNBT format. The file extension of a file can simply be changed, such as level.dat to level.nbt and put in the input folder, and the generator then decodes the GZip compressed NBT data.

History

Java Edition
1.0.0
{{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 one or more clones are on display in item frames, updates are made on all clone-connected maps. 

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 that moves 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.

A map always positions itself facing towards North when placed horizontally within an item frame regardless of how the map is placed.

=== 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''.
File:MapFailedtoFill.png|A map that has not yet filled. A rare bug in Java.
</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>
September 28, 2011Notch works on "saving arbitrary data with item instances."
1.12
{{Extension DPL}}<ul><li>[[Armor Stand|Armor Stand]]<br/>{{ItemEntity
| image = Armor Stand.png
| image2 = Armor Stand BE.png
| extratext = View [[#Gallery|all renders]]
| stackable =
* '''[[JE]]:''' Yes (16)
* '''[[BE]]:''' Yes (64)
| renewable = Yes
| flammable = Yes
| size = '''Normal:'''<br>
Width: 0.5 Blocks<br>
Height: 1.975 Blocks<br>
'''Small:'''<br>
Width: 0.25 Blocks<br>
Height: 0.9875 Blocks<br>
| health = {{hp|20}}
}}
An '''armor stand''' is an inanimate [[entity]] that can wear [[armor]]. It can also hold [[Item|items]] and be posed (but these are not possible in [[Survival]] in [[Java Edition]]).

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

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

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

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

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

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

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

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

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

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

==Behavior==

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

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

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

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

The stand wobbles slightly when being hit by the player.

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

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

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

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

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

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

===Item data===

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

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

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

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

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

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

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

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

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

==Issues==
{{issue list}}

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

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

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

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

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

==References ==
{{reflist}}

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

{{Items}}
{{Entities}}

[[Category:Storage]]

[[de:Rüstungsständer]]
[[es:Soporte para armadura]]
[[fr:Porte-armure]]
[[ja:防具立て]]
[[ko:갑옷 거치대]]
[[pl:Stojak na zbroję]]
[[pt:Suporte de armaduras]]
[[ru:Стойка для брони]]
[[th:แท่นวางชุดเกราะ]]
[[uk:Стійка для обладунків]]
[[zh:盔甲架]]</li><li>[[Le Tricolore|Le Tricolore]]<br/>{{Exclusive|Java}}
{{Joke feature}}
{{Item
| image = 
| renewable = Yes
| stackable = Yes (64)
}}

'''Le Tricolore''' (French for ''The Tricolour'') is a joke item from [[Java Edition 23w13a_or_b]].

== Obtaining ==
One le tricolore and one [[la baguette]] is given to all players when [[French mode]] gets activated. Deactivating the mode will remove le tricolore from the player's inventory (but not la baguette; [[container]]s such as [[chest]]s are not affected).

Le Tricolore is not available in the creative inventory, but can be obtained by using the {{cmd|give}} command.

== Data values ==

=== ID ===
{{ID table
|showforms=y
|generatetranslationkeys=java
|displayname=Le Tricolore
|spritetype=item
|nameid=le_tricolore
|form=item
|foot=1}}

== History ==
{{History|java}}
{{History||23w13a or b|[[File:Le Tricolore.png|32px]] Added Le Tricolore.}}
{{History|foot}}

{{Items}}
{{Jokes}}

[[Category:Joke items]]

[[ja:Le Tricolore]]
[[pt:Le Tricolore]]</li></ul></nowiki>
?Added long array tags.
1.13
{{Extension DPL}}<ul><li>[[Bottle o' Enchanting|Bottle o' Enchanting]]<br/>{{ItemEntity
|image=Bottle o' Enchanting.gif
|imagesize=160px
|invimage=Bottle o' Enchanting
|stackable=Yes (64)
|renewable=Yes
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
|rarity=Uncommon
|networkid='''[[JE]]''': 75
}}

A '''bottle o' enchanting''' is a throwable item that releases [[experience]] orbs on impact.

== Obtaining ==

=== Trading ===
Master-level cleric [[villager]]s sell bottles o' enchanting for 3 emeralds as part of their trade.

=== Natural generation ===

{{LootChestItem|bottle-o'-enchanting}}

== Usage ==

A bottle o' enchanting can be thrown by pressing {{control|use}}. On impact, it drops [[experience]] orbs worth {{xp|3|11}} (average 7.0) and sends out blue particles.

== Sounds ==
{{Edition|Java}}:<br>
Bottles o' enchanting use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Glass dig1.ogg
|sound2=Glass dig2.ogg
|sound3=Glass dig3.ogg
|subtitle=Bottle smashes
|source=neutral
|description=When a bottle o' enchanting impacts something
|id=entity.splash_potion.break
|translationkey=subtitles.entity.potion.splash
|volume=1.0
|pitch=0.9-1.0
|distance=16}}
{{Sound table
|rowspan=2
|sound=Bow shoot.ogg
|subtitle=Bottle thrown
|source=neutral
|description=When a bottle o' enchanting is thrown by a player
|id=entity.experience_bottle.throw
|translationkey=subtitles.entity.potion.throw
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16}}
{{Sound table
|subtitle=Dispensed item
|source=block
|description=When a bottle o' enchanting is dispensed from a [[dispenser]]
|id=block.dispenser.launch
|translationkey=subtitles.block.dispenser.dispense
|volume=1.0
|pitch=1.2
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Glass dig1.ogg
|sound2=Glass dig2.ogg
|sound3=Glass dig3.ogg
|source=block
|description=When a splash potion impacts something
|id=random.glass
|volume=1.0
|pitch=1.0}}
{{Sound table
|rowspan=2
|sound=Bow shoot.ogg
|source=player
|description=When a splash potion is thrown by a player
|id=random.bow
|volume=0.5
|pitch=0.33-0.5}}
{{Sound table
|source=player
|description=When a splash potion is dispensed from a dispenser
|id=random.bow
|volume=1.0
|pitch=0.83-1.25
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Bottle o' Enchanting
|spritetype=item
|nameid=experience_bottle
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Thrown Bottle o' Enchanting
|spritetype=entity
|spritename=Bottle o' Enchanting
|nameid=experience_bottle
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bottle o' Enchanting
|spritetype=item
|nameid=experience_bottle
|id=508
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Bottle o' Enchanting
|spritetype=entity
|nameid=xp_bottle
|id=68
|foot=1}}

=== Entity data ===
{{see also|Chunk format}}

Thrown bottles o' enchanting have entity data that define various properties of the entity.

{{/ED}}

== History ==
<!--When were dispensers made able to fire these? Or was this always a thing?-->
{{History|java}}
{{History||1.2.1|snap=12w04a|[[File:Bottle o' Enchanting JE1 BE1.png|32px]] Added bottles o' enchanting. 
|Bottles o' enchanting can currently be obtained only in [[creative]] mode.}}
{{History||1.3.1|snap=12w21a|With the implementation of the [[trading]] system, the [[player]] can now trade with priest [[villager]]s to obtain 2–4 bottles o' enchanting for 1 [[emerald]].}}
{{History||1.8|snap=14w02a|With the trading revamp, villagers no longer [[trading|sell]] bottles o' enchanting, making them again unobtainable in regular [[survival]].}}
{{History|||snap=14w31a|Cleric [[villager]]s now sell bottles o' enchanting for 3–11 [[emerald]]s each, making them [[renewable resource|renewable]] again.}}
{{History||1.9|snap=15w49a|Bottles o' enchanting, like all projectiles, now take thrower's motion into account.}}
{{History||1.11|snap=16w32a|The entity ID has now been changed from <code>ThrownExpBottle</code> to <code>xp_bottle</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 384.}}
{{History|||snap=18w11a|Bottles o' enchanting can now generate in [[shipwreck]] chests.}}
{{History|||snap=pre5|The entity ID has now been changed to <code>experience_bottle</code>.}}
{{History||1.14|snap=18w43a|[[File:Bottle o' Enchanting JE2 BE2.png|32px]] The texture of bottles o' enchanting has now been changed.}}
{{History|||snap=18w47a|Bottles o' enchanting can now generate in [[pillager outpost]] chests.}}
{{History||1.19|snap=22w13a|Bottles o' enchanting may now be found in [[ancient city]] [[chest]]s.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Bottle o' Enchanting JE1 BE1.png|32px]] Added bottles o' enchanting. 
|Due to the lack of [[trading]], bottles o' enchanting are currently available only in [[creative]] mode, similar to [[Java Edition 12w04a|12w04a]] when it was first released.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|With [[villager]] [[trading]] added, it is now possible to obtain bottles o' enchanting legitimately.}}
{{History||1.1.0|snap=alpha 1.1.0.0|The entity ID has now been changed from <code>potion.experience</code> to <code>xp_bottle</code>.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Bottles o' enchanting can now be found inside [[shipwreck]] and [[buried treasure]] [[chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Bottles o' enchanting can now be found in [[pillager outpost]] chests.
|[[File:Bottle o' Enchanting JE2 BE2.png|32px]] The texture of bottles o' enchanting has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has now been changed and bottles o' enchanting are now [[trading|sold]] by cleric [[villager]]s for 3 [[emerald]]s.}}

{{History|console}}
{{History||xbox=TU7|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Bottle o' Enchanting JE1 BE1.png|32px]] Added bottles o' enchanting.
|Bottle o' enchanting can be found in the Miscellaneous tab in the [[Creative inventory]].}}
{{History||xbox=TU12|Moved bottle o' enchanting to the Brewing tab in the Creative inventory.}}
{{History|PS4}}
{{History||1.90|[[File:Bottle o' Enchanting JE2 BE2.png|32px]] The texture of bottles o' enchanting has now been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Bottle o' Enchanting JE1 BE1.png|32px]] Added bottles o' enchanting.
|Bottles o' enchanting are not available within the [[Creative inventory]].}}
{{History||?|Added bottles o' enchanting to the Creative inventory.{{info needed|Which update did this occur?}}}}
{{History|foot}}

== Issues ==
{{issue list|Bottle o' Enchanting|Experience Bottle}}

== Gallery ==

<gallery>
Bottle O' Enchanting Splash.gif|Bottle o' enchanting splash animation on impact.
Bottle O' Enchanting villager.png|Players may trade with villagers to obtain bottles o' enchanting in survival mode.
</gallery>


{{Items}}
{{Entities}}

[[cs:Lektvar očarování]]
[[de:Erfahrungsfläschchen]]
[[es:Frasco con experiencia]]
[[fr:Fiole d'expérience]]
[[ja:エンチャントの瓶]]
[[ko:경험치 병]]
[[pl:Zaklęta butelka]]
[[pt:Frasco de experiência]]
[[ru:Зелье опыта]]
[[th:ขวดแห่งเวทมนตร์]]
[[zh:附魔之瓶]]</li><li>[[Longer String|Longer String]]<br/>{{stub}}
{{Joke feature}}
{{exclusive|java}}
{{item
| image = Longer String.png
| rarity=Common
| renewable=Yes
| stackable=Yes (64)
}}
'''Longer string''' is a joke item from [[Java Edition 23w13a_or_b]].

==Obtaining==
===Crafting===
{{Crafting
|A1= String |B1= String
|Output= Longer String
|shapeless= 1
|ignoreusage=1
}}

==Data values==
===ID===
{{edition|java}}:{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Longer String
|spritetype=item
|nameid=string2
|form=item|foot=1}}
==History==
{{History|java}}
{{History||23w13a_or_b|[[File:Longer String.png|32px]] Added longer string.}}
{{History|foot}}

{{items}}
{{Jokes}}
[[Category:Joke items]]

[[ja:Longer String]]
[[pt:Linha mais comprida]]</li></ul>
18w01aAdded a data generator to both the Minecraft client and the default multiplayer software.
1.14
{{Extension DPL}}<ul><li>[[Book|Book]]<br/>{{For}}
{{Item
| image = Book.png
| renewable = Yes
| stackable = Yes (64)
|effects=Read}}

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

== Obtaining ==

=== Block loot ===

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

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

=== Chest loot ===

{{LootChestItem|book}}

=== Grindstones ===

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

=== Villager gifts ===

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

== Usage ==

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

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

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

=== Trading ===

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

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

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


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

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

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

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

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

== Video ==

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

== History ==

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

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

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

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

== Issues ==

{{issue list}}

== See also ==

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

== How book is renewable ==
The paper comes from sugar canes, which is renewable because it grows and the leather from killing cows, renewable because cows breed{{Items}}

[[Category:Renewable resources]]

[[cs:Kniha]]
[[de:Buch]]
[[es:Libro]]
[[fr:Livre]]
[[hu:Könyv]]
[[it:Libro]]
[[ja:本]]
[[ko:책]]
[[nl:Boek]]
[[pl:Książka]]
[[pt:Livro]]
[[ru:Книга]]
[[th:หนังสือ]]
[[uk:Книга]] 
[[zh:书]]</li><li>[[Nether Sprouts|Nether Sprouts]]<br/>{{Block
|title=Nether Sprouts
|image=Nether Sprouts.png
|image2=Nether Sprouts (texture) JE2 BE2.png
|transparent=Yes
|tool=shears
|light=No
|renewable=Yes
|stackable=Yes (64)
|flammable=No
|lavasusceptible=Yes
}}

'''Nether sprouts''' are a non-solid fungi block that generate in [[warped forest]]s.

== Obtaining ==
=== Natural generation ===
Nether sprouts generate in [[warped forest]] biomes.

=== Breaking ===
Nether sprouts can be mined instantly with any item. The block also breaks if the block below is removed, or if [[water]] flows into its space. The block only drops if broken with [[shear]]s.

=== Post-generation ===
Applying [[bone meal]] to warped [[nylium]] creates nether sprouts on that block and surrounding nylium, along with both types of [[roots]] and [[fungi]].

== Usage ==
[[File:RootsSproutsPlaceBlock.png|thumb|All of the blocks that nether sprouts can be placed on.]]
Nether sprouts can be planted on the same blocks that [[fungus|fungi]] and [[roots]] can be placed on: [[nylium]], [[soul soil]], [[Grass Block|grass]], [[podzol]], [[mycelium]], [[Moss Block|moss]], [[dirt]], [[coarse dirt]], [[rooted dirt]], and [[farmland]]. However, they cannot be planted in [[flower pot]]s.

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

== Sounds ==
{{Sound table/Block/Nether sprouts}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|generatetranslationkeys=y
|showforms=y
|displayname=Nether Sprouts
|spritetype=block
|nameid=nether_sprouts
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Nether Sprouts
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=nether-sprouts
|spritetype=block
|nameid=nether_sprouts
|id=493
|form=block
|itemform=item.nether_sprouts}}
{{ID table
|displayname=Item
|spritename=nether-sprouts
|spritetype=item
|nameid=nether_sprouts
|id=621
|form=item
|translationkey=tile.nether_sprouts.name
|foot=1}}

== History ==
{{History|java}}
{{History||1.16|snap=20w06a|[[File:Nether Sprouts JE1 BE1.png|24px]] [[File:Nether Sprouts (texture) JE1 BE1.png|24px]] Added nether sprouts.}}
{{History|||snap=20w10a|[[File:Nether Sprouts JE2 BE2.png|24px]] [[File:Nether Sprouts (texture) JE2 BE2.png|24px]] The textures of the nether sprouts have now been changed.}}
{{History|||snap=20w15a|Nether sprouts can now be [[composter|composted]].}}
{{History|||snap=20w19a|Nether sprouts now only [[drops|drop]] if [[breaking|broken]] with [[shears]].}}
{{History|||snap=20w21a|[[File:Nether Sprouts (item) JE3 BE2.png|24px]] The [[inventory]] texture of the nether sprouts have now been changed.
|The [[block]] [[model]] of nether sprouts is now centered of the block rather than positioned randomly.}}
{{History||1.19.3|snap=22w44a|Nether sprouts now make sounds when being walked on.<ref>{{bug|MC-171621|||Fixed}}</ref>}}

{{History|bedrock}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Nether Sprouts JE1 BE1.png|24px]] [[File:Nether Sprouts (texture) JE1 BE1.png|24px]] Added nether sprouts.}}
{{History|||snap=beta 1.16.0.57|Nether sprouts can now be [[composter|composted]].}}
{{History|||snap=beta 1.16.0.59|[[File:Nether Sprouts JE2 BE2.png|24px]] [[File:Nether Sprouts (item) JE3 BE2.png|24px]] The textures of the nether sprouts have now been changed.
|[[File:Nether Sprouts Glitched BE.png|32px]] Nether sprouts now appear with a glitched texture when [[breaking|broken]] in [[survival]] mode or when picking the [[block]] in [[creative]] mode. The [[item]] received is also nameless.<ref>{{bug|MCPE-74339}}</ref>}}
{{History|||snap=beta 1.16.0.63|Nether sprouts now give the [[player]] the correct item when broken in survival mode or when picking the block in creative mode.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Unlike other warped "plants", nether sprouts don't have a crimson equivalent. This is also the case with [[nether wart]], which lacks a warped equivalent.

== References ==
{{Reflist}}

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

[[Category:Nether blocks]]
[[Category:Fungi]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]

[[de:Nethersprossen]]
[[de:Nethersprossen]]
[[es:Rastrojo del Nether]]
[[fr:Germes du Nether]]
[[ja:ネザースプラウト]]
[[pl:Netherowe kiełki]]
[[pt:Brotos do Nether]]
[[ru:Адские ростки]]
[[zh:下界苗]]</li></ul>
19w08a String tags in SNBT can now be within single quotes ' in addition to double quotes ".[5]

References

External links

  • NBT on wiki.vg
  • NBTExplorer, a tool for viewing and editing NBT files.
  • webNBT, an online tool for viewing and editing NBT files.