Minecraft Wiki
Advertisement
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.

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 model(s). 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/minecraft/blockstates. The files are used directly based on their filename, thus a block state file with another name than the existing ones will not affect any block.

  • The root tag
    •  variants: Holds the names of all the variants of the block.
      •  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 will randomly be chosen from the options given, with each option being specified in separate subsidiary -tags. Item frames are treated as blocks and will 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, starting in assets/<namespace>/models.
          •  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 will 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 will be 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, starting in assets/<namespace>/models.
        •  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 will 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 which model 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 along side 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 along side 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 will randomly be chosen 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, starting in assets/<namespace>/models.
            •  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 will 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 will be 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, starting in assets/<namespace>/models.
          •  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 will 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 only used if certain conditions are met. Here the sides of the fence are only applied, 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 1.8, this is a rather big improvement. This tool helps to edit JSON data JSON Parser.

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 only tests 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/minecraft/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, starting in assets/<namespace>/models. 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 only be achieved 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]. If the value is greater than 80, it is displayed as 80. If the value is less then -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. Each texture starts in assets/<namespace>/textures or can be another texture variable.
      •  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.
      •  Texture variable: Defines a texture variable and assigns a texture.
    •  elements: Contains all the elements of the model. they can only have 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 cube according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  to: Stop point of a cube 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 cube. If a face is left out, it will not be rendered.
          •  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 will be 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 will be flipped. UV is optional, and if not supplied it will automatically generate 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 will also determine which 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 will be unaffected.


Example: Standing Torch

For simplicity, this example only describes 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 and the redstone torch. Therefore the "elements" 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. "uv" is used to determine the area where the texture is used. The texture variable "#torch" is used for the particles and the cubes 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 torch.json. As this file is only used for the normal torch, the texture can now be specified. The texture"torch" is now assigned to the texture variable "torch" (without #) and will therefore be 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 only 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 will not be mentioned again. 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

Item models

As items do not have different variants, there is no need to specify them. The folder assets/minecraft/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, starting in assets/<namespace>/models. 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.
      • 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 and banners).
      • Needs to be set to "builtin/compass" or "builtin/clock" for the compass and the clock.
    •  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 then -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. Each texture starts in assets/<namespace>/textures or can be another texture variable.
      •  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 eggs), but the amount of possible layers is hardcoded for each item. Only works in combination with "builtin/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 will use "layer0".
      •  Texture variable: Defines a texture variable and assigns a texture.
    •  elements: Contains all the elements of the model. they can only have 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 cube according to the scheme [x, y, z]. Values must be between -16 and 32.
        •  to: Stop point of a cube 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 cube. If a face is left out, it will not be rendered.
          •  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 will be 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 will be flipped. UV is optional, and if not supplied it will automatically generate 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 will also determine which 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 will be unaffected.
    •  overrides: Determines cases 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 will override. 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 tags for a full list of available tags.
        •  model: The path to the model to use if the case is met, starting in assets/<namespace>/models/

Simple example: old beds

This example will replace the bed item render with the textures currently found in Bedrock Edition: File:Grid Bed.png. 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 game uses assets/minecraft/textures as the parent folder, so that part of the path does not need to be included). 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).

Item tags

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

  • "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 will affect the item they see in inventories, along with the item players see them holding or wearing.
  • "pull": Determines the amount a bow has been pulled, expressed in a decimal value of less than one.
  • "pulling": Used on bows to determine if the bow is being pulled. If 1, the bow is currently being pulled.
  • "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 to apply custom model, expressed in an integer value.‌[upcoming: Lua error in Module:Version_link at line 112: attempt to concatenate local 'text' (a nil value).]

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": "builtin/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 ]
    }
  }
}

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 will be displayed 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 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"

History

Java Edition
1.7.2
{{Extension DPL}}<ul><li>[[Minecart with Chest|Minecart with Chest]]<br/>{{ItemEntity
|image=Minecart with Chest.png
|renewable=Yes
|stackable=No
|size=Height: 0.7 Blocks<br>Width: 0.98 Blocks
|networkid='''[[JE]]''': 10
|drops=1 {{ItemLink|Minecart with Chest}}<br> plus contents
|health={{hp|6}}
}}

A '''minecart with chest''' is a single [[chest]] inside a [[minecart]], and functions as such.

== Natural generation ==
Minecarts with chests containing loot naturally generate in [[mineshaft]]s, each on top of a piece of [[rail]].

== Obtaining ==
=== Crafting ===
{{Crafting|Chest|Minecart|Output=Minecart with Chest|type=Transportation}}

Minecarts with chests can be retrieved by attacking them. By doing so it drops as an [[item]] and any other contents of the chest are dropped as well.

==Usage==
[[File:Minecart with Chest GUI.png|thumb|176px|The GUI of a minecart with chest.]]
Minecarts with chests can be placed by {{control|use item|text=using its item}} on any type of [[rail]].

Chest minecarts' contents can be accessed by pressing {{control|use item}} button on them. The interaction makes no sounds and the chest does not show the opening or closing animation, unlike regular chests.

The boost that minecarts with chests gain from [[powered rail]]s is dependent on their load. For example, from a 1 powered rail starter track, an empty minecart with chest travels 64 blocks, but a full minecart with chest travels only 16 blocks (opposed to 80 blocks for an occupied normal minecart and 8 blocks for an empty normal minecart).

Another physical property of chest minecarts is their ability to be stacked. While three chests can fit in an area three blocks tall, up to four chest minecarts can fit in the same area. Like other minecarts, an unlimited number of minecarts with chests can exist in the same block space.

Minecarts with chests are also able to interact with [[hopper]]s. Hoppers can take items out from the minecart chest if they are below the track as the minecart rolls over it or put them in if the minecart rolls under a downward facing hopper. Hoppers can also input items if they are facing into the side of the minecart.

Opening or destroying a minecart with chest angers [[piglin]]s.

{{See also|Tutorials/Storage minecarts}}

When on top of [[detector rail]]s, nearby [[redstone comparators]] will give out redstone signals based on how full the minecarts with chests are.

== Sounds ==
{{Edition|Java}}:<br>
Minecarts with chests use the Friendly Creatures sound category for entity-dependent sound events.<ref group=sound name=rollsource>{{bug|MC-42132}}</ref>
{{Sound table
|sound=Minecart rolling.ogg
|subtitle=Minecart rolls
|source=Friendly Creatures <ref group=sound name=rollsource/>
|overridesource=1
|description=While a minecart with chest is moving
|id=entity.minecart.riding
|translationkey=subtitles.entity.minecart.riding
|volume=0.0-0.35 <ref group=sound>Relates linearly with horizontal velocity (max 0.5)</ref>
|pitch=0.0-1.0 <ref group=sound>Will increase by 0.0025 per tick if the minecart's horizontal velocity is more than 0.01</ref>
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Minecart rolling.ogg
|source=neutral
|description=While a minecart with chest is moving
|id=minecart.base
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Minecart with Chest
|spritetype=item
|nameid=chest_minecart
|id=389
|form=item
|foot=1}}
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Minecart with Chest
|spritetype=entity
|nameid=chest_minecart
|id=98
|foot=1}}

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

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

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

==Achievements==
{{load achievements|Freight Station}}

== Video==

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

==History ==
[[File:Minecart with Chest BE3.png|thumb|The Minecart models in the Bedrock Edition were north or south on the sides. In the latest version, the front and rear sides are north or south. But the absolute orientation of the chest was not changed.]]
{{info needed section|In bedrock edition 1.16.100 it seems that chests in minecarts face sideways instead of forward - when was this changed?}}
{{History|java alpha}}
{{History||v1.0.14|[[File:Minecart with Chest JE1.png|32px]] [[File:Minecart with Chest (item) JE1 BE1.png|32px]] Minecarts with chests have been added.
|At this point, they are either called "chest minecarts" or "storage minecarts" because no in-game name was indicated.}}
{{History|java beta}}
{{History||1.0|"Minecart with Chest" has been first indicated as its name, via the new item tooltips.}}
{{History||1.8|snap=Pre-release|[[File:Minecart with Chest JE2.png|32px]] The [[model]] of the minecart with chest has been changed to match the new [[chest]] model. However, the [[chest]] is incorrectly offset.<ref>[[mcw:Issues/Beta 1.8pre2#Graphical]]</ref>}}
{{History|||snap=release|[[File:Minecart with Chest JE3 BE1.png|32px]] The model of minecarts with chests has been fixed.}}
{{History|java}}
{{History||1.5|snap=13w02a|Minecarts with chests now generate in [[mineshaft]]s in place of normal chests.}}
{{History||1.9|snap=15w43a|[[Loot table]]s have been added; minecarts with chests now use loot tables, and those in generated in [[mineshaft]]s now use loot tables.}}
{{History||1.9.1|snap=pre2|The title of the [[inventory]] has been changed from 'Chest minecart' to 'Minecart with Chest'.}}
{{History||1.11|snap=16w32a|The [[entity]] ID has been changed from <code>MinecartChest</code> to <code>chest_minecart</code>.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 342.}}
{{History||1.14|snap=18w43a|[[File:Minecart with Chest JE4 BE2.png|32px]] [[File:Minecart with Chest (item) JE2 BE2.png|32px]] The textures of minecarts with chests have been changed.}}
{{History||1.16.2|snap=Pre-release 1|[[Piglin]]s now become angry with players who open or destroy a chest minecart.}}
{{History||1.19|snap=22w13a|The crafting recipe for a minecart with chest is now shapeless.
|Breaking a minecart with chest will now drop the item instead of the minecart and chest separately, though the contents of the chest are still dropped.<ref>{{bug|MC-249493|||Fixed}}</ref>}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Minecart with Chest JE3 BE1.png|32px]] [[File:Minecart with Chest (item) JE1 BE1.png|32px]] Added minecarts with chests.}}
{{History|||snap=build 3|Minecarts with chests now drop [[item]]s when destroyed in [[Creative]] mode.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|The [[entity]] ID has been changed from <code>minecartchest</code> to <code>chest_minecart</code>.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Minecart with Chest JE4 BE2.png|32px]] [[File:Minecart with Chest (item) JE2 BE2.png|32px]] The textures of minecarts with chests have been changed.}}
{{History||1.19.0|snap=beta 1.19.0.30|Breaking a minecart with chest will now drop the item instead of the minecart and chest separately, though the contents of the chest are still dropped.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Minecart with Chest JE3 BE1.png|32px]] [[File:Minecart with Chest (item) JE1 BE1.png|32px]] Added minecarts with chests.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Minecart with Chest JE4 BE2.png|32px]] [[File:Minecart with Chest (item) JE2 BE2.png|32px]] The textures of minecarts with chests have been changed.}}

{{History|new 3ds}}
{{History||0.1.0|[[File:Minecart_with_Chest_JE3_BE1.png|32px]] [[File:Minecart_with_Chest_(item)_JE1_BE1.png|32px]] Added minecarts with chests.
|Minecarts with chests emit smoke [[particles]] when destroyed.}}
{{History|foot}}

==Issues==
{{issue list}}

==Gallery ==
<gallery>
Compact Minecart Storage.png|A compact storage using chest minecarts (left) compared to chest storage in the same volume. Notice how chests cannot be placed next to each other, which is no longer the case after Java Edition 1.13.
GlitchedMinecartChest.png|This minecart with chest is trapped inside a block, due to a [[stronghold]] and a [[mineshaft]] that generated partially overlapping.
Minecartportal.png|A minecart with chest generated on top of an [[end portal frame]], because there is a mineshaft behind the wall.
Chest Minecart Stack.png|A large stack of chest minecarts.
</gallery>

==References==
{{Reflist}}

{{items}}
{{entities}}

[[Category:Mechanics]]
[[Category:Storage]]

[[cs:Nákladní vozík]]
[[de:Güterlore]]
[[es:Vagoneta con cofre]]
[[fr:Wagonnet de stockage]]
[[hu:Tárolócsille]]
[[it:Carrello da miniera]]
[[ja:チェスト付きのトロッコ]]
[[ko:상자가 실린 광산 수레]]
[[nl:Mijnkar met kist]]
[[pl:Wagonik ze skrzynią]]
[[pt:Carrinho de mina com baú]]
[[ru:Вагонетка с сундуком]]
[[uk:Вагонетка зі скринею]]
[[zh:运输矿车]]</li><li>[[Water|Water]]<br/>{{About|the fluid|the bucket|Water Bucket|other forms of water}}
{{Fluid
| image = <gallery>
Water.png|Java Edition
Water BE.png|Bedrock Edition
</gallery>
| invimage = Water Bucket
| invimage2 = Water
| renewable = Yes
| transparent = Partial <small>(-1 to light)</small>
| light = No
| tool = bucket
| infinite = Yes
| flowrate = 5 [[tick]]s/block
| flowdistance = 8 blocks
}}

'''Water''' is a [[fluid]] that naturally generates abundantly in the [[Overworld]].

== Obtaining ==
Water blocks do not exist as items,{{only|java}} but water can be collected by using a [[bucket]] on a water source block or a full water [[cauldron]], creating a [[water bucket]].

{{IN|BE}}, it may be obtained as an item via inventory editing or add-ons.

=== Natural generation ===
Water naturally generates in the [[Overworld]] to form [[ocean]]s, [[river]]s and [[spring]]s. The water level is at [[altitude|layer 63]] near oceans and rivers, but changes depending on location due to the [[aquifer]] system, filling some carvers, noise caves and canyons with water at different levels. Water also generates as small puddles on the floor next to [[dripstone cluster]]s, and as clay pools on the floor of [[lush caves]].

Water also generates in [[village]]s, [[desert well]]s, [[stronghold]]s, [[woodland mansion]]s, [[ancient city|ancient cities]] and [[ocean monument]]s. 

Water never generates in [[the Nether]] and instantly disappears if placed there with a water bucket. However, water can exist in the Nether in a [[cauldron]]. Water can also be placed in the Nether using [[commands]] such as {{cmd|setblock}} and {{cmd|fill}}. Although it does not naturally generate there, water can be placed and function normally in [[the End]].

{{IN|be}}, water also generates as part of [[ocean ruins]] with loot [[chest]]s, but only two water blocks generate: 
* One water block generates inside the loot chest, making it a [[Waterlogging|waterlogged]] loot chest.
* The other water block generates on top of the loot chest.
These water blocks generate even if the ruin is located on the surface.<ref>{{bug|MCPE-36793}}</ref> This is not the case in {{el|je}}; if an underwater ruin generates on the surface, no water generates.<ref>{{bug|MC-136156}}</ref> This also happens with [[shipwreck]]s.

Water spends most of its time as stationary, rather than flowing – regardless of its level, or whether it contains a current downward or to the side. When specifically triggered by a block update, water changes to 'flowing', updates its level, then changes back to stationary. Water springs are generated as flowing, and oceans, and rivers are generated as stationary. This happens before most types of generated structure are created, and the main cause of water "glitches" is that generated structures do not trigger a block update to let water flow into them.

== Usage ==
=== Appearance ===
Water uses a translucent animated texture that is tinted differently in different biomes. {{IN|Java}}, water in cauldrons is completely opaque.<ref>{{bug|MC-13187}}</ref>

Unlike other translucent blocks such as [[ice]], [[stained glass]] and [[tinted glass]], water shows the opposite sides of its external planes when viewed from within and from outside.<ref>{{bug|MC-202578|||WAI}}</ref> However, it applies only to the top plane and four side planes; the bottom face is always unseen from above.<ref>{{bug|MC-190053}}</ref>

=== Swimming ===
{{main|Swimming}}

The button for {{control|swim|text=swimming}} is the same as the button for jumping; non-swimming players and mobs sink slowly in water. Holding the swim button raises the player through the water, and when the surface is reached, the player bobs up and down. The {{control|crouch}} button can be used to sink faster. The {{control|sprint}} button can be used to put the player in "swim mode" when the player is completely submerged in water. When in swim mode, the player is horizontal and one block high. The player has an arm-waving animation when viewed in third person or by other players.

