Minecraft Wiki
(Someone missed a comma so I put it in.)
Tag: Visual edit
No edit summary
(47 intermediate revisions by 30 users not shown)
Line 1: Line 1:
 
{{exclusive|java}}
 
{{exclusive|java}}
'''Block models''' are used to depict all the blocks in the game, whereas '''item models''' are used to display the items in the players hand, on their head (helmets and hats), on the ground, in the inventory, in [[item frame]]s and on [[armor stand]]s. As there are different variants of some blocks, '''block states''' are used to link these with the corresponding models. Each model and each block state has its own file, which is of the <code>.json</code> format. Even the icons used in the inventory are defined in these files.
+
'''Block models''' are used to depict all the blocks in the game, whereas '''item models''' are used to display the items in the players, hand, on their head (helmets and hats), on the ground, in the inventory, in [[item frame]]s and on [[armor stand]]s. As there are different variants of some blocks, '''block states''' are used to link these with the corresponding models. Each model and each block state has its own file, which is of the <code>.json</code> format. Even the icons used in the inventory are defined in these files.
   
 
== File path ==
 
== File path ==
In JSON files of models and block states, the namespaced ID in the form of <code>namespace:name</code> (the namespace <code> minecraft:</code> can be omitted) is used to represent the local file path. See also [[Namespaced ID#Locating contents in packs]].
+
In JSON files of models and block states, the resource location in the form of <code>namespace:path</code> (the <code>minecraft</code> namespace can be omitted) is used to represent the local file path. See also [[Resource_location#Locating_contents_in_packs]].
   
In these files, the path corresponding to the namespaced ID <code>namespace:name</code> is <code>assets/''namespace''/object_type/''name''.suffix</code>, where the name can contain subfolders separated by <code>/</code>, such as namespace:foo/bar/baz (foo and bar are folders, baz is the real file name).
+
In these files, the path corresponding to the resource location <code>namespace:path</code> is <code>assets/''namespace''/''object_type''/''path''.''suffix''</code>, where the path can contain subfolders separated by <code>/</code>, such as <code>namespace:foo/bar/baz</code> (<code>foo</code> and <code>bar</code> are folders, <code>baz</code> is the real file name).
   
The object specified by namespaced ID and its corresponding <code>object_type</code> and <code>suffix</code> are as follows:
+
The object specified by a resource location and its corresponding object type and suffix are as follows:
   
 
{|class="wikitable"
 
{|class="wikitable"
!Object!!<code>object_type</code> substitution!!<code>suffix</code> substitution
+
!Object!!<code>''object_type''</code> substitution!!<code>''suffix''</code> substitution
 
|-
 
|-
|Block States||blockstates||json
+
|Block States||<code>blockstates</code>||<code>json</code>
 
|-
 
|-
|Models||models||json
+
|Models||<code>models</code>||<code>json</code>
 
|-
 
|-
|Textures||textures||png
+
|Textures||<code>textures</code>||<code>png</code>
 
|}
 
|}
   
Line 23: Line 23:
 
There are several different variants of some blocks (like [[door]]s, which can be open or closed), hence each block has its own [[block state]] file, which lists all its existing variants and links them to their corresponding models. Blocks can also be compound of several different models at the same time, called "multipart". The models are then used depending on the block states of the block.
 
There are several different variants of some blocks (like [[door]]s, which can be open or closed), hence each block has its own [[block state]] file, which lists all its existing variants and links them to their corresponding models. Blocks can also be compound of several different models at the same time, called "multipart". The models are then used depending on the block states of the block.
   
These files are stored in the following folder: <code>assets/<namespace>/blockstates</code>. The files are used directly based on their filename, thus a block state file with another name than the existing ones does not affect any block.
+
These files are stored in the following folder: <code>assets/''<namespace>''/blockstates</code>. The files are used directly based on their filename, thus a block state file with another name than the existing ones does not affect any block.
   
 
<div class="treeview">
 
<div class="treeview">
Line 30: Line 30:
 
*** {{nbt|compound}}or{{nbt|list|A variant}}: Name of a variant, which consists of the relevant block states separated by commas. A block with just one variant uses <code>""</code> as a name for its variant. Each variant can have '''one model''' or an '''array of models''' and contains their properties. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary {{nbt|compound}}-tags. Item frames are treated as blocks and use <code>"map=false"</code> for a map-less item frame, and <code>"map=true"</code> for item frames with maps.
 
*** {{nbt|compound}}or{{nbt|list|A variant}}: Name of a variant, which consists of the relevant block states separated by commas. A block with just one variant uses <code>""</code> as a name for its variant. Each variant can have '''one model''' or an '''array of models''' and contains their properties. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary {{nbt|compound}}-tags. Item frames are treated as blocks and use <code>"map=false"</code> for a map-less item frame, and <code>"map=true"</code> for item frames with maps.
 
**** {{nbt|compound|A model}}: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
 
**** {{nbt|compound|A model}}: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
***** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of [[#File path|namespaced ID]].
+
***** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of a [[#File path|resource location]].
 
***** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
***** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
***** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
***** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
***** {{nbt|byte|uvlock}}: Can be <code>true</code> or <code>false</code> (default). Locks the rotation of the texture of a block, if set to <code>true</code>. This way the texture does not rotate with the block when using the x and y-tags above.
 
***** {{nbt|byte|uvlock}}: Can be <code>true</code> or <code>false</code> (default). Locks the rotation of the texture of a block, if set to <code>true</code>. This way the texture does not rotate with the block when using the x and y-tags above.
 
***** {{nbt|int|weight}}: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
 
***** {{nbt|int|weight}}: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
**** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of [[#File path|namespaced ID]].
+
**** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of a [[#File path|resource location]].
 
**** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
**** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
**** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
**** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
Line 48: Line 48:
 
**** {{nbt|compound}}{{nbt|list|apply}}: Determines the model(s) to apply and its properties. There can be '''one model''' or an '''array of models'''. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary {{nbt|compound}}-tags.
 
**** {{nbt|compound}}{{nbt|list|apply}}: Determines the model(s) to apply and its properties. There can be '''one model''' or an '''array of models'''. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary {{nbt|compound}}-tags.
 
***** {{nbt|compound|A model}}: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
 
***** {{nbt|compound|A model}}: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
****** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of [[#File path|namespaced ID]].
+
****** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of a [[#File path|resource location]].
 
****** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
****** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
****** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
****** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
****** {{nbt|byte|uvlock}}: Can be <code>true</code> or <code>false</code> (default). Locks the rotation of the texture of a block, if set to <code>true</code>. This way the texture does not rotate with the block when using the x and y-tags above.
 
****** {{nbt|byte|uvlock}}: Can be <code>true</code> or <code>false</code> (default). Locks the rotation of the texture of a block, if set to <code>true</code>. This way the texture does not rotate with the block when using the x and y-tags above.
 
****** {{nbt|int|weight}}: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
 
****** {{nbt|int|weight}}: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
***** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of [[#File path|namespaced ID]].
+
***** {{nbt|string|model}}: Specifies the path to the model file of the block, in form of a [[#File path|resource location]].
 
***** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
***** {{nbt|int|x}}: Rotation of the model on the x-axis in increments of 90 degrees.
 
***** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
 
***** {{nbt|int|y}}: Rotation of the model on the y-axis in increments of 90 degrees.
Line 128: Line 128:
 
}
 
}
 
</source>
 
</source>
While the first model, the fence post, is always used, the other models are used only if certain conditions are met. Here the sides of the fence are applied only if there is another adjacent block next to this one. As there is just one model for the post and another one for all the sides of the fence, which then is rotated by increments of 90 degrees, the amount of models needed for all the different possible set-ups of fences can be reduced to two. Compared to the five models and 16 variants used in [[Java Edition 1.8]], this is a rather big improvement. This tool helps to edit JSON data [https://jsonformatter.org/json-parser JSON Parser] and you can also use [https://jsonhome.com Json validator].
+
While the first model, the fence post, is always used, the other models are used only if certain conditions are met. Here the sides of the fence are applied only if there is another adjacent block next to this one. As there is just one model for the post and another one for all the sides of the fence, which then is rotated by increments of 90 degrees, the amount of models needed for all the different possible set-ups of fences can be reduced to two. Compared to the five models and 16 variants used in [[Java Edition 1.8]], this is a rather big improvement. This tool helps to edit JSON data [https://onlinejsontools.org/ JSON Parser] and you can also use [https://codeconvertertools.org/jsonviewer Json validator].
   
 
=== Example: Redstone Wire ===
 
=== Example: Redstone Wire ===
Line 193: Line 193:
 
== Block models ==
 
== Block models ==
   
The folder <code>assets/<namespace>/models/block</code> holds the model files for all the specified variants. The names of the files can be changed, but must always correspond with the names used in the variant files.
+
The folder <code>assets/''<namespace>''/models/block</code> holds the model files for all the specified variants. The names of the files can be changed, but must always correspond with the names used in the variant files.
   
 
<div class="treeview">
 
<div class="treeview">
 
* {{nbt|compound}} The root tag
 
* {{nbt|compound}} The root tag
** {{nbt|string|parent}}: Loads a different model from the given path, in form of [[#File path|namespaced ID]]. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
+
** {{nbt|string|parent}}: Loads a different model from the given path, in form of a [[#File path|resource location]]. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
*** Can be set to <code>"builtin/generated"</code> to use a model that is created out of the specified icon. Note that only the first layer is supported, and rotation can be achieved only by using block states files.
 
*** Can be set to <code>"builtin/generated"</code> to use a model that is created out of the specified icon. Note that only the first layer is supported, and rotation can be achieved only by using block states files.
 
** {{nbt|byte|ambientocclusion}}: Whether to use [http://en.wikipedia.org/wiki/Ambient_occlusion ambient occlusion] (<code>true</code> - default), or not (<code>false</code>).
 
** {{nbt|byte|ambientocclusion}}: Whether to use [http://en.wikipedia.org/wiki/Ambient_occlusion ambient occlusion] (<code>true</code> - default), or not (<code>false</code>).
Line 203: Line 203:
 
*** {{nbt|compound|''Position''}}: Named <code>thirdperson_righthand</code>, <code>thirdperson_lefthand</code>, <code>firstperson_righthand</code>, <code>firstperson_lefthand</code>, <code>gui</code>, <code>head</code>, <code>ground</code>, or <code>fixed</code>. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. '''fixed''' refers to item frames, while the rest are as their name states. Note that translations are applied to the model before rotations.
 
*** {{nbt|compound|''Position''}}: Named <code>thirdperson_righthand</code>, <code>thirdperson_lefthand</code>, <code>firstperson_righthand</code>, <code>firstperson_lefthand</code>, <code>gui</code>, <code>head</code>, <code>ground</code>, or <code>fixed</code>. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. '''fixed''' refers to item frames, while the rest are as their name states. Note that translations are applied to the model before rotations.
 
**** {{nbt|list|rotation}}: Specifies the rotation of the model according to the scheme <code>[x, y, z]</code>.
 
**** {{nbt|list|rotation}}: Specifies the rotation of the model according to the scheme <code>[x, y, z]</code>.
**** {{nbt|list|translation}}: Specifies the position of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 80, it is displayed as 80. If the value is less than -80, it is displayed as -80.
+
**** {{nbt|list|translation}}: Specifies the position of the model according to the scheme <code>[x, y, z]</code>. The values are clamped between -80 and 80.
 
**** {{nbt|list|scale}}: Specifies the scale of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 4, it is displayed as 4.
 
**** {{nbt|list|scale}}: Specifies the scale of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 4, it is displayed as 4.
** {{nbt|compound|textures}}: Holds the textures of the model, in form of [[#File path|namespaced ID]] or can be another texture variable.
+
** {{nbt|compound|textures}}: Holds the textures of the model, in form of a [[#File path|resource location]] or can be another texture variable.
*** {{nbt|string|particle}}: What texture to load particles from. This texture is used if you are in a [[nether portal]]. Note: All breaking particles from non-model blocks are hard-coded.
+
*** {{nbt|string|particle}}: What texture to load particles from. This texture is used if you are in a [[nether portal]].{{info needed|Is it also used for the fire animation in front of the player, or the suffocation overlay?}} Also used for [[water]] and [[lava]]'s still textures.<ref>{{bug|MC-240042}}</ref> Note: All breaking particles from non-model blocks are hard-coded.{{info needed|Those being? They definitely seem customizable in the latest version}}
 
*** {{nbt|string|''Texture variable''}}: Defines a texture variable and assigns a texture.
 
*** {{nbt|string|''Texture variable''}}: Defines a texture variable and assigns a texture.
 
** {{nbt|list|elements}}: Contains all the elements of the model. They can have only cubic forms. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
** {{nbt|list|elements}}: Contains all the elements of the model. They can have only cubic forms. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
*** {{nbt|compound}} An element.
 
*** {{nbt|compound}} An element.
**** {{nbt|list|from}}: Start point of a cube according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
+
**** {{nbt|list|from}}: Start point of a cuboid according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
**** {{nbt|list|to}}: Stop point of a cube according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
+
**** {{nbt|list|to}}: Stop point of a cuboid according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
 
**** {{nbt|compound|rotation}}: Defines the rotation of an element.
 
**** {{nbt|compound|rotation}}: Defines the rotation of an element.
 
***** {{nbt|list|origin}}: Sets the center of the rotation according to the scheme <code>[x, y, z]</code>.
 
***** {{nbt|list|origin}}: Sets the center of the rotation according to the scheme <code>[x, y, z]</code>.
Line 218: Line 218:
 
***** {{nbt|byte|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
 
***** {{nbt|byte|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
 
**** {{nbt|byte|shade}}: Defines if shadows are rendered (<code>true</code> - default), not (<code>false</code>).
 
**** {{nbt|byte|shade}}: Defines if shadows are rendered (<code>true</code> - default), not (<code>false</code>).
**** {{nbt|compound|faces}}: Holds all the faces of the cube. If a face is left out, it does not render.
+
**** {{nbt|compound|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
 
***** {{nbt|compound|''Face''}}: Named <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code> or <code>east</code>. Contains the properties of the specified face.
 
***** {{nbt|compound|''Face''}}: Named <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code> or <code>east</code>. Contains the properties of the specified face.
 
****** {{nbt|list|uv:}} Defines the area of the texture to use according to the scheme <code>[x1, y1, x2, y2]</code>. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of <code>x1</code> and <code>x2</code> are swapped (e.g. from <code>0, 0, 16, 16</code> to <code>16, 0, 0, 16</code>), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
 
****** {{nbt|list|uv:}} Defines the area of the texture to use according to the scheme <code>[x1, y1, x2, y2]</code>. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of <code>x1</code> and <code>x2</code> are swapped (e.g. from <code>0, 0, 16, 16</code> to <code>16, 0, 0, 16</code>), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
 
****** {{nbt|string|texture:}} Specifies the texture in form of the texture variable prepended with a <code>#</code>.
 
****** {{nbt|string|texture:}} Specifies the texture in form of the texture variable prepended with a <code>#</code>.
****** {{nbt|string|cullface:}} Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code>, or <code>east</code>. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side.
+
****** {{nbt|string|cullface:}} Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code>, or <code>east</code>. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side. <code>bottom</code> may also be used in the latest versions instead of <code>down</code>, despite appearing only once in the actual game assets.
 
****** {{nbt|int|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).
 
****** {{nbt|int|rotation}}: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though <code>uv</code>).
****** {{nbt|int|tintindex}}: Determines whether to tint the texture using a hardcoded tint index. The default is not using the tint, and any number causes it to use tint. Note that only certain blocks have a tint index; all others are unaffected.
+
****** {{nbt|int|tintindex}}: Determines whether to tint the texture using a hardcoded tint index. The default value, -1, indicates not to use the tint. Any other number is provided to BlockColors to get the tint value corresponding to that index. However, most blocks do not have a tint value defined (in which case white is used). Furthermore, no vanilla block currently uses multiple tint values, and thus the tint index value is ignored (as long as it is set to something other than -1); it could be used for modded blocks that need multiple distinct tint values in the same block though.
   
   
Line 268: Line 268:
 
</source>
 
</source>
   
This file is used to create the model of the torch, which is used for the normal, [[redstone torch]] and the [[soul fire torch]]. Therefore, the <code>"elements"</code> tag is used to create three elements or cubes. Only two faces of each cube are rendered, as only two faces of each one have been specified. <code>"uv"</code> is used to determine the area where the texture is used. The texture variable <code>"#torch"</code> is used for the particles and the cubes and has not yet been defined.
+
This file is used to create the model of the torch, which is used for the normal, [[redstone torch]] and the [[soul fire torch]]. Therefore, the <code>"elements"</code> tag is used to create three elements or cuboids. Only two faces of each cuboid are rendered, as only two faces of each one have been specified. <code>"uv"</code> is used to determine the area where the texture is used. The texture variable <code>"#torch"</code> is used for the particles and the cuboids and has not yet been defined.
   
 
; torch.json
 
; torch.json
Line 280: Line 280:
 
</source>
 
</source>
   
This file represents the model of the normal standing torch. It loads the model of previously defined standing torch with the help of <code>"parent"</code> and inherits all the properties of the file <code>torch.json</code>. As this file is used only for the normal torch, the texture can now be specified. The texture<code>"torch"</code> is now assigned to the texture variable <code>"torch"</code> (in form of [[#File path|namespaced ID]]) and therefore is used for the previously loaded model and its particles, as specified in the other file.
+
This file represents the model of the normal standing torch. It loads the model of previously defined standing torch with the help of <code>"parent"</code> and inherits all the properties of the file <code>template_torch.json</code>. As this file is used only for the normal torch, the texture can now be specified. The texture<code>"torch"</code> is now assigned to the texture variable <code>"torch"</code> (in form of a [[#File path|resource location]]) and therefore is used for the previously loaded model and its particles, as specified in the other file.
   
 
=== Example: Any Block ===
 
=== Example: Any Block ===
Line 441: Line 441:
 
== Item models ==
 
== Item models ==
   
As [[item]]s do not have different variants, there is no need to specify them. The folder <code>assets/<namespace>/models/item</code> contains all the model files. The names of the files are hardcoded and should not be changed.
+
As [[item]]s do not have different variants, there is no need to specify them. The folder <code>assets/''<namespace>''/models/item</code> contains all the model files. The names of the files are hardcoded and should not be changed.
   
 
<div class="treeview">
 
<div class="treeview">
 
* {{nbt|compound}}: The root tag
 
* {{nbt|compound}}: The root tag
**{{nbt|string|parent}}: Loads a different model from the given path, in form of [[#File path|namespaced ID]]. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
+
**{{nbt|string|parent}}: Loads a different model from the given path, in form of a [[#File path|resource location]]. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
*** Can be set to <code>"item/generated"</code> to use a model that is created out of the specified icon.
 
*** Can be set to <code>"item/generated"</code> to use a model that is created out of the specified icon.
 
*** Can be set to <code>"builtin/entity"</code> to load a model from an entity file. As you cannot specify the entity, this does not work for all items (only for [[chest]]s, [[ender chest]]s, [[mob head]]s, [[shield]]s, [[banner]]s and [[trident]]s).
 
*** Can be set to <code>"builtin/entity"</code> to load a model from an entity file. As you cannot specify the entity, this does not work for all items (only for [[chest]]s, [[ender chest]]s, [[mob head]]s, [[shield]]s, [[banner]]s and [[trident]]s).
Line 453: Line 453:
 
**** {{nbt|list|translation}}: Specifies the position of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 80, it is displayed as 80. If the value is less than -80, it is displayed as -80.
 
**** {{nbt|list|translation}}: Specifies the position of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 80, it is displayed as 80. If the value is less than -80, it is displayed as -80.
 
**** {{nbt|list|scale}}: Specifies the scale of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 4, it is displayed as 4.
 
**** {{nbt|list|scale}}: Specifies the scale of the model according to the scheme <code>[x, y, z]</code>. If the value is greater than 4, it is displayed as 4.
** {{nbt|compound|textures}}: Holds the textures of the model, in form of [[#File path|namespaced ID]] or can be another texture variable.
+
** {{nbt|compound|textures}}: Holds the textures of the model, in form of a [[#File path|resource location]] or can be another texture variable.
*** {{nbt|string|layer#}}: Only used to specify the icon of the item used in the inventory. There can be more than just one layer (e.g. for [[spawn egg]]s), but the amount of possible layers is hardcoded for each item. Works only in combination with <code>"builtin/generated"</code>.
+
*** {{nbt|string|layer''N''}}: Only used to specify the icon of the item used in the inventory. There can be more than just one layer (e.g. for [[spawn egg]]s), but the amount of possible layers is hardcoded for each item. Works only in combination with <code>"item/generated"</code>.
 
*** {{nbt|string|particle}}: What texture to load particles from. Used to determine the "crumb" particles generated by food items, as well as to determine the [[barrier]] particle (but it always uses <code>items/barrier.png</code> as blockbreaking particle), which otherwise uses "layer0".
 
*** {{nbt|string|particle}}: What texture to load particles from. Used to determine the "crumb" particles generated by food items, as well as to determine the [[barrier]] particle (but it always uses <code>items/barrier.png</code> as blockbreaking particle), which otherwise uses "layer0".
 
*** {{nbt|string|''Texture variable''}}: Defines a texture variable and assigns a texture.
 
*** {{nbt|string|''Texture variable''}}: Defines a texture variable and assigns a texture.
** {{nbt|string|gui_light}}: Can be <code>"front"</code> or <code>"side"</code>. If set to <code>"side"</code>, the model is rendered like a block. If set to <code>"front"</code>, model is shaded like a flat item.
+
** {{nbt|string|gui_light}}: Can be <code>"front"</code> or <code>"side"</code>. If set to <code>"side"</code>, the model is rendered like a block. If set to <code>"front"</code>, model is shaded like a flat item. Defaults to <code>"side"</code>.
 
** {{nbt|list|elements}}: Contains all the elements of the model. They can have only cubic forms. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
** {{nbt|list|elements}}: Contains all the elements of the model. They can have only cubic forms. If both <code>"parent"</code> and <code>"elements"</code> are set, the <code>"elements"</code> tag overrides the <code>"elements"</code> tag from the previous model.
 
*** {{nbt|compound}} An element.
 
*** {{nbt|compound}} An element.
**** {{nbt|list|from}}: Start point of a cube according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
+
**** {{nbt|list|from}}: Start point of a cuboid according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
**** {{nbt|list|to}}: Stop point of a cube according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
+
**** {{nbt|list|to}}: Stop point of a cuboid according to the scheme <code>[x, y, z]</code>. Values must be between -16 and 32.
 
**** {{nbt|compound|rotation}}: Defines the rotation of an element.
 
**** {{nbt|compound|rotation}}: Defines the rotation of an element.
 
***** {{nbt|list|origin}}: Sets the center of the rotation according to the scheme <code>[x, y, z]</code>.
 
***** {{nbt|list|origin}}: Sets the center of the rotation according to the scheme <code>[x, y, z]</code>.
Line 468: Line 468:
 
***** {{nbt|byte|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
 
***** {{nbt|byte|rescale}}: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
 
**** {{nbt|byte|shade}}: Defines if shadows are rendered (<code>true</code> - default), not (<code>false</code>).
 
**** {{nbt|byte|shade}}: Defines if shadows are rendered (<code>true</code> - default), not (<code>false</code>).
**** {{nbt|compound|faces}}: Holds all the faces of the cube. If a face is left out, it does not render.
+
**** {{nbt|compound|faces}}: Holds all the faces of the cuboid. If a face is left out, it does not render.
 
***** {{nbt|compound|''Face''}}: Named <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code> or <code>east</code>. Contains the properties of the specified face.
 
***** {{nbt|compound|''Face''}}: Named <code>down</code>, <code>up</code>, <code>north</code>, <code>south</code>, <code>west</code> or <code>east</code>. Contains the properties of the specified face.
 
****** {{nbt|list|uv:}} Defines the area of the texture to use according to the scheme <code>[x1, y1, x2, y2]</code>. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of <code>x1</code> and <code>x2</code> are swapped (e.g. from <code>0, 0, 16, 16</code> to <code>16, 0, 0, 16</code>), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
 
****** {{nbt|list|uv:}} Defines the area of the texture to use according to the scheme <code>[x1, y1, x2, y2]</code>. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of <code>x1</code> and <code>x2</code> are swapped (e.g. from <code>0, 0, 16, 16</code> to <code>16, 0, 0, 16</code>), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
Line 479: Line 479:
 
****{{nbt|compound|predicate}}: Holds the cases.
 
****{{nbt|compound|predicate}}: Holds the cases.
 
*****{{nbt|string|''Case''}} A single case tag. See [[#Item predicates|item predicates]] for a full list of available tags.
 
*****{{nbt|string|''Case''}} A single case tag. See [[#Item predicates|item predicates]] for a full list of available tags.
**** {{nbt|string|model}}: The path to the model to use if the case is met, in form of [[#File path|namespaced ID]].
+
**** {{nbt|string|model}}: The path to the model to use if the case is met, in form of a [[#File path|resource location]].
 
</div>
 
</div>
   
Line 588: Line 588:
   
 
In this model, the normal model is overridden if the fishing rod is cast, causing it to instead display the model <code>"item/fishing_rod_cast"</code>
 
In this model, the normal model is overridden if the fishing rod is cast, causing it to instead display the model <code>"item/fishing_rod_cast"</code>
  +
  +
== Objects which cannot be remodelled ==
  +
{{info needed section|Test invisible blocks (air, cave air, void air, barrier, structure void, light block), trident, bell}}
  +
While most blocks and items can have their model changed, there are a multitude of things that cannot:
  +
  +
* Fluids
  +
** including bubble columns
  +
* Entities
  +
** (excluding [[item frame]]s, [[glow item frame]]s, and [[shield]]s)
  +
* Blocks which render as entities
  +
** Chests
  +
*** Chest
  +
*** Trapped Chest
  +
*** Ender Chest
  +
** Signs
  +
*** All 16 versions (8 wood types, and floor/wall)
  +
** Beds
  +
*** All 16 colors
  +
** Shulker boxes
  +
*** All 16 colors
  +
** Heads
  +
*** All 12 versions (6 types, and floor/wall)
  +
** Banner
  +
*** All 32 versions (16 colors, and floor/wall)
  +
** Conduit
  +
** Book on enchanting table
  +
** End Portal
  +
** End Gateway
  +
** Moving Piston
  +
  +
Most blocks have particle textures defined in dedicated model files, however it still stands that actual visual models cannot be changed.
   
 
== History ==
 
== History ==
 
{{needs updating|Nearly everything after 1.9 is missing|section==}}
 
{{needs updating|Nearly everything after 1.9 is missing|section==}}
  +
{{History|java pre-classic}}
  +
{{History||?|Blocks exist, however their models are completely hardcoded, and as such cannot be configured outside of modding.}}
 
{{History|java}}
 
{{History|java}}
{{History||1.7.2|snap=13w36a|[[Flower]]s are now discentered like [[tall grass]].}}
 
 
{{History||1.8|snap=14w06a|Added custom [[block]] models.}}
 
{{History||1.8|snap=14w06a|Added custom [[block]] models.}}
 
{{History|||snap=14w07a|The model format has now been rewritten. Instead of having just "planes", it now has "planes" and "cubes".
 
{{History|||snap=14w07a|The model format has now been rewritten. Instead of having just "planes", it now has "planes" and "cubes".
Line 621: Line 653:
 
|"display" tag defaults have now been changed, and the <code>"thirdperson"</code> and <code>"firstperson"</code> tags have now been replaced with <code>"thirdperson_righthand"</code>, <code>"thirdperson_lefthand"</code>, <code>"firstperson_righthand"</code>, and <code>"firstperson_lefthand"</code>.
 
|"display" tag defaults have now been changed, and the <code>"thirdperson"</code> and <code>"firstperson"</code> tags have now been replaced with <code>"thirdperson_righthand"</code>, <code>"thirdperson_lefthand"</code>, <code>"firstperson_righthand"</code>, and <code>"firstperson_lefthand"</code>.
 
|"parent" and "elements" tags can now coexist, though the top level elements tag overwrites all former ones.
 
|"parent" and "elements" tags can now coexist, though the top level elements tag overwrites all former ones.
|The option to disable alternate [[block]] models has now been removed.}}
+
|The option to disable alternate [[block]] models has now been removed.
  +
|Multipart tag functionality added.}}
 
{{History||1.14|snap=18w43a|Added the item model property <code>"custom_model_data"</code>.}}
 
{{History||1.14|snap=18w43a|Added the item model property <code>"custom_model_data"</code>.}}
 
{{History||1.15|snap=19w39a|Lighting of blocks in the inventory has been swapped from being dark on the right to being dark on the left.}}
 
{{History||1.15|snap=19w39a|Lighting of blocks in the inventory has been swapped from being dark on the right to being dark on the left.}}
Line 631: Line 664:
 
[[de:Modelldaten]]
 
[[de:Modelldaten]]
 
[[fr:Modèles]]
 
[[fr:Modèles]]
 
[[ja:モデル]]
 
[[pl:Modele bloków]]
 
[[pl:Modele bloków]]
 
[[zh:模型]]
 
[[zh:模型]]
[[ja:モデル]]
 

Revision as of 12:46, 22 November 2021

Information icon
This feature is exclusive to Java Edition. 

Block models are used to depict all the blocks in the game, whereas item models are used to display the items in the players, hand, on their head (helmets and hats), on the ground, in the inventory, in item frames and on armor stands. As there are different variants of some blocks, block states are used to link these with the corresponding models. Each model and each block state has its own file, which is of the .json format. Even the icons used in the inventory are defined in these files.

File path

In JSON files of models and block states, the resource location in the form of namespace:path (the minecraft namespace can be omitted) is used to represent the local file path. See also Resource_location#Locating_contents_in_packs.

In these files, the path corresponding to the resource location namespace:path is assets/namespace/object_type/path.suffix, where the path can contain subfolders separated by /, such as namespace:foo/bar/baz (foo and bar are folders, baz is the real file name).

The object specified by a resource location and its corresponding object type and suffix are as follows:

Object object_type substitution suffix substitution
Block States blockstates json
Models models json
Textures textures png

Block states

There are several different variants of some blocks (like doors, which can be open or closed), hence each block has its own block state file, which lists all its existing variants and links them to their corresponding models. Blocks can also be compound of several different models at the same time, called "multipart". The models are then used depending on the block states of the block.

These files are stored in the following folder: assets/<namespace>/blockstates. The files are used directly based on their filename, thus a block state file with another name than the existing ones does not affect any block.

  • The root tag
    •  variants: Holds the names of all the variants of the block.
      • or A variant: Name of a variant, which consists of the relevant block states separated by commas. A block with just one variant uses "" as a name for its variant. Each variant can have one model or an array of models and contains their properties. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary -tags. Item frames are treated as blocks and use "map=false" for a map-less item frame, and "map=true" for item frames with maps.
        •  A model: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
          •  model: Specifies the path to the model file of the block, in form of a resource location.
          •  x: Rotation of the model on the x-axis in increments of 90 degrees.
          •  y: Rotation of the model on the y-axis in increments of 90 degrees.
          •  uvlock: Can be true or false (default). Locks the rotation of the texture of a block, if set to true. This way the texture does not rotate with the block when using the x and y-tags above.
          •  weight: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
        •  model: Specifies the path to the model file of the block, in form of a resource location.
        •  x: Rotation of the model on the x-axis in increments of 90 degrees.
        •  y: Rotation of the model on the y-axis in increments of 90 degrees.
        •  uvlock: Can be true or false (default). Locks the rotation of the texture of a block, if set to true. This way the texture does not rotate with the block when using the x and y-tags above.
    •  multipart: Used instead of variants to combine models based on block state attributes.
      •  A case Determines a case and the model that should apply in that case.
        •  when: A list of cases that have to be met for the model to be applied. If unset, the model always applies.
          •  OR: Matches if any of the contained cases return true. Cannot be set alongside other cases.
            •  A condition A list of cases that all have to match the block to return true.
              •  State Name of a block state. A single case that has to match one of the block states. It can be set to a list separated by | to allow multiple values to match.
          •  State Name of a block state. A single case that has to match one of the block states. It can be set to a list separated by | to allow multiple values to match. Cannot be set alongside the OR-tag.
        •  apply: Determines the model(s) to apply and its properties. There can be one model or an array of models. If set to an array, the model is chosen randomly from the options given, with each option being specified in separate subsidiary -tags.
          •  A model: Contains the properties of a model, if more than one model is used for the same variant. All specified models alternate in the game.
            •  model: Specifies the path to the model file of the block, in form of a resource location.
            •  x: Rotation of the model on the x-axis in increments of 90 degrees.
            •  y: Rotation of the model on the y-axis in increments of 90 degrees.
            •  uvlock: Can be true or false (default). Locks the rotation of the texture of a block, if set to true. This way the texture does not rotate with the block when using the x and y-tags above.
            •  weight: Sets the probability of the model for being used in the game, defaults to 1 (=100%). If more than one model is used for the same variant, the probability is calculated by dividing the individual model's weight by the sum of the weights of all models. (For example, if three models are used with weights 1, 1, and 2, then their combined weight would be 4 (1+1+2). The probability of each model being used would then be determined by dividing each weight by 4: 1/4, 1/4 and 2/4, or 25%, 25% and 50%, respectively.)
          •  model: Specifies the path to the model file of the block, in form of a resource location.
          •  x: Rotation of the model on the x-axis in increments of 90 degrees.
          •  y: Rotation of the model on the y-axis in increments of 90 degrees.
          •  uvlock: Can be true or false (default). Locks the rotation of the texture of a block, if set to true. This way the texture does not rotate with the block when using the x and y-tags above.
"uvlock": true "uvlock": false
Uvlock true Uvlock false

Example: Wall Torch

The wall torch has several variants: It can be placed at a wall facing in four different directions. This example is taken from the file wall_torch.json, which can be found at assets/minecraft/blockstates.

wall_torch.json
{
    "variants": {
        "facing=east": { "model": "block/wall_torch" },
        "facing=south": { "model": "block/wall_torch", "y": 90 },
        "facing=west": { "model": "block/wall_torch", "y": 180 },
        "facing=north": { "model": "block/wall_torch", "y": 270 }
    }
}

A torch can be placed on all four sides of a block and therefore needs four different variants, one for each side. These are called "facing=east", "facing=west", "facing=south" and "facing=north". All four variants use "block/wall_torch" as their model, which is rotated by a multiple of 90 degrees around the "y" axis to align with the different sides of the block they are placed on.

Example: Grass Block

The grass block has two variants, whereby the first one holds four different models. This example is taken from the file grass_block.json, which can be found at assets/minecraft/blockstates.

grass_block.json
{
    "variants": {
        "snowy=false": [
            { "model": "block/grass_block" },
            { "model": "block/grass_block", "y": 90 },
            { "model": "block/grass_block", "y": 180 },
            { "model": "block/grass_block", "y": 270 }
        ],
        "snowy=true":  { "model": "block/grass_block_snow" }
    }
}

The non-snow-covered grass block ("snowy=false") holds four models, which all use the same block model, but each one is rotated by a multiple of 90 degrees. As there are four models and the weight-tag is not used for any of them, each one has a chance of 25% to be used every time a block is placed.

Example: Oak Fence

The oak fence uses the multipart format. This example is taken from oak_fence.json in assets/minecraft/blockstates.

oak_fence.json
{
    "multipart": [
        {   "apply": { "model": "block/oak_fence_post" }},
        {   "when": { "north": "true" },
            "apply": { "model": "block/oak_fence_side", "uvlock": true }
        },
        {   "when": { "east": "true" },
            "apply": { "model": "block/oak_fence_side", "y": 90, "uvlock": true }
        },
        {   "when": { "south": "true" },
            "apply": { "model": "block/oak_fence_side", "y": 180, "uvlock": true }
        },
        {   "when": { "west": "true" },
            "apply": { "model": "block/oak_fence_side", "y": 270, "uvlock": true }
        }
    ]
}

While the first model, the fence post, is always used, the other models are used only if certain conditions are met. Here the sides of the fence are applied only if there is another adjacent block next to this one. As there is just one model for the post and another one for all the sides of the fence, which then is rotated by increments of 90 degrees, the amount of models needed for all the different possible set-ups of fences can be reduced to two. Compared to the five models and 16 variants used in Java Edition 1.8, this is a rather big improvement. This tool helps to edit JSON data JSON Parser and you can also use Json validator.

Example: Redstone Wire

The redstone wire model uses the multipart format. This example is taken from redstone_wire.json in assets/minecraft/blockstates

redstone_wire.json
{
    "multipart": [
        {   "when": { "OR": [
                {"north": "none", "east": "none", "south": "none", "west": "none"},
                {"north": "side|up", "east": "side|up" },
                {"east": "side|up", "south": "side|up" },
                {"south": "side|up", "west": "side|up"},
                {"west": "side|up", "north": "side|up"}
            ]},
            "apply": { "model": "block/redstone_dust_dot" }
        },
        {   "when": { "OR": [
                { "north": "side|up" },
                { "north": "none", "east": "none", "south": "side|up", "west": "none" }
            ]},
            "apply": { "model": "block/redstone_dust_side0" }
        },
        {   "when": { "OR": [
                { "south": "side|up" },
                { "north": "side|up", "east": "none", "south": "none", "west": "none" }
            ]},
            "apply": { "model": "block/redstone_dust_side_alt0" }
        },
        {   "when": { "OR": [
                { "east": "side|up" },
                { "north": "none", "east": "none", "south": "none", "west": "side|up" }
            ]},
            "apply": { "model": "block/redstone_dust_side_alt1", "y": 270 }
        },
        {   "when": { "OR": [
                { "west": "side|up" },
                { "north": "none", "east": "side|up", "south": "none", "west": "none" }
            ]},
            "apply": { "model": "block/redstone_dust_side1", "y": 270 }
        },
        {   "when": { "north": "up" },
            "apply": { "model": "block/redstone_dust_up" }
        },
        {   "when": { "east": "up" },
            "apply": { "model": "block/redstone_dust_up", "y": 90 }
        },
        {   "when": { "south": "up" },
            "apply": { "model": "block/redstone_dust_up", "y": 180 }
        },
        {   "when": { "west": "up" },
            "apply": { "model": "block/redstone_dust_up", "y": 270 }
        }
    ]
}

This model is dynamically created. With the first condition, it is determining cases where the redstone_dust_dot model should be added, which requires either all of the four sides being set to "none", or any two sides that form a corner both being set either to up or side.

The last case tests only one condition, which asks if "west" is set to "up", and if so it applies the model redstone_dust_up.

Block models

The folder assets/<namespace>/models/block holds the model files for all the specified variants. The names of the files can be changed, but must always correspond with the names used in the variant files.

  • The root tag
    •  parent: Loads a different model from the given path, in form of a resource location. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
      • Can be set to "builtin/generated" to use a model that is created out of the specified icon. Note that only the first layer is supported, and rotation can be achieved only by using block states files.
    •  ambientocclusion: Whether to use ambient occlusion (true - default), or not (false).
    •  display: Holds the different places where item models are displayed.
      •  Position: Named thirdperson_righthand, thirdperson_lefthand, firstperson_righthand, firstperson_lefthand, gui, head, ground, or fixed. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. fixed refers to item frames, while the rest are as their name states. Note that translations are applied to the model before rotations.
        •  rotation: Specifies the rotation of the model according to the scheme [x, y, z].
        •  translation: Specifies the position of the model according to the scheme [x, y, z]. The values are clamped between -80 and 80.
        •  scale: Specifies the scale of the model according to the scheme [x, y, z]. If the value is greater than 4, it is displayed as 4.
    •  textures: Holds the textures of the model, in form of a resource location or can be another texture variable.
    •  elements: Contains all the elements of the model. They can have only cubic forms. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
      • An element.
        •  from: Start point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  to: Stop point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  rotation: Defines the rotation of an element.
          •  origin: Sets the center of the rotation according to the scheme [x, y, z].
          •  axis: Specifies the direction of rotation, can be "x", "y" or "z".
          •  angle: Specifies the angle of rotation. Can be 45 through -45 degrees in 22.5 degree increments.
          •  rescale: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
        •  shade: Defines if shadows are rendered (true - default), not (false).
        •  faces: Holds all the faces of the cuboid. If a face is left out, it does not render.
          •  Face: Named down, up, north, south, west or east. Contains the properties of the specified face.
            •  uv: Defines the area of the texture to use according to the scheme [x1, y1, x2, y2]. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of x1 and x2 are swapped (e.g. from 0, 0, 16, 16 to 16, 0, 0, 16), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
            •  texture: Specifies the texture in form of the texture variable prepended with a #.
            •  cullface: Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: down, up, north, south, west, or east. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side. bottom may also be used in the latest versions instead of down, despite appearing only once in the actual game assets.
            •  rotation: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though uv).
            •  tintindex: Determines whether to tint the texture using a hardcoded tint index. The default value, -1, indicates not to use the tint. Any other number is provided to BlockColors to get the tint value corresponding to that index. However, most blocks do not have a tint value defined (in which case white is used). Furthermore, no vanilla block currently uses multiple tint values, and thus the tint index value is ignored (as long as it is set to something other than -1); it could be used for modded blocks that need multiple distinct tint values in the same block though.


Example: Standing Torch

For simplicity, this example describes only the standing torch, which is defined in the files torch.json and template_torch.json stored in the folder assets/minecraft/models/block.

template_torch.json
{
   "ambientocclusion": false,
   "textures": {
       "particle": "#torch"
   },
   "elements": [
       {   "from": [ 7, 0, 7 ],
           "to": [ 9, 10, 9 ],
           "shade": false,
           "faces": {
               "down": { "uv": [ 7, 13, 9, 15 ], "texture": "#torch" },
               "up":   { "uv": [ 7,  6, 9,  8 ], "texture": "#torch" }
           }
       },
       {   "from": [ 7, 0, 0 ],
           "to": [ 9, 16, 16 ],
           "shade": false,
           "faces": {
               "west": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" },
               "east": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" }
           }
       },
       {   "from": [ 0, 0, 7 ],
           "to": [ 16, 16, 9 ],
           "shade": false,
           "faces": {
               "north": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" },
               "south": { "uv": [ 0, 0, 16, 16 ], "texture": "#torch" }
           }
       }
   ]
}

This file is used to create the model of the torch, which is used for the normal, redstone torch and the soul fire torch. Therefore, the "elements" tag is used to create three elements or cuboids. Only two faces of each cuboid are rendered, as only two faces of each one have been specified. "uv" is used to determine the area where the texture is used. The texture variable "#torch" is used for the particles and the cuboids and has not yet been defined.

torch.json
{
   "parent": "block/template_torch",
   "textures": {
       "torch": "block/torch"
   }
}

This file represents the model of the normal standing torch. It loads the model of previously defined standing torch with the help of "parent" and inherits all the properties of the file template_torch.json. As this file is used only for the normal torch, the texture can now be specified. The texture"torch" is now assigned to the texture variable "torch" (in form of a resource location) and therefore is used for the previously loaded model and its particles, as specified in the other file.

Example: Any Block

This example describes the fundamental structure of most normal blocks in Minecraft. All these blocks use the same basic model and apply their texture to it, as already described in the example above. This model is defined in the file cube.json, which can be found in the folder assets/minecraft/models/block.

cube.json
{
  "elements": [
    {
      "from": [ 0, 0, 0 ],
      "to": [ 16, 16, 16 ],
      "faces": {
        "down":  { "texture": "#down", "cullface": "down" },
        "up":    { "texture": "#up", "cullface": "up" },
        "north": { "texture": "#north", "cullface": "north" },
        "south": { "texture": "#south", "cullface": "south" },
        "west":  { "texture": "#west", "cullface": "west" },
        "east":  { "texture": "#east", "cullface": "east" }
      }
    }
  ]
}

Features that have already been described above are not discussed further. The use of "cullface": "down" prevents the bottom face of the block from being rendered, if there is another adjacent block underneath it. The same applies to all the other faces of the block.

Example: Sapling

This example describes the fundamental structure used by all saplings, without assigning a specific texture. The model is specified in cross.json, the texture would e.g. be assigned in oak_sapling.json. Both files are stored in the folder assets/minecraft/models/block.

cross.json
{
  "ambientocclusion": false,
  "textures": {
    "particle": "#cross"
  },
  "elements": [
    {
      "from": [ 0.8, 0, 8 ],
      "to": [ 15.2, 16, 8 ],
      "rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },
      "shade": false,
      "faces": {
        "north": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" },
        "south": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" }
      }
    },
    {
      "from": [ 8, 0, 0.8 ],
      "to": [ 8, 16, 15.2 ],
      "rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },
      "shade": false,
      "faces": {
        "west": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" },
        "east": { "uv": [ 0, 0, 16, 16 ], "texture": "#cross" }
      }
    }
  ]
}

To create the usual shape of the saplings, both elements are being rotated by 45 degrees. Therefore, the origin and the axis of rotation are set to the specified values, the angle is set to 45 degrees and "rescale" is set to true. The latter causes the model to be scaled on the axes it has not been rotated on, so that it takes up the same space as it did before rotating it (see comparison images).

"rescale": true "rescale": false
Block model rescale true Block model rescale false

Examples: Condensing multiple textures into one file

Using the "uv" compound, textures can be read from one file and parts of the file can be used for each side of the block. "uv" doesn't take the pixels of the file, it instead takes percentages of the file in terms of 16; for example taking the top half of a file uses "uv": [0,0, 16,8]: from the coordinates ([0% of 16], [0% of 16]) – (0,0) – which is the top-left pixel, and ends at ([100% of 16], [50% of 16]) – (16,8), which is the middle-right pixel. Because this works in percentages, resizing an image from 16×16 to 32×32, 64×64, etc., does not require changing the model file.

Fletching Table textures

In this example, a fletching table is used (see image) with combined textures (in this example, saved as fletching_table.png): the top 16×16 pixels (if each of the textures are 32×32, etc., then the top 32×32, etc., textures are taken using the same code) textures the top of the block, the center 16×16 textures the front and back, and the bottom 16×16 textures the other sides. The bottom texture is birch_planks. For three textures, this code can be used:

{
    "parent": "block/cube",
    "textures": {
        "particle": "block/fletching_table",
        "all": "block/fletching_table",
        "bottom": "block/birch_planks"
    },
    "elements": [
        {
           "from": [ 0, 0, 0 ],
            "to": [ 16, 16, 16 ],
            "faces": {
                "down":  { "texture": "#bottom", "cullface": "down" },
                "up":    { "uv": [0,0, 16,5.34], "texture": "#all", "cullface": "up" },
                "north": { "uv": [0,5.35, 16,10.66], "texture": "#all", "cullface": "north" },
                "south": { "uv": [0,5.35, 16,10.66], "texture": "#all", "cullface": "south" },
                "west":  { "uv": [0,10.67, 16,16], "texture": "#all", "cullface": "west" },
                "east":  { "uv": [0,10.67, 16,16], "texture": "#all", "cullface": "east" }
            }
        }
    ]
}
Bone Block textures

In this example, only two textures are condensed into one file, in this case for a bone block. For two textures, this code can be used:

{
    "parent": "block/cube",
    "textures": {
        "particle": "block/bone_block",
        "all": "block/bone_block"
    },
    "elements": [
        {
           "from": [ 0, 0, 0 ],
            "to": [ 16, 16, 16 ],
            "faces": {
                "down":  { "uv": [0,0, 16,8], "texture": "#all", "cullface": "down" },
                "up":    { "uv": [0,0, 16,8], "texture": "#all", "cullface": "up" },
                "north": { "uv": [0,8, 16,16], "texture": "#all", "cullface": "north" },
                "south": { "uv": [0,8, 16,16], "texture": "#all", "cullface": "south" },
                "west":  { "uv": [0,8, 16,16], "texture": "#all", "cullface": "west" },
                "east":  { "uv": [0,8, 16,16], "texture": "#all", "cullface": "east" }
            }
        }
    ]
}
Barrel textures

In this example, four textures are condensed into one file, in this case for a barrel. For four textures, this code can be used:

{
    "parent": "block/cube",
    "textures": {
        "particle": "block/barrel",
        "all": "block/barrel"
    },
    "elements": [
        {
           "from": [ 0, 0, 0 ],
            "to": [ 16, 16, 16 ],
            "faces": {
                "down":  { "uv": [8,8, 16,16], "texture": "#all", "cullface": "down" },
                "up":    { "uv": [8,0, 16,8], "texture": "#all", "cullface": "up" },
                "north": { "uv": [0,8, 8,16], "texture": "#all", "cullface": "north" },
                "south": { "uv": [0,8, 8,16], "texture": "#all", "cullface": "south" },
                "west":  { "uv": [0,8, 8,16], "texture": "#all", "cullface": "west" },
                "east":  { "uv": [0,8, 8,16], "texture": "#all", "cullface": "east" }
            }
        }
    ]
}

Item models

As items do not have different variants, there is no need to specify them. The folder assets/<namespace>/models/item contains all the model files. The names of the files are hardcoded and should not be changed.

  • : The root tag
    •  parent: Loads a different model from the given path, in form of a resource location. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
      • Can be set to "item/generated" to use a model that is created out of the specified icon.
      • Can be set to "builtin/entity" to load a model from an entity file. As you cannot specify the entity, this does not work for all items (only for chests, ender chests, mob heads, shields, banners and tridents).
    •  display: Holds the different places where item models are displayed.
      •  Position: Named thirdperson_righthand, thirdperson_lefthand, firstperson_righthand, firstperson_lefthand, gui, head, ground, or fixed. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. fixed refers to item frames, while the rest are as their name states. Note that translations are applied to the model before rotations.
        •  rotation: Specifies the rotation of the model according to the scheme [x, y, z].
        •  translation: Specifies the position of the model according to the scheme [x, y, z]. If the value is greater than 80, it is displayed as 80. If the value is less than -80, it is displayed as -80.
        •  scale: Specifies the scale of the model according to the scheme [x, y, z]. If the value is greater than 4, it is displayed as 4.
    •  textures: Holds the textures of the model, in form of a resource location or can be another texture variable.
      •  layerN: Only used to specify the icon of the item used in the inventory. There can be more than just one layer (e.g. for spawn eggs), but the amount of possible layers is hardcoded for each item. Works only in combination with "item/generated".
      •  particle: What texture to load particles from. Used to determine the "crumb" particles generated by food items, as well as to determine the barrier particle (but it always uses items/barrier.png as blockbreaking particle), which otherwise uses "layer0".
      •  Texture variable: Defines a texture variable and assigns a texture.
    •  gui_light: Can be "front" or "side". If set to "side", the model is rendered like a block. If set to "front", model is shaded like a flat item. Defaults to "side".
    •  elements: Contains all the elements of the model. They can have only cubic forms. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
      • An element.
        •  from: Start point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  to: Stop point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  rotation: Defines the rotation of an element.
          •  origin: Sets the center of the rotation according to the scheme [x, y, z].
          •  axis: Specifies the direction of rotation, can be "x", "y" or "z".
          •  angle: Specifies the angle of rotation. Can be 45 through -45 degrees in 22.5 degree increments.
          •  rescale: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
        •  shade: Defines if shadows are rendered (true - default), not (false).
        •  faces: Holds all the faces of the cuboid. If a face is left out, it does not render.
          •  Face: Named down, up, north, south, west or east. Contains the properties of the specified face.
            •  uv: Defines the area of the texture to use according to the scheme [x1, y1, x2, y2]. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of x1 and x2 are swapped (e.g. from 0, 0, 16, 16 to 16, 0, 0, 16), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
            •  texture: Specifies the texture in form of the texture variable prepended with a #.
            •  cullface: Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: down, up, north, south, west, or east. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side.
            •  rotation: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though uv).
            •  tintindex: Determines whether to tint the texture using a hardcoded tint index. The default is not using the tint, and any number causes it to use tint. Note that only certain blocks have a tint index; all others remain unaffected.
    •  overrides: Determines cases in which a different model should be used based on item tags. All cases are evaluated in order from top to bottom and last predicate that matches overrides. However, overrides are ignored if it has been already overridden once, for example this avoids recursion on overriding to the same model.
      • A case.
        •  predicate: Holds the cases.
          •  Case A single case tag. See item predicates for a full list of available tags.
        •  model: The path to the model to use if the case is met, in form of a resource location.

Simple example: 2D beds

This example replaces the bed item render with the textures currently found in Bedrock Edition and formerly found in Java Edition, such as Red Bed 2D. This file should be placed in the assets/minecraft/models/item folder with the name "red_bed.json":

{
    "parent": "item/generated",
    "textures": {
        "layer0": "item/red_bed"
    }
}

In this example, the parent is set to item/generated, which means that this item model is a flat texture. In the textures tag, layer0 is set to the texture set for this item; in this case, the texture is called red_bed and is found in the assets/minecraft/textures/item folder. The "red" can be changed out for all other colors of bed, but each must be put in a separate JSON file (e.g., black_bed.json, green_bed.json, etc.). There must be item texture files (which is what layer0 is requesting) for beds found in the textures/item folder; these textures can be found below:

Rename the above files to <color>_bed (keep the file extension .png) and place them inside the assets/minecraft/textures/item folder. Make sure to match the layer0 reference to the name of the item texture.

Item predicates

Some items support additional predicates for model overrides. Below is a full list of available predicates.

  • "angle": Used on compasses to determine the current angle, expressed in a decimal value of less than one.
  • "blocking": Used on shields to determine if currently blocking. If 1, the player is blocking.
  • "broken": Used on Elytra to determine if broken. If 1, the Elytra is broken.
  • "cast": Used on fishing rods to determine if the fishing rod has been cast. If 1, the fishing rod has been cast.
  • "cooldown": Used on ender pearls and chorus fruit to determine the remaining cooldown, expressed in a decimal value between 0 and 1.
  • "damage": Used on items with durability to determine the amount of damage, expressed in a decimal value between 0 and 1.
  • "damaged": Used on items with durability to determine if it is damaged. If 1, the item is damaged. Note that if an item has the unbreakable tag, this may be 0 while the item has a non-zero "damage" tag.
  • "lefthanded": Determines the model used by left handed players. It affects the item they see in inventories, along with the item players see them holding or wearing.
  • "pull": Determines the amount a bow or crossbow has been pulled, expressed in a decimal value of less than one.
  • "pulling": Used on bows and crossbows to determine if the bow is being pulled. If 1, the bow is currently being pulled.
  • "charged": Used on crossbows to determine if they are charged with any projectile. If 1, the crossbow is charged.
  • "firework": Used on crossbows. If 1, the crossbow is charged with a firework rocket.
  • "throwing": Used on the trident to determine if the trident is ready to be thrown by the player. If 1, the trident is ready for fire.
  • "time": Used on clocks to determine the current time, expressed in a decimal value of less than one.
  • "custom_model_data": Used on any item and is compared to the tag.CustomModelData NBT, expressed in an integer value. The number is still internally converted to float, causing a precision loss for some numbers above 16 million. If the value read from the item data is greater than or equal to the value used for the predicate, the predicate is positive.

Example: Torch

This example describes the torch as an item. The model can be found in the torch.json, which is stored in the folder assets/minecraft/models/item.

torch.json
{
  "parent": "item/generated",
  "textures": {
    "layer0": "block/torch"
  },
  "display": {
    "thirdperson_righthand": {
      "rotation": [ -90, 0, 0 ],
      "translation": [ 0, 1, -3 ],
      "scale": [ 0.55, 0.55, 0.55 ]
    },
    "firstperson_lefthand": {
      "rotation": [ 0, -135, 25 ],
      "translation": [ 0, 4, 2 ],
      "scale": [ 1.7, 1.7, 1.7 ],
      "scale": [ 0.9, 0.9, 0.9 ]
    }
  }
}

The "parent"-tag uses "builtin/generated", so that the game uses the standard model of the torch, which has been generated out of the 2D graphic used for the item icon. The icon is specified with the "layer0"-tag and the texture, that has already been used for the block model, is used for the icon as well. As there is just one layer hard coded for the torch, there cannot be any more layers added. Furthermore, the display properties for the torch are specified, so that it displays correctly in every possible situation. The torch cannot be placed on a players head and uses the specified icon in the inventory, so there is no need to adjust the model for these situations. To line the model up with the players left or right hand in first and third person view, the model needs to be rotated, moved and scaled, which is done for each of the two situation separately.

Example: Fishing Rod

This example describes the fishing rod as of Java Edition 1.9. The model can be found in the fishing_rod.json, which is stored in the folder assets/minecraft/models/item.

fishing_rod.json
{
  "parent": "item/handheld_rod",
  "textures": {
    "layer0": "item/fishing_rod_uncast"
  },
  "overrides": [
    {
      "predicate": {
        "cast": 1
      },
      "model": "item/fishing_rod_cast"
    }
  ]
}

In this model, the normal model is overridden if the fishing rod is cast, causing it to instead display the model "item/fishing_rod_cast"

Objects which cannot be remodelled

This section is missing information about Test invisible blocks (air, cave air, void air, barrier, structure void, light block), trident, bell. 
Please expand the section to include this information. Further details may exist on the talk page.

While most blocks and items can have their model changed, there are a multitude of things that cannot:

  • Fluids
    • including bubble columns
  • Entities
  • Blocks which render as entities
    • Chests
      • Chest
      • Trapped Chest
      • Ender Chest
    • Signs
      • All 16 versions (8 wood types, and floor/wall)
    • Beds
      • All 16 colors
    • Shulker boxes
      • All 16 colors
    • Heads
      • All 12 versions (6 types, and floor/wall)
    • Banner
      • All 32 versions (16 colors, and floor/wall)
    • Conduit
    • Book on enchanting table
    • End Portal
    • End Gateway
    • Moving Piston

Most blocks have particle textures defined in dedicated model files, however it still stands that actual visual models cannot be changed.

History

Clock JE3
This section needs to be updated. 
Please update this section to reflect recent updates or newly available information.
Reason: Nearly everything after 1.9 is missing
Java Edition pre-Classic
?Blocks exist, however their models are completely hardcoded, and as such cannot be configured outside of modding.
Java Edition
1.8
{{Extension DPL}}<ul><li>[[Painting|Painting]]<br/>{{ItemEntity
|title=Painting
|image=Painting JE2 BE2.png
|extratext=View [[#Renders|all renders]]
|renewable=Yes
|stackable=Yes (64)
|drops=1 {{ItemLink|Painting}}
}}
'''Paintings''' are decorative [[entity|entities]] that hang on walls.

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

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

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

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

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

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

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

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

Paintings are non-flammable.

== Canvases ==
{{Stub|Needing the new painting renders}}
There are 31 paintings in the game. These are mostly based on paintings by [[Kristoffer Zetterstrand]], who also created the ''Minecraft'' versions.

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

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

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

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



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

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

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

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

=== Entity data ===

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

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

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

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

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


}

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

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

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

== Issues ==
{{issue list}}

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

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

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

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

== References ==
{{reflist}}

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

{{items}}
{{entities}}

[[cs:Obraz]]
[[de:Gemälde]]
[[es:Cuadro]]
[[fr:Tableau]]
[[hu:Festmény]]
[[it:Quadro]]
[[ja:絵画]]
[[ko:그림]]
[[nl:Schilderij]]
[[pl:Obraz]]
[[pt:Quadro]]
[[ru:Картина]]
[[th:ภาพวาด]]
[[uk:Картина]]
[[zh:画]]</li><li>[[Axe|Axe]]<br/>{{For}}
{{Item
| image = <gallery>
Wooden Axe.png | Wooden
Stone Axe.png | Stone
Iron Axe.png | Iron
Golden Axe.png | Golden
Diamond Axe.png | Diamond
Netherite Axe.png | Netherite
</gallery>
| rarity = Common
| renewable = 
* '''Netherite''': No 
* '''Others''': Yes
| durability = 
'''Bedrock Edition'''
* Golden: 33
* Wooden: 60 
* Stone: 132
* Iron: 251
* Diamond: 1562
* Netherite: 2032
'''Java Edition'''
* Golden: 32
* Wooden: 59
* Stone: 131
* Iron: 250
* Diamond: 1561
* Netherite: 2031
| stackable = No
}}

An '''axe''' is a [[tool]] used to hasten the [[breaking]] of [[wood]]-based or other tough organic [[block]]s, strip or scrape certain blocks, or as a melee [[weapon]] that can disable [[Shield|shields]] it hits.

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

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

===Repairing===

====Grinding====
{{Grinding
|showdescription=1
|ingredients= 2× Damaged [[Wooden Axe]] or 2× Damaged [[Stone Axe]] or 2× Damaged [[Iron Axe]] or 2× Damaged [[Golden Axe]] or 2× Damaged [[Diamond Axe]] or 2× Damaged [[Netherite Axe]]
|Damaged Wooden Axe; Damaged Stone Axe; Damaged Iron Axe; Damaged Golden Axe; Damaged Diamond Axe; Damaged Netherite Axe
|Damaged Wooden Axe; Damaged Stone Axe; Damaged Iron Axe; Damaged Golden Axe; Damaged Diamond Axe; Damaged Netherite Axe
|Wooden Axe; Stone Axe; Iron Axe; Golden Axe; Diamond Axe; Netherite Axe
|description=The durability of the two axes is added together, plus an extra 5% of max durability.
}}

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

===Mob loot===

==== Equipment ====
{{Main|Drops#Equipped items}}

A [[vindicator]] spawns with an iron axe and has an 8.5% chance (9.5% with Looting I, 10.5% with Looting II, and 11.5% with Looting III) of dropping it upon death by the player. It is usually heavily damaged and is sometimes enchanted.

A [[piglin brute]] spawns with a golden axe and has an 8.5% chance (9.5% with Looting I, 10.5% with Looting II, and 11.5% with Looting III) of dropping it upon death by the player. Also, {{in|java}}, [[Zombified Piglin|zombified piglins]] can drop their golden axe (with the same chance as piglin brute drop) if they have been zombified from a [[Piglin Brute|piglin brute.]]

====Raids====
{{IN|be}}, [[Vindicator]] and [[pillager]]s that spawn in raids have a 4.1% chance (5.12% on hard) to drop a badly-damaged iron axe, which is sometimes enchanted with a random enchantment. A vindicator can drop 2 iron axes, one from natural equipment and one from raid drops.

===Trading===
Novice-level [[Trading#Toolsmith|Toolsmith]] [[villager]]s have a 25% chance to sell a stone axe for one [[emerald]], journeyman-level Toolsmith villagers have a 25% chance to sell an enchanted iron axe for eight emeralds, and expert-level Toolsmith villagers have a 50% chance to sell an enchanted diamond axe for 13 emeralds.{{only|bedrock}}

Novice-level [[Trading#Toolsmith 2|Toolsmith]] villagers have a 40% chance to sell a stone axe for one emerald, journeyman-level Toolsmith villagers have a 40% chance to sell an enchanted iron axe for 7-22 emeralds, and expert-level Toolsmith villagers have a 66.67% chance to sell an enchanted diamond axe for 18-35 emeralds.{{only|java}}

Novice-level [[Trading#Weaponsmith|Weaponsmith]] [[villager]]s sell an iron axe for 3 emeralds as one of their trades, and master-level Weaponsmith villagers sell an enchanted diamond axe for 12 emeralds.{{only|bedrock}}

Novice-level [[Trading#Weaponsmith 2|Weaponsmith]] villagers have a 66.67% chance to sell an iron axe for 3 emeralds. Master-level Weaponsmith villagers always offer to sell an enchanted diamond axe for 18-35 emeralds.{{only|java}}

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

=== Villager gifts ===
[[Trading#Toolsmith 2|Toolsmith]] [[villagers]] occasionally throw stone axes at players with the [[Hero of the Village]] status effect.{{only|java}}

[[Trading#Weaponsmith 2|Weaponsmith]] [[villagers]] occasionally throw either stone, gold, or iron axes at players with the [[Hero of the Village]] status effect.{{only|java}}

===Structure loot===
{{IN|JE}}, a sealed room in [[woodland mansion]]s can appear that has a chest always containing an [[Efficiency]] I iron axe.
{{LootChestItem|wooden-axe,stone-axe,random-enchanted-golden-axe,damaged-random-enchanted-netherite-axe,iron-axe}}

==Usage==

===Chopping===
An axe is used to break [[logs]], blocks derived from wood and some other blocks faster than by using other tools. An axe uses 1 durability to break 1 block. For blocks that break instantly, it uses 0 durability.

====Durability====
Each tier of axe has a different durability:
{| class="wikitable sortable"
! Material
! [[Durability]]
|-
| {{itemLink|Wooden Axe|Wood|link=Axe}}
| 59
|-
| {{itemLink|Stone Axe|Stone|link=Axe}}
| 131
|-
| {{itemLink|Iron Axe|Iron|link=Axe}}
| 250
|-
| {{itemLink|Diamond Axe|Diamond|link=Axe}}
| 1561
|-
| {{itemLink|Golden Axe|Golden|link=Axe}}
| 32
|-
| {{itemLink|Netherite Axe|Netherite|link=Axe}}
| 2031
|}

====Speed====
The following table summarizes the speed at which axes of different qualities perform.
{{breaking row|Wooden Trapdoors|link=Trapdoor|sort=1|simple=1}}
{{breaking row|Wooden Doors|item=1|link=Door|sprite=oak-door}}
{{breaking row|Barrel}}
{{breaking row|Cartography Table}}
{{breaking row|Chest}}
{{breaking row|Trapped Chest}}
{{breaking row|Crafting Table}}
{{breaking row|Fletching Table}}
{{breaking row|Lectern}}
{{breaking row|Loom}}
{{breaking row|Smithing Table}}
{{breaking row|Bamboo Mosaic}}
{{breaking row|Block of Bamboo}}
{{breaking row|Campfire}}
{{breaking row|Fences}}
{{breaking row|Fence Gates}}
{{breaking row|Jukebox}}
{{breaking row|Logs}}
{{breaking row|Planks}}
{{breaking row|Wooden Slabs|link=Slabs|sprite=all-wooden-slabs}}
{{breaking row|Wooden Stairs|link=Stairs|sprite=all-wooden-stairs}}
{{breaking row|Bookshelf}}
{{breaking row|Chiseled Bookshelf}}
{{breaking row|Banners}}
{{breaking row|Jack o'Lantern}}
{{breaking row|Melon}}
{{breaking row|Pumpkin}}
{{breaking row|Sign|sprite=oak-sign}}
{{breaking row|Hanging Sign|sprite=hanging-oak-sign}}
{{breaking row|Note Block}}
{{breaking row|Mangrove Roots}}
{{breaking row|Wooden Pressure Plate|sprite=oak-pressure-plate}}
{{breaking row|Beehive}}
{{breaking row|Ladder}}
{{breaking row|Bee Nest|drop=0}}
{{breaking row|Composter}}
{{breaking row|Bamboo}}
{{breaking row|sprite=red-bed|Bed}}
{{breaking row|Cocoa}}
{{breaking row|Daylight Detector}}
{{breaking row|Mushroom Block|sprite=mushroom-blocks}}
{{breaking row|Vines|drop=0|foot=1}}

=== Stripping ===
{{control|Using}} an axe on a [[log]], [[wood]] block, [[block of bamboo]]\, or [[block of copper]] causes it to become a [[stripped log]], [[stripped wood]] block, [[block of stripped bamboo]], or removes one layer of oxidization or wax, respectively. This consumes one point of durability from the axe.

===Weapon===
An axe loses 2 points of durability when used as a weapon. 

==== Bedrock Edition ====
{{IN|bedrock}}, axes always attack instantly and deal {{hp|1}} less damage than a [[sword]] of the same quality but it lowers the durability of armor and shields faster than any other tool in-game.
{| class="wikitable" style="text-align:center" data-description="Bedrock damage"
! Material !! Damage
|-
| {{ItemSprite|Wooden Axe}} Wooden || rowspan="2" |{{hp|4}}
|-
| {{ItemSprite|Golden Axe}} Golden
|-
| {{ItemSprite|Stone Axe}} Stone ||{{hp|5}}
|-
| {{ItemSprite|Iron Axe}} Iron ||{{hp|6}}
|-
| {{ItemSprite|Diamond Axe}} Diamond ||{{hp|7}}
|-
| {{ItemSprite|Netherite Axe}} Netherite ||{{hp|8}}
|}

====Java Edition====

Attacking a [[shield]] user with an axe should have a chance to disable the use of the shield for 5 seconds, but currently this always disables a shield.<ref>{{bug|MC-197537}}</ref> The base chance is 25%, plus 5 percentage points per level of [[Efficiency]] on the axe, plus 75 percentage points if attacking while sprinting. [[Vindicator]]s, [[piglin brute]]s, or other [[mob]]s with commands always disable the player's shield. Damage done when using an axe as a weapon is more than that of a [[sword]] of the same tier, though they take longer than a sword to [[Damage#Attack cooldown|recover]], resulting in lower <abbr title="Damage/Second">DPS</abbr> (with the exception of [[gold]]en axes). The damage dealt and cooldown time depends on the type:

{| class="wikitable" style="text-align:center" data-description="Attack damage"
! Material
! {{ItemSprite|Wooden Axe|text=Wooden}}
! {{ItemSprite|Golden Axe|text=Gold}}
! {{ItemSprite|Stone Axe|text=Stone}}
! {{ItemSprite|Iron Axe|text=Iron}}
! {{ItemSprite|Diamond Axe|text=Diamond}}
! {{ItemSprite|Netherite Axe|text=Netherite}}
|-
! Attack Damage
| {{hp|7}}
| {{hp|7}}
| {{hp|9}}
| {{hp|9}}
| {{hp|9}}
| {{hp|10}}
|-
! Attack Speed
| 0.8
| 1.0
| 0.8
| 0.9
| 1.0
| 1.0
|-
! Recovery time
| {{convert|1.25|sec|tick|sep=}}
| {{convert|1|sec|tick|sep=}}
| {{convert|1.25|sec|tick|sep=}}
| {{convert|1.11|sec|tick|sep=}}
| {{convert|1|sec|tick|sep=}}
| {{convert|1|sec|tick|sep=}}
|-
! <abbr title="Damage/Second">DPS</abbr>
| 5.6
| 7.0
| 7.2
| 8.1
| 9.0
| 10.0
|-
! Lifetime damage inflicted<ref group="note">The formula to find the total lifetime damage is <code>ceil(''durability'' ÷ 2) × ''damage per hit''</code>. The durability is halved then ceiled because axes take double durability when used as a weapon, and the last 1 durability can also deal damage. The formula also ignores enchantments and critical hits, and assumes each attack is performed at maximum charge.</ref>
| {{hp|210}}
| {{hp|112}}
| {{hp|594}}
| {{hp|1125}}
| {{hp|7029}}
| {{hp|10160}}
|}
{{notelist}}

=== Enchantments ===
An axe can receive the following enchantments:
{| class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Fortune]]<ref group=note name=exc>Silk Touch and Fortune are mutually exclusive.</ref>
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Silk Touch]]<ref group=note name=exc/>
|I
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Efficiency]]
|V
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Sharpness]]<ref group="note" name="exc2">Sharpness, Smite, Bane of Arthropods, and Cleaving{{upcoming|java Combat Tests}} are mutually exclusive.</ref>
|V
|{{Inventory slot|Anvil}}
|-
|[[Smite]]<ref group="note" name=exc2/>
|V
|{{Inventory slot|Anvil}}
|-
|[[Bane of Arthropods]]<ref group="note" name=exc2/>
|V
|{{Inventory slot|Anvil}}
|-
|[[Fire Aspect]]{{upcoming|java Combat Tests}}<ref group="note" name="sword">Fire Aspect, Looting, Knockback, and Sweeping Edge currently exist, but they can be used only for [[sword]]s.</ref>
|II
|{{Inventory slot|Anvil}}
|-
|[[Looting]]{{upcoming|java Combat Tests}}<ref group="note" name="sword" />
|III
|{{Inventory slot|Anvil}}
|-
|[[Knockback]]{{upcoming|java Combat Tests}}<ref group="note" name="sword" />
|II
|{{Inventory slot|Anvil}}
|-
|[[Cleaving]]{{upcoming|java Combat Tests}}<ref group="note" name="exc2" />
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Sweeping Edge]]{{upcoming|java Combat Tests}}<ref group="note" name="sword" />
|III
|{{Inventory slot|Enchanting Table}}{{Inventory slot|Anvil}}
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|}

{{notelist}}

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

===Smelting ingredient===
{{Smelting|showname=1|Iron Axe;Golden Axe|Iron Nugget;Gold Nugget|0,1}}

===Piglins===
{{EntityLink|Piglin|Piglins}} are attracted to golden axes and run toward any golden axes on the ground, and inspect it for 6 to 8 seconds before putting it in their inventory.

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Axe strip1.ogg
|sound2=Axe strip2.ogg
|sound3=Axe strip3.ogg
|sound4=Axe strip4.ogg
|subtitle=Axe strips
|source=block
|description=When an axe strips a log or wood block
|id=item.axe.strip
|translationkey=subtitles.item.axe.strip
|volume=0.9
|pitch=1.0/0.85
|distance=16}}
{{Sound table
|sound=wax_off1.ogg
|sound2=wax_off2.ogg
|sound3=wax_off3.ogg
|subtitle=Wax off
|source=block
|description=When an axe unwaxes a [[block of copper]]
|id=item.axe.wax_off
|translationkey=subtitles.item.axe.wax_off
|volume=1.0
|pitch=0.9/1.1/1.0
|distance=16}}
{{Sound table
|sound=scrape1.ogg
|sound2=scrape2.ogg
|sound3=scrape3.ogg
|subtitle=Axe scrapes
|source=block
|description=When an axe deoxidizes a block of copper
|id=item.axe.scrape
|translationkey=subtitles.item.axe.scrape
|volume=1.0
|pitch=1.0/0.9/1.1
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When an axe's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Wood hit1.ogg
|sound2=Wood hit2.ogg
|sound3=Wood hit3.ogg
|sound4=Wood hit4.ogg
|sound5=Wood hit5.ogg
|sound6=Wood hit6.ogg
|source=block
|description=When an axe strips a log or wood block <ref group=sound name=stripsoundbug>{{Bug|MCPE-106552}}</ref>
|id=use.wood
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=Stem step1.ogg
|sound2=Stem step2.ogg
|sound3=Stem step3.ogg
|sound4=Stem step4.ogg
|sound5=Stem step5.ogg
|sound6=Stem step6.ogg
|source=block
|description=When an axe strips a stem or hyphae block <ref group=sound name=stripsoundbug/>
|id=use.stem
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=Bamboo wood step1.ogg
|sound2=Bamboo wood step2.ogg
|sound3=Bamboo wood step3.ogg
|sound4=Bamboo wood step4.ogg
|sound5=Bamboo wood step5.ogg
|sound6=Bamboo wood step6.ogg
|source=player
|description=When an axe strips a [[block of bamboo]] <ref group=sound name=stripsoundbug/>
|id=step.bamboo_wood
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=Cherry wood step1.ogg
|sound2=Cherry wood step2.ogg
|sound3=Cherry wood step3.ogg
|sound4=Cherry wood step4.ogg
|sound5=Cherry wood step5.ogg
|sound6=Cherry wood step6.ogg
|source=player
|description=When an axe strips a cherry log or cherry wood block <ref group=sound name=stripsoundbug/>
|id=step.cherry_wood
|volume=1.0
|pitch=0.8}}
{{Sound table
|sound=wax_off1.ogg
|sound2=wax_off2.ogg
|sound3=wax_off3.ogg
|source=neutral
|description=When an axe unwaxes or deoxidizes a block of copper {{More info|Is use.copper used as well?}}
|id=copper.wax.off
|volume=1.0
|pitch=0.8-1.2}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When an axe's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Wooden Axe
|spritetype=item
|nameid=wooden_axe
|form=item}}
{{ID table
|displayname=Stone Axe
|spritetype=item
|nameid=stone_axe
|form=item}}
{{ID table
|displayname=Iron Axe
|spritetype=item
|nameid=iron_axe
|form=item}}
{{ID table
|displayname=Diamond Axe
|spritetype=item
|nameid=diamond_axe
|form=item}}
{{ID table
|displayname=Golden Axe
|spritetype=item
|nameid=golden_axe
|form=item}}
{{ID table
|displayname=Netherite Axe
|spritetype=item
|nameid=netherite_axe
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wooden Axe
|spritetype=item
|nameid=wooden_axe
|id=311
|form=item}}
{{ID table
|displayname=Stone Axe
|spritetype=item
|nameid=stone_axe
|id=315
|form=item}}
{{ID table
|displayname=Iron Axe
|spritetype=item
|nameid=iron_axe
|id=298
|form=item}}
{{ID table
|displayname=Diamond Axe
|spritetype=item
|nameid=diamond_axe
|id=319
|form=item}}
{{ID table
|displayname=Golden Axe
|spritetype=item
|nameid=golden_axe
|id=325
|form=item}}
{{ID table
|displayname=Netherite Axe
|spritetype=item
|nameid=netherite_axe
|id=607
|form=item
|foot=1}}

==Achievements==
{{load achievements|MOAR Tools ;Oooh, shiny!}}

==Advancements ==
{{load advancements|Oh Shiny;Wax off}}

==History==
{{History|java indev}}
{{History||0.31|snap=20100110|[[File:Iron Axe JE1.png|32px]] Added iron axes.
|An axe is used to gather [[log|wood]] 400% faster than by hand.
|When starting in a new world, the [[player]] is given one of each [[tools|tool]].}}
{{History|||snap=20100122|[[File:Iron Axe JE2.png|32px]] The texture of axes has been changed. Half of the axe head has been removed.}}
{{History|||snap=20100124|[[File:Iron Axe JE3.png|32px]] The texture of axes has been changed again. The other axe head is now used instead.
|A complete toolset is no longer given to the [[player]] on starting a new world. Instead, there are multiple [[chest]]s in the later called "[[Indev House]]" containing a stack of most accessible [[blocks]]/[[items]] including [[tools]].}}
{{History|||snap=20100128|[[File:Wooden Axe JE1 BE1.png|32px]] [[File:Stone Axe JE1 BE1.png|32px]] [[File:Diamond Axe JE1 BE1.png|32px]] [[Tools]] now have tiers. Wooden, stone, and diamond axes have been added.
|[[File:Iron Axe JE4 BE1.png|32px]] The texture of iron axes has been changed.
|An axe held by the player is now rendered to appear more 3D.
|They cannot be crafted yet, but have been added to the item chest in the Indev house.}}
{{History|||snap=20100129|Wooden, stone, iron, and diamond axes can now be [[craft]]ed.}}
{{History|||snap=20100130|[[File:Golden Axe JE1.png|32px]] Axes can now be made out of gold.}}
{{History|||snap=20100201-1|[[Tools]] now take [[damage]] when being used. Better tools now last longer.}}
{{History||20100206|[[File:Golden Axe JE2 BE1.png|32px]] The texture of golden axes has been changed.}}
{{History|java beta}}
{{History||1.2|Gold [[tools]], including axes, now remove [[block]]s faster than diamond tools.}}
{{History|java}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft wooden axes.}}
{{History||1.3.1|snap=12w16a|Wooden and stone axes are now found in the new [[bonus chest]]s.}}
{{History|||snap=12w18a|Wooden axes can now be used as [[fuel]] in a [[furnace]].}}
{{History|||snap=12w21a|Blacksmith [[villager]]s now [[trading|sell]] 1 diamond axe for 9–11 [[emerald]]s, and 1 iron axe for 6–7 emeralds.}}
{{History||1.6.1|snap=13w21a|Instead of replacing the barehanded [[damage]] ({{hp|1}}), axes now add their damage onto the barehanded damage, which results in all axes doing {{hp|1}} more damage than before.}}
{{History||1.7.2|snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft wooden axes.}}
{{History||1.8|snap=14w02a|Weapon smith villagers now sell 1 [[enchanting|enchanted]] diamond axe for 9–12 emeralds, and 1 iron axe for 6–8 emeralds. Unenchanted diamond axes are no longer sold.}}
{{History||1.9|snap=15w34a|Axes now use the attack speed combat mechanic meter. The time it takes for the meter to fill up for an axe is 1.2 seconds.}}
{{History|||snap=15w34b|Axes now have an attack speed of 0.8, taking about 1.25 seconds to fill the attack meter.}}
{{History|||snap=15w34c|Axes do {{hp|4}} more [[damage]] than previously.
|Axes now have an attack speed of 0.85.
|Axes can now temporarily disable [[shield]] use.}}
{{History|||snap=15w35a|The [[damage]] of axes has been reduced by {{hp|1}}.
|The speed of axes has been increased to 0.9.}}
{{History|||snap=15w37a|Stone and diamond axes now both do {{hp|9}} damage, instead of the previous {{hp|8}} and {{hp|10}} respectively.
|Axes now have attack speed based on the tier, with wooden and stone having a speed of 0.8, iron having a speed of 0.9, and diamond and gold having a speed of 1.}}
{{History|||snap=15w43a|Stone axes may now be found in [[igloo]] basement chests.}}
{{History|||snap=15w44a|The average yield of stone and wooden axes from [[bonus chest]]s has been decreased.}}
{{History||1.11.1|snap=16w50a|Golden and iron axes now [[smelting|smelt]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 271, 275, 258, 279 and 286.}}
{{History||1.13|snap=18w07a|{{control|Using}} an axe on a block of [[wood]] or [[log]] now turns it into a stripped block of wood or log.}}
{{History|||snap=18w09a|Stone axes now can generate in the [[chest]]s of [[underwater ruins]].}}
{{History|||snap=pre2|{{control|Using}} an axe on a bark now turns it into a stripped bark.}}
{{History||1.14|snap=18w43a|[[File:Wooden Axe JE2 BE2.png|32px]] [[File:Stone Axe JE2 BE2.png|32px]] [[File:Iron Axe JE5 BE2.png|32px]] [[File:Golden Axe JE3 BE2.png|32px]] [[File:Diamond Axe JE2 BE2.png|32px]] The textures of all axes have been changed.}}
{{History|||snap=19w11a|Toolsmith villagers now sell stone axes, as well as enchanted iron and diamond axes.}}
{{History|||snap=19w13a|Toolsmith villagers now give stone axes to players under the [[Hero of the Village]] effect.
|Weaponsmith villagers now give stone, golden and iron axes to players under the [[Hero of the Village]] effect.}}
{{History||1.16|snap=20w06a|[[File:Netherite Axe JE1.png|32px]] Added netherite axes.
|Netherite axes are obtained by combining one diamond axe and one netherite ingot in a crafting table.
|[[Crimson planks]] and [[warped planks]] can now be used to craft wooden axes.}}
{{History|||snap=20w09a|[[File:Diamond Axe JE3 BE3.png|32px]] The texture of diamond axes has been changed.}}
{{History|||snap=20w10a|[[File:Netherite Axe JE2.png|32px]] The texture of netherite axes has been changed.
|Netherite axes can no longer be crafted.
|Netherite axes are now obtained by combining one diamond axe and one netherite ingot in a smithing table.}}
{{History|||snap=20w15a|Stone axes can now be crafted using [[blackstone]].}}
{{History|||snap=20w16a|Golden axes now generate randomly enchanted in [[ruined portal]] chests.}} 
{{History||1.16.2|snap=20w30a|Enchanted golden axes can now be found in [[bastion remnant]] chests.}}
{{History||1.17|snap=21w08a|Stone axes can now be crafted using [[cobbled deepslate]].}}
{{History|||snap=21w11a|Axes can now be used to scrape wax and oxidation off [[copper block]]s.}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft wooden axes.}}
{{History||1.20 (Experimental)|link=1.19.3|snap=22w42a|Added [[block of bamboo]], which when used with an axe gives a block of stripped bamboo.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Upgrading diamond axes to netherite axes now requires the netherite upgrade [[smithing template]].}}
{{History||1.20|snap=23w12a|Iron axes can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]].}}

{{History|upcoming java}}
{{History||Combat Tests|snap=1.14.3 - Combat Test|The attack speed for all axes has been increased to 2.
|All axes now deal {{hp|1}} more [[damage]] than their sword counterparts.}}
{{History|||snap=Combat Test 3|The [[Cleaving|Chopping]] enchantment has been added for axes, which adds 1 damage and 0.5 seconds (10 [[game tick]]s) of [[shield]] stunning per level and is mutually exclusive with [[Sharpness]].
|Axes now always disable shields for {{convert|1.6|seconds|ticks}}, instead of having a 25% to disable them for 5 seconds (100 game ticks).
|Axes now take 1 damage when attacking instead of 2.
|The [[Sweeping Edge]] enchantment can now be applied to axes.}}
{{History|||snap=Combat Test 4|[[Knockback]], [[Looting]], and [[Fire Aspect]] enchantments can now be applied to axes.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Stone Axe JE1 BE1.png|32px]] Added stone axes.}}
{{History||v0.3.0|[[File:Wooden Axe JE1 BE1.png|32px]] Added wooden axes.
|Survival players no longer start with an infinite durability stone axe in the inventory.}}
{{History||v0.3.2|[[File:Iron Axe JE4 BE1.png|32px]] [[File:Golden Axe JE2 BE1.png|32px]] [[File:Diamond Axe JE1 BE1.png|32px]] Added iron, golden and diamond axes.}}
{{History||v0.4.0|Removed stone axes from the creative inventory.}}
{{History||v0.11.0|snap=build 11|All axes are now available in the [[creative]] [[inventory]].}}
{{History|||snap=build 12|All axes have been removed from creative.}}
{{History|||snap=build 13|All axes have been re-added to creative mode.}}
{{History||v0.12.1|snap=build 1|Instead of replacing the barehanded [[damage]] ({{hp|1}}), axes now add their damage onto the barehanded damage, which results in all axes doing {{hp|1}} more damage than before.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Stone axes now can be found inside [[igloo]] basement [[chest]]s.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Weaponsmith [[villager]]s now [[trading|sell]] iron axes for 6-8 [[emerald]]s as part of their first tier [[trading|trades]] and [[enchanting|enchanted]] diamond axes for 9-12 emeralds as part of their third tier trades.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden axes are now [[smelting|smeltable]].
|Iron axes with the [[Efficiency]] I enchantment can now be found inside [[chest]]s in [[woodland mansion]]s.
|Added [[vindicator]]s, who rarely [[drops|drop]] iron axes.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Wooden and stone axes can now be found in [[bonus chest]]s.}}
{{History||1.4.0|snap=beta 1.2.13.8|Using an axe on a [[log]] now turns it into a stripped log.}}
{{History|||snap=beta 1.2.20.1|Stone axes can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Wooden Axe JE2 BE2.png|32px]] [[File:Stone Axe JE2 BE2.png|32px]] [[File:Iron Axe JE5 BE2.png|32px]] [[File:Golden Axe JE3 BE2.png|32px]] [[File:Diamond Axe JE2 BE2.png|32px]] The textures of all axes have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn in [[raid]]s can now [[drops|drop]] an iron axe.
|[[Trading]] has been changed, weaponsmith [[villager]]s now [[trading|sell]] iron axes for 3 [[emerald]]s and [[enchanting|enchanted]] diamond axes for 12 emeralds as part of their fourth tier [[trading|trades]].
|Stone axes, enchanted iron axes, and diamond axes can now be [[trading|bought]] from toolsmith villagers.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Netherite Axe BE1.png|32px]] Added netherite axes.|Netherite axes are obtained by combining one diamond axe and one netherite ingot in a crafting table.
|[[File:Diamond Axe JE3 BE3.png|32px]] The texture of diamond axes has been changed.}}
{{History|||snap=beta 1.16.0.57|Netherite axes can no longer be crafted.
|Netherite axes are now obtained by combining one diamond axe and one netherite ingot in a smithing table.
|Stone axes can now be crafted using blackstone.
|Golden axes now generate randomly enchanted in [[ruined portal]] chests.
|Netherite axes now generate randomly enchanted in [[bastion remnant]] chests.}}
{{History||1.16.20|snap=beta 1.16.20.50|Added [[piglin brute]]s, who rarely drop golden axes.}}
{{History||1.16.100|snap=beta 1.16.100.54|Piglin brutes no longer spawn with enchanted axes.}}
{{History|||snap=beta 1.16.100.55|Zombified piglins that are converted from piglin brutes now keep their golden axes.}}
{{History||1.16.220|snap=beta 1.16.220.52|Axes can now be used to scrape wax off copper blocks.}}
{{History||1.18.30|snap=beta 1.18.30.26|Axes can now temporarily disable [[shield]] use. This is not mentioned in the official changelog.<ref>{{tweet|kingbdogz|1504505321884196872|We missed a change in recent changelogs for the Bedrock beta that you may like - we have now made a parity fix that makes shields get disabled for 5 seconds when attacked by an Axe-wielding mob or player. We will make sure to list this properly in the next beta :)|March 17, 2022}}</ref>
}}

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

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

==Issues==
{{issue list}}

==Trivia==
*Before [[Java Edition 1.13]], in the language files, axes were referred to as Hatchets.<ref name="1.8 lang">''1.8/assets/minecraft/lang/en_US.lang'', line 915: '''item.hatchetIron.name= Iron Axe'''</ref>
*Weaponsmith villagers gifting stone, iron and golden axes is a reference to the story ''[[wikipedia:The Honest Woodcutter|The Honest Woodcutter]]'', where a woodcutter dropped his axe into a river, and is successively provided a silver and a golden axe by the river god.{{cn}}

== Gallery ==
<gallery>
Stone Axe SDGP.png|Stone axe in the [[Super Duper Graphics Pack]].
</gallery>
=== Enchanted axes ===
<gallery>
Enchanted Wooden Axe.gif
Enchanted Stone Axe.gif
Enchanted Iron Axe.gif
Enchanted Golden Axe.gif
Enchanted Diamond Axe.gif
Enchanted Netherite Axe.gif
</gallery>

==See also==
*{{ItemLink|Pickaxe}}

==References==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--axe Taking Inventory: Axe] – Minecraft.net on February 6, 2020

{{items}}

[[Category:Combat]]

[[cs:Sekera]]
[[de:Axt]]
[[es:Hacha]]
[[fr:Hache]]
[[hu:Balta]]
[[ja:斧]]
[[ko:도끼]]
[[nl:Bijl]]
[[pl:Siekiera]]
[[pt:Machado]]
[[ru:Топор]]
[[th:ขวาน]]
[[uk:Сокира]]
[[zh:斧]]</li></ul>
14w06aAdded custom block models.
14w07aThe model format has now been rewritten. Instead of having just "planes", it now has "planes" and "cubes".
The rotation of objects are now limited to one directional rotation per object in increments of 22.5 degrees.
14w11aLighting on solid block no longer makes inner sections completely black.
14w11bGeneric blocks now load models instead of pre-defined shapes.
April 12, 2014TheMogMiner posts about upcoming changes to the model format.
14w17aConverted most of the remaining static blocks to the model format.
Added "rotateVariantTextures" to preserve uv details through rotation.
14w25aThe directional attribute from the uv definition has now been removed and replaced it with explicit texture references. "textureFacing" has been replaced with "texture" parameter, which is now prepended with the hash symbol (#).
"useAmbientOcclusion" has now been renamed to "ambientocclusion".
"rotateVariantTextures" has now been renamed to "UV lock".
"cull" has now been renamed to "cullface", specifies the opposite of which neighboring face causes culling to occur.
Rotation has now been made more verbose, it is now more clear that it can occur only on a single axis. Example, the rotation for one of the two faces of the "cross" model is now: "rotation": { "origin": [ 8, 8, 8 ], "axis": "y", "angle": 45, "rescale": true },.
The folder models/blocks/meshes has now been removed and model files are now stored in models/block.
The folder blockstates has now been added and stores the model selection files previously found in models/block.
The model format now supports custom item models.
14w27aBlock state names have now been replaced with data that better reflects the internal data. This does not yet reflect all data for some blocks and switches to using the actual stored data in a future version when numerical data values are completely dropped in favor of block states.
14w27bThe block state files now support an array of models allowing for random models.
14w30aAdded the item model "builtin/entity".
1.8.2
{{Extension DPL}}<ul><li>[[Bread|Bread]]<br/>{{dungeons hatnote|type=item}}
{{Item
| title = Bread
| image = Bread.png
| renewable = Yes
| heals = {{hunger|5}}
| stackable = Yes (64)
}}
'''Bread''' is a [[food]] [[item]] that can be eaten by the [[player]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |A2=Wheat
  |B2=Wheat
  |C2=Wheat
  |Output=Bread
  |type=Foodstuff
}}

=== Chest loot ===

{{LootChestItem|bread}}

=== Trading ===

Novice-level farmer [[Villager|villagers]] sell 6 bread for one [[emerald]] as part of their [[Trading|trades]]. {{IN|java}} they only have a 40% chance of offering this trade.

=== Villager gifts ===

Farmer villagers may use wheat they have harvested to craft bread, which they can trade with other villagers.

Farmer villagers may throw bread at players under the [[Hero of the Village]] effect.{{only|java}}

== Usage ==

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

Bread can be eaten with the use control while it is selected in the [[hotbar]]. Eating bread restores {{hunger|5}} [[hunger]] and 6.0 [[Hunger#Mechanics|hunger saturation]].

=== Breeding ===

Villagers can pick up bread items to become willing, allowing them to breed. Villagers require 3 bread to become willing.

=== Composting ===
Placing bread into a [[composter]] has an 85% chance of raising the compost level by 1. It is more efficient to compost [[wheat]] than bread made from wheat.

== Sounds ==

{{Sound table/Entity/Food}}

== Data values ==

=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Bread
|spritetype=item
|nameid=bread
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bread
|spritetype=item
|nameid=bread
|id=261
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Bake Bread}}

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

== History ==

{{History|java indev}}
{{History||20100206|[[File:Bread JE1 BE1.png|32px]] Bread has been added, which now restores {{hp|5}}.}}
{{History||20100223|Bread now requires 3 [[wheat]] (1 row of 3) instead of 6 (2 rows of 3) to be crafted.}}
{{History|java infdev}}
{{History||?|Bread is no longer stackable.}}
{{History||20100625-2|Bread can now be found in the new [[dungeon]] [[chest]]s.}}
{{History|java beta}}
{{History||1.8|snap=Pre-release|Bread is now stackable to 64.
|Bread now restores {{hunger|5}} instead of {{hp|5}}.
|[[Dungeon]] [[chests]] now contain more bread, now that it stacks.
|Bread can now be found in the new [[stronghold]] storerooms and [[mineshaft]] [[chest]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 3|Bread can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History||1.1|snap=12w01a|Bread can now be found in the new [[village]] blacksmith chests.}}
{{History||1.3.1|snap=12w16a|Bread can now be found in the new [[bonus chest]]s.}}
{{History|||snap=12w21a|Farmer [[villager]]s now [[trading|sell]] 3–4 loaves of bread for 1 [[emerald]].}}
{{History||1.4.2|snap=12w37a|[[File:Bread JE2 BE2.png|32px]] The dark outline has now been removed from the bread texture.}}
{{History||1.6.1|snap=13w16a|Bread can now be used to feed [[horse]]s.}}
{{History||1.8|snap=14w02a|Farmer [[villager]]s now [[trading|sell]] 2–4 loaves of bread for 1 [[emerald]].}}
{{History|||snap=14w26c|[[Horse]]s no longer can eat bread.}}
{{History||1.9|snap=15w44a|The average yield of bread from [[mineshaft]] and [[dungeon]] [[chest]]s has now been decreased.}}
{{History||1.11|snap=16w39a|Bread can now found in the new [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 297.}}
{{History||1.14|snap=18w43a|[[File:Bread JE3 BE3.png|32px]] The texture of bread has now been changed.}}
{{History|||snap=18w48a|Bread can now generate inside chests in cartographer houses, tanneries and plains [[village]] houses.}}
{{History|||snap=18w49a|Bread can now generate inside chests in mason houses, and savanna and snowy [[village]] houses.}}
{{History|||snap=18w50a|Bread can now generate inside chests in village temples, toolsmith, and desert and taiga [[village]] houses.}}
{{History|||snap=19w03a|Placing bread into the new [[composter]] now has an 80% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Bread now has an 85% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w13a|Farmer villagers now give bread to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.4.0|[[File:Bread JE1 BE1.png|32px]] Added bread.}}
{{History||v0.5.0|Bread now restores {{hp|5}} instead of {{hp|2}}.}}
{{History||v0.8.0|snap=build 1|[[File:Bread JE2 BE2.png|32px]] The dark outline has now been removed from the bread texture.}}
{{History||v0.12.1|snap=build 1|Bread now restores [[hunger]] instead of [[health]].}}
{{History||v0.14.0|snap=build 1|Bread can now be found inside [[minecart with chest]]s in [[mineshaft]]s.}}
{{History|pocket}}
{{History||1.0.4|snap=alpha 1.0.4.0|[[Villager]]s now require bread to become willing, in order to [[breeding|breed]].
|Farmer [[villager]]s now [[trading|sell]] 2-4 loaves of bread for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Bread can now be found in [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Bread can now be found inside [[bonus chest]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Bread JE3 BE3.png|32px]] The texture of bread has now been changed.
|Bread can now be found inside [[plains]] [[village]] houses [[chest]]s, plains tannery house chests, village cartographer house chests and plains weaponsmith chests.}}
{{History||1.11.0|snap=beta 1.11.0.1|Bread can now be found in village chests other than plains.
|Bread can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|Farmer [[villager]]s now [[trading|sell]] 6 bread for one [[emerald]].}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|[[File:Bread JE1 BE1.png|32px]] Added bread.}}
{{History||xbox=TU5|Bread is now stackable to 64. 
|Bread now restores [[hunger]] instead of [[health]].}}
{{History||xbox=TU12|[[File:Bread JE2 BE2.png|32px]] The dark outline has now been removed from the bread texture.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bread JE3 BE3.png|32px]] The texture of bread has now been changed.}}

{{History|new3DS}}
{{History||0.1.0|[[File:Bread JE2 BE2.png|32px]] Added bread.}}
{{History|foot}}

== Issues ==
{{issue list}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--bread Taking Inventory: Bread] – Minecraft.net on February 25, 2021

{{Items}}

[[Category:Food]]
[[Category:Renewable resources]]

[[cs:Chléb]]
[[de:Brot]]
[[es:Pan]]
[[fr:Pain]]
[[hu:Kenyér]]
[[it:Pane]]
[[ja:パン]]
[[ko:빵]]
[[nl:Brood]]
[[pl:Chleb]]
[[pt:Pão]]
[[ru:Хлеб]]
[[th:ขนมปัง]]
[[uk:Хліб]]
[[zh:面包]]</li><li>[[Rotten Flesh|Rotten Flesh]]<br/>{{Item
| title = Rotten Flesh
| image = Rotten Flesh.png
| renewable = Yes
| heals = {{hunger|4}}
|effects={{EffectLink|link=Hunger (status effect)|Hunger}} (0:30) (80% chance) 
| stackable = Yes (64)
}}

'''Rotten flesh''' is a [[food]] item that can be eaten by the [[player]], with high risk of inflicting [[Hunger (status effect)|Hunger]] and low [[Saturation]].

== Obtaining ==

=== Mob loot ===

==== Zombies ====
[[Zombie]]s, [[zombie villager]]s, [[zombie horse]]s, [[husk]]s, and [[drowned]] drop from 0 to 2 units of rotten flesh. [[Looting]] can increase this by one per level, for a maximum of 5 rotten flesh.

==== Zoglins ====
[[Zoglin]]s drop 1-3. Looting III grants a maximum of 6.

==== Zombified piglins ====
[[Zombified Piglin|Zombified piglins]] drop 0-1. Looting III grants a maximum of 4.

=== Fishing ===
Rotten flesh can be obtained as a "junk" item while [[fishing]].

=== Chest loot ===

{{LootChestItem|rotten-flesh}}

=== Cat gifts ===
{{main|Cat#Gifts}}

Tamed [[cat]]s have a 70% chance of giving the [[player]] a gift when they wake up from a [[bed]], and the gift has a 16.13% chance to be a rotten flesh.

== Usage ==

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

To eat rotten flesh, press and hold {{control|use}} while rotten flesh is selected in the hotbar.

Eating rotten flesh restores {{hunger|4}} [[hunger]] and 0.8 hunger [[Hunger#Mechanics|saturation]], but has an 80% chance of inflicting {{EffectLink|Hunger (effect)|id=Hunger}} for 30 seconds. Note that the duration does ''not'' accumulate when eating multiple pieces. However, if more is consumed and the [[Hunger (effect)|Hunger]] status effect is inflicted, the duration resets to 30 seconds.

=== Wolves ===
Rotten flesh can be used to [[breed]] and heal tamed [[wolves]], lead them around, and make baby tamed wolves grow up faster by 10% of the remaining time.

Wolves are immune to the Hunger effect.

=== Trading ===
Novice-level [[Trading#Cleric|cleric villagers]] buy 32 rotten flesh for 1 [[emerald]] as part of their trades.

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Rotten Flesh
|spritetype=item
|nameid=rotten_flesh
|id=277
|form=item
|foot=1}}

== Achievements ==

{{load achievements|Iron Belly}}

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

== Video ==
{{Video note|The video is outdated, as rotten flesh can now be also gained from [[fishing]], [[trading]], or loot chests.}}

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

== History ==

{{History|java beta}}
{{History||1.8|snap=Pre-release|[[File:Rotten Flesh JE1.png|32px]] Added rotten flesh. 
|[[Zombie]]s and [[zombie pigmen]] now drop rotten flesh instead of [[feather]]s and [[cooked porkchop]]s respectively.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Food poisoning can now be stopped by drinking [[milk]].}}
{{History||1.2.1|snap=12w03a|Rotten flesh can now be used to [[Breeding|breed]] wolves. When a wolf eats rotten flesh, it will not receive the [[Hunger (effect)|Hunger]] effect.}}
{{History||1.3.1|snap=12w21a|Rotten flesh can now be found in [[desert temple]] [[chest]]s.
|Priest [[villager]]s now [[trading|buy]] rotten flesh.}}
{{History|||snap=1.3|[[File:Rotten Flesh JE2 BE1.png|32px]] The texture of rotten flesh has been changed.}}
{{History|||snap=12w22a|Rotten flesh now generates in [[jungle temple]] chests.
|Priest [[villager]]s no longer [[trading|buy]] rotten flesh.}}
{{History||1.7.2|snap=13w36a|Rotten flesh can now be obtained as one of the "junk" [[item]]s from [[fishing]].}}
{{History||1.8|snap=14w02a|Cleric [[villager]]s now [[trading|buy]] 36–40 rotten flesh for 1 [[emerald]], as their tier I trade.}}
{{history||1.9|snap=15w43a|Rotten flesh may now be found in [[igloo]] basement [[chest]]s.}}
{{history|||snap=15w44a|Rotten flesh now generates in [[dungeon]] chests.
|The average yield of rotten flesh has been decreased in [[desert temple]] chests.}}
{{History||1.11|snap=16w39a|Rotten flesh can now be found in [[woodland mansion]] [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 367.}}
{{History|||snap=18w09a|Rotten flesh now generates in the loot [[chest]]s of [[underwater ruins]].}}
{{History|||snap=18w11a|[[Drowned]] may now [[drops|drop]] rotten flesh upon death.
|Rotten flesh now sometimes generates in [[shipwreck]] [[chest]]s.}}
{{History||1.14|snap=18w43a|[[File:Rotten Flesh JE3 BE2.png|32px]] The texture of rotten flesh has been changed.}}
{{History|||snap=18w44a|[[Cat]]s now offer rotten flesh as [[Cat#Gifts|gift]]s.}}
{{History|||snap=18w50a|Rotten flesh can now be found in [[village]] temple chests.}}
{{History||1.16|snap=20w06a|Added [[hoglin]]s, which can drop rotten flesh if killed.}}
{{History|||snap=20w07a|Rotten flesh has a {{frac|10|109}} (~9.17%) chance of being given by the new [[piglin]]s when [[bartering]], in a stack size of 4–12.
|[[Hoglin]]s no longer drop rotten flesh.}}
{{History|||snap=20w09a|Rotten flesh can no longer be obtained by bartering with piglins.}}
{{History|||snap=20w14a|Added [[zoglin]]s, which drop rotten flesh when killed.}}

{{History|pocket alpha}}
{{History||v0.11.0|snap=build 1|[[File:Rotten Flesh JE2 BE1.png|32px]] Added rotten flesh. 
|As the hunger bar has not yet been added, rotten flesh inflicts [[poison]] rather than [[hunger]].
|[[Zombie]]s and [[zombie pigmen]] now [[drops|drop]] rotten flesh.}}
{{History|||snap=build 11|Rotten flesh can now be used to feed [[wolves]].}}
{{History||v0.12.1|snap=build 1|Eating rotten flesh now gives the [[player]] the [[Hunger]] status effect.
|Rotten flesh now restores [[hunger]] instead of [[health]].
|Added [[zombie villager]]s, which [[drops|drop]] rotten flesh when killed.}}
{{History||v0.13.0|snap=build 1|Rotten flesh can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.15.0|snap=build 1|Added [[husk]]s and [[zombie horse]]s, both of which drop rotten flesh when killed.
|Rotten flesh can now be found inside [[jungle temple]] chests.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Rotten flesh can now be found inside the basement [[chest]]s of [[igloo]]s.}}
{{History||1.0.4|snap=alpha 1.0.4.0|36-40 rotten flesh can now be [[trading|sold]] to cleric [[villager]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Rotten flesh can now be found in [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.13.8|Added [[drowned]], which [[drops|drop]] rotten flesh when killed.}}
{{History|||snap=beta 1.2.14.2|Rotten flesh can now be found in some [[shipwreck]] [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Rotten flesh can now be found inside [[underwater ruins]] chests.}}
{{History||1.8.0|snap=beta 1.8.0.8|Tamed [[cat]]s can now give the [[player]] rotten flesh as a gift.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Rotten Flesh JE3 BE2.png|32px]] The texture of rotten flesh has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Rotten flesh can now be found in [[desert]] [[village]] temple [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has been changed, cleric [[villager]]s now [[trading|buy]] 32 rotten flesh for an [[emerald]].}}

{{History|console}}
{{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Rotten Flesh JE2 BE1.png|32px]] Added rotten flesh.}}	
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Rotten Flesh JE3 BE2.png|32px]] The texture of rotten flesh has been changed.}}

{{History|new3ds}}
{{History||0.1.0|[[File:Rotten Flesh JE2 BE1.png|32px]] Added rotten flesh.}}
{{History|foot}}

== Issues ==
{{issue list}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--rotten-flesh Taking Inventory: Rotten Flesh] – Minecraft.net on June 8, 2020

{{Items}}

[[cs:Shnilé maso]]
[[de:Verrottetes Fleisch]]
[[es:Carne podrida]]
[[fr:Chair putréfiée]]
[[hu:Rohadt hús]]
[[it:Carne marcia]]
[[ja:腐った肉]]
[[ko:썩은 살점]]
[[nl:Bedorven vlees]]
[[pl:Zgniłe mięso]]
[[pt:Carne podre]]
[[ru:Гнилая плоть]]
[[uk:Гнила плоть]]
[[zh:腐肉]]
[[Category:Renewable resources]]
[[Category:Food]]</li></ul>
pre5The tag "translation" is now limited to the range of -24 to 24.
The tag "scale" is now limited to 4 or less.
1.9
{{Extension DPL}}<ul><li>[[Crossbow|Crossbow]]<br/>{{For}}
{{Item
| title = Crossbow
| image = <gallery>
Crossbow.png | Crossbow
Crossbow Pull 0.png | Pull (state 0)
Crossbow Pull 1.png | Pull (state 1)
Crossbow Pull 2.png | Pull (state 2)
Arrow Loaded Crossbow.png | Arrow loaded
Firework Loaded Crossbow.png | Firework loaded
</gallery>
| rarity = Common
| renewable = Yes
| durability = 465{{only|JE|short=yes}}<br>464{{only|BE|short=1}}
| stackable = No
}}

A '''crossbow''' is a ranged [[weapon]] similar to a [[bow]] that uses [[arrow]]s or [[firework rocket|fireworks]] as ammunition.

== Obtaining ==
=== Crafting ===
{{Crafting
|A1=Stick|B1=Iron Ingot |C1=Stick
|A2=String|B2= Tripwire Hook|C2=String
|B3= Stick
|Output= Crossbow
|type= Combat
}}

=== Repairing ===
{{Grinding
|showdescription=1
|ingredients=2× Damaged [[Crossbow]] or<br>2× Damaged [[Arrow Loaded Crossbow]] or<br>2× Damaged [[Firework Loaded Crossbow]]
|Damaged Crossbow; Damaged Arrow Loaded Crossbow; Damaged Firework Loaded Crossbow
|Damaged Crossbow; Damaged Arrow Loaded Crossbow; Damaged Firework Loaded Crossbow
|Crossbow; Arrow Loaded Crossbow; Firework Loaded Crossbow
|description=The [[item durability|durability]] of the two crossbows is added together, plus an extra 5% durability.‌
}}

{{Crafting
|Damaged Crossbow;Damaged Arrow Loaded Crossbow;Damaged Firework Loaded Crossbow
|Damaged Crossbow;Damaged Arrow Loaded Crossbow;Damaged Firework Loaded Crossbow
|Output=Crossbow
|type=Combat
|ignoreusage=1
|showdescription=1
|description=The durability of the two crossbows is added together, plus an extra 5% durability.‌ Any loaded ammunition is lost.
}}

=== Mob loot ===

==== Pillagers ====

When killed, a [[pillager]] has a small chance (8.5%) of dropping a loaded or unloaded crossbow with random [[durability]]; the [[drop]] rate increases by 1% per [[level]] of [[Looting]]: 9.5% with Looting I, 10.5% with Looting II and 11.5% with Looting III. The [[drop]]ped crossbow can rarely (10% chance) be [[enchanted]] at level 5–19 regardless of being [[enchanted]] when it [[spawn]]ed.

Crossbows dropped by pillagers may have multiple enchantments, including duplicate enchantments on the same weapon.

==== Piglins ====
[[Piglin]]s have a chance of wielding a crossbow upon spawning, and they also have a small chance (8.5%) of dropping a loaded or unloaded crossbow of random durability when killed; this rate increases by 1% per level of [[Looting]]: 9.5% with Looting I, 10.5% with Looting II and 11.5% with Looting III. It can rarely (10% chance) be enchanted at level 5–19 regardless of being enchanted when spawned.

=== Chest loot ===

{{LootChestItem|crossbow,damaged-level-enchanted-crossbow,damaged-random-enchanted-crossbow,damaged-random-enchanted-crossbow-2}}

=== Trading ===

Journeyman-level Fletcher [[villager]]s offer to [[trading|sell]] an unenchanted crossbow for 3 [[emerald]]s.

Master-level Fletcher villagers have a {{frac|1|16}} (6.25%) chance of selling an [[enchanting|enchanted]] crossbow for 8 emeralds.{{only|bedrock}}

Master-level Fletcher villagers have {{frac|2|3}} chance of selling an enchanted crossbow for 7-22 emeralds.{{only|java}}

== Usage ==
<gallery>
Steve aiming with Crossbow.png|
Alex aiming with Crossbow.png|
Pillager Aiming with Crossbow BE.png|
Piglin with Crossbow targeting JE.png|
</gallery>

Despite using [[iron ingot]]s in their crafting recipe, crossbows cannot be smelted into [[iron nugget]]s.<ref>{{bug|MC-111738}}</ref>

=== Weapon ===
[[File:Crossbowcooldown.gif|thumb|right|Charging and shooting the crossbow {{in|bedrock}}.]]
Crossbows are similar to [[bow]]s, but take longer to load and are slightly more powerful, shooting farther with slightly higher accuracy. Alternatively, they can be loaded with a firework rocket, which flies in a straight line.

Load them by {{control|using}} them, which makes the player move at sneak speed. Unlike bows, the [[arrow]] or [[firework rocket]] can be fired only if the player releases the use button after the crossbow is loaded{{Only|je}}  or if the crossbow finishes its loading animation {{Only|be}}. At this point, it ''must be used a second time'' to fire its bolt.

Once it has reached full charge, the [[player]]'s speed returns to normal. After that, shooting a charged crossbow does not delay any of the [[player]]'s current action like [[sprinting]] or [[swimming]].

The crossbow can even be placed in another [[inventory]] slot or into an [[item frame]] without the [[arrow]] or [[firework rocket]] being unloaded or fired. A charged crossbow also remains charged after enchanting it with an enchantment table or with an anvil.

In order to use the crossbow, at least one arrow or firework rocket must be present in the inventory. The player can choose the type of arrow to fire based on its location in their [[inventory]]:
* [[File:Java Crossbow 1stP Loading.mp4|thumb|177x177px|Java Edition first-person loading animation for crossbows.]]Arrows in the off-hand, or the selected [[hotbar]] slot if the crossbow is in the off-hand, are prioritized first. 
* If there are no arrows in the off-hand or selected hotbar slot, the arrow closest to slot 0 is selected. 
Crossbows take 1.25 seconds (25 ticks) to load. 

The player can load either an arrow, spectral arrow, tipped arrow (of any effect) or a firework (of any color/type).
[[File:Bedrock Crossbow 1stP Loading.mp4|thumb|177x177px|Bedrock Edition first-person loading animation for crossbows.]]
[[Endermen]] teleport away from projectile paths, so they cannot be hit with crossbow [[arrow]]s. However, they can still get harmed by [[firework rocket]] explosions, if they can't detect the firework rocket.

;Attack strength

''Java Edition'':

{| class="wikitable" style="text-align:center" data-description="Crossbow Damage Statistic"
|-
! Damage || Arrow || Max firework
|-
| {{ItemSprite|Crossbow|text= '''Minimum'''}}
| {{hp|7}}
| {{hp|11}}
|-
| {{ItemSprite|Crossbow|text= '''Average'''}}
| {{hp|9}}
| {{hp|14.5}}
|-
| {{ItemSprite|Crossbow|text= '''Maximum'''}}
| {{hp|11}}
| {{hp|18}}
|}

''Bedrock Edition''
* Always {{hp|9}}

=== Fireworks ===

[[Firework rocket]]s can be fired by loading the crossbow only while holding the rockets in the off-hand. They fly at 32 m/s. Firework rockets with higher flight duration have a longer time before they explode and therefore travel farther. Firing a firework rocket uses 3 [[durability]] points per shot.
{| class="wikitable" style="text-align:center"
! colspan="4" |Firework rocket range
|-
|Minimum
|Average
|Maximum
|Gunpowder
|-
|32m (20 ticks)
|40.8m (25.5 ticks)
|49.6m (31 ticks)
|1 ([[File:Gunpowder JE2 BE2.png|12x12px]])
|-
|48m (30 ticks)
|56.8m (35.5 ticks)
|65.6m (41 ticks)
| 2 ([[File:Gunpowder JE2 BE2.png|12x12px]][[File:Gunpowder JE2 BE2.png|12x12px]])
|-
|64m (40 ticks)
|72.8m (45.5 ticks)
|81.6m (51 ticks)
|3 ([[File:Gunpowder JE2 BE2.png|12x12px]][[File:Gunpowder JE2 BE2.png|12x12px]][[File:Gunpowder JE2 BE2.png|12x12px]])
|}
Firework rockets also work with the [[Multishot]] enchantment, enabling the [[player]] to shoot 3 firework rockets at a time. The increased durability usage stacks, resulting in 9 durability being consumed with each shot.

A shot firework rocket explodes instantly when it hits a [[mob]] or [[block]].{{only|java}} If the firework rocket has no explosion effect, it deals no [[damage]]. The explosion of a firework rocket deals {{hp|5}} to {{hp|6}} points of damage, with one [[firework star]]. The explosion has a radius of roughly 4 blocks, which is unaffected by the firework star's [[Firework Star#Effects|effect]]. Each additional firework star on the rocket deals an additional {{hp|1}} to {{hp|2}} points of damage, for a maximum of {{hp|11}} to {{hp|18}} with 7 firework stars. The flight duration of the firework increases the maximum range the firework can travel before exploding, but does not affect the damage output. Likewise, the damage remains the same regardless of any dyes used. The [[Piercing]] enchantment causes the firework rocket to pierce a number of entities based on its respective level before exploding.{{only|java}} Unlike an arrow shot from a bow, the firework does not slow down under water.

=== Repair ===

Crossbows can be repaired in an [[anvil]] or [[grindstone]] by combining two crossbows. Any loaded ammunition is retained from the crossbow in the first slot but sacrificed from the crossbow in the second slot.

===Enchantments===
{| class="wikitable"
|+
!Name
!Description
!Max Level
|-
|[[Quick Charge]]
|Decreases the reloading time of the crossbow by {{code|level * 0.25}} seconds. Crossbows with [[Quick Charge]] III fire slightly faster than [[bow]]s. If [[commands]] are used to enchant a crossbow with Quick Charge V, the crossbow charges instantaneously. A crossbow enchanted with Quick Charge VI is effectively impossible to charge, which renders it useless. This can be done only {{in|je}}.
|III
|-
|[[Multishot]]
| Makes the crossbow fire a spread of 3 projectiles at once instead of a single projectile, which is useful for targeting mobs spread out in a small area. This works for both [[arrow]]s and [[firework rocket]]s. Firing with this enchantment still uses only one projectile, and because of that, it is possible to recover only one of the three arrows shot from a Multishot crossbow. Multishot crossbows use 3 [[item durability|durability]] points per shot, unless using fireworks for ammunition, in which case 9 durability is consumed. Mutually exclusive with Piercing.
|I
|-
|[[Piercing]]
|Makes [[arrow]]s shot from the crossbow pierce [[entity|entities]] they hit and continue their flight, which allows each arrow to hit up to {{code|level + 1}} entities. This is useful for targeting [[mob]]s closely packed together, and for conserving arrows, as they can be picked up after piercing entities. Arrows fired in this manner also ignore [[Shield|shields]]. Mutually exclusive with Multishot.
|IV
|-
|[[Unbreaking]]
|Causes a <code>(Level /(Level+1)) * 100%</code> chance a shot fired does not reduce the [[item durability|durability]] of the crossbow.
|III
|-
|[[Mending]]
|Allows a certain proportion of [[experience]] orbs collected to contribute toward repairing the crossbow, rather than raising the [[player]]'s experience.
|I
|-
|[[Curse of Vanishing]]
| Causes the crossbow to disappear instead of dropping on the ground when the player dies. The {{cmd|gamerule keepInventory}} overrides this.
|I
|}

[[Multishot]] and [[Piercing]] are mutually exclusive. Normal methods of [[enchanting]] allow only one of them to be applied to a crossbow.

Crossbows can receive 3 unique [[enchanting|enchantment]]s, and have a base enchantability of 1. Enchantments specific to crossbows include [[Quick Charge]], Multishot and Piercing.

===Fuel===
Crossbows can be used as [[fuel]] in [[furnace]]s, [[smelting]] 1.5 [[item]]s per crossbow.

== Sounds ==
{{el|je}}:
{{Sound table
|sound=Crossbow loading start.ogg
|subtitle=Crossbow charges up
|source=player
|description=When a crossbow starts to load
|id=item.crossbow.loading_start
|translationkey=subtitles.item.crossbow.charge
|volume=0.15
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Crossbow quick charge one1.ogg
|sound2=Crossbow quick charge one2.ogg
|sound3=Crossbow quick charge one3.ogg
|subtitle=Crossbow charges up
|source=player
|description=When a Quick Charge I crossbow starts to load <ref group=sound><code>quick1_3</code> occurs at half the frequency as the other sounds</ref>
|id=item.crossbow.quick_charge_1
|translationkey=subtitles.item.crossbow.charge
|volume=''varies'' <ref group=sound>0.325 for all except <code>quick1_1</code> (pitch=0.9), which is 0.25</ref>
|pitch=''varies'' <ref group=sound><code>quick1_1</code> can be 1.0 or 0.9; <code>quick1_2</code> can be 1.0 or 0.95; <code>quick1_3</code> can be 1.0</ref>
|distance=16}}
{{Sound table
|sound=Crossbow quick charge two1.ogg
|sound2=Crossbow quick charge two2.ogg
|sound3=Crossbow quick charge two3.ogg
|subtitle=Crossbow charges up
|source=player
|description=When a Quick Charge II crossbow starts to load <ref group=sound name=quickchargefrequency><code>_1</code> occurs at {{frac|2|3}} the frequency as the other sounds</ref>
|id=item.crossbow.quick_charge_2
|translationkey=subtitles.item.crossbow.charge
|pitch=''varies'' <ref group=sound name=quickchargevolume />
|volume=''varies'' <ref group=sound name=quickchargepitch />
|distance=16}}
{{Sound table
|sound=Crossbow quick charge three1.ogg
|sound2=Crossbow quick charge three2.ogg
|sound3=Crossbow quick charge three3.ogg
|subtitle=Crossbow charges up
|source=player
|description=When a Quick Charge III crossbow starts to load <ref group=sound name=quickchargefrequency />
|id=item.crossbow.quick_charge_3
|translationkey=subtitles.item.crossbow.charge
|volume=''varies'' <ref group=sound name=quickchargevolume>0.325 for all except <code>_1</code> (pitch=0.95), which is 0.25</ref>
|pitch=''varies'' <ref group=sound name=quickchargepitch><code>_1</code> can be 1.0 or 0.95; <code>_2</code> can be 1.0, 0.95, or 1.05; <code>_3</code> can be 1.0, 0.9, or 1.05</ref>
|distance=16}}
{{Sound table
|sound=Crossbow loading middle1.ogg
|sound2=Crossbow loading middle2.ogg
|sound3=Crossbow loading middle3.ogg
|sound4=Crossbow loading middle4.ogg
|subtitle=MC-203146
|source=player
|description=While a crossbow is loading <ref group=sound><code>loading_middle4</code> occurs at {{frac|1|4}} the frequency as the other sounds</ref>
|id=item.crossbow.loading_middle
|translationkey=-
|volume=0.325
|pitch=''varies'' <ref group=sound><code>loading_middle1</code> can be 1.0, 0.95, or 1.2; <code>loading_middle2</code> and <code>loading_middle3</code> can be 1.0, 0.9, or 1.05; <code>loading_middle4</code> can be 1.0</ref>
|distance=16}}
{{Sound table
|sound=Crossbow loading end.ogg
|subtitle=Crossbow loads
|source=dependent
|description=When a crossbow stops loading
|id=item.crossbow.loading_end
|translationkey=subtitles.item.crossbow.load
|volume=1.0
|pitch={{frac|13|15}}-1.2
|distance=16}}
{{Sound table
|sound=Crossbow shoot1.ogg
|sound2=Crossbow shoot2.ogg
|sound3=Crossbow shoot3.ogg
|subtitle=Crossbow fires
|source=dependent
|description=When a crossbow fires
|id=item.crossbow.shoot
|translationkey=subtitles.item.crossbow.shoot
|volume=0.8/0.9/0.9
|pitch=1.0/1.0/0.9 <ref group=sound>Multiplied by the loading percentage of the crossbow</ref>
|distance=16}}
{{Sound table
|sound=Arrow hit1.ogg
|sound2=Arrow hit2.ogg
|sound3=Arrow hit3.ogg
|sound4=Arrow hit4.ogg
|subtitle=Arrow hits
|source=neutral
|description=When an arrow hits a block or entity
|id=item.crossbow.hit
|translationkey=subtitles.item.crossbow.hit
|volume=1.0
|pitch={{frac|12|11}}-{{frac|4|3}}
|distance=16}}
{{Sound table
|sound=Succesfull Hit.ogg
|subtitle=Player hit
|source=player
|description=When an arrow shot by a player hits another player
|id=entity.arrow.hit_player
|translationkey=subtitles.entity.arrow.hit_player
|volume=0.18
|pitch=0.45
|distance=16}}
{{Sound table
|sound=Firework launch.ogg
|subtitle=Firework launches
|source=ambient
|description=When a crossbow fires a firework rocket
|id=entity.firework_rocket.launch
|translationkey=subtitles.entity.firework_rocket.launch
|volume=3.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=dependent
|description=When a crossbow's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Crossbow loading start.ogg
|source=player
|description=When a crossbow starts to load
|id=crossbow.loading.start
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow loading middle1.ogg
|sound2=Crossbow loading middle2.ogg
|sound3=Crossbow loading middle3.ogg
|sound4=Crossbow loading middle4.ogg
|source=player
|description=While a crossbow is loading and when a crossbow stops loading
|id=crossbow.loading.middle
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow loading end.ogg
|source=player
|description=''Unused sound event''
|id=crossbow.loading.end
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow quick charge one1.ogg
|sound2=Crossbow quick charge two1.ogg
|sound3=Crossbow quick charge three1.ogg
|source=player
|description=When a crossbow with Quick Charge starts to load
|id=crossbow.quick_charge.start
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow quick charge one2.ogg
|sound2=Crossbow quick charge two2.ogg
|sound3=Crossbow quick charge three2.ogg
|source=player
|description=While a crossbow with Quick Charge is loading
|id=crossbow.quick_charge.middle
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow quick charge one3.ogg
|sound2=Crossbow quick charge two3.ogg
|sound3=Crossbow quick charge three3.ogg
|source=player
|description=When a crossbow with Quick Charge stops loading
|id=crossbow.quick_charge.end
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Crossbow shoot1.ogg
|sound2=Crossbow shoot2.ogg
|sound3=Crossbow shoot3.ogg
|source=player
|description=When a crossbow fires
|id=crossbow.shoot
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Arrow hit1.ogg
|sound2=Arrow hit2.ogg
|sound3=Arrow hit3.ogg
|sound4=Arrow hit4.ogg
|source=player
|description=When an arrow hits a block or entity
|id=random.bowhit
|volume=1.0
|pitch=1.09-1.3}}
{{Sound table
|sound=Firework launch.ogg
|source=ambient
|description=When a crossbow fires a firework rocket
|id=firework.launch
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a crossbow's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Crossbow
|spritetype=item
|nameid=crossbow
|id=575
|form=item
|foot=1}}

===Item data===

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview" style="margin-top: 0;">
*{{nbt|compound|tag}}: The '''tag''' tag.
{{:Player.dat_format/Crossbow}}
</div>

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

==Achievements==
{{load achievements|Sniper Duel;Archer;Bullseye}}

==Advancements==
{{load advancements|Take Aim;Bullseye;Sniper Duel;Ol' Betsy;Who's the Pillager Now;Two Birds;Arbalistic}}

==History==
{{History||September 29, 2018|link={{tweet|Minecraft|1046094916902965249}}|Crossbows are announced at [[MINECON Earth 2018]].}}
{{History|java}}
{{History||1.14|snap=18w43a|[[File:Crossbow.png|32px]] [[File:Crossbow Pull 0.png|32px]] [[File:Crossbow Pull 1.png|32px]] [[File:Crossbow Pull 2.png|32px]] [[File:Arrow Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] [[File:Crossbow Pull 0.png|32px]] [[File:Crossbow Pull 1.png|32px]] [[File:Crossbow Pull 2.png|32px]] [[File:Firework Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] Added crossbows.
|Crossbows can be enchanted with either the [[Quick Charge]] (Highest Level III), [[Piercing]] (Highest Level IV) or [[Multishot]] (Highest Level I).}}
{{History|||snap=18w47a|Crossbows can now be found inside loot [[chest]]s at the top of [[pillager outpost]]s.}}
{{History|||snap=19w11a|Fletcher [[villager]]s now [[trading|sell]] crossbows and enchanted crossbows.}}
{{History||1.16|snap=20w07a|[[File:Piglin with Crossbow.png|32px]] [[File:Piglin left handed with Crossbow.png|35px]] [[File:Piglin using one hand to hold a loaded crossbow JE1.png|35px]] Added [[piglin]]s, which can spawn with and [[drops|drop]] crossbows.}}
{{History|||snap=20w16a|Crossbows now generate randomly enchanted in [[bastion remnants]] chests.}}
{{History||1.18|snap=21w37a|Crossbow durability is increased to 465 to match {{edition|BE}}.}}
{{History||1.19.4|snap=23w07a|The crossbow recipes are no longer unlocked by [[stick]]s.}}
{{History|upcoming java}}
{{History||Villager Trade Rebalance<br>(Experimental)|link=Java Edition 1.20.2|snap=23w31a|Enchantments exclusive to crossbows are no longer obtainable from villager [[trading]].}}

{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.10|[[File:Crossbow.png|32px]] [[File: Crossbow Pull 0.png|32px]] [[File: Crossbow Pull 1.png|32px]] [[File: Crossbow Pull 2.png|32px]] [[File:Arrow Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] [[File:Crossbow Pull 0.png|32px]] [[File:Crossbow Pull 1.png|32px]] [[File:Crossbow Pull 2.png|32px]] [[File:Firework Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] Added crossbows.
|Crossbows are currently apart of [[Experimental Gameplay]].}}
{{History||1.9.0|snap=beta 1.9.0.0|Added [[pillager]]s, which use and [[drops|drop]] crossbows.}}
{{History|||snap=beta 1.9.0.3|Crossbows now appear bigger in a pillager's hand.}}
{{History||1.10.0|snap=beta 1.10.0.3|Crossbows are now fully implemented and separate from [[Experimental Gameplay]].
|Crossbows can now be found in [[pillager outpost]] [[chest]]s.}}
{{History||1.11.0|snap=beta 1.11.0.4|Unenchanted and [[enchanting|enchanted]] crossbows can now be [[trading|bought]] from fletcher [[villager]]s.}}
{{History||1.12.0|snap=beta 1.12.0.3|Journeyman-level fletcher villagers now have 100% chance to [[trading|sell]] unenchanted crossbow, rather than 50% chance.}}
{{History||1.16.0|snap=beta 1.16.0.51|[[File:Piglin with Crossbow BE.png|32px]] Added [[piglin]]s, which can spawn with and [[drops|drop]] crossbows.}}
{{History|||snap=beta 1.16.0.57|Crossbows now generate randomly enchanted in [[bastion remnants]] chests.}}

{{History|PS4}}
{{History||1.90|[[File:Crossbow.png|32px]] [[File: Crossbow Pull 0.png|32px]] [[File: Crossbow Pull 1.png|32px]] [[File: Crossbow Pull 2.png|32px]] [[File:Arrow Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] [[File:Crossbow Pull 0.png|32px]] [[File:Crossbow Pull 1.png|32px]] [[File:Crossbow Pull 2.png|32px]] [[File:Firework Loaded Crossbow.png|32px]] [[File:Crossbow.png|32px]] Added crossbows.}}
{{History|foot}}

==Issues==
{{issue list}}

==Trivia==
*Alongside [[pillager]]s, crossbows were inspired by ''[[Minecraft Dungeons]]'', even though they were added in the base game first.<ref>{{cite|url=https://discord.com/channels/579770991056519194/818903542139453480/819631528593588244| title = March 2021 developper Q&A|website=discord.com|date=March 11, 2021}}</ref>
*Crossbows [[enchanting|enchanted]] with [[Quick Charge]] VI and above get stuck on the first frame on the recharging animation because the resulting charge time is negative, and the game never reaches the time markers that tell it to advance the animation or the reloading procedure itself. It is technically possible to charge such crossbows, but this would require overflowing the value that determines how long the crossbow has been charged. This takes such an amount of time that this is practically impossible: for example, charging a crossbow with Quick Charge VI would take 69.4 years to complete.
*Although Piercing allows arrows to bypass [[shield]]s, they can't get through the wither armor.
*The crossbow's first-person loading animation in [[Bedrock Edition]] is different from [[Java Edition]].
*Even if a crossbow is already wound with a projectile, when it drops on the ground, it always looks uncharged.<ref>{{bug|MC-137552}}</ref>
*In real life, crossbows don't shoot the same arrows as bows, rather they shoot shorter, thicker, and oftentimes fletchless arrows (usually called "bolts") made to withstand the crossbow's increased power, which can shatter conventional arrows.

==Gallery==
<gallery>
File:CrossbowMinecon.png|A crossbow shown at [[MINECON Earth 2018]].
File:PillagerMinecon.png|A [[pillager]] armed with a crossbow, shown at MINECON Earth 2018.
File:EquippingCrossbow.png|How the crossbow is equipped.
File:Enchanted_Crossbow.gif|An enchanted crossbow.
File:Steve_Charging_Crossbow.gif|Steve charging crossbow {{in|java}}.
File:Alex_Charging_Crossbow.gif|Alex charging crossbow {{in|java}}.
File:Pillager_Charging_Crossbow.gif|Pillager charging crossbow.
File:Piglin_Charging_Crossbow.gif|Piglin charging crossbow.
File:Crossbow_(MCD).png|The ''Minecraft Dungeons'' variant of the crossbow
</gallery>

== References ==
{{reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--crossbow Taking Inventory: Crossbow] – Minecraft.net on October 20, 2022

{{Items}}

[[Category:Combat]]
[[Category:Renewable resources]]

[[de:Armbrust]]
[[es:Ballesta]]
[[fr:Arbalète]]
[[it:Balestra]]
[[ja:クロスボウ]]
[[ko:쇠뇌]]
[[pl:Kusza]]
[[pt:Besta]]
[[ru:Арбалет]]
[[th:หน้าไม้]]
[[zh:弩]]</li><li>[[Bowl|Bowl]]<br/>{{Item
| image = Bowl.png‎
| renewable = Yes
| stackable = Yes (64)
}}
'''Bowls''' are containers that can hold certain [[food]]s.

== Obtaining ==
=== Crafting ===
{{Crafting
|A2= Any Planks
|C2= Any Planks     
|B3= Any Planks
|Output= Bowl,4
|type= Material
}}

=== Fishing ===
Bowls can be obtained as a "junk" item while [[fishing]].

=== Eating ===
A bowl containing food becomes an empty bowl when the food is eaten. 

=== Mob loot ===
When a [[turtle]] is killed by a [[Thunderstorm#Lightning|lightning bolt]], it drops 1 bowl.<ref name=BowlReport>{{Cite bug|MC|125562|Turtles drop bowls when killed by lightning|date=February 16, 2018}}</ref><ref>{{Cite bug|MCPE|57038| Turtles killed by lightning drop Bowls.|date=November 17, 2019}}</ref>

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Mooshrooms ===

{{control|use|text=Using}} a bowl on a [[mooshroom]] turns the bowl into [[mushroom stew]] or [[suspicious stew]]. The stew can then be consumed immediately and the process repeated, making this an excellent way to quickly restore depleted [[hunger]] and [[saturation]] with almost no cost or effort.

=== Fuel ===
Bowls can be used as a fuel in [[furnace]]s, smelting 0.5 items per bowl {{in|je}}, and 1 item per bowl {{in|be}}.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Bowl
|spritetype=item
|nameid=bowl
|id=321
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100130|[[File:Bowl JE1 BE1.png|32px]] Added bowls.
|Bowls are used to craft [[mushroom soup]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Added [[mooshroom]]s, which can be {{control|use|text=milked}} with a bowl.}}
{{History||1.2.4|snap=release|[[Spruce planks]], [[birch planks]], and [[jungle planks]] can now be used to craft bowls.}}
{{History||1.7.2|snap=13w36a|Bowls can now be obtained as one of the "junk" [[item]]s by [[fishing]].}}
{{History|||snap=1.7.1|[[Acacia planks]] and [[dark oak planks]] can now be used to craft bowls.}}
{{History||1.8|snap=14w27a|Bowls are now used to craft [[rabbit stew]].}}
{{History||1.9|snap=15w31a|Bowls are now used to craft [[beetroot soup]].}}
{{History||1.11|snap=16w33a|Bowls can now be used to fuel [[furnace]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 281.}}
{{History|||snap=18w07a|[[Turtles]] drop 0 to 1 bowls if killed by [[lightning]].<ref name=BowlReport/>}}
{{History||1.14|snap=18w43a|[[File:Bowl JE2 BE2.png|32px]] The texture of bowls has now been changed.
|Bowls are now used to craft [[suspicious stew]].}}
{{History||1.16|snap=20w06a|[[Crimson planks]] and [[warped planks]] can now be used to craft bowls.}}
{{History||1.19|snap=22w11a|[[Mangrove planks]] can now be used to craft bowls.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Bowl JE1 BE1.png|32px]] Added bowls. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.0|Bowls are now [[craft]]able. They still serve no purpose.}}
{{History||v0.4.0|Bowls are now used to craft [[mushroom stew]].}}
{{History||v0.5.0|Bowls now appear in the [[nether reactor]].}}
{{History||v0.8.0|snap=build 2|Bowls are now used to craft [[beetroot soup]].}}
{{History|||snap=build 7|Bowls can now be used as fuel in a [[furnace]].}}
{{History||v0.9.0|snap=build 1|Added bowls to [[creative]] mode.
|[[Mooshroom]]s can now be "milked" to obtain [[mushroom stew]].}}
{{History||v0.12.1|snap=build 1|Bowls are no longer available from the [[nether reactor]].}}
{{History||v0.13.0|snap=build 1|Bowls are now used to craft [[rabbit stew]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Bowl JE2 BE2.png|32px]] The texture of bowls has now been changed.}}
{{History||1.13.0|snap=beta 1.13.0.9|Bowls can now be used to craft [[suspicious stew]].}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Bowl JE1 BE1.png|32px]] Added bowls.}}
{{History||xbox=TU9|Bowls now stack to 64.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Bowl JE2 BE2.png|32px]] The texture of bowls has now been changed.}}

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

== Issues ==
{{issue list}}

== Trivia ==
* {{in|be}}, bowls are actually more fuel efficient than [[stick]]s. If 6 wood planks are crafted into 8 bowls, 8 items can be [[smelt]]ed; but if those are crafted into 12 sticks, only 6 items can be smelted. This can be useful when the player only has access to Nether wood types, which cannot be used as fuel.

== See also ==
* [[Mushrooms]]

== References ==
{{reflist}}

== External Links ==
* {{Mcnet|taking-inventory--bowl|Taking Inventory: Bowl|April 25, 2019}}

{{Items}}

[[Category:Renewable resources]]

[[cs:Miska]]
[[de:Schüssel]]
[[es:Cuenco]]
[[fr:Bol]]
[[hu:Tál]]
[[it:Ciotola]]
[[ja:ボウル]]
[[ko:그릇]]
[[nl:Kom]]
[[pl:Miska]]
[[pt:Tigela]]
[[ru:Миска]]
[[th:ชาม]]
[[uk:Миска]]
[[zh:碗]]</li></ul>
15w31aUV is now optional, and if not supplied it automatically generates based on the element's position.
Added different models/textures for different damage values, item states, and whether the player is left handed. This works on compasses, clocks, and anything that can have a durability bar. It also contains additional tags for bows and fishing rods.
Models can now be put together based on block state attributes, such as fences. As a result, the vanilla set of block models was reduced by almost 300 models.
Block model JSON is now strict, comments and quoteless identifiers are now not allowed.
"display" tag defaults have now been changed, and the "thirdperson" and "firstperson" tags have now been replaced with "thirdperson_righthand", "thirdperson_lefthand", "firstperson_righthand", and "firstperson_lefthand".
"parent" and "elements" tags can now coexist, though the top level elements tag overwrites all former ones.
The option to disable alternate block models has now been removed.
Multipart tag functionality added.
1.14
{{Extension DPL}}<ul><li>[[Glow Ink Sac|Glow Ink Sac]]<br/>{{For|the regular sac dropped by squids|Ink Sac}}
{{Item
|Image=Glow Ink Sac.png
| renewable = Yes
| stackable = Yes (64)
|}}

A '''glow ink sac''' is an item dropped by a [[glow squid]] upon death. Unlike regular ink sacs, it can be added to [[sign]]s to make glowing text, and can be used to craft glow item frames.

== Obtaining ==
=== Mob loot ===
[[Glow squid]]s drop 1–3 glow ink sacs upon death. The maximum amount is increased by 1 per level of [[Looting]], for a maximum of 1–6 with Looting III.

=== Compound creation ===
A glow ink sac can be created from its base [[element]]s, using the [[compound creator]].{{only|bedrock|education}}

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

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

=== Signs ===
[[File:Glow Ink Sign with Orange Dye JE2.png|thumb|150px|An oak sign with a glow ink sac used on it.]]
Glow ink sacs can be used on [[sign]]s or [[hanging sign]]s to make their text brighter in low light levels. This also adds an outline around the text on the sign, the color of which is based on the color of the sign's text. The text does not emit any light, it is only more visible in darkness, similarly to the eyes of spiders and endermen. Normal [[ink sacs]] can be applied to revert glowing text back to default.

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Ink sac1.ogg
|sound2=Ink sac2.ogg
|sound3=Ink sac3.ogg
|subtitle=Glow Ink Sac splotches
|source=block
|description=When a glow ink sac is used on a [[sign]]
|id=item.glow_ink_sac.use
|translationkey=subtitles.item.glow_ink_sac.use
|volume=1.0
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.95, or 1.05</ref>
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Ink sac1.ogg
|sound2=Ink sac2.ogg
|sound3=Ink sac3.ogg
|source=sound
|description=When a glow ink sac is used on a sign
|id=sign.ink_sac.use
|volume=1.0
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Glow Ink Sac
|spritetype=item
|nameid=glow_ink_sac
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Glow Ink Sac
|spritetype=item
|nameid=glow_ink_sac
|form=item
|id=503
|foot=1}}

== Advancements ==
{{load advancements|Glow and Behold}}

== History ==
{{History|java}}
{{History||1.17|snap=21w03a|[[File:Glow Ink Sac JE1 BE1.png|32px]] Added glow ink sacs.}}
{{History||1.17.1|snap=Pre-release 1|[[Zombie]]s, [[husk]]s, [[zombie villager]]s, and [[drowned]] no longer pick up [[glow ink sac]]s.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Glow ink sacs can now be used to make the text glow on a [[hanging sign]].}}

{{History|bedrock}}
{{History||Caves & Cliffs (experimental)|link=Bedrock Edition 1.17.0|snap=beta 1.16.210.59|[[File:Glow Ink Sac JE1 BE1.png|32px]] Added glow ink sacs.}}
{{History|||snap=beta 1.16.210.60|Glow ink sacs have been removed temporarily.}}
{{History|||snap=beta 1.16.220.50|[[File:Glow Ink Sac JE1 BE1.png|32px]] Re-added glow ink sacs.}}
{{History||1.17.0|snap=beta 1.17.0.52|Glow ink sacs are now available without enabling [[experimental gameplay]].}}
{{History||1.17.30|snap=beta 1.17.30.20|[[Zombie]]s, [[husk]]s, [[zombie villager]]s, and [[drowned]] no longer pick up [[glow ink sac]]s.}}
{{History|foot}}

== Issues ==
{{Issue list}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--glow-ink-sac Taking Inventory: Glow Ink Sac] – Minecraft.net on October 14, 2021

{{Items}}

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

[[de:Leuchttintenbeutel]]
[[es:Saco de tinta luminosa]]
[[it:Sacca d'inchiostro luminescente]]
[[ja:輝くイカスミ]]
[[pl:Torbiel ze świecącym atramentem]]
[[pt:Bolsa de tinta brilhante]]
[[ru:Светящийся чернильный мешок]]
[[uk:Сяйний чорнильний мішок]]
[[zh:荧光墨囊]]</li><li>[[Flower Pot|Flower Pot]]<br/>{{more images|The potted cherry sapling texture has been change in 1.19.4-pre2.}}
{{For|other uses|Pot}}
{{Block
| image = Flower Pot.png
| image2 = Potted Poppy.png
| extratext = View [[#Gallery|all renders]]
| transparent = Yes
| light = No
| tool = any
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = No
}}

A '''flower pot''' is a decorative [[block]] that can contain flowers, bamboo, saplings, cacti, mushrooms, fungi, and other reasonably small plants.

== Obtaining ==
=== Natural generation ===
Flower pots naturally generate in [[witch hut]]s where they contain a red [[mushroom]], the basement of [[igloo]]s where they contain a [[cactus]], and in [[woodland mansion]]s, where they contain birch [[sapling]]s, dark oak saplings, dandelions, poppies, blue orchids, alliums, azure bluets, red and white tulips, and oxeye daisies.

Flower pots containing a dandelion can be found in some [[plains]] and [[savanna]] [[village]] houses. Flower pots containing a cactus or a dead bush can be found in some [[desert]] village houses. Flower pots containing a spruce sapling can be found in [[taiga]] village mason houses. Flower pots containing a poppy can be found in taiga village churches.

=== Breaking ===
Flower pots can be mined instantly using any [[tool]] or without a tool.

A flower pot drops itself as an [[item]] (any [[plant]] or [[mushroom]] in it separately) when pushed by a [[piston]] or washed away with [[water]].

[[Lava]] can flow into the space of a flower pot, destroying it.

=== Chest loot ===
{{LootChestItem|flower-pot}}

=== Crafting ===
{{Crafting
|A2= Brick
|C2= Brick
|B3= Brick
|Output= Flower Pot
|type= Decoration block
}}

== Usage ==
A flower pot can be used to hold [[mushroom]]s, [[Fungus|fungi]], and various [[plant]]s. Plants that can be {{control|placed}} in a pot include any one block high [[flower]]s, [[sapling]]s, [[fern]]s, [[dead bush]]es, [[cacti]], [[bamboo]], [[azalea]]s, [[mangrove propagule]], and [[roots]].

Plants can be removed by using the interact button.

{{IN|je}}, flower pots can be placed on any block, or over [[air]].<ref>{{bug|MC-127036|||WAI}}</ref>

{{IN|be}}, they must be placed on top of a full-[[block]] top surface, or the top of a [[fence]], stone [[wall]], or [[hopper]]. They cannot be placed on [[slab]]s and [[stairs]] unless those blocks are upside-down. Pots may also be placed on an upward facing trapdoor. If the trapdoor is opened, the pot will break.

Flower pots are {{frac|3|8}} of a block high and can be stepped on. It is not possible to walk from the top of a flower pot onto a full sized block without jumping. It is possible to jump from a flower pot onto a fence.
 
The plant or fungus can be removed from the flower pot by pressing the {{control|use}} control. This places the item directly back into the player's inventory.<ref>{{bug|MC-169496|||WAI}}</ref>

They can be used to display cacti and wither roses without inheriting their damaging properties.<ref>{{bug|MC-2241|||WAI}}</ref><ref>{{bug|MC-138024|||WAI}}</ref>

Potted [[Fungus|warped fungus]] can be used to repel [[hoglin]]s.

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

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Flower Pot
|spritetype=block
|nameid=flower_pot
|blocktags=flower_pots
|translationkey=block.minecraft.flower_pot,item.minecraft.flower_pot}}
{{ID table
|displayname=Potted Dandelion
|spritetype=block
|nameid=potted_dandelion
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Poppy
|spritetype=block
|nameid=potted_poppy
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Blue Orchid
|spritetype=block
|nameid=potted_blue_orchid
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Allium
|spritetype=block
|nameid=potted_allium
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Azure Bluet
|spritetype=block
|nameid=potted_azure_bluet
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Red Tulip
|spritetype=block
|nameid=potted_red_tulip
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Orange Tulip
|spritetype=block
|nameid=potted_orange_tulip
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted White Tulip
|spritetype=block
|nameid=potted_white_tulip
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Pink Tulip
|spritetype=block
|nameid=potted_pink_tulip
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Oxeye Daisy
|spritetype=block
|nameid=potted_oxeye_daisy
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Cornflower
|spritetype=block
|nameid=potted_cornflower
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Lily of the Valley
|spritetype=block
|nameid=potted_lily_of_the_valley
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Wither Rose
|spritetype=block
|nameid=potted_wither_rose
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Oak Sapling
|spritetype=block
|nameid=potted_oak_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Spruce Sapling
|spritetype=block
|nameid=potted_spruce_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Birch Sapling
|spritetype=block
|nameid=potted_birch_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Jungle Sapling
|spritetype=block
|nameid=potted_jungle_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Acacia Sapling
|spritetype=block
|nameid=potted_acacia_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Dark Oak Sapling
|spritetype=block
|nameid=potted_dark_oak_sapling
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Red Mushroom
|spritetype=block
|nameid=potted_red_mushroom
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Brown Mushroom
|spritetype=block
|nameid=potted_brown_mushroom
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Fern
|spritetype=block
|nameid=potted_fern
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Dead Bush
|spritetype=block
|nameid=potted_dead_bush
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Cactus
|spritetype=block
|nameid=potted_cactus
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Bamboo
|spritetype=block
|nameid=potted_bamboo
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Azalea
|spritetype=block
|nameid=potted_azalea_bush
|blocktags=flower_pots
|spritename=potted azalea bush
|form=block}}
{{ID table
|displayname=Potted Flowering Azalea
|spritetype=block
|nameid=potted_flowering_azalea_bush
|blocktags=flower_pots
|spritename=potted flowering azalea bush
|form=block}}
{{ID table
|displayname=Potted Crimson Fungus
|spritetype=block
|nameid=potted_crimson_fungus
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Warped Fungus
|spritetype=block
|nameid=potted_warped_fungus
|blocktags=flower_pots, hoglin_repellents
|form=block}}
{{ID table
|displayname=Potted Crimson Roots
|spritetype=block
|nameid=potted_crimson_roots
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Warped Roots
|spritetype=block
|nameid=potted_warped_roots
|blocktags=flower_pots
|form=block}}
{{ID table
|displayname=Potted Mangrove Propagule
|spritetype=block
|nameid=potted_mangrove_propagule
|blocktags=flower_pots
|form=block
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Flower Pot
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=flower-pot
|spritetype=block
|nameid=flower_pot
|id=140
|form=block
|itemform=item.flower_pot
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=flower-pot
|spritetype=item
|nameid=flower_pot
|id=514
|form=item
|foot=1}}

=== Block states ===
{{see also|Block states}}
{{IN|be}}, flower pots use the following block states:

{{/BS}}

=== Block data ===
{{IN|bedrock}}, flower pot has a block entity associated with it that holds additional data about the block.

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

== Achievements ==
{{load achievements|Pot Planter}}

== History ==
{{History||August 16, 2012|link={{tweet|Dinnerbone|236062188555624448}}|[[Dinnerbone]] tweeted the first image of flower pots.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|[[File:Flower Pot JE1.png|32px]] [[File:Potted Dandelion JE1.png|32px]] [[File:Potted Rose JE1.png|32px]] [[File:Potted Red Mushroom JE1.png|32px]] [[File:Potted Brown Mushroom JE1.png|32px]] [[File:Potted Oak Sapling JE1.png|32px]] [[File:Potted Birch Sapling JE1.png|32px]] [[File:Potted Spruce Sapling JE1.png|32px]] [[File:Potted Jungle Sapling JE1.png|32px]] [[File:Potted Cactus JE1.png|32px]] [[File:Potted Fern JE1.png|32px]] [[File:Potted Dead Bush JE1.png|32px]]<br>[[File:Flower Pot (item) JE1 BE1.png|32px]] Added flower pots.
|At this point, plants inside of pots rendered much like they do outside of flower pots, not being subject to directional shading.}}
{{History|||snap=12w40a|A potted [[red mushroom]] can now be found on one window of a [[witch hut]]. This changed to an empty pot in a far later unknown version,{{info needed}} but returned again afterward.{{info needed}}}}
{{History||1.7.2|snap=13w36a|[[File:Potted Allium JE1.png|32px]] [[File:Potted Azure Bluet JE1.png|32px]] [[File:Potted Oxeye Daisy JE1.png|32px]] [[File:Potted Blue Orchid JE1.png|32px]] [[File:Potted Red Tulip JE1.png|32px]] [[File:Potted Orange Tulip JE1.png|32px]] [[File:Potted White Tulip JE1.png|32px]] [[File:Potted Pink Tulip JE1.png|32px]] Allium, azure bluet, oxeye daisies, blue orchids, red tulips, orange tulips, white tulips and pink tulips can now be placed in flower pots.
|[[File:Potted Poppy JE1.png|32px]] As the rose has been replaced with the poppy, the potted rose is also now replaced with the potted poppy as a result.
|Flower pots can no longer use data values because more than 15 plants can be potted, it now has a [[block entity]] instead.
|[[File:Potted Green Shrub.png|32px]] [[File:Potted Cobweb JE1.png|32px]] Due to the tile entity handling, it is now possible to place any [[block]] inside of a flower pot via NBT editors. However, at this point, with the ones possible in vanilla [[survival]] aside, only [[grass]], [[shrub|green shrub]]s, and [[cobweb]]s actually render.
|[[File:Potted Grass JE1.png|32px]] Potted grass now exists can be placed in flower pots using [[commands]].
|[[File:Potted Grass (no tint) JE1.png|32px]] [[File:Potted Fern (no tint) JE1.png|32px]] Potted shrubs, grass, and ferns must now have block data value 11 to display biome colors, otherwise rendering as default/gray.}}
{{History|||snap=13w37a|Added {{cmd|setblock}}, allowing for the aforementioned potted plants to be obtained without map editing.}}
{{History|||snap=13w43a|[[File:Potted Acacia Sapling JE1.png|32px]] [[File:Potted Dark Oak Sapling JE1.png|32px]] Acacia sapling and dark oak saplings can now be placed in flower pots.}}
{{History||1.8|snap=14w06a|Many more blocks (almost all full cubes) placed into a flower pot by modifying the block entity now render, if in somewhat buggy fashion, as the texture is in a cross shape. {{LoadPage|Flower Pot/1.8 development gallery/14w06a|Click show to display all of the applicable blocks.|b}}
|[[File:Potted Cactus JE2.png|32px]] Potted cacti now appear as a cross formed of their bottom texture inside of a pot.<ref>{{bug|MC-47469}}</ref>}}
{{History|||snap=14w06b|Further blocks now render in flower pots than did in the previous snapshot. {{LoadPage|Flower Pot/1.8 development gallery/14w06b|Click show to display all of the applicable blocks.|b}}
|[[File:Potted Cactus JE3.png|32px]] The accidental potted cactus model change has been reverted.}}
{{History|||snap=14w07a|[[File:Potted Iron Trapdoor.png|32px]] The newly added [[iron trapdoor]] also renders in flower pots when created with commands.}}
{{History|||snap=14w17a|[[File:Flower Pot JE2.png|32px]] [[File:Potted Dandelion JE2.png|32px]] [[File:Potted Allium JE2.png|32px]] [[File:Potted Azure Bluet JE2.png|32px]] [[File:Potted Oxeye Daisy JE2.png|32px]] [[File:Potted Blue Orchid JE2.png|32px]] [[File:Potted Poppy JE2.png|32px]] [[File:Potted Red Tulip JE2.png|32px]] [[File:Potted Orange Tulip JE2.png|32px]] [[File:Potted White Tulip JE2.png|32px]] [[File:Potted Pink Tulip JE2.png|32px]] [[File:Potted Red Mushroom JE2.png|32px]] [[File:Potted Brown Mushroom JE2.png|32px]] [[File:Potted Oak Sapling JE2.png|32px]] [[File:Potted Birch Sapling JE2.png|32px]] [[File:Potted Spruce Sapling JE2.png|32px]] [[File:Potted Jungle Sapling JE2.png|32px]] [[File:Potted Acacia Sapling JE2.png|32px]] [[File:Potted Dark Oak Sapling JE2.png|32px]] [[File:Potted Cactus JE4.png|32px]] [[File:Potted Fern JE2.png|32px]] [[File:Potted Dead Bush JE2.png|32px]] The flower pot model and rendering has changed. The insides are now subject to directional shading, rather than being fully lit, much like the changes made to [[hopper]]s and [[cauldron]]s in 14w10a. In addition, the outer face (as well as the cuboids comprising the cactus in potted cactus) are no longer subject to ambient occlusion. The potted cactus also now uses the side texture on the top face, rather than the top texture.
|Invalid blocks no longer render inside flower pots. This also includes cobweb and grass.}}
{{History|||snap=14w25a|[[File:Potted Dandelion JE3.png|32px]] [[File:Potted Allium JE3.png|32px]] [[File:Potted Azure Bluet JE3.png|32px]] [[File:Potted Oxeye Daisy JE3.png|32px]] [[File:Potted Blue Orchid JE3.png|32px]] [[File:Potted Poppy JE3.png|32px]] [[File:Potted Red Tulip JE3.png|32px]] [[File:Potted Orange Tulip JE3.png|32px]] [[File:Potted White Tulip JE3.png|32px]] [[File:Potted Pink Tulip JE3.png|32px]] [[File:Potted Red Mushroom JE3.png|32px]] [[File:Potted Brown Mushroom JE3.png|32px]] [[File:Potted Oak Sapling JE3.png|32px]] [[File:Potted Birch Sapling JE3.png|32px]] [[File:Potted Spruce Sapling JE3.png|32px]] [[File:Potted Jungle Sapling JE3.png|32px]] [[File:Potted Acacia Sapling JE3.png|32px]] [[File:Potted Dark Oak Sapling JE3.png|32px]] [[File:Potted Fern JE3.png|32px]] [[File:Potted Dead Bush JE3.png|32px]] Potted cross shaped objects are now affected by directional shading.<ref>{{bug|MC-129826}}</ref>}}
{{History||1.9|snap=15w43a|A potted cactus can now be found on a table in [[igloo]] basements.}}
{{History||1.11|snap=16w32a|The block entity ID of flower pots has been changed from <code>FlowerPot</code> to <code>flower_pot</code>.}}
{{History|||snap=16w39a|Potted plants can now be removed from flower pots by pressing {{control|use}}.
|Flower pots now generate in [[woodland mansion]]s.}}
{{History||1.13|snap=17w47a|The different block states for the <code>flower_pot</code> ID have been split up into their own IDs.
|Flower pots are no longer block entities.
|Prior to [[1.13/Flattening|''The Flattening'']], this block's numeral ID was 140, and the item's was 390.}}
{{History||1.14|snap=18w43a|[[File:Flower Pot JE3.png|32px]] [[File:Potted Dandelion JE4.png|32px]] [[File:Potted Poppy JE4.png|32px]] [[File:Potted Allium JE4.png|32px]] [[File:Potted Azure Bluet JE4.png|32px]] [[File:Potted Oxeye Daisy JE4.png|32px]] [[File:Potted Blue Orchid JE4.png|32px]] [[File:Potted Red Tulip JE4.png|32px]] [[File:Potted Orange Tulip JE4.png|32px]] [[File:Potted White Tulip JE4.png|32px]] [[File:Potted Pink Tulip JE4.png|32px]] [[File:Potted Red Mushroom JE4.png|32px]] [[File:Potted Brown Mushroom JE4.png|32px]] [[File:Potted Oak Sapling JE4.png|32px]] [[File:Potted Birch Sapling JE4.png|32px]] [[File:Potted Spruce Sapling JE4.png|32px]] [[File:Potted Jungle Sapling JE4.png|32px]] [[File:Potted Acacia Sapling JE4.png|32px]] [[File:Potted Dark Oak Sapling JE4.png|32px]] [[File:Potted Cactus JE5.png|32px]] [[File:Potted Fern JE4.png|32px]] [[File:Potted Dead Bush JE4.png|32px]] <br>[[File:Flower Pot (item) JE2 BE2.png|32px]] The textures of flower pots and their contained plants have been changed.
|[[File:Potted Cornflower JE1 BE1.png|32px]] [[File:Potted Lily of the Valley JE1 BE1.png|32px]] [[File:Potted Wither Rose JE1 BE1.png|32px]] [[File:Potted Bamboo JE1 BE1.png|32px]] Cornflower, lily of the valley, wither rose and [[bamboo]] can now be placed in flower pots.}}
{{History|||snap=18w44a|[[File:Potted Cactus JE6.png|32px]] The texture of potted cacti has been changed.}}
{{History|||snap=18w47b|[[File:Potted Poppy JE5.png|32px]] The texture of potted poppies has been changed.}}
{{History|||snap=18w49a|Flower pots can now be found in [[chest]]s in [[village]] mason houses.}}
{{History|||snap=19w11a|Flower pots have become [[renewable resource|renewable]], as mason [[villager]]s now [[trading|sell]] [[brick]]s.}}
{{History||1.16|snap=20w06a|The model of flower pots has been fixed and has been given an underside, which has changed the model from [[File:Flower Pot UNKVER2 (facing NWU).png|32px]] to [[File:Flower Pot UNKVER3 (facing NWU).png|32px]].}}
{{History|||snap=20w09a|[[File:Potted Crimson Fungus JE1 BE1.png|32px]] [[File:Potted Warped Fungus JE1 BE1.png|32px]] [[File:Potted Crimson Roots JE1 BE1.png|32px]] [[File:Potted Warped Roots JE1 BE1.png|32px]] Crimson and warped [[fungi]] and crimson and warped [[roots]] can now be placed in flower pots.
|The model for potted plants has been fixed, so the bottom face now renders,<ref>{{bug|MC-170842}}</ref> which has changed the model from [[File:Potted Dandelion UNKVER1 (facing NWU).png|32px]] [[File:Potted Poppy UNKVER1 (facing NWU).png|32px]] [[File:Potted Allium UNKVER1 (facing NWU).png|32px]] [[File:Potted Azure Bluet UNKVER1 (facing NWU).png|32px]] [[File:Potted Oxeye Daisy UNKVER1 (facing NWU).png|32px]] [[File:Potted Blue Orchid UNKVER1 (facing NWU).png|32px]] [[File:Potted Red Tulip UNKVER1 (facing NWU).png|32px]] [[File:Potted Orange Tulip UNKVER1 (facing NWU).png|32px]] [[File:Potted White Tulip UNKVER1 (facing NWU).png|32px]] [[File:Potted Pink Tulip UNKVER1 (facing NWU).png|32px]] [[File:Potted Red Mushroom UNKVER1 (facing NWU).png|32px]] [[File:Potted Brown Mushroom UNKVER1 (facing NWU).png|32px]] [[File:Potted Oak Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Birch Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Spruce Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Jungle Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Acacia Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Dark Oak Sapling UNKVER1 (facing NWU).png|32px]] [[File:Potted Cactus UNKVER1 (facing NWU).png|32px]] [[File:Potted Fern UNKVER1 (facing NWU).png|32px]] [[File:Potted Dead Bush UNKVER1 (facing NWU).png|32px]] [[File:Potted Cornflower UNKVER1 (facing NWU).png|32px]] [[File:Potted Lily of the Valley UNKVER1 (facing NWU).png|32px]] [[File:Potted Wither Rose UNKVER1 (facing NWU).png|32px]] [[File:Potted Bamboo UNKVER1 (facing NWU).png|32px]] to [[File:Potted Dandelion UNKVER2 (facing NWU).png|32px]] [[File:Potted Poppy UNKVER2 (facing NWU).png|32px]] [[File:Potted Allium UNKVER2 (facing NWU).png|32px]] [[File:Potted Azure Bluet UNKVER2 (facing NWU).png|32px]] [[File:Potted Oxeye Daisy UNKVER2 (facing NWU).png|32px]] [[File:Potted Blue Orchid UNKVER2 (facing NWU).png|32px]] [[File:Potted Red Tulip UNKVER2 (facing NWU).png|32px]] [[File:Potted Orange Tulip UNKVER2 (facing NWU).png|32px]] [[File:Potted White Tulip UNKVER2 (facing NWU).png|32px]] [[File:Potted Pink Tulip UNKVER2 (facing NWU).png|32px]] [[File:Potted Red Mushroom UNKVER2 (facing NWU).png|32px]] [[File:Potted Brown Mushroom UNKVER2 (facing NWU).png|32px]] [[File:Potted Oak Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Birch Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Spruce Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Jungle Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Acacia Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Dark Oak Sapling UNKVER2 (facing NWU).png|32px]] [[File:Potted Cactus UNKVER2 (facing NWU).png|32px]] [[File:Potted Fern UNKVER2 (facing NWU).png|32px]] [[File:Potted Dead Bush UNKVER2 (facing NWU).png|32px]] [[File:Potted Cornflower UNKVER2 (facing NWU).png|32px]] [[File:Potted Lily of the Valley UNKVER2 (facing NWU).png|32px]] [[File:Potted Wither Rose UNKVER2 (facing NWU).png|32px]] [[File:Potted Bamboo UNKVER2 (facing NWU).png|32px]].}}
{{History|||snap=20w11a|[[File:Potted Bamboo UNKVER3 (facing NWU).png|32px]] An unneeded face has been removed from potted bamboo to solve a z-fighting issue.<ref>{{bug|MC-173156}}</ref>}}
{{History|||snap=Pre-release 3|[[File:Potted Cactus JE7.png|32px]] [[File:Potted Cactus UNKVER3 (facing NWU).png|32px]] The model of the potted cacti has been changed. The top face now uses the top texture of cactus, rather than the side texture and the bottom face has been changed to the top texture of the flower pot.}}
{{History||1.16.2|snap=20w28a|[[File:Potted Cactus UNKVER4 (facing NWU).png|32px]] The model of the potted cactus no longer has a hole in the bottom, although the texture is stretched.}}
{{History||1.17|snap=Pre-release 1|[[File:Potted Azalea JE1 BE1.png|32px]] [[File:Potted Flowering Azalea JE1 BE1.png|32px]][[Azalea]] and flowering azalea can now be placed in flower pots.
|[[File:Potted Flowering Azalea (plant texture) JE1.png|32px]] Potted flowering azalea has own unused plant texture but uses normal variant for consistency with flowering azalea: [[File:Potted Flowering Azalea (bottom) JE1 BE1.png|32px]] [[File:Flowering Azalea (bottom) JE2 BE2.png|32px]]}}
{{History||1.19|snap=22w11a|[[File:Potted Mangrove Propagule JE1.png|32px]] [[Mangrove propagule]]s can now be placed in flower pots.}}
{{History|||snap=22w18a|[[File:Potted Mangrove Propagule JE2.png|32px]] The western element of the flower pot in potted mangrove propagules has been deleted.<ref name="mc-251355">{{bug|MC-251355}}</ref>}}
{{History|||snap=Pre-release 1|[[File:Potted Mangrove Propagule JE1.png|32px]] The aforementioned western element has been restored.<ref name="mc-251355"/>}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Potted Torchflower JE1.png|32px]] [[File:Potted Cherry Sapling JE1.png|32px]] [[Torchflower]]s and [[cherry sapling]]s can now be placed in flower pots.}}
{{History|||snap=1.19.4-pre2|Changed the texture of potted cherry saplings.}}
{{History||1.20|snap=23w12a|Potted torchflower and cherry sapling are now available without using the "Update 1.20" experimental datapack.|Flower pot can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w13a|[[File:Potted Flowering Azalea JE2.png|32px]] Flowering azalea now uses own plant texture, changing appearance from [[File:Potted Flowering Azalea (bottom) JE1 BE1.png|32px]] to [[File:Potted Flowering Azalea (bottom) JE2.png|32px]] and breaking consistency with flowering azalea.<ref>{{bug|MC-230916}}</ref>}}
{{History|||snap=23w16a|Flower pot no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; flower pot now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.12.1|snap=build 1|[[File:Flower Pot JE1.png|32px]] [[File:Potted Dandelion JE1.png|32px]] [[File:Potted Red Mushroom JE1.png|32px]] [[File:Potted Brown Mushroom JE1.png|32px]] [[File:Potted Oak Sapling JE1.png|32px]] [[File:Potted Birch Sapling JE1.png|32px]] [[File:Potted Spruce Sapling JE1.png|32px]] [[File:Potted Jungle Sapling JE1.png|32px]] [[File:Potted Cactus JE1.png|32px]] [[File:Potted Fern JE1.png|32px]] [[File:Potted Allium JE1.png|32px]] [[File:Potted Azure Bluet JE1.png|32px]] [[File:Potted Oxeye Daisy JE1.png|32px]] [[File:Potted Blue Orchid JE1.png|32px]] [[File:Potted Poppy JE1.png|32px]] [[File:Potted Red Tulip JE1.png|32px]] [[File:Potted Orange Tulip JE1.png|32px]] [[File:Potted White Tulip JE1.png|32px]] [[File:Potted Pink Tulip JE1.png|32px]] [[File:Potted Acacia Sapling JE1.png|32px]] [[File:Potted Dark Oak Sapling JE1.png|32px]]{{verify|Are these models the ones used in this version?}}<br>[[File:Flower Pot (item) JE1 BE1.png|32px]] Added flower pots.}}
{{History||v0.14.0|snap=build 1|Flower pots now generate in [[witch hut]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Flower pots now generate in [[igloo]] basements.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Flower pots now generate naturally in [[woodland mansion]]s.}}
{{History|bedrock}}
{{History||1.8.0|snap=beta 1.8.0.8|[[File:Potted Bamboo JE1 BE1.png|32px]]{{verify|Is this how they really look in BE?}} [[Bamboo]] can now be placed in flower pots.}}
{{History||1.9.0|snap=beta 1.9.0.0|[[File:Potted Cornflower BE.jpg|32px]] [[File:Potted Lily of the Valley BE.jpg|32px]] Cornflower and lily of the valley can now be placed in flower pots.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Flower Pot BE.jpg|32px]] [[File:Potted Dandelion BE.jpg|32px]] [[File:Potted Poppy BE.jpg|32px]] [[File:Potted Allium BE.jpg|32px]] [[File:Potted Azure Bluet BE.jpg|32px]] [[File:Potted Oxeye Daisy BE.jpg|32px]] [[File:Potted Blue Orchid BE.jpg|32px]] [[File:Potted Red Tulip BE.jpg|32px]] [[File:Potted Orange Tulip BE.jpg|32px]] [[File:Potted White Tulip BE.jpg|32px]] [[File:Potted Pink Tulip BE.jpg|32px]] [[File:Potted Red Mushroom BE.jpg|32px]] [[File:Potted Brown Mushroom BE.jpg|32px]] [[File:Potted Oak Sapling BE.jpg|32px]] [[File:Potted Birch Sapling BE.jpg|32px]] [[File:Potted Spruce Sapling BE.jpg|32px]] [[File:Potted Jungle Sapling BE.jpg|32px]] [[File:Potted Acacia Sapling BE.jpg|32px]] [[File:Potted Dark Oak Sapling BE.jpg|32px]] [[File:Potted Cactus BE.png|32px]] [[File:Potted Fern BE.jpg|32px]]<br>[[File:Flower Pot (item) JE2 BE2.png|32px]] The textures of flower pots have been changed.
|Flower pots now generate in the new [[village]]s.}}
{{History||1.11.0|snap=beta 1.11.0.1|Flower pots can now be found in [[village]] mason [[chest]]s.}}
{{History||1.13.0|snap=beta 1.13.0.9|[[File:Potted Wither Rose JE1 BE1.png|32px]] [[Wither rose]]s can now be placed in flower pots.}}
{{History||1.16.0|snap=beta 1.15.0.51|Potted plants can now be removed from flower pots by pressing {{control|use}}.}}
{{History|||snap=beta 1.16.0.51|[[File:Potted Crimson Fungus JE1 BE1.png|32px]] [[File:Potted Warped Fungus JE1 BE1.png|32px]] [[File:Potted Crimson Roots JE1 BE1.png|32px]] [[File:Potted Warped Roots JE1 BE1.png|32px]] Crimson and warped [[fungi]] and crimson and warped [[roots]] can now be placed in flower pots.}}
{{History||1.17.10|snap=beta 1.17.10.21|[[File:Potted Azalea JE1 BE1.png|32px]] [[File:Potted Flowering Azalea JE1 BE1.png|32px]] [[Azalea]] and flowering azalea can now be placed in flower pots.}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Flower Pot JE1.png|32px]] [[File:Potted Dandelion JE1.png|32px]] [[File:Potted Red Mushroom JE1.png|32px]] [[File:Potted Brown Mushroom JE1.png|32px]] [[File:Potted Oak Sapling JE1.png|32px]] [[File:Potted Birch Sapling JE1.png|32px]] [[File:Potted Spruce Sapling JE1.png|32px]] [[File:Potted Jungle Sapling JE1.png|32px]] [[File:Potted Cactus JE1.png|32px]] [[File:Potted Fern JE1.png|32px]] [[File:Potted Allium JE1.png|32px]] [[File:Potted Azure Bluet JE1.png|32px]] [[File:Potted Oxeye Daisy JE1.png|32px]] [[File:Potted Blue Orchid JE1.png|32px]] [[File:Potted Poppy JE1.png|32px]] [[File:Potted Red Tulip JE1.png|32px]] [[File:Potted Orange Tulip JE1.png|32px]] [[File:Potted White Tulip JE1.png|32px]] [[File:Potted Pink Tulip JE1.png|32px]] [[File:Potted Acacia Sapling JE1.png|32px]] [[File:Potted Dark Oak Sapling JE1.png|32px]] [[File:Potted Dead Bush JE3.png|32px]]{{verify|Are these models the ones used in this version?}}<br>[[File:Flower Pot (item) JE1 BE1.png|32px]] Added flower pots.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Flower Pot BE.png|32px]] [[File:Potted Dandelion BE.png|32px]] [[File:Potted Poppy BE.png|32px]] [[File:Potted Allium BE.png|32px]] [[File:Potted Azure Bluet BE.png|32px]] [[File:Potted Oxeye Daisy BE.png|32px]] [[File:Potted Blue Orchid BE.png|32px]] [[File:Potted Red Tulip BE.png|32px]] [[File:Potted Orange Tulip BE.png|32px]] [[File:Potted White Tulip BE.png|32px]] [[File:Potted Pink Tulip BE.png|32px]] [[File:Potted Red Mushroom BE.png|32px]] [[File:Potted Brown Mushroom BE.png|32px]] [[File:Potted Oak Sapling BE.png|32px]] [[File:Potted Birch Sapling BE.png|32px]] [[File:Potted Spruce Sapling BE.png|32px]] [[File:Potted Jungle Sapling BE.png|32px]] [[File:Potted Acacia Sapling BE.png|32px]] [[File:Potted Dark Oak Sapling BE.png|32px]] [[File:Potted Cactus BE.png|32px]] [[File:Potted Fern BE.png|32px]]<br>[[File:Flower Pot (item) JE2 BE2.png|32px]] The textures of flower pots have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Flower Pot JE1.png|32px]] [[File:Potted Dandelion JE1.png|32px]] [[File:Potted Red Mushroom JE1.png|32px]] [[File:Potted Brown Mushroom JE1.png|32px]] [[File:Potted Oak Sapling JE1.png|32px]] [[File:Potted Birch Sapling JE1.png|32px]] [[File:Potted Spruce Sapling JE1.png|32px]] [[File:Potted Jungle Sapling JE1.png|32px]] [[File:Potted Cactus JE1.png|32px]] [[File:Potted Fern JE1.png|32px]] [[File:Potted Allium JE1.png|32px]] [[File:Potted Azure Bluet JE1.png|32px]] [[File:Potted Oxeye Daisy JE1.png|32px]] [[File:Potted Blue Orchid JE1.png|32px]] [[File:Potted Poppy JE1.png|32px]] [[File:Potted Red Tulip JE1.png|32px]] [[File:Potted Orange Tulip JE1.png|32px]] [[File:Potted White Tulip JE1.png|32px]] [[File:Potted Pink Tulip JE1.png|32px]] [[File:Potted Acacia Sapling JE1.png|32px]] [[File:Potted Dark Oak Sapling JE1.png|32px]]{{verify|Are these models the ones used in this version?}}<br>[[File:Flower Pot (item) JE1 BE1.png|32px]] Added flower pots.}}
{{History|foot}}

<gallery>
Suggestion for itemframes.png|Original Reddit image suggesting item frames and flower pots.
FlowerPot.png|The first image of flower pots, released by [[Dinnerbone]].
Pots 1-100.png|An [[Java Edition 14w06a|14w06a]] example of some of the blocks that can be placed inside of flower pots, and their rendering.
Pots 1-100b.png|The same arrangement as prior in [[Java Edition 14w06b|14w06b]].
</gallery>

=== Flower pot "item" ===
{{:Technical blocks/Flower Pot}}

== Gallery ==
=== Renders ===
; Flowers
<gallery>
Potted Dandelion.png | 
Potted Poppy.png | 
Potted Blue Orchid.png | 
Potted Allium.png | 
Potted Azure Bluet.png | 
Potted Red Tulip.png | 
Potted Orange Tulip.png | 
Potted White Tulip.png | 
Potted Pink Tulip.png | 
Potted Oxeye Daisy.png | 
Potted Cornflower.png | 
Potted Lily of the Valley.png | 
Potted Wither Rose.png | 
Potted Torchflower.png
</gallery>

; Saplings
<gallery>
Potted Oak Sapling.png | 
Potted Spruce Sapling.png | 
Potted Birch Sapling.png | 
Potted Jungle Sapling.png | 
Potted Acacia Sapling.png | 
Potted Dark Oak Sapling.png | 
Potted Azalea.png | 
Potted Flowering Azalea.png | 
Potted Mangrove Propagule.png | 
Potted Cherry Sapling.png
</gallery>

; Mushrooms
<gallery>
Potted Red Mushroom.png | 
Potted Brown Mushroom.png | 
Potted Crimson Fungus.png | 
Potted Warped Fungus.png |
</gallery>

; Roots and bushes
<gallery>
Potted Crimson Roots.png | 
Potted Warped Roots.png | 
Potted Fern.png | 
Potted Dead Bush.png | 
Potted Cactus.png | 
Potted Cactus BE.png | 
Potted Bamboo.png
</gallery>
=== Other ===
<gallery>
FiveFlowerPots.png | Five flower pots in a player-created village.
</gallery>
== Issues ==

{{issue list}}

== Trivia ==

* The flower pot is based on a suggestion from Reddit, like [[ender chest]]s and [[item frame]]s.<ref>{{tweet|dinnerbone|235747041286975488|My next task is going to be flower pots.|August 15, 2012}}</ref>
* Flower pots break [[falling block]]s.
* If a plant that has been [[Name Tag|named]] is put in a flower pot, the plant loses its name.
* The inside of the flower pot in ''Java Edition'' uses the center 4x4 pixels of the dirt texture while Bedrock Edition uses the center 6x6.

==References==

{{Reflist}}

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

[[Category:Manufactured blocks]]
[[Category:Storage]]
[[Category:Generated structure blocks]]
[[Category:Non-solid blocks]]
[[Category:Utility blocks]]

[[cs:Květináč]]
[[de:Blumentopf]]
[[es:Maceta]]
[[fr:Pot de fleurs]]
[[hu:Virágcserép]]
[[it:Vaso da fiori]]
[[ja:植木鉢]]
[[ko:화분]]
[[nl:Bloempot]]
[[pl:Doniczka]]
[[pt:Vaso]]
[[ru:Цветочный горшок]]
[[zh:花盆]]
[[uk:Квітковий горщик]]</li></ul>
18w43aAdded the item model property "custom_model_data".
1.15
{{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>[[Bamboo|Bamboo]]<br/>{{for|the plant feature|Bamboo (feature)}}
{{Distinguish|text = [[Sugar Cane]], which was colloquially known as Bamboo}}
{{Block
| image = <gallery>
Leafless Bamboo.png|Leafless
Small Leaves Bamboo.png|Small
Big Leaves Bamboo.png|Big
Leafless Old Bamboo.png|Leafless Old
Small Leaves Old Bamboo.png|Small Old
Big Leaves Old Bamboo.png|Big Old
</gallery>
| image2 = Bamboo Shoot.png<!--different infobox for this later down the line, like with pistons?-->
| image3 = Bamboo (item) JE1 BE1.png
| transparent = Yes
| light = No
| tool = Sword
| tool2 = Axe
| renewable = Yes
| stackable = Yes (64)
| flammable = '''Bamboo''': Yes (60)<br>'''Shoot''': No
| lavasusceptible = Yes
}}
'''Bamboo''' is a versatile, fast-growing, [[Bone Meal|bonemealable]] [[plant]] found primarily in [[jungle]]s, which is used for [[crafting]] (particularly [[scaffolding]] and [[Block of Bamboo|bamboo wood]]), [[smelting]] and [[breeding]] [[Panda|pandas]]. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BS}}

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

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

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

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

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

== Issues ==
{{Issue list}}

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

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

==References==
{{Reflist}}

{{Blocks|vegetation}}

{{Items}}

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

[[cs:Bambus]]
[[de:Bambus]]
[[es:Bambú]]
[[fr:Bambou]]
[[it:Bambù]]
[[ja:竹]]
[[ko:대나무]]
[[pl:Bambus]]
[[pt:Bambu]]
[[ru:Бамбук]]
[[th:ไม้ไผ่]]
[[zh:竹子]]</li></ul>
19w39aLighting of blocks in the inventory has been swapped from being dark on the right to being dark on the left.
19w40aLighting of blocks in the inventory is once again darker on the right, as it was before 19w39a.