Swimming in water is considerably slower against currents (see [[#Current|Current]] below), but faster when going with the current.

Most mobs that can stand can also swim any time they are in water, except for [[iron golem]]s, [[piglin]]s, [[hoglin]]s, [[strider]]s, [[piglin brute]]s and undead mobs. This can lead to drowning if the water is falling from above.

Water of any depth prevents any entity, including the player, from sustaining falling damage if they fall into it, regardless of the distance fallen.

Being inside of water also imparts a [[fog]] effect, tinted accordingly.

=== Spreading ===
{{Main|Fluid#Spread}}
[[File:Water spread v1-13.png|300px|right|An image showing water's spreading distance]]
Water spreads horizontally and downward into nearby [[air]] blocks. Water can spread downward infinitely until stopped by a block, and 7 blocks horizontally from a source block on a flat surface. Water spreads at a rate of 1 block every 5 game ticks, or 4 blocks per second.

When spreading horizontally, a weight is assigned to every direction water can flow. For each direction, this weight is initially set to 1000. Then, for every adjacent block it can flow into it tries to find a way down that is reachable in four or fewer blocks from the block it wants to flow to. When found, the flow weight for that direction is set to the shortest path distance to the way down. Finally, water spreads in the directions with the lowest flow weight.

Spreading water extinguishes [[fire]] and washes away certain types of items or placed blocks, causing them to drop as items and then carrying them along in the flow until the edge of the spread. Affected items include [[plant]]s (except trees), [[snow]], [[torch]]es, [[carpet]]s, [[redstone dust]] and some other redstone components, [[cobweb]], [[end rod]]s, [[head]]s, and [[flower pot]]s.

==== Flow arrangement tables ====
{| class="wikitable"
|+ 
|
|
|
|
|
|
|
!7
|
|
|
|
|
|
|
|-
|
| 
| 
| 
| 
| 
! 7
!6
! 7
| 
| 
| 
| 
| 
|
|-
|
| 
| 
| 
| 
! 7
!6
!5
!6
! 7
| 
| 
| 
| 
|
|-
|
| 
| 
| 
! 7
!6
!5
!4
!5
!6
! 7
| 
| 
| 
|
|-
|
| 
| 
! 7
!6
!5
!4
!3
!4
!5
!6
! 7
| 
| 
|
|-
|
| 
! 7
!6
!5
!4
!3
!2
!3
!4
!5
!6
! 7
| 
|
|-
|
! 7
!6
!5
!4
!3
!2
!1
!2
!3
!4
!5
!6
! 7
|
|-
!7
!6
!5
!4
!3
!2
!1
!0
!1
!2
!3
!4
!5
!6
!7
|-
|
! 7
!6
!5
!4
!3
!2
!1
!2
!3
!4
!5
!6
! 7
|
|-
|
| 
! 7
!6
!5
!4
!3
!2
!3
!4
!5
!6
! 7
| 
|
|-
|
| 
| 
! 7
!6
!5
!4
!3
!4
!5
!6
! 7
| 
| 
|
|-
|
| 
| 
| 
! 7
!6
!5
!4
!5
!6
! 7
| 
| 
| 
|
|-
|
| 
| 
| 
| 
! 7
!6
!5
!6
! 7
| 
| 
| 
| 
|
|-
|
| 
| 
| 
| 
| 
! 7
!6
! 7
| 
| 
| 
| 
| 
|
|-
|
|
|
|
|
|
|
!7
|
|
|
|
|
|
|
|}

{| class="wikitable"
! colspan="2" |Range
!Height in blocks
|-
!1
|block
|1
|-
!2
|blocks
|0.75-1
|-
!3
|blocks
|0.625-0.75
|-
!4
|blocks
|0.5-0.625
|-
!5
|blocks
|0.375-0.5
|-
!6
|blocks
|0.25-0.375
|-
!7
|blocks
|0.125-0.25
|}

=== Source blocks ===
{{anchor|Water Spawner}} <!-- Compatibility anchor -->
{{about|the behavior and creation of source units of water|the removed block that created water sources|Water Spawner|section=1}}
A water source block is created from a flowing block that is horizontally adjacent to two or more other source blocks, and sitting on top of a solid block or another water source block. This allows water spawners to exist, in which a new source block immediately forms in the space left by removing a source block with a [[bucket]]. Pools of still water can be created by placing water source blocks in a confined area.

Water spawners can be constructed by arranging for two source blocks to flow into a third block. Each of the examples below require two source blocks, each on opposite ends of the hole, to create a renewable water source block in between.

While water source blocks only generate adjacent to solid blocks, they do not require a solid block to support them. Removing all adjacent blocks to a water source block only causes it to remain floating in the air.

{{IN|java}}, the formation of new water sources blocks can be disabled when the [[game rule]] {{cd|waterSourceConversion}} is set to {{cd|false}}.

<gallery>
2x2 water source.png|2x2 water spawner (every corner is renewable)
3x1 water source.png|3x1 water spawner (middle water block is renewable)
L-shaped water source.png|L-shaped water spawner (corner water block is renewable)
</gallery>

A [[dispenser]] loaded with a filled [[bucket]] places a water source block in an empty block in front of it when activated. A dispenser loaded with an empty bucket and a water source right in front of it sucks the source into the bucket when activated.

In snowy [[biome]]s, water source blocks have a chance to turn into [[ice]] if directly under the sky. Ice blocks under brighter light levels melt back into water source blocks (except in [[the Nether]]). Ice reverts to water when broken, but only if there is a solid block under it.

=== Current ===
The current in a water block determines both the direction it appears to flow and the direction an [[entity]] such as a player or [[boat]] is pushed from that block.

Water with a current pushes players and [[mob]]s at a speed of about 1.39 meters per second, or 25 blocks every 18 seconds. Players that are in creative flying mode don’t get pushed.{{only|je}}<ref>{{bug|MCPE-84592}}</ref>

The horizontal current in a water block is based on a vector sum of the flows to and from that block from its four horizontal neighbors. For example, if a block receives water from the north and sends it both south and east, but borders a solid block on its west edge, then a south-southeast current exits from that block, because 2 southward flows (in and out) are combined with 1 eastward flow (out). Thus, 16 horizontal directions are possible. If a branch in a channel is 2 blocks wide at its entrance, then entities float into it rather than continuing in a straight line.

Water blocks can create a downward current. A downward current in a water block is caused by the block below it. Most blocks that do not have a solid upper face cause downward current on above water blocks. Also, ice and falling water blocks (blocks created by spreading downward) cause downward current on the water block above. Falling water blocks have a downward current by default.

=== Light ===
{{IN|bedrock}}, every block of water reduces [[light]] by 1 extra level (in addition to the normal fading-out of light). {{IN|java}}, water does not cause any additional decrease for block light, but diffuses sky light, causing the light to fade with depth. Underwater visibility changes depending on the biome the player is in. The [[Night Vision]] and [[Conduit Power]] effects increase underwater visibility.

=== Color ===
Water has several colors, depending on the biome.

==== Java Edition ====
{| class="wikitable sortable mw-collapsible mw-collapsed" data-description="Water Color in Java Edition"
|-
!Biome!!Water color!!Water fog color!!Block
|-
|{{BiomeSprite|Plains|text=Default (biomes not listed below)}}||{{color|#3F76E4}}||{{color|#050533}}||[[File:Plains Water JE.png|32px]]
|-
|{{BiomeLink|Swamp}}||{{color|#617B64}}||{{color|#232317}}||[[File:Swamp Water.png|32px]]
|-
|{{BiomeLink|Lukewarm Ocean}}<br>{{BiomeLink|Deep Lukewarm Ocean}}||{{color|#45ADF2}}||{{color|#041633}}||[[File:Lukewarm Ocean Water JE.png|32px]]
|-
|{{BiomeLink|Warm Ocean}}||{{color|#43D5EE}}||{{color|#041F33}}||[[File:Warm Ocean Water JE.png|32px]]
|-
|{{BiomeLink|Cold Ocean}}<br>{{BiomeLink|Deep Cold Ocean}}<br>{{BiomeLink|Snowy Taiga}}<br>{{BiomeLink|Snowy Beach}}||{{color|#3D57D6}}||{{color|#050533}}||[[File:Cold Ocean Water JE.png|32px]]
|-
|{{BiomeLink|Frozen River}}<br>{{BiomeLink|Frozen Ocean}}<br>{{BiomeLink|Deep Frozen Ocean}}||{{color|#3938C9}}||{{color|#050533}}||[[File:Frozen Ocean Water JE.png|32px]]
|-
|{{BiomeLink|Meadow}}||{{color|#0E4ECF}}||{{color|#050533}}||[[File:Meadow Water.png|32px]]
|-
|{{BiomeLink|Mangrove Swamp}}||{{color|#3A7A6A}}||{{color|#4D7A60}}|||[[File:Mangrove Swamp Water.png|32px]]
|-
|{{BiomeLink|Cherry Grove}}||{{color|#5DB7EF}}||{{color|#5DB7EF}}||[[File:Cherry Grove Water.png|32px]]
|}

==== Bedrock Edition====
Biome tints
<!--[[File:Water color.png|500px|thumb|center|From left to right - Badlands Plateau, Birch Forest and Snowy Taiga]]-->
{| class="wikitable sortable mw-collapsible mw-collapsed" data-description="Water Color in Bedrock Edition" 
! Biome
!Water Surface Color
! Water Fog Color
!Water Fog Distance
!Water Surface Transparency
!Block
|-
|Default<br>(biomes not listed below)
|{{color|#44aff5}}||{{color|#44aff5}}||15||65%||[[File:Water BE.png|32px]]
|-
|{{BiomeLink|Sunflower Plains}}<br>{{BiomeLink|Plains}}
|{{color|#44aff5}}||{{color|#44aff5}}||60||-||[[File:Water BE.png|32px]]
|-
|{{BiomeLink|Desert}}
|{{color|#32a598}}||{{color|#32a598}}||60||-||[[File:Desert Water.png|32px]]
|-
|{{BiomeLink|Mountains}}
|{{color|#007BF7}}||{{color|#007BF7}}||-||-||[[File:Mountains Water.png|32px]]
|-
|{{BiomeLink|Forest}}
|{{color|#1e97f2}}||{{color|#1e97f2}}||60||-||[[File:Forest Water.png|32px]]
|-
|{{BiomeLink|Flower Forest}}
|{{color|#20a3CC}}||{{color|#20a3CC}}||60||-||[[File:Flower Forest Water.png|32px]]
|-
| {{BiomeLink|Taiga}}
| {{color|#287082}}||{{color|#287082}}||60||-||[[File:Taiga Water.png|32px]]
|-
|{{BiomeLink|Taiga Mountains}}
|{{color|#1e6B82}}||{{color|#1e6B82}}||-||-||[[File:Taiga Mountains Water.png|32px]]
|-
|{{BiomeLink|Swamp}}
|{{color|#4c6559}}||{{color|#4c6559||30||100%||[[File:Swamp Water BE.png|32px]]
|-
| {{BiomeLink|River}}
|{{color|#0084ff}}||{{color|#0084ff}}||60||-||[[File:River Water.png|32px]]
|-
|{{BiomeLink|Nether Wastes}}<br>{{BiomeLink|Warped Forest}}<br>{{BiomeLink|Crimson Forest}}<br>{{BiomeLink|Soul Sand Valley}}
|{{color|#905957}}||{{color|#905957}}||15||-||[[File:Nether Water.png|32px]]
|-
|{{BiomeLink|Basalt Deltas}}
|{{color|#3f76e4}}||{{color|#423e42}}||15||-||[[File:Basalt Deltas Water.png|32px]]
|-
|{{BiomeLink|The End}}
| {{color|#62529e}}||{{color|#62529e}}||-||-||[[File:The End Water.png|32px]]
|-
|{{BiomeLink|Frozen River}}
|{{color|#185390}}||{{color|#185390}}||60||-||[[File:Frozen River Water.png|32px]]
|-
|{{BiomeLink|Snowy Tundra}}<br>{{BiomeLink|Ice Spikes}}
|{{color|#14559b}}||{{color|#14559b}}||-||-||[[File:Ice Spikes Water.png|32px]]
|-
| {{BiomeLink|Mushroom Fields}}
|{{color|#8a8997}}||{{color|#8a8997}}||-||-||[[File:Mushroom Fields Water.png|32px]]
|-
|{{BiomeLink|Beach}}
| {{color|#157cab}}||{{color|#157cab}}||60||-||[[File:Beach Water.png|32px]]
|-
|{{BiomeLink|Mountain Edge}}
|{{color|#045cd5}}||{{color|#045cd5}}||-||-||[[File:Mountain Edge Water.png|32px]]
|-
|{{BiomeLink|Jungle}}<br>{{BiomeLink|Bamboo Jungle}}
|{{color|#14a2c5}}||{{color|#14a2c5||60<br>15||-||[[File:Jungle Water.png|32px]]
|-
|{{BiomeLink|Jungle Edge}}
| {{color|#0D8AE3}}||{{color|#0D8AE3}}||-||-||[[File:Jungle Edge Water.png|32px]]
|-
|{{BiomeLink|Stone Shore}}
|{{color|#0d67bb}}||{{color|#0d67bb}}||60||-||[[File:Stone Shore Water.png|32px]]
|-
|{{BiomeLink|Snowy Beach}}
|{{color|#1463a5}}||{{color|#1463a5}}||60||-||[[File:Snowy Beach Water.png|32px]]
|-
|{{BiomeLink|Birch Forest}}
|{{color|#0677ce}}||{{color|#0677ce}}||60||-||[[File:Birch Forest Water.png|32px]]
|-
|{{BiomeLink|Dark Forest}}
|{{color|#3B6CD1}}||{{color|#3B6CD1}}||60||-||[[File:Dark Forest Water.png|32px]]
|-
|{{BiomeLink|Snowy Taiga}}
|{{color|#205e83}}||{{color|#205e83}}||60||-||[[File:Snowy Taiga Water.png|32px]]
|-
|{{BiomeLink|Giant Tree Taiga}}<br>{{BiomeLink|Giant Spruce Taiga}}
|{{color|#2d6d77}}||{{color|#2d6d77}}||60||-||[[File:Giant Tree Taiga Water.png|32px]]
|-
|{{BiomeLink|Windswept Forest}}<br>{{BiomeLink|Windswept Gravelly Hills}}
|{{color|#0E63AB}}||{{color|#0E63AB}}||-||-||[[File:Wooded Mountains Water.png|32px]]
|-
|{{BiomeLink|Savanna}}
|{{color|#2C8B9C}}||{{color|#2C8B9C}}||60||-||[[File:Savanna Water.png|32px]]
|-
|{{BiomeLink|Savanna Plateau}}<br>{{BiomeLink|Shattered Savanna}}
|{{color|#2590a8}}||{{color|#2590a8}}||-||-||[[File:Savanna Plateau Water.png|32px]]
|-
|{{BiomeLink|Badlands}}
|{{color|#4E7f81}}||{{color|#4E7f81||60
|<nowiki>-||[[File:Badlands Water.png|32px]]
|-
|{{BiomeLink|Eroded Badlands}}<br>{{BiomeLink|Wooded Badlands}}
|{{color|#497f99}}||{{color|#497f99}}||-||-||[[File:Eroded Badlands Water.png|32px]]
|-
|{{BiomeLink|Ocean}}
|{{color|#1787D4}}||{{color|#1165b0}}||60||-||[[File:Ocean Water.png|32px]]
|-
|{{BiomeLink|Deep Ocean}}
|{{color|#1787D4}}||{{color|#1463a5}}||60||-||[[File:Ocean Water.png|32px]]
|-
|{{BiomeLink|Warm Ocean}}
|{{color|#02B0E5}}||{{color|#0289d5}}||60||55%||[[File:Warm Ocean Water.png|32px]]
|-
| {{BiomeLink|Lukewarm Ocean}}
|{{color|#0D96DB}}||{{color|#0a74c4}}||60||-||[[File:Lukewarm Ocean Water.png|32px]]
|-
|{{BiomeLink|Deep Lukewarm Ocean|Lukewarm Deep Ocean}}
|{{color|#0D96DB}}||{{color|#0e72b9}}||60||-||[[File:Lukewarm Ocean Water.png|32px]]
|-
|{{BiomeLink|Cold Ocean}}
|{{color|#2080C9}}||{{color|#14559b}}||60||-||[[File:Cold Ocean Water.png|32px]]
|-
|{{BiomeLink|Deep Cold Ocean|Cold Deep Ocean}}
|{{color|#2080C9}}||{{color|#185390}}||60||-||[[File:Cold Ocean Water.png|32px]]
|-
|{{BiomeLink|Frozen Ocean}}
|{{color|#2570B5}}||{{color|#174985}}||60||-||[[File:Frozen Ocean Water.png|32px]]
|-
|{{BiomeLink|Deep Frozen Ocean|Frozen Deep Ocean}}
|{{color|#2570B5}}||{{color|#1a4879}}||60||-||[[File:Frozen Ocean Water.png|32px]]
|-
|{{BiomeLink|Mangrove Swamp}}
|{{color|#3a7a6a}}||{{color|#4d7a60}}||30||-||[[File:Mangrove Swamp Water BE.png|32px]]
|}
Biome tints from [[Biome/Before 1.18|unused biomes]]
{| class="wikitable sortable mw-collapsible mw-collapsed" data-description="Water Color in Bedrock Edition" 
! Biome
!Water Surface Color
!Water Fog Color
!Water Fog Distance
!Water Surface Transparency
!Block
|-
|{{BiomeLink|Legacy Frozen Ocean}}
|{{color|#44aff5}}||{{color|#44aff5}}||-||-||[[File:Water BE.png|32px]]
|-
|{{BiomeLink|Mountains}}
|{{color|#007BF7}}||{{color|#007bf7}}||-||-||[[File:Mountains Water.png|32px]]
|-
|{{BiomeLink|Taiga Mountains}}
|{{color|#1e6B82}}||{{color|#1e6b82}}||-||-||[[File:Taiga Mountains Water.png|32px]]
|-
|{{BiomeLink|Swamp Hills}}
| {{color|#4c6156}}||{{color|#4c6156||30||100%||[[File:Swamp Hills Water.png|32px]]
|-
| {{BiomeLink|Snowy Mountains}}
|{{color|#1156a7}}||{{color|#1156a7}}||-||-||[[File:Snowy Mountains Water.png|32px]]
|-
|{{BiomeLink|Mushroom Field Shore}}
|{{color|#818193}}||{{color|#818193}}||-||-||[[File:Mushroom Field Shore Water.png|32px]]
|-
|{{BiomeLink|Desert Hills}}
|{{color|#1a7aa1}}||{{color|#1a7aa1}}||-||-||[[File:Desert Hills Water.png|32px]]
|-
|{{BiomeLink|Wooded Hills}}
|{{color|#056bd1}}||{{color|#056bd1}}||-||-||[[File:Wooded Hills Water.png|32px]]
|-
|{{BiomeLink|Taiga Hills}}
|{{color|#236583}}||{{color|#236583}}||-||-||[[File:Taiga Hills Water.png|32px]]
|-
|{{BiomeLink|Mountain Edge}}
|{{color|#045cd5}}||{{color|#045cd5}}||-||-||[[File:Mountain Edge Water.png|32px]]
|-
|{{BiomeLink|Jungle Hills}}<br>{{BiomeLink|Modified Jungle}}<br>{{BiomeLink|Bamboo Jungle Hills}}
|{{color|#1B9ED8}}||{{color|#1B9ED8}}||-||-||[[File:Jungle Hills Water.png|32px]]
|-
|{{BiomeLink|Modified Jungle Edge}}
|{{color|#0D8AE3}}||{{color|#0D8AE3}}||-||-||[[File:Jungle Edge Water.png|32px]]
|-
|{{BiomeLink|Birch Forest Hills}}
|{{color|#0a74c4}}||{{color|#0a74c4}}||-||-||[[File:Birch Forest Hills Water.png|32px]]
|-
|{{BiomeLink|Snowy Taiga Mountains}}
|{{color|#205e83}}||{{color|#205e83}}||60||-||[[File:Snowy Taiga Water.png|32px]]
|-
|{{BiomeLink|Snowy Taiga Hills}}
|{{color|#245b78}}||{{color|#245b78}}||-||-||[[File:Snowy Taiga Hills Water.png|32px]]
|-
|{{BiomeLink|Giant Tree Taiga Hills}}
|{{color|#286378}}||{{color|#286378}}||-||-||[[File:Giant Tree Taiga Hills Water.png|32px]]
|-
|{{BiomeLink|id=modified-gravelly-mountains|Gravelly Mountains+}}
|{{color|#0E63AB}}||{{color|#0e63ab}}||-||-||[[File:Wooded Mountains Water.png|32px]]
|-
|{{BiomeLink|Shattered Savanna Plateau}}
|{{color|#2590a8}}||{{color|#2590a8}}||-||-||[[File:Savanna Plateau Water.png|32px]]
|-
|{{BiomeLink|Badlands Plateau}}<br>{{BiomeLink|Modified Badlands Plateau}}
|{{color|#55809E}}||{{color|#55809e}}||-||-||[[File:Badlands Plateau Water.png|32px]]
|-
|{{BiomeLink|Deep Warm Ocean|Warm Deep Ocean}}
|{{color|#02B0E5}}||{{color|#0686ca}}||60||-||[[File:Warm Ocean Water.png|32px]]
|}

===Water and lava===
{{Main|Fluid#Mixing}}

Water and lava can produce [[stone]], [[cobblestone]], or [[obsidian]] based on how they interact. If water touches a lava source, the lava source turns to obsidian. If both touch each other while flowing, cobblestone is made and no sources are removed, and if lava flows downward onto water, the water turns to stone.

===Interactions with mobs===
====Direct contact====

Water damages [[endermen]], [[snow golem]]s, [[Strider|striders]] and [[blaze]]s, at a rate of {{hp|1}} per half second. If water comes into contact with a [[shulker]] or an [[enderman]], the mob teleports away.

====Suffocation====
{{Main|Damage#Suffocation in water}}

Players and mobs (except [[aquatic mob]]s, [[undead mob]]s and [[iron golem]]s) have a breath meter that lasts 15 seconds. After they run out of breath, they take {{hp|2}} suffocation damage every second until they die, surface, or enter [[bubble column]]s.

[[Dolphin]]s are a special case in drowning: they take suffocation damage when underwater for about 4 minutes, but also take suffocation damage when in air for about 2 minutes.

Each level of the [[Respiration]] enchantment adds 15 seconds to the breath meter and grants an x/(x+1) chance (where x is the Respiration level) of not taking damage after that time: 30 seconds and an average {{hp|1}}/second with Respiration I, 45 seconds and an average of {{frac|2|3}} damage/second with Respiration II, and 60 seconds and an average of {{frac|1|2}} damage/second with Respiration III.

If a [[husk]] suffocates underwater, it starts to shake and eventually becomes a [[zombie]]. If a [[zombie]] suffocates underwater, it starts to shake and eventually transforms into a [[drowned]].

=== Slower mining speed===
Players with their head underwater require 5 times the normal amount of time to mine blocks while standing on the ground, or 25 times while not on the ground. If a player wears a helmet with the [[Aqua Affinity]] enchantment, then underwater mining speed while standing on the ground is the same as on land, and 5 times slower if not standing on the ground.

===Explosions===
Water does not prevent explosions from activating. Water has a high blast resistance, causing it to absorb any normal blasts, with the exception of explosions from [[underwater TNT]].

===Hardening concrete powder ===
When water comes into contact with [[concrete powder]], the powder hardens into solid [[concrete]].

===Sponges===
When a dry [[sponge]] comes into contact with a water source or flowing block, it becomes a wet [[sponge]], absorbing all water within 3 to 5 blocks in all directions. [[Kelp]] and [[lily pad]]s within the absorbed water blocks are destroyed and drop as items, and [[seagrass]] is destroyed without dropping anything. Mobs that take damage out of water are affected as a side-effect. 

Sponges do not absorb water from [[Waterlogging|waterlogged]] blocks, nor water that comes into contact by flowing back in from outside the area of absorption. For instance, placing a sponge 4 or more blocks from a single water source removes the flowing water in the area of effect, but as the flow from the source resumes it is not affected by the wet sponge.

A sponge instantly absorbs nearby water when it is placed next to water or when water comes into contact with it (by being placed next to the sponge, or by flowing toward it). A sponge absorbs [[water]] around itself (water source blocks or flowing water) out to a [[taxicab distance]] of 7 in all directions (including up and down), but won't absorb more than 65 blocks of water (water closest to the sponge is absorbed first). The absorption propagates only from water to water and does not "jump over" non-water blocks (including air).

===Dripping===
[[File:WaterDropletsExample.png|thumb|Dripping water.]]
Water above a non-transparent block (except for stairs, fences, or slabs) produces dripping particles on the underside of that block. If a block of [[Pointed Dripstone|pointed dripstone]] hangs under any block directly beneath a water source, the drips can slowly fill up a [[cauldron]] placed underneath. Without the dripstone, a cauldron does not fill.

===Vertical transport===
[[Bubble column]]s are created by placing magma blocks or [[soul sand]] under water. These can be used to transport [[mobs]] or items quickly vertically.

==Sounds==
{{el|je}}:
{{Sound table
|sound=Entering water1.ogg
|sound2=Entering water2.ogg
|sound3=Entering water3.ogg
|subtitle=MC-177092
|source=ambient
|description=When the player's eye level goes underwater
|id=ambient.underwater.enter
|translationkey=-
|volume=0.8<wbr>{{Until|JE 1.20.2}}<br>0.5<wbr>{{Upcoming|JE 1.20.2}}
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Exiting water1.ogg
|sound2=Exiting water2.ogg
|sound3=Exiting water3.ogg
|subtitle=MC-177092
|source=ambient
|description=When the player's eye level goes above water
|id=ambient.underwater.exit
|translationkey=-
|volume=0.5<wbr>{{Until|JE 1.20.2}}<br>0.3<wbr>{{Upcoming|JE 1.20.2}}
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Underwater Ambience.ogg
|subtitle=MC-196825
|source=ambient
|description=Randomly when underwater
|id=ambient.underwater.loop
|translationkey=-
|volume=0.65
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bubbles1.ogg
|sound2=Bubbles2.ogg
|sound3=Bubbles3.ogg
|sound4=Bubbles4.ogg
|sound5=Bubbles5.ogg
|sound6=Bubbles6.ogg
|sound7=Water1.ogg
|sound8=Water2.ogg
|subtitle=MC-196825
|source=ambient
|description=Randomly when underwater
|id=ambient.underwater.loop.additions
|translationkey=-
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Animal1.ogg
|sound2=Bass Whale1.ogg
|sound3=Bass Whale2.ogg
|sound4=Crackles1.ogg
|sound5=Crackles2.ogg
|sound6=Driplets1.ogg
|sound7=Driplets2.ogg
|sound8=Earth Crack.ogg
|subtitle=MC-196825
|source=ambient
|description=Randomly when underwater
|id=ambient.underwater.loop.additions.rare
|translationkey=-
|volume=''varies'' <ref group=sound>The first, fifth, and eighth sounds are 1.0; the second sound is 0.45; the third, sixth, and seventh sounds are 0.5; the fourth sound is 0.7</ref>
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Animal2.ogg
|sound2=Dark1.ogg
|sound3=Dark2.ogg
|sound4=Dark3.ogg
|sound5=Dark4.ogg
|subtitle=MC-196825
|source=ambient
|description=Randomly when underwater
|id=ambient.underwater.loop.additions.ultra_rare
|translationkey=-
|volume=1.0 <ref group=sound>Except the third sound, which is 0.7</ref>
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Water1.ogg
|sound2=Water2.ogg
|subtitle=Water flows
|source=block
|description=Randomly from flowing water
|id=block.water.ambient
|translationkey=subtitles.block.water.ambient
|volume=0.75-1.0
|pitch=0.5-1.5
|distance=16}}
{{Sound table
|sound=Water splash1.ogg
|sound2=Water splash2.ogg
|subtitle=Splashing
|source=dependent
|description=When something enters water
|id=entity.generic.splash
|translationkey=subtitles.entity.generic.splash
|volume=0.0-1.0 <ref group=sound name=speedvolume>The mob's momentum, with the horizontal axes' velocities multiplied by 0.2 (capped at 1.0)</ref>
|pitch=0.6-1.4
|distance=16}}
{{Sound table
|sound=Swim1.ogg
|sound2=Swim2.ogg
|sound3=Swim3.ogg
|sound4=Swim4.ogg
|subtitle=Swimming
|source=dependent
|description=While something is moving through water
|id=entity.generic.swim
|translationkey=subtitles.entity.generic.swim
|volume=0.0-1.0 <ref group=sound name=speedvolume/>
|pitch=0.6-1.4
|distance=16}}
{{Sound table
|sound=Empty water bucket1.ogg
|sound2=Empty water bucket1.ogg
|sound3=Empty water bucket2.ogg
|sound4=Empty water bucket3.ogg
|subtitle=Bucket empties
|source=block
|description=When water is placed with a bucket
|id=item.bucket.empty
|translationkey=subtitles.item.bucket.empty
|volume=1.0 <ref group=sound>Except for the second copy of {{cd|empty1}}, which is 0.9</ref>
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|subtitle=Bucket fills
|source=player
|description=When water is collected with a bucket
|id=item.bucket.fill
|translationkey=subtitles.item.bucket.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Axolotl.ogg
|sound2=Dragon fish.ogg
|sound3=Shuniji.ogg
|subtitle=-
|source=music
|description=Randomly when underwater
|id=music.under_water
|translationkey=-
|volume=0.4
|pitch=1.0
|distance=16
|foot=1}}

{{el|be}}:
{{Sound table
|type=bedrock
|sound=Water2.ogg
|source=block
|description=Randomly from flowing water
|id=liquid.water
|volume=0.75-1.0
|pitch=0.5-1.5}}
{{Sound table
|sound=Water Splash Old.ogg
|source=player
|description=When something enters water<wbr><ref group=sound>{{Bug|MCPE-44120}}</ref>
|id=random.splash
|pitch=0.6-1.4}}
{{Sound table
|sound=Water splash1.ogg
|sound2=Water splash2.ogg
|source=ambient
|description=?[[Category:Pages missing sound description]]<wbr>{{Upcoming|BE 1.20.40}}
|id=entity.generic.splash
|pitch=0.6-1.4}}
{{Sound table
|sound=Entering water1.ogg
|sound2=Entering water2.ogg
|sound3=Entering water3.ogg
|source=player
|description=When the player's eye level goes underwater<wbr>{{Upcoming|BE 1.20.40}}
|id=ambient.underwater.enter
|volume=<!--0.8 (other multipliers)-->
|pitch=1.0}}
{{Sound table
|sound=Exiting water1.ogg
|sound2=Exiting water2.ogg
|sound3=Exiting water3.ogg
|source=player
|description=When the player's eye level goes above water<wbr>{{Upcoming|BE 1.20.40}}
|id=ambient.underwater.exit
|volume=<!--1.0 (other multipliers)-->
|pitch=1.0}}
{{Sound table
|sound=Swim1.ogg
|sound2=Swim2.ogg
|sound3=Swim3.ogg
|sound4=Swim4.ogg
|source=player
|description=While something is moving through water
|id=random.swim
|pitch=0.6-1.4}}
{{Sound table
|sound=Empty water bucket1.ogg
|sound2=Empty water bucket2.ogg
|sound3=Empty water bucket3.ogg
|source=block
|description=When water is placed with a bucket
|id=bucket.empty_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Fill water bucket1.ogg
|sound2=Fill water bucket2.ogg
|sound3=Fill water bucket3.ogg
|source=block
|description=When water is collected with a bucket
|id=bucket.fill_water
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Axolotl.ogg
|sound2=Dragon fish.ogg
|sound3=Shuniji.ogg
|source=music
|description=Randomly when underwater
|id=music.game.water
|volume=0.2
|pitch=1.0
|foot=1}}

==Data values==
===ID===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Water
|showforms=y
|generatetranslationkeys=y
|displayname=Block
|spritename=water
|spritetype=block
|nameid=water
|form=block
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Water
|showfluidtags=y
|displayname=Fluid
|spritename=water
|spritetype=block
|nameid=water
|fluidtags=water}}
{{ID table
|displayname=Flowing Fluid
|spritetype=block
|spritename=water
|nameid=flowing_water
|fluidtags=water
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Water
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Flowing
|spritename=water
|spritetype=block
|nameid=flowing_water
|id=8
|form=block}}
{{ID table
|displayname=Stationary
|spritename=water
|spritetype=block
|nameid=water
|id=9
|form=block
|foot=1}}

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

{{/BS}}

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

{{/FS}}

==Achievements==
{{load achievements|Free Diver;Sleep with the Fishes}}

==Advancements==
{{load advancements|Tactical fishing;The Cutest Predator}}

==History==
{{Main|/History}}
{{History|java classic}}
{{History||May 17, 2009|link=https://archive.org/download/Minecraft_IRC_Logs_2009/history/files/May-15-to-June-03-2009/2009-05-17.140618-0400EDT.txt.~1~|Notch mentions developing water.{{q|a very very first version of the water is somewhat working now, heh [/] the level starts out without any water and is surrounded a by a huge ocean [/] it quickly fills, leaving islands}}}}
{{History||0.0.12a|snap=May 18, 2009|slink=Java Edition Classic 0.0.12a/Development#Water test (May 18, 2009)|[[File:Water (pre-release).png|32px]] Water is shown.}}
{{History|||snap=release|slink=Java Edition Classic 0.0.12a|[[File:Water JE1.png|32px]] Added water.
|Water flows to any available space below or beside it and creates a new source [[block]], making it easy to flood a whole world just with one source.}}
{{History||May 22, 2009|link=wordofnotch:111386404|[[Notch]] pointed out that when a [[plant]] or non-cube block is placed in water, it produces a box of [[air]] around it. He asked how it could be fixed, and whether he even had to.}}
{{History||0.0.13a|[[File:Water JE2.png|32px]] The model of water has been changed.}}
{{History||May 24, 2009|link=wordofnotch:112481256|A new water system is mentioned.}}
{{History||May 24, 2009|link=wordofnotch:112481370|A new water system is shown.}}
{{History||May 24, 2009|link=wordofnotch:112487511| Another test of water is shown.}}
{{History||May 26, 2009|link=wordofnotch:113350683|While sharing feedback on experiments with random vertex and color offsets, and deciding to scrap it, Notch said he would investigate salvaging the technique to add animation to water tiles.}}
{{History||0.0.19a|[[File:Water JE3.png|32px]] Added [[Procedural animated texture generation|procedural animated texture]] to water. The old texture is retained for use as a [[animation placeholder texture|placeholder]].
|Upscaled model 2% to fix z-fighting with blocks below water. It's created water or lava models overlapping and z-fighting with each other.
|Added [[sponge]]s, which remove water.
|Water part of the [[world boundary]] still uses the old water texture.}}
{{History||0.0.20a_02|[[File:Water JE4.png|32px]] Changed model scale back to normal with 1% offset on all coordinates.}}
{{History||0.26 SURVIVAL TEST|[[File:Water JE5.png|32px]] UV mapping on side faces now has 11% v offset up.}}
{{History||0.28|[[File:Water JE4.png|32px]] Fixed UV mapping.}}
{{History|java indev}}
{{History||0.31|snap=20091223-1|[[File:Water JE6.png|32px]] Added the flowing water texture, which is now used on the sides of water.}}
{{History|||snap=20100106|Water part of the [[world boundary]] now uses the animated water texture.}}
{{History|||snap=20100113|Water is now finite.|[[Ocean]]s now have infinite water.
|Water now always drains from its highest remove location.
|Water no longer moves on the surface on its own.
|Water now has a {{frac|2|3}} probability to evaporate and a {{frac|1|3}} probability to copy.}}
{{History|||snap=20100122|Water now spawns in level generation as [[spring]]s and lakes.}}
{{History|||snap=20100131|The texture of water is now seen when underwater.}}
{{History|java infdev}}
{{History||20100227-1|Water no longer flows due to changes in chunk handling for infinite worlds.{{verify|type=change}}}}
{{History||20100607|[[File:Water JE7.png|32px]] UV mapping now has 1% uv offset on top and bottom faces and 1% u, 11% v offset on side faces.}}
{{History||20100608|[[File:Water JE6.png|32px]] Fixed UV mapping, once again.}}
{{History||20100615|[[File:Water JE8.png|32px]] The model has been changed.
|Added flowing water.
|Sources placed in isolation flow exclusively downward, rather than spreading out one block in each direction as well.
|Water and lava do not produce any solid blocks when combined.
|Water does not replace plants.
|Water is now infinite again.
|Added [[water bucket]]s, which can be filled with water.}}
{{History||20100616-1|[[File:Water JE9.png|32px]] Added vertex offset.
|Water and flowing water now has visual connection to blocks.
|Downward flowing water now pushes the [[player]] out.{{info needed|and other entities?}}}}
{{History||20100617-2|[[File:Water JE10.png|32px]] Removed vertex offset.
|Water sources placed in the air now flow outward.
|Lava and flowing lava touching water, flowing water now replaces with [[obsidian]].
|Downward flowing water no longer pushes the player out.
|Water now can replace [[plants]]. However no items are dropped.}}
{{History||20100618|Water can now replace [[rail]]s.}}
{{History||20100624|Water now destroys plants, dropping as items.}}
{{History|java alpha}}
{{History||v1.0.2_02|[[Fluids]], including water, have been slightly tweaked.}}
{{History||v1.0.5_01|Water can now freeze into [[ice]].}}
{{History||v1.2.6|[[Lake]]s, which contain water, have been added.}}
{{History|java beta}}
<!--{{History||1.5|Dropped [[item]]s in flowing water now move faster.{{check version|Taken from trivia, may not be beta}}}}-->
{{History||1.6|snap=Test Build 3|[[Rain]] and [[snow]] no longer fall through water.
|Water sources now form over [[glass]].}}
{{History||1.8|snap=Pre-release|[[File:Water JE11.png|32px]] Changed [[lighting]].
|Underwater [[particles]] have been added.
|Because of the change in how land is generated, if a [[player]] is in a world that was made pre-1.8 and travels into new [[chunk]]s, there's a chance that a large [[ocean]] may be formed as the ocean [[biome]]. There is also a one-[[block]]-high drop in sea level along the discontinuity between the old and new chunks with the old chunks being higher.
|Water can now be found in the farms and wells of [[village]]s, and the fountain rooms of [[stronghold]]s.
|Two [[biome]]s have been added that are almost all water: [[ocean]]s and [[river]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|[[File:Swamp Water JE1.png|32px]] {{color|#E0FF70}} Added water color in swampland.
|Added dripping water.}}
{{History|||snap=Beta 1.9 Prerelease 4|Added [[Respiration]] and [[Aqua Affinity]] enchantments, which allow more breathing time in water and normal digging speed in water.}}
{{History|||snap=Beta 1.9 Prerelease 5|Now flowing downward creates source blocks}}
{{History|||snap=RC1|[[File:Water JE12.png|32px]] [[File:Swamp Water JE2.png|32px]] Faces on model now 0.1% moved to center to fix z-fighting on inner faces.}}
{{History||1.1|snap=12w01a|[[File:Swamp Water JE3.png|32px]] {{color|#E0FFAE}} The water color in swampland is now less intense.}}
{{History||1.2.1|snap=12w04a|Added [[desert well]]s, which contain water.}}
{{History||1.3.1|snap=12w17a|The ability to bring water using [[ice]] into [[the Nether]] has been removed.}}
{{History|||snap=12w21a|[[Dispenser]]s have been given the ability to shoot out [[fluids]], including water, inside [[water bucket]]s. They can also collect the fluids if activated again.}}
{{History||1.4.2|snap=12w38a|The [[sound]] when jumping and swimming in water has been changed.
|The sound of flowing water is now continuous.
|The water overlay is a more saturated blue.}}
{{History||1.4.4|snap=1.4.3|Water of any depth now negates all [[Damage#Fall damage|fall damage]]. [[Player]]s and [[mob]]s no longer die from great heights in shallow water.<ref>{{bug|MC-1644}} resolved as Works As Intended</ref>}}
{{History||1.5|snap=13w02a|[[File:Water JE13.png|32px]] [[File:Swamp Water JE4.png|32px]] The texture of water has been changed to use an animated texture file. Prior to this version, the texture was procedurally generated by the game (see dedicated section below).}}
{{History|||snap=13w03a|A water source [[block]] now forms if there is another water source block below it.}}
{{History|||snap=13w04a|Flowing water in [[Creative]] mode no longer slows the [[player]] down when flying.}}
{{History||1.6.1|snap=13w17a|Water [[lake]]s no longer generate in [[desert]]s.}}
{{History||1.7.2|snap=13w36a|[[File:Swamp Water JE4.png|32px]] {{color|#E0FFAE}} Added water color in swampland M, which is the same as in swampland.}}
{{History||1.7.2|snap=13w36a|Water pools now generate in the new desert M [[biome]].
|[[Ocean]]s are much smaller.}}
{{History|||snap=13w41a|[[File:Water JE14.png|32px]] [[File:Swamp Water JE5.png|32px]] Water's six internal faces are now visible from the outside.
|Water, [[ice]] and [[portal]]s are now visible through each other. This also now allows water's inside faces to be visible from outside.}}
{{History|||snap=13w42a|[[File:Water JE13.png|32px]] [[File:Swamp Water JE6.png|32px]] Water's internal faces have been removed. This visually reverts water to its pre-13w41a appearance when seen from the outside.}}
{{History||1.7.4|snap=13w47a|Water's internal top face has been readded.<ref>{{bug|MC-35658}}</ref>}}
{{History|||snap=13w48a|[[File:Water JE15.png|32px]] [[File:Swamp Water JE7.png|32px]] Water's internal side faces except the bottom face, have been readded.<ref>{{bug|MC-40621}}</ref><ref>{{bug|MC-190053}}</ref>}}
{{History||1.9|snap=15w43b|When viewed through [[glass]], water now appears as a solid blue color, as opposed to a downward flowing water texture.<ref name="badwatergraphicsJE">{{bug|MC-35790}}</ref>}}
{{History||1.11|snap=16w39a|Water now generates in [[woodland mansion]]s.}}
{{History||1.12|snap=17w06a|Water now hardens [[concrete powder]] into [[concrete]], on contact.}}
{{History||1.13|snap=18w07a|[[Item]]s now float in water.
|The [[player]]'s underwater visibility has been changed - the longer a player stays underwater, the better they can see.}}
{{History|||snap=18w10a|Underwater visibility now depends on the [[biome]] the player is in.}}
{{History|||snap=18w10c|Water can now be placed in the same block as [[chest]]s, [[trapped chest]]s, [[stairs]], [[slab]]s, [[fence]]s, [[wall]]s, [[iron bars]] and [[glass pane]]s.}}
{{History|||snap=18w10d|Water can now be placed in [[ender chest]]s, [[trapdoor]]s, [[ladder]]s, and [[sign]]s.}}
{{History|||snap=18w15a|[[File:Water JE16.png|32px]] {{color|#3F76E4}} Added default water color. The textures of water have been changed from blue to grayscale.<ref>{{bug|MC-200838}}</ref>
|[[File:Warm Ocean Water JE.png|32px]] [[File:Lukewarm Ocean Water JE.png|32px]] [[File:Frozen Ocean Water JE.png|32px]] [[File:Cold Ocean Water JE.png|32px]] Added water colors for [[warm ocean]], [[lukewarm ocean]], [[frozen ocean]] and [[cold ocean]].
|[[File:Swamp Water.png|32px]] {{color|#617B64}} Water color in swampland has been changed.
|[[File:Swamp Hills Water 18w15a.png|32px]] {{color|#E0FFAE}} Water color in swampland M is unchanged.<ref>{{bug|MC-128558}}</ref>
|Water now blocks 1 [[light]] level per [[block]] instead of 3.
|[[Player]]s no longer receive the [[Night Vision]] effect while underwater.{{verify|type=change|Did this ever happen, or is it just being used as an analogy?}}}}
{{History|||snap=18w16a|When water spreads and would later turn into a source [[block]], it now immediately places a source block.}}
{{History|||snap=18w19a|[[Experience orb]]s now float in water.}}
{{History|||snap=pre3|[[File:Swamp Water.png|32px]] {{color|#617B64}} water color in swamp hills now the same as in [[swamp]].}}
{{History|||snap=pre7|Pressing the {{control|jump}} button in flowing water at <code>level=1</code>, <code>level=2</code> and <code>level=3</code> now do normal jumps instead of {{control|swimming}} up.}}
{{History||1.15|snap=19w34a|Added [[bee]]s, which get damaged while in water.}}
{{History|||snap=19w35a|Bees now try to avoid water.}}
{{History||1.17|snap=20w45a|Flowing water no longer breaks rails.}}
{{History|||snap=21w06a|[[Aquifer]]s, large bodies of water in caves, have been added.}}
{{History|||snap=21w07a|Aquifers generate less often.}}
{{History|||snap=21w08a|Water [[spring]]s are now able to generate below Y{{=}}0.}}
{{History|||snap=21w10a|The FOV shrinking effect now respects the "FOV Effects" accessibility slider.<ref>{{bug|MC-214629}}</ref>}}
{{History|||snap=21w15a|All changes to water generation from 21w06a to 21w08a have been reverted.}}
{{History|||snap=Pre-release 2|[[Smooth lighting]] now works properly underwater.<ref>{{bug|MC-68129}} resolved as "Fixed"</ref>}}
{{History||1.18|snap=Experimental Snapshot 1|[[File:Meadow Water.png|32px]] Added water color in [[meadow]].
|All changes to water generation in the 1.17 snapshots have been reintroduced.}}
{{History||1.18|snap=21w40a|[[Water lake]]s no longer generate.}}
{{History||1.19|snap=Deep Dark Experimental Snapshot 1|Water can now generate as part of [[Ancient City|ancient cities]].}}
{{History||1.19|snap=22w14a|[[File:Mangrove Swamp Water.png|32px]] Added water color in [[mangrove swamp]].}}
{{History||1.19.3|snap=22w44a|Added the [[game rule]] {{cd|waterSourceConversion}}, which disables the formation of new water source blocks when set to {{cd|false}}.}}
{{History||1.20<br>(experimental)|link=1.19.4|snap=23w07a|[[File:Cherry Grove Water JE1.png|32px]] Added water color in [[cherry grove]].}}

{{History|pocket alpha}}
{{History||v0.1.0|[[File:Water JE11.png|32px]]{{verify|type=change|Is this accurate to how it appeared in this edition at this time?}} Added water. 
|[[File:Water JE2.png|32px]] On older or much newer devices, the old [[Java Edition|Java]] water texture is used, whereas the newer animated texture is used on intermediately modern devices.}}
{{History||v0.7.0|[[File:Water JE11.png|32px]]{{verify|type=change|Is this accurate to how it appeared in this edition at this time?}} The texture of water has been changed to the new texture for all devices.}}
{{History||v0.9.0|snap=build 1|[[File:Swamp Water BE1.png|32px]] Water now uses a dark blue coloration in [[swamp]]s.
|Water dripping [[particles]] have been changed.
|[[Water lake]]s have been added.
|Water can now be found in the farms and wells of [[village]]s.
|Two [[biome]]s have been added that are almost all water: [[ocean]]s and [[river]]s.
|Oasis now generate in the new [[desert]] M [[biome]].}}
{{History||v0.10.0|snap=build 1|Smooth lighting for water has been added.
|A gradient effect has been added to water that increases its opacity with distance.
|[[File:Old bedrock swamp water.png|32px]] Water color in swampland has been changed.
|Flowing water can now push [[entities]].}}
{{History|||snap=build 7|Running water now has [[sound]]s.}}
{{History|||snap=?|Water now destroys [[block]]s.{{info needed|if this is referring to washing away plants and torches and stuff, it's been able to do that since 0.1.0}}}}
{{History||v0.14.0|snap=build 1|[[Dispenser]]s can now shoot out water from [[water bucket]]s. They can also suck up [[fluids]], including water, directly adjacent to the side they are facing.}}
{{History||v0.14.2|[[File:Old bedrock water.png|32px]] Water now uses animated texture files.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 1.0.0.0|When viewed through [[glass]], water now appears as a solid blue color, as opposed to a downward flowing water texture.<ref name="badwatergraphicsBE">{{bug|MCPE-11140}}</ref>}}
{{History||1.1.0|snap=alpha 1.1.0.0|Water now generates in [[woodland mansion]]s.
|Water now hardens [[concrete powder]] into [[concrete]], on contact.}}
{{History|bedrock}}
{{History||?|The rendering change for water in 1.0.0 has been reverted for an unknown reason.}}
{{History||1.2.13|snap=beta 1.2.13.5|Water can now be placed in the same [[block]]s as [[slab]]s and [[stairs]].}}
{{History||1.4.0|snap=beta 1.2.14.2|Water can now be placed in the same block as most transparent blocks, instead of slabs and stairs only.}}
{{History|||snap=beta 1.2.20.1|[[File:Plains Water.png|32px]] Water now has a completely new look for every [[biome]] and it is now much easier to see above and underwater (see [[Water#Bedrock Edition]] for all biome colors).
|[[Item]]s now float to the top of water.
|Underwater visibility now depends on the [[biome]] the [[player]] is in.
|[[Respiration]] enchantment and [[Water Breathing]] effect no longer grants enhanced underwater visibility.}}
{{History|||snap=?|When viewed through [[glass]], water now appears as its own top texture, as opposed to a downward flowing water texture.<ref name="badwatergraphicsBE"/>}}
{{History||1.14.0|snap=beta 1.14.0.1|Added [[bee]]s, which get damaged when touching water and try to avoid it.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Water JE11.png|32px]]{{verify|type=change|Is this accurate to how it appeared in this edition at this time?}} [[File:Swamp Water JE2.png|32px]] Added water.}}
{{History||xbox=TU9|[[Dispenser]]s have been given the ability to shoot out [[fluids]], including water, inside [[water bucket]]s. They can also suck up the fluids if activated again, but a bug prevents the empty [[bucket]] from being filled.}}
{{History||xbox=TU12|[[File:Water JE15.png|32px]] Water now uses animated texture files.}}
{{History||xbox=TU25|xbone=CU14|ps=1.17|Water can be used in custom superflats. It appears as a 3D block in the block selection screen of the custom superflat interface.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Water splash [[sound]]s have been updated.
|Most [[mob]]s can now [[swimming|swim]] in water.}}
{{History||xbox=TU69|xbone=none|ps=1.76|wiiu=Patch 38|switch=none|[[File:Warm Ocean Water.png|32px]] [[File:Lukewarm Ocean Water.png|32px]] [[File:Frozen Ocean Water.png|32px]] [[File:Cold Ocean Water.png|32px]] Added [[warm ocean]], [[lukewarm ocean]], [[frozen ocean]] and [[cold ocean]] texture colors for water in those [[biome]]s.}}
{{History||ps=1.78|The animation of water is now less smooth.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Water JE15.png|32px]]{{verify|type=change|Is this accurate to how it appeared in this edition at this time?}} [[File:Old bedrock swamp water.png|32px]] Added water.}}
{{History|foot}}
<!-- Still need to add in the right version: Drowning added, Water can turn into ice -->
<!--- Still need to add "1.16 pre-release 5 - Water overlay texture turned slightly darker" -->
{{More sounds|Old and older water splash sounds.|type=historical}}

===Data history===
{{History|java}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these blocks' numeral IDs were 8 and 9. Both blocks have been merged into a single one.}}
{{History|||snap=18w10c|Removed <code>flowing_water</code>.}}
{{History|foot}}

<gallery>
EarlyFlowingWater.png|The water and flowing water in [[Infdev 20100615]].
</gallery>

==Issues==
{{Issue list}}

==Trivia==
*The texture subtly overlaid on the screen when underwater is that of the original water texture from 0.0.12a.
**The outdatedness of this texture is not considered a bug or oversight, unlike many other outdated textures.<ref>{{bug|MC-241000|||Invalid}}</ref>
**This texture is particularly difficult to notice due to its extreme transparency,<ref>{{bug|MC-128337}}</ref> as well as the fact that other blocks likely make the scene visually noisy enough to further obscure it under most conditions.
* While underwater, the player's FOV (field of vision) is lowered by 10 to simulate light {{w|refraction}}. This can be disabled via the "FOV Effects" [[option]].
*If a player or mob with the [[Levitation]] effect touches water, the effect is completely negated.<ref>{{bug|MC-83369}}</ref>

==Gallery==
<gallery>
1.8underwater.png|Underwater particles, or "bubbles".
Underground water mix.png|Water that is underground, but is still part of 2 different biomes. The color is split.
InvisibleWater.png|A glitch where water is invisible below its surface level.
Water Cave Filling.png|Water flowing into a [[cave]].
Under water.png|A view underwater.
Mac os water texture V1.13-920.gif|Animated view of the Java edition water texture.
Bubbles.gif|These bubbles appear above the [[hunger]] bar when the player's head is in water, and when all the bubbles pop, a heart of damage is dealt every second until the player is no longer entirely under water.
Waterfall.png|A naturally occurring waterfall.
Water (texture) JE1 BE1.png|This texture is subtly overlaid on the screen when underwater.
Land ruin.png|An underwater ruin {{in|bedrock}} that generated on land with a water block on top of it.
Land ruin Java.png|An underwater ruin {{in|java}} that generated on land with a visible loot chest that is not waterlogged and doesn't have water on top of it.
Largelake.png|A large lake, during a [[thunderstorm]].
Coral reef at night.png|A [[coral reef]] at night, in a [[warm ocean]] biome.
WaterRavine.jpg|A bug that causes the water to not flow into the pit.
Obsidian Spring.png|A water flowing on lava lake, creating obsidian. The water was placed by a player.
Two flowing streams.png|Waterfalls made by a player.
Watercave.png|Water flowing into the cave from nearby lake.
RavineandStornghold.png|Ravine with multiple ores, water and lava falls, and stronghold bridge over it.
Water shade.png|Different water colors in swamp biome.
File:Nonflowingwater.png|A block of water, which is not flowing because of a glitch, besides a village farm.
</gallery>

==See also==
*[[Waterlogging]]

==References ==
{{Reflist}}

==External Links ==
*[https://www.minecraft.net/en-us/article/block-week-water Block of the Week: Water] – Minecraft.net on July 14, 2017

{{Blocks|natural}}
{{Items}}

[[Category:Fluids]]
[[Category:Natural blocks]]
[[Category:Non-solid blocks]]
[[Category:Generated structure blocks]]

[[cs:Voda]]
[[de:Wasser]]
[[es:Agua]]
[[fr:Eau]]
[[hu:Víz]]
[[it:Acqua]]
[[ja:水]]
[[ko:물]]
[[nl:Water]]
[[pl:Woda]]
[[pt:Água]]
[[ru:Вода]]
[[th:น้ำ]]
[[tr:Su]]
[[uk:Вода]]
[[zh:水]]</li></ul></nowiki>
13w36aFlowers are now discentered like tall grass.
1.8
{{Extension DPL}}<ul><li>[[Saddle|Saddle]]<br/>{{about|normal saddles|the removed horse saddle|Horse Saddle}}
{{item
| image = <gallery>
Saddle (Pig).png | Pig
Saddle (Horse).png | Horse
Saddle (Strider).png | Strider
</gallery>
| invimage = Saddle
| renewable = Yes
| stackable = No
}}

A '''saddle''' is an [[item]] required to ride [[Pig|pigs]] and [[Strider|striders]] or control ridden [[camel]]s, [[Horse|horses]], [[Donkey|donkeys]] and [[Mule|mules]].

== Obtaining ==
=== Chest loot ===
{{LootChestItem|saddle}}

=== Fishing ===
Saddles can be obtained as a "treasure" item from [[fishing]] with a base chance (without fishing rod enchantments) of 0.8%.

=== Trading ===
Master-level [[Trading#Leatherworker|leatherworker]] [[villager]]s have a 50% chance to sell a saddle for 6 [[Emerald|emeralds]] as their trade.{{only|bedrock}} This trade is always offered in ''Java Edition''.

=== Mob loot ===
Any mob that the player equips with a saddle drops the saddle upon death.

A [[strider]] may spawn being ridden by a [[zombified piglin]], which causes it to spawn wearing a saddle. This saddle always drops when the strider is killed.

A [[ravager]] always spawns with a saddle and always drops the saddle upon death. Looting does not affect the drop.

== Usage ==
[[File:SaddledHorse.png|thumb|right|A [[horse]] equipped with a saddle.]]
While [[camel]]s, [[horse]]s, [[donkey]]s, [[mule]]s and [[Skeleton Horse|skeleton horse]]s{{Only|Java}} can always be ridden, a saddle is required to control them. These mobs (only after being tamed, in the case of equine mobs) can be equipped with a saddle by placing it in their inventory, which can be opened by pressing {{control|use}} while holding a saddle or {{control|sneaking}}. The saddle can be unequipped by removing it from {{SlotSprite|Saddle}} the specific inventory slot. 

Saddles are required to ride [[Pig|pigs]] and [[Strider|striders]], but even with a saddle their movement cannot be controlled like other mobs. A [[Carrot on a Stick|carrot on a stick]] (for pigs) or a [[Warped Fungus on a Stick|warped fungus on a stick]] (for striders) is required to direct these mobs. {{control|Using}} a saddle on one of these mobs equips them with the saddle, and, since they have no inventory, there is no way to retrieve the saddle without killing the mob.

Animals can also be equipped with saddles by a [[dispenser]].

Although [[ravager]]s are equipped with saddles and sometimes ridden by other mobs, the [[player]] is unable to ride ravagers.

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=4
|sound=Saddle equip.ogg
|source=neutral
|subtitle=Saddle equips
|description=When a saddle is equipped to a camel
|id=entity.camel.saddle
|translationkey=subtitles.entity.horse.saddle
|volume=0.5
|pitch=0.8
|distance=16}}
{{Sound table
|subtitle=MC-184399
|source=neutral
|description=When a saddle is equipped to a strider
|id=entity.strider.saddle
|translationkey=-
|volume=0.5
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Saddle equips
|source=neutral
|description=When a saddle is equipped to a horse, donkey, mule, skeleton horse, or zombie horse
|id=entity.horse.saddle
|translationkey=subtitles.entity.horse.saddle
|volume=0.5
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Saddle equips 
|source=neutral
|description=When a saddle is equipped to a pig
|id=entity.pig.saddle
|translationkey=subtitles.entity.pig.saddle
|volume=0.5
|pitch=1.0
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|rowspan=3
|sound=Saddle equip.ogg
|source=neutral
|description=When a saddle is equipped to a camel
|id=mob.horse.leather
|volume=1.0
|pitch=1.0}}
{{Sound table
|source=neutral
|description=When a saddle is equipped to a horse, mule, skeleton horse, or zombie horse
|id=mob.horse.leather
|volume=0.6
|pitch=1.0}}
{{Sound table
|source=neutral
|description=When a saddle is equipped to a donkey
|id=mob.horse.leather
|volume=0.5
|pitch=1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Saddle
|spritetype=item
|nameid=saddle
|id=371
|form=item
|foot=1}}

== Achievements ==
{{load achievements|When Pigs Fly}}

== Advancements ==
{{load advancements|This Boat Has Legs}}

== History ==
{{needs render|type=old|isolated saddles in 1.13 dev|section=11}}
{{History|java infdev}}
{{History||20100625-2|[[File:Saddle (Pig) JE1 BE1.png|32px]] [[File:Saddle JE1 BE1.png|32px]] Added saddles.
|Saddles do not [[drops|drop]] from saddled [[pig]]s.
|Saddles can be found in the new [[dungeon]] [[chest]]s.}}
{{History|java}}
{{History||1.2.4|snap=release|When baby animals were introduced, baby [[pig]]s could be ridden just like adult pigs. After this version, baby pigs can no longer be saddled.}}
{{History||1.3.1|snap=12w21a|Saddles can now be [[trading|bought]] from butcher [[villager]]s for 6–7 [[emerald]]s each, and thus have become [[renewable resource|renewable]].}}
{{History||1.4.2|snap=12w36a|Saddles now [[drops|drop]] from killing saddled [[pig]]s.
|Added [[Carrot on a Stick|carrot on a stick]] to direct saddled pigs, effectively controlling them.}}
{{History|||snap=12w37a|Pigs can now jump when being ridden.}}
{{History||1.6.1|snap=13w18a|Regular saddles can now be used to ride [[horse]]s, while previously they required [[Horse Saddle|horse saddle]]s.
|Added saddles to the loot tables of [[mineshaft]] minecarts, [[stronghold]] altar chests, [[village]] blacksmith chests, as well as [[Desert pyramid|desert]] and [[jungle pyramid]]s.
|Added chests to [[Nether Fortress|nether fortresses]], where saddles can be found.}}
{{History||1.7.2|snap=13w36a|Saddles can now be [[fishing|fished]] with [[Fishing Rod|fishing rod]]s and are described as treasure.}}
{{History||1.8|snap=14w02a|[[Trading]] has been changed: leatherworker [[villager]]s now [[trading|sell]] saddles for 8–10 [[emerald]]s each, and butchers no longer [[trading|trade]] saddles.}}
{{History||1.9|snap=15w31a|Saddles can now be found in [[End City|end city]] [[chest]]s.}}
{{History|||snap=15w43a|The average yield of saddles in [[Nether Fortress|nether fortress]] chests has been slightly decreased.}}
{{History|||snap=15w44a|Saddles have been removed from [[mineshaft]] chests.
|The average yield of saddles in [[dungeon]] chests has been decreased.
|The average yield of saddles in [[desert pyramid|desert temple]] chests has been increased.}}
{{History||1.13|snap=17w45a|[[File:White Horse (Saddle) 17w45a.png|50px]] The models of the horse's saddle has been changed.}}
{{History|||snap=17w46a|[[File:White Horse (Saddle) 17w46a.png|50px]] The models of the horse's saddle has been changed once again.}}
{{History|||snap=17w47a|Prior to [[Java Edition 1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 329.}}
{{History|||snap=18w03a|[[File:White Horse (Saddle) 18w03a.png|50px]] The models of the horse's saddle has been changed once again.}}
{{History|||snap=pre2|[[File:White Horse (Saddle) 1.13pre2.png|50px]] The models of the horse's saddle has been changed once again. The reins bit has now been rendered. Also, the lines of the reins are no longer rendered except when riding.}}
{{History||1.14|snap=18w43a|Added [[ravager|illager beast]]s, which [[drops|drop]] saddles.
|[[File:Saddle (Pig) JE2 BE2.png|32px]] [[File:Saddle (Horse) JE2 BE2.png|32px]] <br>[[File:Saddle JE2 BE2.png|32px]] The textures of saddles have been changed.}}
{{History|||snap=18w48a|Saddles can now be found in [[chest]]s in [[village]] tanneries.}}
{{History|||snap=18w49a|Saddles can now be found in chests in [[savanna]] village houses.}}
{{History||1.16|snap=20w13a|[[File:Saddle (Strider) JE1 BE1.png|32px]] Added [[strider]]s, which can be ridden with saddles.}}
{{History|||snap=20w15a|Saddles placed in a [[dispenser]] can now saddle pigs, striders, and tamed horses, donkeys and mules.}}
{{History|||snap=20w16a|Saddles now generate in [[Bastion Remnant|bastion remnant]] chests.}}
{{History|||snap=20w17a|[[File:Saddle (Strider) JE2.png|32px]] The texture of the strider saddles has been changed. The front and back orientation of the saddle has been corrected.<ref>{{bug|MC-176116}}</ref>}}
{{History||1.19|snap=22w13a|Saddles may now be found in [[ancient city]] [[chest]]s.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Saddles can be used to ride [[camel]]s with the use of a built-in experimental data pack.}}

{{History|pocket alpha}}
{{History||v0.7.0|[[File:Saddle JE1 BE1.png|32px]] Added saddles. They are currently unobtainable and have no practical usage since they cannot be equipped on any mobs.}}
{{History||v0.9.0|snap=build 1|Saddles can now be obtained from [[village]] blacksmith [[chest]]s.}}
{{History||v0.11.0|snap=build 1|Saddles can now be [[fishing|fished]] with [[fishing rod]]s and are described as treasure.}}
{{History||v0.12.1|snap=build 1|Saddles can now be found in [[nether fortress]]es.}}
{{History||v0.13.0|snap=build 1|Saddles can now be found in [[desert temple]]s.}} 
{{History||v0.15.0|snap=build 1|[[File:Saddle (Pig) JE1 BE1.png|32px]] [[File:Saddle (Horse) JE1 BE1.png|32px]] Saddles can now be used for riding [[horse]]s and [[pig]]s.|Saddles can now be found inside [[jungle temple]]s.}}
{{History||snap=?||Added saddles to the [[Creative inventory]].{{info needed}}}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Saddles can now be found in [[end cities]].}}
{{History||1.0.4|snap=alpha 1.0.4.0|Saddles are now [[trading|sold]] by leatherworker [[villager]]s for 8-10 [[emerald]]s as their only third tiers [[trading|trades]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|Saddles can now be found in [[plains]] [[village]] tannery and weaponsmith [[chest]]s.
|Added [[ravager]]s, which [[drops|drop]] a saddle upon death.
|[[File:Saddle (Pig) JE2 BE2.png|32px]] [[File:Saddle (Horse) JE2 BE2.png|32px]] <br>[[File:Saddle JE2 BE2.png|32px]] The textures of saddles have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Saddles can now be found in [[savanna]], [[snowy taiga]], [[taiga]] and [[snowy tundra]] village tannery [[chest]]s.
|Saddles can now be found in savanna, taiga, snowy taiga, and [[desert]] village weaponsmith chests.
|Saddles can now be found in savanna [[village]] house chests.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has been changed. Leatherworker [[villager]]s now have 50% chance to [[trading|sell]] saddles for 10 [[emerald]]s as part of their last tier [[trading|trade]].}}
{{History||1.12.0|snap=beta 1.12.0.3|The trading price of saddles has been lowered to 6 emeralds.}}
{{History||1.16.0|snap=beta 1.16.0.57|[[File:Saddle (Strider) JE1 BE1.png|32px]] Added [[strider]]s, which can be ridden with saddles.|Saddles now generate in [[Bastion Remnant|bastion remnant]] chests.}}
{{History||1.20.0<br>(Experimental)|link=Bedrock Edition 1.19.50|snap=beta 1.19.50.21|Saddles can now be used to ride [[camel]]s with the use of the "[[Bedrock Edition 1.20|Next Major Update]]" [[experimental]] toggle.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Saddle (Pig) JE1 BE1.png|32px]] <br>[[File:Saddle JE1 BE1.png|32px]] Added saddles.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Saddle (Pig) JE2 BE2.png|32px]] [[File:Saddle (Horse) JE2 BE2.png|32px]] <br>[[File:Saddle JE2 BE2.png|32px]] The textures of saddles have been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Saddle (Pig) JE1 BE1.png|32px]] <br>[[File:Saddle JE1 BE1.png|32px]] Added saddles.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* A saddle is considered "armor" by the game, but the value of protection to the animal is zero.
* A saddle on a pig can still be seen if the pig is afflicted with [[Invisibility]].
* When riding a saddled mob, the hunger bar is replaced by hearts (representing the mounted mob's health) resembling the look of the saddle.

== Gallery ==
<gallery>
File:Pig saddle.png|A [[player]] riding a [[pig]] (before [[Java Edition Beta 1.8|Beta 1.8]]).
File:Horse saddle.png|A player riding a [[horse]].
File:13w21a-new-HorseUI-inventory.png|The horse interface implemented in [[Java Edition 13w21a|13w21a]] that allows for the removal of saddles, but only on horses, [[donkey]]s or [[mule]]s.
File:Saddled Mule (picture).png|Mule equipped with both a saddle and a [[chest]].
File:GodSpawner.png|A saddle found in a monster room chest, which coincidentally contains an [[enchanted golden apple]].
</gallery>

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

== References ==
{{reflist}}

{{items}}

[[cs:Sedlo]]
[[de:Sattel]]
[[es:Montura]]
[[fr:Selle]]
[[hu:Nyereg]]
[[it:Sella]]
[[ja:鞍]]
[[ko:안장]]
[[nl:Zadel]]
[[pl:Siodło]]
[[pt:Sela]]
[[ru:Седло]]
[[zh:鞍]]
[[Category:Renewable resources]]
[[uk:Сідло]]</li><li>[[Redstone Comparator|Redstone Comparator]]<br/>{{Block
| image = 
| image2 = 
| transparent = Yes
| light = No
| tool = any
| renewable = Yes
| stackable = Yes (64)
| flammable = No
| lavasusceptible = No
| group = Redstone Comparator
| group2 = Subtracting
| group3 = Powered
| group4 = Powered+Subtracting
| 1-1 = Redstone Comparator.png
| 2-1 = Subtracting Redstone Comparator.png
| 3-1 = Powered Redstone Comparator.png
| 4-1 = Powered Subtracting Redstone Comparator.png
}}
{{Many images}}
A '''redstone comparator''' is a [[block]] that can produce an [[Redstone Dust|output signal]] from its front by reading [[chest]]s, [[lectern]]s, [[beehive]]s and similar blocks, or repeat a signal without changing its strength. It can also be set to either stop outputting a signal when its side input recieves a stronger one (front torch off), or subtract its side input's signal strength from its output (front torch on).

== Obtaining ==
=== Natural generation ===
Redstone comparators generate in [[Ancient City|ancient cities]].

=== Breaking ===
A redstone comparator can be broken instantly with any [[tool]], or by hand, and drops itself as an item.

{{Breaking row|Redstone Comparator|horizontal=y}}

A redstone comparator is removed and dropped as an item if:
* its attachment block is moved, removed, or destroyed;
* [[water]] flows into its space;{{only|java}}
* a [[piston]] tries to push it or moves a block into its space.

If [[lava]] flows into a redstone comparator's space, the redstone comparator is destroyed without dropping as an item.

=== Crafting ===
{{Crafting
|B1=Redstone Torch
|A2=Redstone Torch
|B2=Nether Quartz
|C2=Redstone Torch
|A3=Stone
|B3=Stone
|C3=Stone
|Output= Redstone Comparator
|type=Redstone
}}

== Usage ==
A redstone comparator can be placed on the top of any [[opaque]] block with a solid full-height top surface (including upside-down [[slab]]s and upside-down [[stairs]]). {{IN|be}}, a comparator can also be placed on [[wall]]s and fences. For more information about placement on transparent blocks, see [[Opacity/Placement]].

The redstone comparator has a front and a back — the arrow on the top of the comparator points to the front. When placed, the comparator faces away from the player. The comparator has two miniature redstone torches at the back and one at the front. The back torches turn on when the comparator's output is greater than zero (the arrow on top also turns red). The front torch has two states that can be toggled by {{control|using}} the comparator:
* Down and unpowered (indicating the comparator is in "comparison mode")
* Up and powered (indicating the comparator is in "subtraction mode")

The redstone comparator can take a signal strength input from its rear as well as from both sides. Side inputs are accepted only from [[redstone dust]], [[block of redstone]], [[redstone repeater]]s, other comparators, and [[observer]]s in specific scenarios. The redstone comparator's front is its output.

It takes 1 [[redstone tick]] (2 game ticks, or 0.1 seconds barring lag) for signals to move through a redstone comparator, either from the rear or from the sides. This applies to changing signal strengths as well as simply to turning on and off. 

Redstone comparators check their power state before their scheduled ticks update. This results in redstone comparators not usually responding to 1-tick fluctuations of power or signal strength — for example, a [[clock circuit|1-clock]] input is treated as always off from the side, and always on from the rear. This happens because the signal changes back to its original state before the redstone comparator checks its input states. However, certain setups such as powering any input with two separate observer pulses at the same time will cause a redstone comparator to respond to 2 gametick pulses.

The redstone comparator has four functions: maintain signal strength, compare signal strength, subtract signal strength, and measure certain block states (primarily the fullness of containers).

=== Maintain signal strength ===
A redstone comparator with no powered sides outputs the same signal strength as its rear input.

=== Compare signal strength ===
[[File:Comparators Explained.png|Comparators in comparison mode.|thumb]]
A redstone comparator in comparison mode (front torch down and unpowered) compares its rear input to its two side inputs. If either side input is greater than the rear input, the comparator output turns off. If neither side input is greater than the rear input, the comparator outputs the same signal strength as its rear input.

The formula for calculating the output signal strength is as follows:

<code>output = rear × [[Wikipedia:Iverson bracket|[]]'''''left''''' ≤ '''''rear''''' AND '''''right''''' ≤ '''''rear'''''[[Wikipedia:Iverson bracket|<nowiki>]]]</code>
{{-}}

=== Subtract signal strength ===
[[File:Redstone comparator.png|thumb|The greatest of the side inputs A and C is subtracted from the rear input B, outputting 1. If either A or C were greater than B, it would output 0.]]
A redstone comparator in subtraction mode (front torch up and powered) subtracts the signal strength of the higher side input from the signal strength of the rear input.

<code>output = max('''''rear''''' − max('''''left''', '''right'''''), 0)</code>

For example: if the signal strength is 6 at the left input, 7 at the right input and 4 at the rear, the output signal has a strength of ''max(4 − max(6, 7), 0) = max(4−7, 0) = max(−3, 0) = 0''.

If the signal strength is 9 at the rear, 2 at the right input and 5 at the left input, the output signal has a strength of ''max(9 − max(2, 5), 0) = max(9−5, 0) = 4''.

=== Measure block state ===
{{Schematic | caption = A redstone comparator can measure the fullness of a chest, as well as other block states, even through an opaque block.
 |rd-ew!|rc-w!|ch|SB|rc-e!|rd-ew!
}}
A redstone comparator treats certain blocks behind it as power sources and outputs a signal strength proportional to the block's state. The comparator may be separated from the measured block by an opaque block. However, {{in|je}}, if the opaque block is powered to signal strength 15, then the comparator outputs 15 no matter the fullness of the container.<ref>{{bug|MC-64394}} (resolved as "Works As Intended")</ref>
[[Category:Java Edition specific information]]
{{-}}

==== Fullness of containers ====
{| class="wikitable floatright" style="margin-left: 0.5em; margin-right: 0; text-align: center;"
|+ Minimum Items for Container Signal Strength
|-
!Containers
!{{BlockSprite|Furnace|link=Furnace}}<br>{{BlockSprite|Blast Furnace|link=Blast Furnace}}<br>{{BlockSprite|Smoker|link=Smoker}}
!{{BlockSprite|Hopper|link=Hopper}}<br>{{EntitySprite|Minecart with Hopper|link=Minecart with Hopper}}<br>{{BlockSprite|Brewing Stand|link=Brewing Stand}}
!{{BlockSprite|Dispenser|link=Dispenser}}<br>{{BlockSprite|Dropper|link=Dropper}}
!{{BlockSprite|Chest|link=Chest}}<br>{{EntitySprite|Minecart with Chest|link=Minecart with Chest}}<br>{{BlockSprite|Shulker Box|link=Shulker Box}}<br>{{BlockSprite|Barrel|link=Barrel}}
![[Double Chest|{{Schematic|size=16|ch-s|-|ch-n}}
]]
!{{BlockSprite|Jukebox|link=Jukebox}}
|-
!Total Slots
!3!!5!!9!!27!!54!!1
|-
!Power Level
! colspan="5" |Number of Items
!Music Disc
|-
|0||0||0||0||0||0||No disc
|-
|1||1||1||1||1||1||"13"
|-
|2||14||23||42||1s 60||3s 55||"cat"
|-
|3||28||46||1s 19||3s 55||7s 46||"blocks"
|-
|4||42||1s 5||1s 60||5s 51||11s 37||"chirp"
|-
|5||55||1s 28||2s 37||7s 46||15s 28||"far"
|-
|6||1s 5||1s 51||3s 14||9s 42||19s 19||"mall"
|-
|7||1s 19||2s 10||3s 55||11s 37||23s 10||"mellohi"
|-
|8||1s 32||2s 32||4s 32||13s 32||27s||"stal"
|-
|9||1s 46||2s 55||5s 10||15s 28||30s 55||"strad"
|-
|10||1s 60||3s 14||5s 51||17s 23||34s 46||"ward"
|-
|11||2s 10||3s 37||6s 28||19s 19||38s 37||"11"
|-
|12||2s 23||3s 60||7s 5||21s 14||42s 28||"wait"
|-
|13||2s 37||4s 19||7s 46||23s 10||46s 19||"Pigstep"
|-
|14||2s 51||4s 42||8s 23||25s 5||50s 10||"Otherside"<br>"Relic"
|-
|15||3s||5s||9s||27s||54s||"5"
|}
A redstone comparator can output a signal indicating how full a container is. (0 for empty, 15 for full, etc.) The table on the right is described more in detail, later in this section.

Containers that can be measured by a comparator include:
* {{BlockLink|Furnace}}
* {{BlockLink|Blast Furnace}}
* {{BlockLink|Smoker}}
* {{BlockLink|Brewing Stand}}
* {{BlockLink|Hopper}}
* {{ItemLink|Minecart with Hopper}} on top of a [[detector rail]]
* {{BlockLink|Dispenser}}
* {{BlockLink|Dropper}}
* {{BlockLink|Chest}}
* {{BlockLink|Trapped Chest}}
* {{ItemLink|Minecart with Chest}} on top of a [[detector rail]]
* {{BlockLink|Barrel}}
* {{SchematicSprite|size=16|ch-e}}{{SchematicSprite|size=16|ch-w}} Large chest
* {{SchematicSprite|size=16|ch-e}}{{SchematicSprite|size=16|ch-w}} Large trapped chest
* {{BlockLink|Shulker Box}} (any color)

Generally speaking, the comparator output signal strength represents the average fullness of the slots, based on how many of that item form a full stack (64, 16, or 1 for non-stackable items).

The ''Minimum Items for Container Signal Strength'' table (right) shows the minimum '''''full-stack-equivalent (FSE)''''' to produce different signal strengths from common containers. A '''''full-stack-equivalent''''' quantifies how many normal 64-stackable items are needed to output a corresponding signal strength. The 's' is a constant 64, with the additional amount needed following after.

One may also consider the terms: '''c''umulative-weight''''' or '''''weighted-sum''''' instead of '''''full-stack-equivalent'''''.

Items that stack to a max of 16  ([[snowball]]s, [[sign]]s, [[ender pearl]]s, etc.), contribute +4 to the ''full-stack-equivalent'' for each unity (count of 1 item). Similarly, items that stack to 1 ([[minecart]], [[boat]], etc.) contribute +64, and items that stack to 64 contribute +1.

Example 1: 3 ender pearls will contribute a 3 x 4 = 12 ''full-stack-equivalent''.

Example 2: 16 ender pearls and 60 redstone dust contributes a 16x4 + 60x1 = 124 ''full-stack-equivalent''.

Example 3: 1 minecart and 60 redstone dust contributes a 1x64 + 60x1 = 124 ''full-stack-equivalent''.

Example 4: To produce a signal strength of 10 from a hopper, one requires a ''full-stack-equivalent'' of at least 3s + 14 = 206 but strictly less than than 3s + 37 = 229. This can be done with 3 minecarts, and 14 dirt.

When a comparator measures a large chest or large trapped chest, it measures the entire large chest (54 slots), not just the half directly behind the comparator. A chest or trapped chest that cannot be opened (either because it has an opaque block, [[ocelot]], or [[cat]] above it) always produces an output of 0 no matter how many items are in the container — shulker boxes can always be measured, even if they cannot open.

;Calculating signal strength from items

:When a container is empty, the output is off.

:When it is not empty, the output signal strength is calculated as follows:

:<code>'''''signal strength''''' = floor(1 + (('''''sum of all slots' fullnesses''''') / ('''''number of slots in container''''')) × 14)</code>

:<code>fullness of a slot = '''''number of items in slot''''' / '''''max stack size for this type of item'''''</code>

:''Example:'' 300 blocks in a dispenser (which has 9 slots), where each block stacks to a maximum of 64 has a 300 ''full-stack-equivalent.'' This produces an output with a signal strength of 8:
<blockquote>
1 + ((300 items / 64 items per slot) / 9 slots) × 14 = 8.292, floored is 8
</blockquote>

;Calculating items from signal strength

:It can be useful in redstone circuits to use containers with comparators to create signals of a specific strength. The number of items required in a container to produce a signal of desired strength is calculated as follows:

:<code>items required = max('''''desired signal strength''''', roundup(('''''total slots in container''''' × 64 / 14) × (desired signal strength − 1)))</code>

:''Example:'' To use a furnace (which has 3 slots) to create a strength 9 signal, players need 110 items:
<blockquote>
max(9, (3×64/14) × (9−1)) = 109.714, rounded up is 110
</blockquote>
{{-}}

==== Miscellaneous ====
[[File:Comparator storage.png|Comparators used to measure containers.|thumb]]
Some non-container blocks can also be measured by a redstone comparator:

;{{BlockLink|Beehive}} and {{BlockLink|Bee nest}}

: A hive or nest outputs a signal strength equal to the amount of honey in the hive/nest.

;{{BlockLink|Cake}}

: A cake outputs a signal strength relative to the amount of cake remaining.  Each slice is worth 2 signal strength, with 7 total slices, for an output of 14 for a full cake.

[[File:Cauldron Redstone Strength Values.png|Cauldron signal strength|thumb]]
;{{BlockLink|Cauldron}}

: A cauldron outputs different signal strengths depending on how much water or powdered snow is inside. From completely empty to completely full, the output values are 0, 1, 2, and 3. If lava or powder snow is inside, the strength is always 3.

[[File:Composter Redstone Strength Values.png|Composter signal strength|thumb]]
;{{BlockLink|Composter}}

: A composter outputs different signal strengths depending on the level inside. From completely empty to completely full, the output values are 0, 1, 2, 3, 4, 5, 6, 7 and 8.

;{{Anchor|CommandBlock}}{{BlockLink|Command Block}}

: A command block stores the "success count" of the last command executed, which represents the number of times the most recently used command of this command block succeeded. A "success" is defined by the [[command]]'s success conditions: if a red error message is returned in the chat, the command was not successful.

: Most commands can succeed once per execution, but certain commands (such as those that accept players as arguments) can succeed multiple times, and the comparator outputs the number of times it succeeded (maximum 15 when sent to redstone dust, but in the code it is able to go up to the 32-bit integer limit, and can be used in contraptions with no redstone dust with those values).

: A command block continues to store the success count of the last command executed until it executes its command again, thus the comparator continues to output the same signal strength even after the command block is no longer being activated (it doesn't turn off when the signal to the command block turns off).

;{{BlockLink|End Portal Frame}}

: An end portal frame outputs a full signal of 15 if it contains an [[eye of ender]] and zero otherwise.

[[File:Item frame and comparator.png|A comparator can measure the presence and rotation of an item frame's contents.|thumb]]

;{{EntityLink|Item Frame}}

: A comparator can measure the state of an [[item frame]]'s contents. An item frame comparator outputs 0 if the item frame is empty, or 1 to 8 for any item depending on its rotation: 1 at initial placement, plus 1 for each 45° of rotation for a maximum of 8.

: For an item frame that holds a map, a unit of rotation is 90° instead of 45°, but a comparator still outputs power levels 1 to 8. It takes two full rotations to cycle through all comparator outputs, and each orientation of the map corresponds to two output levels that differ by 4.

: The comparator must be placed behind the block the item frame is attached to, facing away from the item frame. The block must be a full block, and the item frame cannot be submerged in water. Having a sign in the same block as the item frame will prevent the frame from sending a signal as well.{{only|java}}

;{{BlockLink|Jukebox}}

: A jukebox outputs a signal strength indicating which music disc is currently playing. See the ''Minimum Items for Container Signal Strength'' table above.

;{{BlockLink|Lectern}}

: A lectern outputs a signal strength that depends on what page the player is currently on. The calculation used is:
:<code>'''''signal strength''''' = floor(1 + (('''''current page''''' - 1) / ('''''number of pages in book''''' - 1)) × 14)</code>
:This results in page 1 having a signal strength of 1, and the last page having a signal strength of 15. The exception is a single page book, which will output a signal strength of 15.
:For example, a book with 15 pages will output a signal equal to the current page number.  A book with 5 pages will output signal strengths of 1, 4, 8, 11 and 15 for the different pages. A book with 100 pages will have the signal strength increase to the next level on pages 1, 9, 16, 23, 30, 37, 44, 51, 58, 65, 72, 79, 86, 93 and 100.
:

;{{BlockLink|Respawn Anchor}}

: A respawn anchor outputs a signal strength of 0, 3, 7, 11, or 15, depending on the "charged" value.

;{{BlockLink|Sculk Sensor}}

: A sculk sensor outputs a signal strength depending on the type of vibration that is detected.

;{{BlockLink|Chiseled Bookshelf}}

: A chisled bookshelf outputs a signal strength between 1 and 6 indicating the last slot interacted with. When no slot has been interacted with yet, it outputs 0.
{{-}}

== Sounds ==
=== Generic ===
{{Edition|Java}}:
{{Sound table/Block/Stone/JE}}
{{Edition|Bedrock}}:
{{Sound table/Block/Wood/BE}}

=== Unique ===
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Click.ogg
|subtitle=Comparator clicks
|source=block
|description=When a comparator is set to subtraction mode
|id=block.comparator.click
|translationkey=subtitles.block.comparator.click
|volume=0.3
|pitch=0.55
|distance=16}}
{{Sound table
|subtitle=Comparator clicks
|source=block
|description=When a comparator is set to comparison mode
|id=block.comparator.click
|translationkey=subtitles.block.comparator.click
|volume=0.3
|pitch=0.5
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|rowspan=2
|sound=Click.ogg
|source=block
|description=When a comparator is set to subtraction mode
|id=block.click
|volume=0.2
|pitch=0.55}}
{{Sound table
|source=block
|description=When a comparator is set to comparison mode
|id=block.click
|volume=0.2
|pitch=0.5
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Redstone Comparator
|spritetype=block
|nameid=comparator
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=redstone-comparator
|spritetype=block
|nameid=comparator
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Redstone Comparator
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Unpowered block
|spritename=unpowered-comparator
|spritetype=block
|nameid=unpowered_comparator
|id=149
|form=block
|translationkey=-}}
{{ID table
|displayname=Powered block
|spritename=powered-comparator
|spritetype=block
|nameid=powered_comparator
|id=150
|form=block
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=redstone-comparator
|spritetype=item
|nameid=comparator
|id=522
|form=item
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=redstone-comparator
|spritetype=block
|nameid=Comparator
|foot=1}}

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

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

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

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

== Advancements ==
{{Load advancements|the power of books}}

== Video ==

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

== History ==
{{info needed section|If {{bug|MC-50242}} also affected comparators?}}
''For a more in-depth breakdown of changes to repeater textures and models, including a set of renders for each state combination, see [[/Asset history]]''
{{History|java}}
{{History||November 24, 2012|link=https://youtube.com/watch?v=YG9RNyRhIow&t=6m56s|[[Jeb]] stated that there may be a "capacitor" in [[Minecraft]]. }}
{{History||December 27, 2012|link={{tweet|Dinnerbone|284388625595125760}}|[[Dinnerbone]] released [https://web.archive.org/web/20190710120115/https://imgur.com/a/FBKed pictures] of the first version of the "comparator", stating it was a replacement for the "capacitor" idea that has variable, alternate inputs.}}
{{History||January 2, 2013|link={{tweet|Dinnerbone|286428595423965184}}|Dinnerbone released one more [http://dinnerbone.com/media/uploads/2013-01/screenshots/2013-01-02_12.06.47.png picture] of the comparator. The picture itself showing a digital-to-analog converter, using the comparator as the main [[block]].}}
{{History||1.5|snap=13w01a|[[File:Redstone Comparator (S) JE1.png|32px]] [[File:Powered Redstone Comparator (S) JE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE1.png|32px]] [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.
|Redstone comparators have 0 delay.
At this point, block ID 149 was used for unpowered comparators, and block ID 150 for powered comparators.}}
{{History|||snap=13w01b|A delay of 1 game tick ({{frac|1|2}} redstone tick) has now been added to redstone comparators to fix bugs.
|The ability to measure containers to redstone comparators has now been added.}}
{{History|||snap=13w02a|[[File:Redstone Comparator (S) JE2.png|32px]] [[File:Powered Redstone Comparator (S) JE2.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2.png|32px]] The appearance of redstone comparators has now been changed - the top texture has changed to show [[quartz]] in the middle and the sides now use the [[smooth stone]] texture rather than the smooth stone slab side texture.
|The algorithm for measuring containers has now been changed so that redstone comparators output a signal with as few as 1 [[item]] in the container.}}
{{History|||snap=13w02b|Redstone comparators now treat large [[chest]]s as a single container.}}
{{History|||snap=13w03a|Redstone comparators now output success count of [[command block]]s.
|Redstone comparators now measure container [[minecart]]s on [[detector rail]]s.}}
{{History|||snap=13w04a|Redstone comparators now measure [[jukebox]]es.}}
{{History|||snap=13w05a|Redstone comparators no longer cause constant [[block]] updates. The delay has now been made consistent, and side input no longer causes a pulse output.
|Block 150 (later <code>powered_comparator</code>) is no longer used; powered state is now represented by the 8s bit on block 149 (later <code>unpowered_comparator</code>).}}
{{History|||snap=13w05b|Redstone comparator delay has now been changed from 1 game tick (1/2 [[redstone]] tick) to 2 game ticks (1 redstone tick).}}
{{History|||snap=13w09c|The redstone signal strength from a redstone comparator next to a [[brewing stand]] with 3 [[water bottle]]s in it is now the same as one with 3 water bottles and 1 ingredient in it.}}
{{History||1.6.1|snap=13w18a|Redstone comparators now measure [[cauldron]]s and [[end portal frame]]s.}}
{{History||1.8|snap=14w04a|Redstone comparators now measure [[item frame]]s.}}
{{History|||snap=14w10a|The torches under redstone comparators have now been shortened, which has changed the underside appearance from [[File:Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Powered Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Subtracting Redstone Comparator UNKVER1 (facing NWU).png|32px]] [[File:Powered Subtracting Redstone Comparator UNKVER1 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER2 (facing NWU).png|32px]].}}
{{History|||snap=14w25a|[[File:Redstone Comparator (S) JE3.png|32px]] [[File:Powered Redstone Comparator (S) JE3.png|32px]] [[File:Subtracting Redstone Comparator (S) JE3.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE3.png|32px]] The torches on comparators are now subject to ambient occlusion.
|Comparators set to subtract mode appear to be powered as well regardless of incoming power. The subtracting-only model still exists and can be achieved through {{cmd|setblock}}.}}
{{History|||snap=14w25b|[[File:Subtracting Redstone Comparator (S) JE4.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE4.png|32px]] The powered front torch when in subtraction mode is now lower.
|Comparators set to subtract by hand now appear normally again.}}
{{History|||snap=14w28a|Redstone comparators now measure [[cake]]s.}}
{{History||1.9|snap=15w42a|With the addition of the [[blaze powder]] fuel slot, [[brewing stand]]s now have 5 slots instead of 4. Their original comparative power values from redstone comparators are listed below:
{{{!}} class{{=}}"wikitable collapsible collapsed" data-description{{=}}"Original values"
! Original values
{{!}}-
{{!}}
*0: 0
*1: 1
*2: 19
*3: 37
*4: 55
*5: 1s 10
*6: 1s 28
*7: 1s 46
*8: 2s
*9: 2s 19
*10: 2s 37
*11: 2s 55
*12: 3s 10
*13: 3s 28
*14: 3s 46
*15: 4s
{{!}}}
}}
{{History|||snap=15w47a|Redstone comparators' side inputs now take power from [[redstone block]]s.}}
{{History||1.13|snap=17w47a|All 3 IDs for the redstone comparator have now been merged into one ID: <code>comparator</code>.
|Redstone comparators now render their underside, which has changed their undersides from [[File:Redstone Comparator UNKVER2 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER3 (facing NWU).png|32px]].
|Prior to [[1.13/Flattening|''The Flattening'']], these blocks' numeral IDs were 149 and 150, and the [[item]]'s 404.
|As a result, the formerly unused comparator ID is now technically used again, due to both unpowered and powered versions being merged into a single comparator block ID.}}
{{History||1.14|snap=18w43a|[[File:Redstone Comparator (S) JE4.png|32px]] [[File:Powered Redstone Comparator (S) JE4.png|32px]] [[File:Subtracting Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE5.png|32px]] [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}
{{History|||snap=19w02a|Redstone comparators now measure [[lectern]]s.}}
{{History|||snap=19w03a|Redstone comparators now measure [[composter]]s.}}
{{History|||snap=19w12b|Redstone comparators can now be placed on [[glass]], [[ice]], [[glowstone]] and [[sea lantern]]s.}}
{{History||1.15|snap=19w34a|Redstone comparators now measure how much honey is inside [[beehive|bee hive]]s and [[bee nest]]s.}}
{{History||1.16|snap=20w06a|The way to calculate the input signals of redstone comparators has now been changed.}}
{{History|||snap=20w11a|The changes to the way of calculating the input signals of redstone comparators from [[Java Edition 20w06a|20w06a]] have now been reverted.}}
{{History|||snap=20w16a|Redstone comparators now measure [[Pigstep music disc]]s in [[jukebox]]es.}}
{{History||1.17|snap=20w45a|Redstone comparators now measure [[lava cauldron]]s.}}
{{History|||snap=20w46a|Redstone comparators now measure [[Cauldron#Holding powder snow|powder snow cauldron‌]]s.}}
{{History||1.18|snap=21w41a|[[File:Powered Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE6.png|32px]] The texture of powered redstone comparator have now been changed.}}
{{History||1.19|snap=22w13a|Redstone comparators now generate as part of [[ancient cities]].}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Redstone comparators now measure [[chiseled bookshelves]].}}
{{History||1.20.2|snap=23w33a|Redstone comparators now use stone sounds instead of wood sounds.<ref>{{bug|MC-182820|||Fixed}}</ref>}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Redstone comparators now measure [[end portal frame]]s.}}
{{History||1.0.5|snap=alpha 1.0.5.0|Redstone comparators now output success count of [[command block]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Redstone comparators now measure [[shulker box]]es.}}
{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|Redstone comparators now measure [[jukebox]]es.
|Redstone comparators now render their underside, which has changed their undersides from [[File:Redstone Comparator UNKVER1 (facing NWU).png|32px]] to [[File:Redstone Comparator UNKVER3 (facing NWU).png|32px]]}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Redstone Comparator (S) BE.png|32px]] [[File:Powered Redstone Comparator (S) BE.png|32px]] [[File:Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Redstone comparators now measure [[smoker]]s, [[blast furnace]]s, [[lectern]]s and [[composter]]s.}}
{{History||1.18.10|snap=beta 1.18.10.20|[[File:Powered Redstone Comparator (S) JE5.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE6.png|32px]] The texture of powered redstone comparator have now been changed.}}
{{History||1.20.30|snap=beta 1.20.30.20|Redstone comparators now use the <code>minecraft:cardinal_direction</code> [[block state]] instead of <code>direction</code>.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE1 BE1.png|32px]] Added redstone comparators.}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|switch=1.0.1|Redstone comparators can now measure [[item frame]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Redstone Comparator (S) BE.png|32px]] [[File:Powered Redstone Comparator (S) BE.png|32px]] [[File:Subtracting Redstone Comparator (S) BE.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) BE.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE2 BE2.png|32px]] The textures of redstone comparators have now been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Subtracting Redstone Comparator (S) JE2 BE1.png|32px]] [[File:Powered Subtracting Redstone Comparator (S) JE2 BE1.png|32px]]{{verify|Was this the model used?}} [[File:Redstone Comparator (item) JE2 BE2.png|32px]] Added redstone comparators.}}
{{History|foot}}

=== Redstone comparator "items" ===
{{:Technical blocks/Redstone Comparator}}

== Issues ==
{{issue list}}

== Trivia ==
* Comparators do not emit redstone particles when powered, unlike redstone torches and repeaters.<ref>{{bug|MC-51692|||WAI}}</ref>

== Gallery ==
<gallery>
Dinnerbone Comparator 1.png|Dinnerbone showing how comparators work.
Dinnerbone Comparator 2.png|Dinnerbone showing how comparators work.
Dinnerbone Comparator 3.png|Dinnerbone showing how comparators work.
Dinnerbone Comparators 1.png|A contraption incorporating comparators.
Dinnerbone Comparators 2.png|Comparators in action.
Dinnerbone Comparators 3.png|Output specific signals.
Dinnerbone Comparator Thing.png|Another comparator in use.
Item Frame Comparator.png|Rotating the torch in the item frame adjusts the comparator's output.
</gallery>

== References ==
{{reflist}}

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

[[Category:Mechanics]]
[[Category:Block entities]]
[[Category:Redstone mechanics]]
[[Category:Mechanisms]]
[[Category:Manufactured blocks]]
[[Category:Non-solid blocks]]

[[de:Redstone-Komparator]]
[[es:Comparador de redstone]]
[[fr:Comparateur de redstone]]
[[hu:Redstone-komparátor]]
[[ja:レッドストーンコンパレーター]]
[[ko:레드스톤 비교기]]
[[nl:Redstonevergelijker]]
[[pl:Komparator]]
[[pt:Comparador de redstone]]
[[ru:Компаратор]]
[[uk:Редстоуновий компаратор]]
[[zh:红石比较器]]</li></ul></nowiki>
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 will now no longer make inner sections completely black.
14w11bGeneric blocks will 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 only occur 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 will now support 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 will switch 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 will now support an array of models allowing for random models.
14w30aAdded the item model "builtin/entity".
1.8.2
{{Extension DPL}}<ul><li>[[Gunpowder|Gunpowder]]<br/>{{Item
| image = Gunpowder.png
| stackable = Yes (64)
| renewable = Yes
}}

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

== Obtaining ==

=== Mob loot ===

==== Creepers ====

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

==== Ghasts ====

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

==== Witches ====

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

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

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

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

=== Chest loot ===

{{LootChestItem|gunpowder}}

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

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

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

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

== History ==

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

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

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

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

== Issues ==
{{issue list}}

== References ==
{{reflist}}

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

{{Items}}

[[Category:Recipe using Charcoal]]

[[cs:Střelný prach]]
[[de:Schwarzpulver]]
[[es:Pólvora]]
[[fr:Poudre à canon]]
[[hu:Puskapor]]
[[it:Polvere da sparo]]
[[ja:火薬]]
[[ko:화약]]
[[nl:Buskruit]]
[[pl:Proch]]
[[pt:Pólvora]]
[[ru:Порох]]
[[th:ดินปืน]]
[[tr:Barut]]
[[uk:Порох]]
[[zh:火药]]
[[Category:Renewable resources]]
[[Category:Brewing recipe]]</li><li>[[Wheat|Wheat]]<br/>{{About||the artifact in ''Minecraft Dungeons''|Minecraft Dungeons:Wonderful Wheat|the seed|Wheat Seeds}}
{{Item
| image = Wheat.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Wheat''' is an [[item]] primarily obtained by harvesting fully-grown [[Wheat Seeds|wheat crops]]. It is used for [[crafting]] as well as to feed certain animals.

== Obtaining ==

=== Natural generation ===

{{LootChestItem|wheat}}

=== Farming ===

{{main|Tutorials/Crop farming}}

When a fully-grown wheat crop is harvested, it drops 1 wheat and 1 to 4 [[wheat seeds]] ({{frac|2|5|7}} per crop harvested on average). A wheat crop has a total of eight stages (0-7) from the time it is planted until it can be harvested. If a crop is harvested before it is fully grown, it just drops one seed. Wheat needs light to grow; a seed is destroyed if planted without light. Harvesting with a [[Fortune]]-enchanted tool increases the number of seeds dropped but does not increase the yield of wheat.

=== Crafting ===

{{Crafting
|Hay Bale
|Output= Wheat,9
|type= Material
}}

=== Drops ===
A [[fox]] sometimes spawns holding wheat, which it always drops upon death. Alternatively, the player can drop a [[food]] item, causing the fox to drop the wheat.

== Usage ==

=== Food ===

[[File:New Cattle.png|thumb|Using wheat to lead a cow.]]
When wheat is held, it causes nearby [[cow]]s, [[sheep]], [[goat]]s and [[mooshroom]]s to follow the player, until either the player stops holding the wheat or goes too far away from the animal, thus leading them to lose interest.

Wheat may be used to [[breed]] cows, sheep, goats, and mooshrooms by first herding two of them together and then {{control|using}} the wheat on them to begin "Love Mode."

Wheat can heal a [[horse]] {{hp|1}} health or lower its temper by 3% when attempting to tame it. It can also decrease the time it takes for a foal to grow by 20 seconds.

Similarly, wheat can heal a [[llama]] {{hp|2}} health, and it decreases the time it takes a baby llama to grow by 10 seconds.

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===

Novice-level farmer [[Villager|villagers]] have a 25%{{only|bedrock}} or 40%{{only|java}} chance to buy 20 wheat for one [[emerald]].

=== Composting ===
Placing wheat into a [[composter]] has a 65% chance of raising the compost level by 1. A stack of wheat yields an average of 5.94 [[bone meal]].

== Achievements ==
{{load achievements|Bake Bread;The Lie;Repopulation}}

== Advancements ==
{{load advancements|A Seedy Place}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Wheat
|spritetype=item
|nameid=wheat
|id=334
|form=item
|foot=1}}

== Video ==

{{Video note|the narrator demonstrates at 0:56 that walking over wheat can destroy the crop and un-till the land. This is outdated: since version {{Version link|JE 1.1}}, wheat can be destroyed only by a player or mob jumping on it or falling on it.}}

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

== History ==

{{History|java indev}}
{{History||20100206|[[File:Wheat JE1 BE1.png|32px]] Wheat has been added.
|Wheat can be used to craft [[bread]].}}
{{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||20100625-2|Wheat can now be found in the new [[dungeon]] [[chest]]s.}}
{{History|java beta}}
{{History||1.2|Wheat can now be used to craft [[cake]].}}
{{History||1.4|Wheat can now be used to craft [[cookie]]s.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Wheat can now be used in [[breeding]].}}
{{History||1.3.1|snap=12w21a|Wheat can now be [[trading|sold]] to farmer [[villager]]s, at 18–21 wheat for 1 [[emerald]].}}
{{History||1.4.2|snap=12w36a|[[Chicken]]s and [[pig]]s no longer use wheat to [[breeding|breed]].}}
{{History||1.6.1|snap=13w16a|[[Horse]]s can now be healed by being fed wheat.
|Foals can now have their growth increased by being fed wheat.}}
{{History|||snap=13w17a|[[Horse]]s can now have their tempers lowered with wheat.}}
{{History|||snap=13w18a|Nine wheat can now be crafted to make a [[hay bale]].}}
{{History||1.8|snap=14w02a|Trading has been changed: farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{history||1.9|snap=15w43a|Wheat may now be found in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of wheat in [[dungeon]] chests has been decreased.}}
{{History||1.11|snap=16w39a|Wheat can now be 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 296.}}
{{History|||snap=18w09a|Wheat can now generate in the chests of [[underwater ruins]].}}
{{History|||snap=18w11a|Wheat can now generate in [[shipwreck]] chests.}}
{{History||1.14|snap=18w43a|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History|||snap=18w47a|Wheat can now generate inside of loot chests on top of [[pillager outpost]]s.}}
{{History|||snap=18w49a|Wheat can now generate in chests in [[village]] butcher and shepherd houses.}}
{{History|||snap=18w50a|Wheat can now generate in chests in desert [[village]] houses.}}
{{History||1.14|snap=19w03a|Placing wheat into the new [[composter]] has a 50% chance of raising the compost level by 1.}}
{{History|||snap=19w05a|Wheat now has a 65% chance of increasing the compost level in a composter by 1.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with wheat in their mouths.}}
{{History||1.17|snap=21w13a|Wheat can now be used to breed [[goat]]s.}}
{{History||1.19|snap=22w11a|Wheat can now be used to craft [[packed mud]].}}
{{History||1.20|snap=23w12a|Wheat can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Wheat no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for suspicious gravel within [[trail ruins]], wheat is now common loot.}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Wheat JE1 BE1.png|32px]] Added wheat. It is currently unobtainable and serves no purpose.}}
{{History||v0.4.0|Wheat is now obtainable via farming and can be used to craft [[bread]].}}
{{History||v0.7.0|Wheat can now be used to craft [[cake]].}}
{{History||v0.8.0|snap=build 1|Wheat can now be used to breed [[cow]]s and [[sheep]].
|Wheat can now be used to craft [[hay bale]]s.}}
{{History||v0.9.0|snap=build 1|Wheat [[crop]]s now naturally spawn in [[village]]s.
|Wheat can now be used to craft [[cookie]]s.}}
{{History||v0.15.0|snap=build 1|Wheat can now be used to grow, increase tame and heal [[horse]]s, [[donkey]]s and [[mule]]s.}}
{{History||v0.16.2|Wheat can now be found in the [[chest]]s inside of large houses in [[ice plains]] and [[cold taiga]] [[village]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Wheat can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Farmer [[villager]]s now [[trading|buy]] 18–22 wheat for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Wheat can now be found in the new [[woodland mansion]] chests.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Wheat can now be found inside [[shipwreck]] chests.}}
{{History|||snap=beta 1.2.20.1|Wheat can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Wheat can now be found in [[pillager outpost]] chests.
|[[File:Wheat JE2 BE2.png|32px]] The texture of wheat has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Wheat can now be found in [[desert]] [[village]] house chests, village shepherd and butcher house chests.
|Wheat can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|[[Trading]] has changed, farmer [[villager]]s now have a 25% chance to buy 20 wheat for one [[emerald]] as part of their first tier trade.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can drop wheat.}}

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

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

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Wheat SDGP.png|Wheat in the [[Super Duper Graphics Pack]].
File:Field of Wheat.jpg|[[Steve]] and [[Kai]] in a field of wheat crops.<ref>https://www.instagram.com/p/CumuJleg6Ij/</ref>
</gallery>

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--wheat Taking Inventory: Wheat] – Minecraft.net on April 21, 2022
{{Items}}

[[Category:Plants]]
[[Category:Food]]

[[cs:Pšenice]]
[[de:Weizen]]
[[es:Trigo]]
[[fr:Blé]]
[[hu:Búza]]
[[it:Grano]]
[[ja:小麦]]
[[ko:밀]]
[[nl:Tarwe]]
[[pl:Pszenica]]
[[pt:Trigo]]
[[ru:Пшеница]]
[[th:ข้าวสาลี]]
[[uk:Пшениця]]
[[zh:小麦]]
[[Category:Renewable resources]]</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>[[Glass Bottle|Glass Bottle]]<br/>{{about|the empty bottle||Bottle}}

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

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

== Obtaining ==

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

=== Crafting ===

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

=== Drinking ===

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

=== Mob loot ===

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

=== Mud ===

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

=== Cauldrons ===

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

== Usage ==

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

=== Collecting liquids ===

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

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

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

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

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

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

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

=== Trading ===

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

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

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

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Bottle fill water1.ogg
|sound2=Bottle fill water2.ogg
|sound3=Bottle fill water3.ogg
|sound4=Bottle fill water4.ogg
|subtitle=Bottle fills
|source=block
|description=When a bottle is filled with a liquid from a cauldron, or honey from a bee nest or beehive
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with water from a water source
|id=item.bottle.fill
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bottle empty1.ogg
|sound2=Bottle empty2.ogg
|subtitle=Bottle empties
|source=block
|description=When a water bottle is emptied
|id=item.bottle.empty
|translationkey=subtitles.item.bottle.empty
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Bottle fill dragon breath1.ogg
|sound2=Bottle fill dragon breath2.ogg
|subtitle=Bottle fills
|source=neutral
|description=When a bottle is filled with dragon's breath
|id=item.bottle.fill_dragonbreath
|translationkey=subtitles.item.bottle.fill
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

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

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

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

== Achievements ==

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

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

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

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

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

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

== Issues ==
{{issue list}}

==References==
{{Reflist}}

{{Items}}

[[cs:Lahvička]]
[[de:Glasflasche]]
[[es:Frasco de cristal]]
[[fr:Fiole]]
[[hu:Üvegpalack]]
[[it:Ampolla]]
[[ja:ガラス瓶]]
[[ko:유리병]]
[[nl:Glazen fles]]
[[pl:Szklana butelka]]
[[pt:Frasco]]
[[ru:Колба]]
[[zh:玻璃瓶]]
[[Category:Renewable resources]]</li><li>[[Emerald|Emerald]]<br/>{{About|the item|the currency in ''Minecraft Dungeons''|MCD:Emerald|the skin|MCD:Emerald (skin)|the ore|Emerald Ore|the mineral block|Block of Emerald}}
{{Item
| image = Emerald.png
| renewable =  Yes
| stackable = Yes (64)
| rarity = Common}}
'''Emeralds''' are rare minerals that are used primarily as the currency for [[trading]] with [[villager]]s and [[wandering trader]]s. Naturally-occurring emeralds are rarer than [[diamond]]s.

== Obtaining ==

=== Trading (how emerald is renewable) ===
{{main|Trading}}
Emeralds can be obtained by trading with [[villager]]s, since they are the currency that villagers use for trading. Villagers either buy or sell specific goods for emeralds. Some villagers trade stuff that is renewable with emerald.

=== Mining ===
[[Emerald ore]] drops one emerald when mined using an iron or better [[pickaxe]]. If the pickaxe is enchanted with [[Fortune]], it may drop an extra emerald per level of Fortune, up to a maximum of 4 emeralds with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops itself in ore form instead of an emerald.

=== Crafting ===

{{Crafting
|Block of Emerald
|Output= Emerald,9
|type= Material
}}

=== Smelting ===

{{Smelting
|Emerald Ore; Deepslate Emerald Ore
|Emerald
|1
}}

=== Natural generation ===
{{see also|Emerald Ore#Natural generation}}

Emeralds can generate in [[chest]]s in some [[village]] houses or other generated [[Generated structures|structures]].

{{needs update|inaccurate=1|section=1}}
{{LootChestItem|emerald}}

=== Drops ===
[[Vindicator]]s and [[evoker]]s drop 0–1 emeralds upon death. [[Looting]] increases the maximum emerald drop by one per level, for a maximum of 4 emeralds with Looting III.

[[Fox]]es that are holding emeralds also have a chance of 100% to drop the emerald they are holding upon death. Alternatively, the player can drop a food item to entice the fox to drop the emerald without killing it.

{{IN|bedrock}}, vindicators and [[pillager]]s spawned from [[raids]] can drop 0–1 emeralds. Depending on difficulty, vindicators and pillagers spawned from raids also have a chance of dropping additional emeralds. There is a 65% chance of dropping on easy and normal, and an 80% chance of dropping on hard. If this additional drop condition is met, different emerald counts can drop with different chances. There is a {{frac|10|39}} chance to drop an additional 0–1 emeralds, a {{frac|5|39}} chance to drop an additional 2–3, and a {{frac|2|39}} chance to drop an additional 4–5.

{{IN|bedrock}}, with Looting III, it is possible for a vindicator in a raid to drop up to 16 emeralds upon death (vindicator drops + raid drops + an additional drop<!-- emerald from 2/39 chance-->).

== Usage ==

=== Trading ===

{{main|Trading}}

Emeralds are primarily used as currency for [[trading]] with villagers and wandering traders. Trading is typically a faster way to obtain emeralds than by mining, as an emerald ore is rarer than a diamond ore.

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

===Beacons===

Emeralds can be used to select powers from a [[beacon]]. The player must select one of the available powers and then insert an emerald into the item slot. 

An emerald can be substituted for an [[iron ingot]], a [[gold ingot]], a [[diamond]] or a [[netherite ingot]] in a beacon.

=== Smithing ingredient ===
{{Smithing
|head=1
|ingredients=Any Armor Trim +<br/>Any Armor Piece + <br/>Emerald
|Any Armor Trim Smithing Template
|Netherite Chestplate
|Emerald
|Emerald Trim Netherite Chestplate
|showdescription=1
|description = All armor types can be used in this recipe,<br/>a netherite chestplate is shown as an example.
|tail=1
}}

;Trim color palette
The following color palette is shown on the designs on trimmed armor:
*{{TrimPalette|emerald}}

== Achievements ==

{{load achievements|The Haggler;Buy Low;Master Trader}}

== Advancements ==
{{load advancements|What a Deal!}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Emerald
|spritetype=item
|nameid=emerald
|itemtags=beacon_payment_items
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Emerald
|spritetype=item
|nameid=emerald
|id=512
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100129|Added [[diamond]]s, referred to as emeralds in the code.}}
{{History|java}}
{{History||May 21, 2012|link={{tweet|jeb_|204619936616808451}}|[[File:Ruby pJE20120521.png|32px]] [[Jens Bergensten|Jeb]] released a screenshot of himself testing the [[trading]] system. At this time, what would become emeralds were [[History_of_textures/Unused_textures#Ruby|rubies]].<ref>http://www.minecraftforum.net/topic/1621716-15-new-blocksitems/#entry19977082</ref>}}
{{History||1.3.1|snap=12w21a|[[File:Emerald JE1 BE1.png|32px]] Added emeralds and [[emerald ore]].
|Emeralds can be [[trading|traded]] with [[villager]]s in exchange for different [[item]]s.
|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing emeralds.
|[[File:Ruby JE1 BE1.png|32px]] The texture of [[History_of_textures/Unused_textures#Ruby|rubies]] can be found in the (at this time unused) file {{cd|items.png}}.<ref name="en_US 12w21">Snapshot 12w21a/b ''lang/en_US.lang'': '''item.ruby.name=Ruby'''</ref>}}
{{History|||snap=12w22a|[[Block of emerald]] has now been added, which is [[crafting|crafted]] from nine emeralds and can be placed as a decorative [[block]].
|Added [[jungle temple]]s, which contain loot [[chest]]s with emeralds.}}
{{History||1.4.2|snap=12w32a|As [[zombie villager]]s can now spawn and be cured, emeralds can now still be obtained in [[trading|trades]] even if [[generated structures]] are disabled.}}
{{history||1.9|snap=15w31a|Emeralds now generate in [[end city]] ship [[chest]]s.}}
{{history|||snap=15w43a|Emeralds now generate in [[igloo]] basement chests.}}
{{history|||snap=15w44a|The average yield of emeralds in [[desert temple]] chests has now been increased.}}
{{History||1.11|snap=16w39a|Added [[vindicator]]s and [[evoker]]s, which drop emeralds if killed by a player.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 388.}}
{{History|||snap=18w09a|Emeralds can now generate in the loot [[chest]]s of [[underwater ruins]].}}
{{History|||snap=18w10a|Emeralds can now generate in [[buried treasure]] chests.}}
{{History|||snap=18w11a|Emeralds can now generate in the chests of [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.
|Added [[pillager]]s, which can [[drops|drop]] emeralds.}}
{{History|||snap=18w46a|Pillagers no longer drop emeralds.}}
{{History|||snap=18w48a|Emeralds now generate in chests in [[village]] tanneries, fisher cottages and plains village houses.}}
{{History|||snap=18w49a|Emeralds now generate in chests in [[village]] shepherd houses, mason houses, butcher shops, and savanna and snowy village houses.}}
{{History|||snap=18w50a|Emeralds now generate in chests in [[village]] fletcher houses, temples, and desert and taiga village houses.}}
{{History|||snap=19w07a|Added [[fox]]es, which sometimes spawn with emeralds in their mouths.}}
{{History|||snap=19w08a|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again and it looks smaller.}}
{{History||1.17|snap=21w13a|The unused [[History_of_textures/Unused_textures#Ruby|rubies]] texture was removed.}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Emeralds can now be used as an armor trim material.}}
{{History|||snap=23w07a|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}}
{{History||1.20|snap=23w12a|The probability for the emerald to generate in the [[suspicious sand]] in [[desert temple]] and in [[desert well]] has been changed from 1/7 to 1/8.|Emerald can now be found in [[suspicious gravel]] and [[suspicious sand]] in cold and warm [[ocean ruins]] and in [[trail ruins]].}}
{{History|||snap=23w16a|Emerald 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]]; emerald now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.9.0|snap=build 1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|||snap=build 5|Emeralds can now be used to craft [[blocks of emerald]].}}
{{History||v0.13.0|snap=build 1|Emeralds can now be found inside [[desert temple]] [[chest]]s.}}
{{History||v0.15.0|snap=build 1|Added [[jungle temple]]s, which contain loot chests with emeralds.}}
{{History||v0.16.0|snap=build 1|Emeralds can now be used to power [[beacon]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Emeralds can now be found in [[end city]] ship [[chest]]s.
|Emeralds can now be found in [[igloo]] basement chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Emeralds are now used as "currency" for [[villager]] [[trading]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Added [[evoker]]s and [[vindicator]]s, which [[drops|drop]] emeralds when killed.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Emeralds can now be found in some [[shipwreck]] [[chest]]s.}}
{{History|||snap=beta 1.2.20.1|Emeralds can now be found inside [[underwater ruins]] chests.}}
{{History||1.10.0|snap=beta 1.10.0.3|Emeralds can now be used to [[trading|buy]] items from [[wandering trader]]s.
|Emeralds can now be found in [[plains]] [[village]] house and tannery [[chest]]s.
|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Emeralds can now be found in [[village]] [[chest]]s other than [[plains]].}}
{{History|||snap=beta 1.11.0.4|[[Vindicator]]s and [[pillager]]s that spawn from [[raid]]s can now [[drops|drop]] bonus emeralds.}}
{{History|||snap=beta 1.11.0.5|[[File:Emerald JE3 BE3.png|32px]] The texture of emeralds has now been changed, once again.}}
{{History||1.13.0|snap=beta 1.13.0.1|Added [[fox]]es, which can [[drops|drop]] emeralds.}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|Emeralds now drop when brushing [[suspicious sand]] in [[desert pyramid]]s or [[desert well]]s.}}
{{History|||snap=beta 1.19.80.21|Emeralds can now be used as an armor trim material.}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|Ps4}}
{{History||1.90|[[File:Emerald JE2 BE2.png|32px]] The texture of emeralds has now been changed.}}

{{History|new3DS}}
{{History||0.1.0|[[File:Emerald JE1 BE1.png|32px]] Added emeralds.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==

<gallery>
Villager trading preview.png|The first image of the trading system released by [[Jeb]]. What would become emeralds can be seen in the [[inventory]] space.
Emerald Ore 12w21a.png|A wall of [[emerald ore]] utilizing a previous texture in snapshot [[12w21a]].
Room of Emeralds.png|All forms of emeralds in one photo: emerald (in the form of [[emerald block|block]], [[emerald ore|ore]] and the emerald itself).
</gallery>

==Trivia==

*The [[History_of_textures/Unused_textures#Ruby|ruby]] was going to be the [[villager]] currency but was changed to emeralds before the update's release.

== References ==

{{Reflist}}

{{Items}}

[[Category:Renewable resources]]

[[cs:Smaragd]]
[[de:Smaragd]]
[[es:Esmeralda]]
[[fr:Émeraude]]
[[hu:Smaragd]]
[[it:Smeraldo]]
[[ja:エメラルド]]
[[ko:에메랄드]]
[[nl:Smaragd]]
[[pl:Szmaragd]]
[[pt:Esmeralda]]
[[ru:Изумруд]]
[[th:มรกต]]
[[tr:Zümrüt]]
[[uk:Смарагд]]
[[zh:绿宝石]]</li></ul>
15w31aUV is now optional, and if not supplied it will automatically generate 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.


Advertisement