Minecraft Wiki
Advertisement
This article is about data pack tags. For other uses, see Tag (disambiguation).
Information icon
This feature is exclusive to Java Edition. 

Tags in data packs allow players to group items, blocks, fluids, entity types or functions together using JSON files.

Usage

This section is missing information about game event tags. 
Please expand the section to include this information. Further details may exist on the talk page.

To utilize block, item, or function tags the JSON files must be placed in a data pack inside the data/(namespace)/tags/blocks, data/(namespace)/tags/items, data/(namespace)/tags/entity_types or data/(namespace)/tags/functions folder respectively.

Minecraft itself also uses tags. For example, vanilla block tags are used for various block properties, vanilla item tags are used for various item properties, vanilla advancement files and vanilla recipe files, and vanilla entity type tags are used for various mob properties. See #List of tags section for their usages.

There are no vanilla function tags since there are no vanilla functions, but the game reads from certain function tags under the minecraft namespace.

Folder structure

  • (data pack root directory)
    • data
      • (namespace)
        • tags
          • blocks
            • (name).json
          • entity_types
            • (name).json
          • fluids
            • (name).json
          • functions
            • (name).json
          • game_events
            • (name).json
          • items
            • (name).json

Block tags

Block tags can be called when testing for block arguments in commands with #(resource location), which succeeds if the block matches any of the blocks specified in the tag.

Item tags

Item tags can be called when testing for item arguments in commands with #(resource location) or in recipes and advancements using "tag": "(resource location)", which succeeds if the item matches any of the items specified in the tag. They can also be searched in the creative inventory by searching #(resource location).

Entity type tags

Entity type tags can be called in type target selector argument and loot table conditions with #(resource location), which checks if the entity's type matches any of the entity types specified in the tag.

Function tags

Function tags can be called in the /function command with #(resource location), which runs all the functions specified in the tag in the order of their first appearance in a tag. If a function is referenced multiple times in a tag and its sub-tags, it is run once.

Moreover, functions tagged in the minecraft:tick tag runs every tick at the start of the tick and functions tagged in minecraft:load runs once at the start of the tick after a server (re)load.

JSON format

  • The root object.
    •  replace: Optional. Whether or not contents of this tag should completely replace tag contents from different lower priority data packs with the same resource location. When false the tag's content is appended to the contents of the higher priority data packs, instead. Defaults to false.
    •  values: A list of mix and match of object names and tag names. For tags, recursive reference is possible, but a circular reference causes a loading failure.
      • : An object's resource location in the form (resource location).
      • : ID of another tag of the same type in the form #(resource location).
      • : An entry with additional options. (1.16.2+)
        •  id: A string in one of the string formats above.
        •  required: Whether or not loading this tag should fail if this entry is not found, true by default (also for the string entries). A tag that fails to load can still be referenced in any data pack and be (re)defined in other data packs. In other words, only the entries in this JSON file is ignored if this entry cannot be found.

List of tags

Blocks

Tag name Values Usage
mineable/axe note_block, attached_melon_stem, attached_pumpkin_stem, azalea, bamboo, barrel, bee_nest, beehive, beetroots, big_dripleaf_stem, big_dripleaf, bookshelf, brown_mushroom_block, brown_mushroom, campfire, carrots, cartography_table, carved_pumpkin, cave_vines_plant, cave_vines, chest, chorus_flower, chorus_plant, cocoa, composter, crafting_table, crimson_fungus, daylight_detector, dead_bush, fern, fletching_table, glow_lichen, grass, hanging_roots, jack_o_lantern, jukebox, ladder, large_fern, lectern, lily_pad, loom, melon_stem, melon, mushroom_stem, nether_wart, potatoes, pumpkin_stem, pumpkin, red_mushroom_block, red_mushroom, scaffolding, small_dripleaf, smithing_table, soul_campfire, spore_blossom, sugar_cane, sweet_berry_bush, tall_grass, trapped_chest, twisting_vines_plant, twisting_vines, vine, warped_fungus, weeping_vines_plant, weeping_vines, wheat, #banners, #fence_gates, #flowers[until JE 1.18], #logs, #planks, #saplings, #signs, #wooden_buttons, #wooden_doors, #wooden_fences, #wooden_pressure_plates, #wooden_slabs, #wooden_stairs, #wooden_trapdoors
  • Blocks in this tag are mined faster with axes.
mineable/hoe nether_wart_block, warped_wart_block, hay_block, dried_kelp_block, target, shroomlight, sponge, wet_sponge, jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves, azalea_leaves, flowering_azalea_leaves, sculk_sensor, moss_block, moss_carpet
  • Blocks in this tag are mined faster with hoes.
mineable/pickaxe stone, granite, polished_granite, diorite, polished_diorite, andesite, polished_andesite, cobblestone, gold_ore, deepslate_gold_ore, iron_ore, deepslate_iron_ore, coal_ore, deepslate_coal_ore, nether_gold_ore, lapis_ore, deepslate_lapis_ore, lapis_block, dispenser, sandstone, chiseled_sandstone, cut_sandstone, gold_block, iron_block, bricks, mossy_cobblestone, obsidian, spawner, diamond_ore, deepslate_diamond_ore, diamond_block, furnace, cobblestone_stairs, stone_pressure_plate, iron_door, redstone_ore, deepslate_redstone_ore, netherrack, basalt, polished_basalt, stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks, iron_bars, chain, brick_stairs, stone_brick_stairs, nether_bricks, nether_brick_fence, nether_brick_stairs, enchanting_table, brewing_stand, end_stone, sandstone_stairs, emerald_ore, deepslate_emerald_ore, ender_chest, emerald_block, light_weighted_pressure_plate, heavy_weighted_pressure_plate, redstone_block, nether_quartz_ore, hopper, quartz_block, chiseled_quartz_block, quartz_pillar, quartz_stairs, dropper, white_terracotta, orange_terracotta, magenta_terracotta, light_blue_terracotta, yellow_terracotta, lime_terracotta, pink_terracotta, gray_terracotta, light_gray_terracotta, cyan_terracotta, purple_terracotta, blue_terracotta, brown_terracotta, green_terracotta, red_terracotta, black_terracotta, iron_trapdoor, prismarine, prismarine_bricks, dark_prismarine, prismarine_stairs, prismarine_brick_stairs, dark_prismarine_stairs, prismarine_slab, prismarine_brick_slab, dark_prismarine_slab, terracotta, coal_block, red_sandstone, chiseled_red_sandstone, cut_red_sandstone, red_sandstone_stairs, stone_slab, smooth_stone_slab, sandstone_slab, cut_sandstone_slab, petrified_oak_slab, cobblestone_slab, brick_slab, stone_brick_slab, nether_brick_slab, quartz_slab, red_sandstone_slab, cut_red_sandstone_slab, purpur_slab, smooth_stone, smooth_sandstone, smooth_quartz, smooth_red_sandstone, purpur_block, purpur_pillar, purpur_stairs, end_stone_bricks, magma_block, red_nether_bricks, bone_block, observer, white_glazed_terracotta, orange_glazed_terracotta, magenta_glazed_terracotta, light_blue_glazed_terracotta, yellow_glazed_terracotta, lime_glazed_terracotta, pink_glazed_terracotta, gray_glazed_terracotta, light_gray_glazed_terracotta, cyan_glazed_terracotta, purple_glazed_terracotta, blue_glazed_terracotta, brown_glazed_terracotta, green_glazed_terracotta, red_glazed_terracotta, black_glazed_terracotta, white_concrete, orange_concrete, magenta_concrete, light_blue_concrete, yellow_concrete, lime_concrete, pink_concrete, gray_concrete, light_gray_concrete, cyan_concrete, purple_concrete, blue_concrete, brown_concrete, green_concrete, red_concrete, black_concrete, dead_tube_coral_block, dead_brain_coral_block, dead_bubble_coral_block, dead_fire_coral_block, dead_horn_coral_block, tube_coral_block, brain_coral_block, bubble_coral_block, fire_coral_block, horn_coral_block, dead_tube_coral, dead_brain_coral, dead_bubble_coral, dead_fire_coral, dead_horn_coral, dead_tube_coral_fan, dead_brain_coral_fan, dead_bubble_coral_fan, dead_fire_coral_fan, dead_horn_coral_fan, dead_tube_coral_wall_fan, dead_brain_coral_wall_fan, dead_bubble_coral_wall_fan, dead_fire_coral_wall_fan, dead_horn_coral_wall_fan, polished_granite_stairs, smooth_red_sandstone_stairs, mossy_stone_brick_stairs, polished_diorite_stairs, mossy_cobblestone_stairs, end_stone_brick_stairs, stone_stairs, smooth_sandstone_stairs, smooth_quartz_stairs, granite_stairs, andesite_stairs, red_nether_brick_stairs, polished_andesite_stairs, diorite_stairs, polished_granite_slab, smooth_red_sandstone_slab, mossy_stone_brick_slab, polished_diorite_slab, mossy_cobblestone_slab, end_stone_brick_slab, smooth_sandstone_slab, smooth_quartz_slab, granite_slab, andesite_slab, red_nether_brick_slab, polished_andesite_slab, diorite_slab, smoker, blast_furnace, grindstone, stonecutter, bell, lantern, soul_lantern, warped_nylium, crimson_nylium, netherite_block, ancient_debris, crying_obsidian, respawn_anchor, lodestone, blackstone, blackstone_stairs, blackstone_slab, polished_blackstone, polished_blackstone_bricks, cracked_polished_blackstone_bricks, chiseled_polished_blackstone, polished_blackstone_brick_slab, polished_blackstone_brick_stairs, gilded_blackstone, polished_blackstone_stairs, polished_blackstone_slab, polished_blackstone_pressure_plate, chiseled_nether_bricks, cracked_nether_bricks, quartz_bricks, tuff, calcite, oxidized_copper, weathered_copper, exposed_copper, copper_block, copper_ore, deepslate_copper_ore, oxidized_cut_copper, weathered_cut_copper, exposed_cut_copper, cut_copper, oxidized_cut_copper_stairs, weathered_cut_copper_stairs, exposed_cut_copper_stairs, cut_copper_stairs, oxidized_cut_copper_slab, weathered_cut_copper_slab, exposed_cut_copper_slab, cut_copper_slab, waxed_copper_block, waxed_weathered_copper, waxed_exposed_copper, waxed_oxidized_copper, waxed_oxidized_cut_copper, waxed_weathered_cut_copper, waxed_exposed_cut_copper, waxed_cut_copper, waxed_oxidized_cut_copper_stairs, waxed_weathered_cut_copper_stairs, waxed_exposed_cut_copper_stairs, waxed_cut_copper_stairs, waxed_oxidized_cut_copper_slab, waxed_weathered_cut_copper_slab, waxed_exposed_cut_copper_slab, waxed_cut_copper_slab, lightning_rod, pointed_dripstone, dripstone_block, deepslate, cobbled_deepslate, cobbled_deepslate_stairs, cobbled_deepslate_slab, polished_deepslate, polished_deepslate_stairs, polished_deepslate_slab, deepslate_tiles, deepslate_tile_stairs, deepslate_tile_slab, deepslate_bricks, deepslate_brick_stairs, deepslate_brick_slab, chiseled_deepslate, cracked_deepslate_bricks, cracked_deepslate_tiles, smooth_basalt, raw_iron_block, raw_copper_block, raw_gold_block, ice, packed_ice, blue_ice, stone_button, piston, sticky_piston, piston_head, amethyst_cluster, small_amethyst_bud, medium_amethyst_bud, large_amethyst_bud, amethyst_block, budding_amethyst, infested_cobblestone, infested_chiseled_stone_bricks, infested_cracked_stone_bricks, infested_deepslate, infested_stone, infested_mossy_stone_bricks, infested_stone_bricks, conduit, #walls, #shulker_boxes, #anvil, #cauldrons, #rails
  • Blocks in this tag are mined faster with pickaxes.
mineable/shovel clay, dirt, coarse_dirt, podzol, farmland, grass_block, gravel, mycelium, sand, red_sand, snow_block, snow, soul_sand, dirt_path, white_concrete_powder, orange_concrete_powder, magenta_concrete_powder, light_blue_concrete_powder, yellow_concrete_powder, lime_concrete_powder, pink_concrete_powder, gray_concrete_powder, light_gray_concrete_powder, cyan_concrete_powder, purple_concrete_powder, blue_concrete_powder, brown_concrete_powder, green_concrete_powder, red_concrete_powder, black_concrete_powder, soul_soil, rooted_dirt
  • Blocks in this tag are mined faster with shovels.
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood
animals_spawnable_on‌[upcoming: JE 1.18] grass_block
anvil anvil, chipped_anvil, damaged_anvil
  • Used to determine which blocks should open the anvil GUI. Does not work for any other blocks than the default ones. Removing any of the default blocks may cause the GUI to flash quickly before disappearing.
  • Used to determine the damage source for entities being damaged by a falling block, which is used by the death messages.
  • Used to determine if a block has a chance to get "damaged" or break upon landing.
  • Blocks added receive only their falling block properties when summoned through commands. For example, sand does not harm entities unless summoned.
  • Used in reading NBT from falling block entities to set the internal HurtEntities boolean to true if the entity did not have HurtEntities set.
  • Used to determine if the block should have a chance to take damage from using the anvil GUI.
axolotls_spawnable_on‌[upcoming: JE 1.18] clay
azalea_grows_on‌[upcoming: JE 1.18] #dirt, #sand, #terracotta, snow_block, powder_snow
azalea_root_replaceable‌[upcoming: JE 1.18] #lush_ground_replaceable, #terracotta, red_sand
bamboo_plantable_on #sand, #dirt, bamboo, bamboo_sapling, gravel
  • Used to check where bamboo can be planted
banners white_banner, orange_banner, magenta_banner, light_blue_banner, yellow_banner, lime_banner, pink_banner, gray_banner, light_gray_banner, cyan_banner, purple_banner, blue_banner, brown_banner, green_banner, red_banner, black_banner, white_wall_banner, orange_wall_banner, magenta_wall_banner, light_blue_wall_banner, yellow_wall_banner, lime_wall_banner, pink_wall_banner, gray_wall_banner, light_gray_wall_banner, cyan_wall_banner, purple_wall_banner, blue_wall_banner, brown_wall_banner, green_wall_banner, red_wall_banner, black_wall_banner
  • Used by maps upon clicking a block, to see if it should place a marker. Adding blocks to this animation causes maps to play the use animation when clicked, but no marker is added.
  • Used in the #wall_post_override block tag.
base_stone_nether netherrack, basalt, blackstone
base_stone_overworld stone, granite, diorite, andesite, tuff, deepslate
  • Used to determine what blocks dirt, gravel, granite, diorite, andesite, tuff, clay, coal ore, iron ore, and copper ore can replace when generated as underground ores.
  • Used to determine what blocks the "large dripstone" feature can replace.
  • Used in the generation of the "dripstone cluster" feature.
  • Used in the #dripstone_replaceable_blocks‌ and #lush_plants_replaceable block tags.
beacon_base_blocks netherite_block, emerald_block, diamond_block, gold_block, iron_block
  • Used by beacons to check which base blocks can activate it.
beds red_bed, black_bed, blue_bed, brown_bed, cyan_bed, gray_bed, green_bed, light_blue_bed, light_gray_bed, lime_bed, magenta_bed, orange_bed, pink_bed, purple_bed, white_bed, yellow_bed
  • Cats use this tag to determine where to sit or sleep with the player.
  • Used to determine what blocks can be slept in by villagers.
  • Used to determine what blocks baby villagers can jump on.
  • Adding blocks to this tag has no effect on villagers. Villagers still pathfind to beds not in this tag, but they do not jump or sleep on them.
beehives bee_nest, beehive
  • Determines which blocks can fill with honey when a bee deposits pollen.
  • Blocks in this tag can have honey removed by a dispenser with a glass bottle or shears.
  • Used in the 'husbandry/safely_harvest_honey.json' advancement file.
bee_growables #crops, sweet_berry_bush, cave_vines, cave_vines_plant
  • When bees pollinate these blocks they grow one stage.
  • Removing blocks from this tag has no effect.
big_dripleaf_placeable‌[upcoming: JE 1.18] #dirt, #small_dripleaf_placeable, farmland
  • Big dripleaves can be placed on blocks in this tag, even if there is no water in the block where the big dripleaf is being placed[verify].
birch_logs birch_log, birch_wood, stripped_birch_log, stripped_birch_wood
buttons #wooden_buttons, stone_button, polished_blackstone_button
campfires campfire, soul_campfire
  • Bees, parrots, and turtles view blocks in this tag as dealing fire damage and pathfind accordingly.
  • Campfires use this tag to determine if they are lit or not.
  • Flint and steel and fire charges use this tag to determine if it can light campfires. Adding blocks to this tag has no effect.
  • Splash water bottles set the lit value of blocks in this tag to false.
candle_cakes candle_cake, white_candle_cake, orange_candle_cake, magenta_candle_cake, light_blue_candle_cake, yellow_candle_cake, lime_candle_cake, pink_candle_cake, gray_candle_cake, light_gray_candle_cake, cyan_candle_cake, purple_candle_cake, blue_candle_cake, brown_candle_cake, green_candle_cake, red_candle_cake, black_candle_cake
  • Blocks in this tag are considered candle cakes and can be lit, if they have the lit block state set to false.
candles candle, white_candle, orange_candle, magenta_candle, light_blue_candle, yellow_candle, lime_candle, pink_candle, gray_candle, light_gray_candle, cyan_candle, purple_candle, blue_candle, brown_candle, green_candle, red_candle, black_candle
  • Blocks in this tag are considered candles and can be lit, if they have the lit, and waterlogged block state and both are false.
carpets white_carpet, orange_carpet, magenta_carpet, light_blue_carpet, yellow_carpet, lime_carpet, pink_carpet, gray_carpet, light_gray_carpet, cyan_carpet, purple_carpet, blue_carpet, brown_carpet, green_carpet, red_carpet, black_carpet
cauldrons cauldron, water_cauldron, lava_cauldron, powder_snow_cauldron
cave_vines cave_vines_plant, cave_vines
climbable ladder, vine, scaffolding, weeping_vines, weeping_vines_plant, twisting_vines, twisting_vines_plant, cave_vines, cave_vines_plant
  • Used in mob pathfinding.
  • This tag is used to determine what blocks the player can climb.
  • For the player to be able to climb added blocks, the block must be small enough that the center of the player's hitbox can occupy the same block.
  • This means that blocks such as chests cannot be climbed from the sides, but can from the top.
  • Used in the process of determining where to put an entity when it dismounts another entity[more information needed]
  • If scaffolding is removed, the player cannot smoothly climb up, but can still jump up and crouch down.
coal_ores coal_ore, deepslate_coal_ore
copper_ores copper_ore, deepslate_copper_ore
corals #coral_plants, tube_coral_fan, brain_coral_fan, bubble_coral_fan, fire_coral_fan, horn_coral_fan
coral_blocks tube_coral_block, brain_coral_block, bubble_coral_block, fire_coral_block, horn_coral_block
  • Used to generate coral reefs.
  • Using bone meal on a sea pickle on a block in this tag creates more sea pickles.
coral_plants tube_coral, brain_coral, bubble_coral, fire_coral, horn_coral
crimson_stems crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae
  • Used in the #logs block tag.
crops beetroots, carrots, potatoes, wheat, melon_stem, pumpkin_stem
crystal_sound_blocks amethyst_block, budding_amethyst
  • Blocks in this tag play play the "amethyst block chime" sound repeatedly for a short amount of time after being stepped on, gradually decreasing in volume.
  • The initial step sound is not affected by this tag.
dark_oak_logs dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood
deepslate_ore_replaceables deepslate, tuff
  • Iron ore, redstone ore, gold ore, diamond ore, and lapis lazuli ore can generate in blocks in this tag, and if they do, they become their deepslate variant
  • Infested stone (from blobs) that generates in a block in this tag generates as infested deepslate
diamond_ores diamond_ore, deepslate_diamond_ore
dirt dirt, grass_block, podzol, coarse_dirt, mycelium, rooted_dirt, moss_block
doors #wooden_doors, iron_door
  • Mobs view all blocks in this tag as doors and pathfind accordingly.
  • Replaced with air when generating zombie villages
dragon_immune barrier, bedrock, end_portal, end_portal_frame, end_gateway, command_block, repeating_command_block, chain_command_block, structure_block, jigsaw, moving_piston, obsidian, crying_obsidian, end_stone, iron_bars, respawn_anchor
dripstone_replaceable_blocks #base_stone_overworld, dirt
  • Used in dripstone generation to determine what dripstone can replace and what pointed dripstone can generate on.
emerald_ores emerald_ore, deepslate_emerald_ore
enderman_holdable #small_flowers, #dirt, sand, red_sand, gravel, brown_mushroom, red_mushroom, tnt, cactus, clay, pumpkin, carved_pumpkin, melon, crimson_fungus, crimson_nylium, crimson_roots, warped_fungus, warped_nylium, warped_roots
  • Used to determine what blocks endermen can pick up.
features_cannot_replace bedrock, spawner, chest, end_portal_frame
  • Blocks with this tag cannot be replaced by any generated features
fence_gates acacia_fence_gate, birch_fence_gate, dark_oak_fence_gate, jungle_fence_gate, oak_fence_gate, spruce_fence_gate, crimson_fence_gate, warped_fence_gate
fences #wooden_fences, nether_brick_fence
  • Mobs view all blocks in this tag as fences and pathfind accordingly.
  • Leads can be attached to solid blocks in this tag.
  • The lead knot entity uses this tag to determine if it should break or not.
  • Fences in this tag attempt to connect only to other fences in this tag, but not in the #wooden_fences block tag.
  • Fences not in either tag do not connect to fences in the #wooden_fences block tag.
fire fire, soul_fire
  • Blocks in this tag are ignored when detecting valid unactivated nether portals, and get removed upon activation
  • Mobs view all blocks in this tag as fire and pathfind accordingly.
  • Blocks in this tag cannot stop falling blocks.
  • Potions capable of dousing fire remove blocks in this tag.
  • Pistons do not create particles when destroying blocks in this tag.
  • Entities ignited by blocks in this tag continue burning after leaving the fire source.
flower_pots flower_pot, potted_poppy, potted_blue_orchid, potted_allium, potted_azure_bluet, potted_red_tulip, potted_orange_tulip, potted_white_tulip, potted_pink_tulip, potted_oxeye_daisy, potted_dandelion, potted_oak_sapling, potted_spruce_sapling, potted_birch_sapling, potted_jungle_sapling, potted_acacia_sapling, potted_dark_oak_sapling, potted_red_mushroom, potted_brown_mushroom, potted_dead_bush, potted_fern, potted_cactus, potted_cornflower, potted_lily_of_the_valley, potted_wither_rose, potted_bamboo, potted_crimson_fungus, potted_warped_fungus, potted_crimson_roots, potted_warped_roots, potted_azalea_bush, potted_flowering_azalea_bush
flowers #small_flowers, #tall_flowers, flowering_azalea, flowering_azalea_leaves
  • Bees can pollinate and remember blocks in this tag
  • Saplings grown next to blocks in this tag have a chance to have a bee nest
foxes_spawnable_on‌[upcoming: JE 1.18] grass_block, snow, snow_block, podzol, coarse_dirt
geode_invalid_blocks bedrock, water, lava, ice, packed_ice, blue_ice
  • Amethyst geodes cannot try to generate inside blocks in this tag.
goats_spawnable_on‌[upcoming: JE 1.18] stone, snow, powder_snow, snow_block, packed_ice, gravel
gold_ores gold_ore, nether_gold_ore, deepslate_gold_ore
guarded_by_piglins gold_block, barrel, chest, ender_chest, gilded_blackstone, trapped_chest, raw_gold_block, #shulker_boxes, #gold_ores
  • Piglins become hostile toward a player that destroys a block in this tag.
  • This tag has no effect on which blocks cause piglins to become hostile when opened.
hoglin_repellents warped_fungus, potted_warped_fungus, nether_portal, respawn_anchor
ice ice, packed_ice, blue_ice, frosted_ice
  • Blocks in this tag do not act a surface for ocean ruins to generate on.
impermeable glass, white_stained_glass, orange_stained_glass, magenta_stained_glass, light_blue_stained_glass, yellow_stained_glass, lime_stained_glass, pink_stained_glass, gray_stained_glass, light_gray_stained_glass, cyan_stained_glass, purple_stained_glass, blue_stained_glass, brown_stained_glass, green_stained_glass, red_stained_glass, black_stained_glass, tinted_glass
  • Blocks in this tag do not let fluids or honey drip through.
infiniburn_end #infiniburn_overworld, bedrock
  • Used in the infiniburn preset of the end dimension type (determines which blocks stay on fire forever in the end)
infiniburn_nether #infiniburn_overworld
  • Used in the infiniburn preset of the nether dimension type (determines which blocks stay on fire forever in the nether)
infiniburn_overworld netherrack, magma_block
  • Used in the infiniburn preset of the overworld dimension type (determines which blocks stay on fire forever in the overworld)
  • Used in the #infiniburn_nether and #infiniburn_end block tags
inside_step_sound_blocks snow, powder_snow
  • While the player walks in a block in this tag, the step sound noises of the sound type of the block are played instead of the noise of the below block.
iron_ores iron_ore, deepslate_iron_ore
jungle_logs jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood
  • Cocoa beans can be placed on blocks in this tag.
  • Used in the #logs_that_burn block tag.
lapis_ores lapis_ore, deepslate_lapis_ore
lava_pool_stone_replaceables‌[until JE 1.18]
lava_pool_cannot_replace‌[upcoming: JE 1.18]
#features_cannot_replace, #leaves
  • Blocks in this tag cannot be replaced by stone generated in lava pools.
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves, azalea_leaves, flowering_azalea_leaves
  • Blocks in this tag don't obstruct many features from generating, such as bonus chests, trees, and huge mushrooms.
  • Used to determine placement rules for some transparent blocks
  • Blocks in this tag are destroyed 1.5x faster than normal with swords
  • Blocks in this tag are destroyed 15x faster than normal with shears and increment their stat usage
  • Blocks is this tag recognize shears as a correct tool
  • Parrots and ocelots can spawn in blocks in this tag
logs #logs_that_burn, #crimson_stems, #warped_stems
  • Used for one of the requirements for settling on a block position for the parrot wandering AI.
  • If a block in this tag is around a leaves block, the leaves block sets its distance block state to the distance the closest tagged block is.
  • Blocks in this tag do not stop trees from growing
  • Checks progress for the punch_tree tutorial step.
  • Used in some other pathfinding processes.[more information needed]
logs_that_burn #dark_oak_logs, #oak_logs, #acacia_logs, #birch_logs, #jungle_logs, #spruce_logs
  • Used in the #logs block tag.
lush_ground_replaceable #moss_replaceable, clay, gravel, sand
  • Rooted dirt from azalea trees and clay patches and pools in lush caves can replace blocks in this tag.
mooshrooms_spawnable_on‌[upcoming: JE 1.18] mycelium
moss_replaceable #base_stone_overworld, #cave_vines, #dirt
  • Blocks in this tag can be replaced with moss blocks when a nearby moss block has bone meal applied to it.
mushroom_grow_block mycelium, podzol, crimson_nylium, warped_nylium
  • Mushrooms can spread to or be placed on blocks in this tag regardless of light level
  • Huge mushrooms can be grown on blocks in this tag regardless of light level
needs_diamond_tool obsidian, crying_obsidian, netherite_block, respawn_anchor, ancient_debris
  • If a block in this tag requires a certain type tool to drop, it will require a diamond, or better, tool to drop.
needs_iron_tool diamond_block, diamond_ore, deepslate_diamond_ore, emerald_ore, deepslate_emerald_ore, emerald_block, gold_block, raw_gold_block, gold_ore, deepslate_gold_ore, redstone_ore, deepslate_redstone_ore
  • If a block in this tag requires a certain type tool to drop, it will require an iron, or better, tool to drop.
needs_stone_tool iron_block, raw_iron_block, iron_ore, deepslate_iron_ore, lapis_block, lapis_ore, deepslate_lapis_ore, copper_block, raw_copper_block, copper_ore, deepslate_copper_ore, cut_copper_slab, cut_copper_stairs, cut_copper, weathered_copper, weathered_cut_copper_slab, weathered_cut_copper_stairs, weathered_cut_copper, oxidized_copper, oxidize_cut_copper_slab, oxidize_cut_copper_stairs, oxidize_cut_copper, exposed_copper, exposed_cut_copper_slab, exposed_cut_copper_stairs, exposed_cut_copper, waxed_copper_block, waxed_cut_copper_slab, waxed_cut_copper_stairs, waxed_cut_copper, waxed_weathered_copper, waxed_weathered_cut_copper_slab, waxed_weathered_cut_copper_stairs, waxed_weathered_cut_copper, waxed_exposed_copper, waxed_exposed_cut_copper_slab, waxed_exposed_cut_copper_stairs, waxed_exposed_cut_copper, waxed_oxidized_copper, waxed_oxidized_cut_copper_slab, waxed_oxidized_cut_copper_stairs, waxed_oxidized_cut_copper, lightning_rod
  • If a block in this tag requires a certain type tool to drop, it will require a stone, or better, tool to drop.
non_flammable_wood warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae, crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae, crimson_planks, warped_planks, crimson_slab, warped_slab, crimson_pressure_plate, warped_pressure_plate, crimson_fence, warped_fence, crimson_trapdoor, warped_trapdoor, crimson_fence_gate, warped_fence_gate, crimson_stairs, warped_stairs, crimson_button, warped_button, crimson_door, warped_door, crimson_sign, warped_sign, crimson_wall_sign, warped_wall_sign
nylium crimson_nylium, warped_nylium
  • Used as a check during generation certain vegetation in crimson and warped forests.
  • Crimson and warped roots and nether sprouts can be placed on blocks in this tag, as well as soul soil.
  • Netherrack is a valid bonemeal target only if a nearby block is in this tag, or if netherrack itself is in this tag.
  • A non-nylium block nearby causes bonemeal to be consumed without producing anything when used on netherrack.
  • It is still possible to spread nylium onto netherrack even if one or both nylium blocks are removed from the tag, as long as a block in the nylium tag is still nearby. This is because the check to grow nylium on the netherrack does not use the tag.
  • Fungi can be placed on blocks in this tag, as well as mycelium and soul soil.[more information needed]
oak_logs oak_log, oak_wood, stripped_oak_log, stripped_oak_wood
occludes_vibration_signals #wool
  • Blocks in this tag prevent sculk sensors from hearing vibrations if the block is between the sculk sensor and the vibration.
parrots_spawnable_on‌[upcoming: JE 1.18] grass_block, air, #leaves, #logs
piglin_repellents soul_fire, soul_torch, soul_lantern, soul_wall_torch, soul_campfire
planks oak_planks, spruce_planks, birch_planks, jungle_planks, acacia_planks, dark_oak_planks, crimson_planks, warped_planks
polar_bears_spawnable_on_in_frozen_ocean‌[upcoming: JE 1.18] ice
portals nether_portal, end_portal, end_gateway
  • When an entity dismounts another entity, it is not put into blocks with this tag to prevent unwanted teleportation; instead, the entity dismounts at the ridden entity's location.
pressure_plates light_weighted_pressure_plate, heavy_weighted_pressure_plate, #wooden_pressure_plates, #stone_pressure_plates
prevent_mob_spawning_inside #rails
  • Mobs cannot spawn inside blocks in this tag.
rabbits_spawnable_on‌[upcoming: JE 1.18] grass_block, snow, snow_block, sand
rails rail, powered_rail, detector_rail, activator_rail
  • Minecarts can be placed and dispensed onto blocks in this tag.
  • When TNT minecarts explode, blocks in this tag that the minecart is on have a blast resistance of 0.
  • Used in determining rail directional placement. Adding blocks to this tag has no effect.
  • Used in determining minecart speed. Adding blocks to this tag has no effect on this behavior.
  • Used in the #prevent_mob_spawning_inside block tag.
redstone_ores redstone_ore, deepslate_redstone_ore
replaceable_plants‌[upcoming: JE 1.18] grass, fern, dead_bush, vine, glow_lichen, sunflower, lilac, rose_bush, peony, tall_grass, large_fern, hanging_roots
sand sand, red_sand
saplings oak_sapling, spruce_sapling, birch_sapling, jungle_sapling, acacia_sapling, dark_oak_sapling, azalea, flowering_azalea
shulker_boxes shulker_box, black_shulker_box, blue_shulker_box, brown_shulker_box, cyan_shulker_box, gray_shulker_box, green_shulker_box, light_blue_shulker_box, light_gray_shulker_box, lime_shulker_box, magenta_shulker_box, orange_shulker_box, pink_shulker_box, purple_shulker_box, red_shulker_box, white_shulker_box, yellow_shulker_box
  • Fences, walls and panes do not connect to blocks in this tag.
  • If blocks are removed from this tag, the above blocks still disconnect when the shulker box opens
  • Used in the #guarded_by_piglins block tag.
signs #standing_signs, #wall_signs
  • Blocks in this tag are not destroyed by flowing water
  • Removing blocks from this tag has no effect
  • Used in the #wall_post_override block tag.
slabs #wooden_slabs, stone_slab, smooth_stone_slab, stone_brick_slab, sandstone_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_brick_slab, dark_prismarine_slab, polished_granite_slab, smooth_red_sandstone_slab, mossy_stone_brick_slab, polished_diorite_slab, mossy_cobblestone_slab, end_stone_brick_slab, smooth_sandstone_slab, smooth_quartz_slab, granite_slab, andesite_slab, red_nether_brick_slab, polished_andesite_slab, diorite_slab, cut_sandstone_slab, cut_red_sandstone_slab, blackstone_slab, polished_blackstone_brick_slab, polished_blackstone_slab, cobbled_deepslate_slab, polished_deepslate_slab, deepslate_tile_slab, deepslate_brick_slab, waxed_weathered_cut_copper_slab, waxed_exposed_cut_copper_slab, waxed_cut_copper_slab, oxidized_cut_copper_slab, weathered_cut_copper_slab, exposed_cut_copper_slab, cut_copper_slab, waxed_oxidized_cut_copper_slab
  • Blocks in this tag are viewed as slabs by ruined portal generation.
small_dripleaf_placeable clay, moss_block
  • Big dripleaves‌[upcoming: JE 1.18] and small dripleaves can be placed on blocks in this tag, even if there is no water in the block where the small dripleaf is being placed.
small_flowers dandelion, poppy, blue_orchid, allium, azure_bluet, red_tulip, orange_tulip, white_tulip, pink_tulip, oxeye_daisy, cornflower, lily_of_the_valley, wither_rose
snow snow, snow_block, powder snow
  • Blocks in this tag turn blocks with a snowy variant below them (like grass) into said snow variant.
soul_fire_base_blocks soul_sand, soul_soil
  • Blocks in this tag can support soul fire.
soul_speed_blocks soul_sand, soul_soil
  • Soul Speed increases the player's speed on blocks in this tag.
spruce_logs spruce_log, spruce_wood, stripped_spruce_log, stripped_spruce_wood
stairs #wooden_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_brick_stairs, prismarine_stairs, dark_prismarine_stairs, polished_granite_stairs, smooth_red_sandstone_stairs, mossy_stone_brick_stairs, polished_diorite_stairs, mossy_cobblestone_stairs, end_stone_brick_stairs, stone_stairs, smooth_sandstone_stairs, smooth_quartz_stairs, granite_stairs, andesite_stairs, red_nether_brick_stairs, polished_andesite_stairs, diorite_stairs, blackstone_stairs, polished_blackstone_brick_stairs, polished_blackstone_stairs, cobbled_deepslate_stairs, polished_deepslate_stairs, deepslate_tile_stairs, deepslate_brick_stairs, oxidized_cut_copper_stairs, weathered_cut_copper_stairs, exposed_cut_copper_stairs, cut_copper_stairs, waxed_weathered_cut_copper_stairs, waxed_exposed_cut_copper_stairs, waxed_cut_copper_stairs, waxed_oxidized_cut_copper_stairs
  • Blocks in this tag are viewed as stairs by ruined portal generation.
standing_signs oak_sign, spruce_sign, birch_sign, acacia_sign, jungle_sign, dark_oak_sign, crimson_sign, warped_sign
stone_bricks stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks
stone_ore_replaceables stone, granite, diorite, andesite
  • Iron ore, redstone ore, gold ore, diamond ore, and lapis lazuli ore can generate as their stone variants in blocks in this tag
  • Infested stone (from blobs) that generates in a block in this tag generate as infested stone
stone_pressure_plates stone_pressure_plate, polished_blackstone_pressure_plate
strider_warm_blocks lava
  • Unless a strider is in a block in this tag, it shivers.
tall_flowers sunflower, lilac, peony, rose_bush
  • Bees attempt to pollinate blocks in this tag
  • Used in the #flowers block tag.
terracotta‌[upcoming: JE 1.18] terracotta, white_terracotta, orange_terracotta, magenta_terracotta, light_blue_terracotta, yellow_terracotta, lime_terracotta, pink_terracotta, gray_terracotta, light_gray_terracotta, cyan_terracotta, purple_terracotta, blue_terracotta, brown_terracotta, green_terracotta, red_terracotta, black_terracotta
trapdoors #wooden_trapdoors, iron_trapdoor
  • Mobs treat all blocks in this tag as trapdoors when pathfinding
  • Climbable blocks in this tag use the "<player> fell off a ladder" death message when applicable
underwater_bonemeals seagrass, #corals, #wall_corals
  • Blocks in this tag replace water source blocks (within 5 horizontal and 2 vertical blocks) when bone meal is used under water in warm ocean biomes.
  • If the blocks in this tag are customized, the behavior is applied to water source blocks in any biome. These blocks are not waterlogged by default.
unstable_bottom_center #fence_gates
  • Blocks in this tag cannot support lanterns and bells on their bottom side even if they would otherwise be able to.
valid_spawn grass_block, podzol
  • Used to determine if a location is a valid initial spawn position for the player.
walls cobblestone_wall, mossy_cobblestone_wall, brick_wall, prismarine_wall, red_sandstone_wall, mossy_stone_brick_wall, granite_wall, stone_brick_wall, nether_brick_wall, andesite_wall, red_nether_brick_wall, sandstone_wall, end_stone_brick_wall, diorite_wall, blackstone_wall, polished_blackstone_brick_wall, polished_blackstone_wall, cobbled_deepslate_wall, polished_deepslate_wall, deepslate_tile_wall, deepslate_brick_wall
  • Mobs treat blocks in this tag as fences when pathfinding.
  • Fence gates have the in_wall tag when next to a block in this tag.
  • Other walls (not defined by the tag), glass panes, and iron bars attempt to connect to non-solid blocks in this tag.
  • Blocks in this tag are viewed as walls by ruined portal generation.
wall_corals tube_coral_wall_fan, brain_coral_wall_fan, bubble_coral_wall_fan, fire_coral_wall_fan, horn_coral_wall_fan
  • Used to generate coral reefs.
  • When bone meal is used in warm and deep warm oceans, blocks in this tag may be placed on the sides of blocks.
  • The game may crash if added blocks do not have directional placement.
  • Used in the #underwater_bonemeals block tag.
wall_post_override torch, soul_torch, redstone_torch, tripwire, #signs, #banners, #pressure_plates
  • Blocks in this tag cause walls to become pillars, even if they are not solid.
wall_signs oak_wall_sign, spruce_wall_sign, birch_wall_sign, acacia_wall_sign, jungle_wall_sign, dark_oak_wall_sign, crimson_wall_sign, warped_wall_sign
warped_stems warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae
  • Used in the #logs block tag.
wart_blocks nether_wart_block, warped_wart_block
wither_immune barrier, bedrock, end_portal, end_portal_frame, end_gateway, command_block, repeating_command_block, chain_command_block, structure_block, jigsaw, moving_piston
  • Wither cannot destroy blocks with this tag by moving into them. This doesn't protect blocks from the explosion caused from creating the Wither or by Wither Skulls entities.
wither_summon_base_blocks soul_sand, soul_soil
  • Blocks in this tag can be used in the base to summon the wither.
wolves_spawnable_on‌[upcoming: JE 1.18] grass_block, snow, snow_block
wooden_buttons oak_button, spruce_button, birch_button, jungle_button, acacia_button, dark_oak_button, crimson_button, warped_button
wooden_doors oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door, crimson_door, warped_door
  • Mobs that interact with wooden doors use this tag to detect wooden doors.
  • Only iron doors can be added to this tag. If added, villagers can open them.
  • Used in the #doors block tag.
wooden_fences oak_fence, acacia_fence, dark_oak_fence, spruce_fence, birch_fence, jungle_fence, crimson_fence, warped_fence
  • Used in the #fences block tag.
  • Fences in this tag attempt to connect to each other.
  • Fences in the #fences block tag do not attempt to connect to fences in this tag.
  • Fences not in either tag do not connect to fences in this tag, including other fences of the same type.
wooden_pressure_plates oak_pressure_plate, spruce_pressure_plate, birch_pressure_plate, jungle_pressure_plate, acacia_pressure_plate, dark_oak_pressure_plate, crimson_pressure_plate, warped_pressure_plate
wooden_slabs oak_slab, spruce_slab, birch_slab, jungle_slab, acacia_slab, dark_oak_slab, crimson_slab, warped_slab
wooden_stairs oak_stairs, spruce_stairs, birch_stairs, jungle_stairs, acacia_stairs, dark_oak_stairs, crimson_stairs, warped_stairs
wooden_trapdoors acacia_trapdoor, birch_trapdoor, dark_oak_trapdoor, jungle_trapdoor, oak_trapdoor, spruce_trapdoor, crimson_trapdoor, warped_trapdoor
wool white_wool, orange_wool, magenta_wool, light_blue_wool, yellow_wool, lime_wool, pink_wool, gray_wool, light_gray_wool, cyan_wool, purple_wool, blue_wool, brown_wool, green_wool, red_wool, black_wool
  • Blocks in this tag are broken 5× faster by shears and also increase the usage stat of shears.
  • Placing blocks in this tag under a note block sets the instrument used to guitar.
  • If blocks that cause note blocks to play a different instrument are added to this tag, they cause the note block to play guitar.
  • Used in the #occludes_vibration_signals block tag.

Entity types

Tag name Values Usage
arrows arrow, spectral_arrow
  • Used in the 'adventure/shoot_arrow.json' advancement file.
  • Used in the #impact_projectiles entity type tag.
axolotl_always_hostiles drowned, guardian, elder_guardian
  • Axolotls are always hostile toward entities in this tag.
axolotl_hunt_targets tropical_fish, pufferfish, salmon, cod, squid, glow_squid
  • Axolotls exhibit the cooldown-based "hunt" behavior toward entities in this tag.
beehive_inhabitors bee
  • Entities in this tag can be in beehives
freeze_hurts_extra_types strider, blaze, magma_cube
  • Entities in this tag take 5x more damage from the freezing effect.
freeze_immune_entity_types stray, polar_bear, snow_golem, wither
  • Entities in this tag cannot be frozen.
impact_projectiles #arrows, snowball, fireball, small_fireball, egg, trident, dragon_fireball, wither_skull
  • Used to determine what entities can break chorus fruit when hit.
  • Entities can be removed from this tag, but only entities that activate targets work when added.
powder_snow_walkable_mobs rabbit, endermite, silverfish, fox
  • Entities in this tag can walk on top of powder snow.
raiders evoker, illusioner, pillager, ravager, vindicator, witch
  • Determines which entities get the glowing effect when ringing a bell.
  • Entities in this tag do not override a ravager's AI when riding one.
  • Used in the 'adventure/voluntary_exile.json' advancement file.
skeletons skeleton, stray, wither_skeleton
  • Makes creepers drop music discs when killed by a tagged mob
  • Used in the 'entities/creeper.json' loot table.

Fluids

Tag name Values Usage
lava lava, flowing_lava
  • Cactus breaks when next to this fluid
  • Used to enable the lava texture on a fluid
  • Used to create a smoke particle from rain instead of the normal rain particle
  • Used to enable lava-like fog
  • Items and experience orbs burn when in this fluid
  • When a bucket containing this fluid is placed, it uses the lava sound effect
  • Indicates a LAVA pathfinder node
  • Used in the process of forming stone/cobblestone/obsidian
  • Used in various strider pathfinding procedures
  • Striders cannot be ridden while submersed in fluids in this tag.
water water, flowing_water
  • Coral must have this on at least one side
  • Coral fans must be placed in this
  • Farmland uses this to determine hydration
  • Sugar Cane checks if this fluid, or a frosted ice block, is present next to the block below its base.
  • Sponges can absorb this fluid
  • Several particles use this to determine whether they should persist (bubble, bubble_column_up, current_down, underwater)
  • The drip particle internally uses this to determine its color.
  • Used to enable water fog
  • Determines if entities move as if they are in water
  • Indicates a WATER pathfinder node. Certain mobs pathfind toward this.
  • Boats check for this
  • Concrete solidifies in this.
  • Items and experience orbs float in this.
  • Guardians, squid, and turtles check for this
  • Fishing bobbers bob in this
  • Glass bottles may be filled in this
  • This fluid cannot be placed by buckets in the nether

Game events

Tag name Values Usage
ignore_vibrations_sneaking hit_ground, projectile_shoot, step, swim
  • Game events in this tag ignore by sculk sensors if the source entity is sneaking.
vibrations block_attach, block_change, block_close, block_destroy, block_detach, block_open, block_place, block_press, block_switch, block_unpress, block_unswitch, container_close, container_open, dispense_fail, drinking_finish, eat, elytra_free_fall, entity_damaged, entity_killed, entity_place, equip, explode, fishing_rod_cast, fishing_rod_reel_in, flap, fluid_pickup, fluid_place, hit_ground, mob_interact, lightning_strike, minecart_moving, piston_contract, piston_extend, prime_fuse, projectile_land, projectile_shoot, ravager_roar, ring_bell, shear, shulker_close, shulker_open, splash, step, swim, wolf_shaking
  • Game events in this tag trigger sculk sensors.

Items

Tag name Values Usage
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood
  • Used in the 'acacia_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
anvil anvil, chipped_anvil, damaged_anvil
arrows arrow, tipped_arrow, spectral_arrow
  • Controls what items can be shot by bows and crossbows. Any items added to the tag can be shot and picked up as a normal arrow.
axolotl_tempt_items tropical_fish_bucket
  • Items in this tag can be used to tempt axolotls.
banners white_banner, orange_banner, magenta_banner, light_blue_banner, yellow_banner, lime_banner, pink_banner, gray_banner, light_gray_banner, cyan_banner, purple_banner, blue_banner, brown_banner, green_banner, red_banner, black_banner
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
beacon_payment_items netherite_ingot, emerald, diamond, gold_ingot, iron_ingot
  • Used by beacons to check which items can be placed inside of its GUI to select an effect.
beds red_bed, black_bed, blue_bed, brown_bed, cyan_bed, gray_bed, green_bed, light_blue_bed, light_gray_bed, lime_bed, magenta_bed, orange_bed, pink_bed, purple_bed, white_bed, yellow_bed
birch_logs birch_log, birch_wood, stripped_birch_log, stripped_birch_wood
  • Used in the 'birch_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
boats oak_boat, spruce_boat, birch_boat, jungle_boat, acacia_boat, dark_oak_boat
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 1200.
buttons #wooden_buttons, stone_button, polished_blackstone_button
candles candle, white_candle, orange_candle, magenta_candle, light_blue_candle, yellow_candle, lime_candle, pink_candle, gray_candle, light_gray_candle, cyan_candle, purple_candle, blue_candle, brown_candle, green_candle, red_candle, black_candle
  • Cakes use this tag to determine if a candle item can be placed on it or not.
  • Adding items to this tag has no effect.
carpets white_carpet, orange_carpet, magenta_carpet, light_blue_carpet, yellow_carpet, lime_carpet, pink_carpet, gray_carpet, light_gray_carpet, cyan_carpet, purple_carpet, blue_carpet, brown_carpet, green_carpet, red_carpet, black_carpet
  • Used to check whether or not an item can go in the decoration slot of a llama, but items other than carpets do not change the llama visually.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 67.
cluster_max_harvestables diamond_pickaxe, golden_pickaxe, iron_pickaxe, netherite_pickaxe, stone_pickaxe, wooden_pickaxe
  • When amethyst clusters are broken with an item in this tag, they drop 4 amethyst shards.
coal_ores coal_ore, deepslate_coal_ore
coals coal, charcoal
  • Used in the 'campfire.json' advancement and recipe files.
copper_ores copper_ore, deepslate_copper_ore
creeper_drop_music_discs music_disc_13, music_disc_cat, music_disc_blocks, music_disc_chirp, music_disc_far, music_disc_mall, music_disc_mellohi, music_disc_stal, music_disc_strad, music_disc_ward, music_disc_11, music_disc_wait
  • Used to determine what a creeper drops when killed by a skeleton.
  • Used in the 'entities/creeper.json' loot table.
  • Used in the #music_discs item tag.
crimson_stems crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae
  • Used in the 'crimson_planks.json' advancement and recipe files.
  • Used in the #logs item tag.
dark_oak_logs dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood
  • Used in the 'dark_oak_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
diamond_ores diamond_ore, deepslate_diamond_ore
dirt‌[upcoming: JE 1.18] dirt, grass_block, podzol, coarse_dirt, mycelium, rooted_dirt, moss_block
doors #wooden_doors, iron_door
emerald_ores emerald_ore, deepslate_emerald_ore
fences #wooden_fences, nether_brick_fence
fishes cod, cooked_cod, salmon, cooked_salmon, pufferfish, tropical_fish
  • Used by dolphins to pick a player to swim to. The item can be both in the main and offhand.
  • Feeding a dolphin one of these items increases its 'trust' in the player.
  • Items in this tag add 1 to the fish_caught statistic when caught through fishing.
flowers #small_flowers, #tall_flowers, flowering_azalea, flowering_azalea_leaves
  • Items in this tag can be used to breed bees.
  • Bees follow players holding items in this tag.
fox_food sweet_berries, glow_berries
  • Foxes treat items in this tag like they do sweet berries.
freeze_immune_wearables leather_boots, leather_leggings, leather_chestplate, leather_helmet, leather_horse_armor
  • Entities with an item in this tag in any armor slot do not freeze.
gold_ores gold_ore, nether_gold_ore, deepslate_gold_ore
  • Used in the 'gold_ingot.json' and 'gold_ingot_from_blasting.json' advancement and recipe files.
  • Used in the #piglin_loved item tag.
ignored_by_piglin_babies leather
  • Baby piglins do not attempt to pick up items in this tag. Baby piglins still follow the other rules adult piglins follow.
  • Takes precedence over piglin_food, and piglin_loved item tags when an item is in both.
iron_ores iron_ore, deepslate_iron_ore
jungle_logs jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood
  • Used in the 'jungle_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
lapis_ores lapis_ore, deepslate_lapis_ore
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves, azalea_leaves, flowering_azalea_leaves
lectern_books written_book, writable_book
  • Controls what items can be put in a lectern. Items cannot be added to this tag, only removed.
logs #logs_that_burn, #crimson_stems, #warped_stems
  • Used in various checks to either skip or progress with the "punch_tree" tutorial step.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the 'campfire.json', 'smoker.json', and 'soul_campfire.json' recipe files.
logs_that_burn #dark_oak_logs, #oak_logs, #acacia_logs, #birch_logs, #jungle_logs, #spruce_logs
  • Used in the 'charcoal.json' advancement and recipe files.
  • Used in the #logs item tag.
music_discs #creeper_drop_music_discs, music_disc_pigstep
non_flammable_wood warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae, crimson_stem, stripped_crimson_stem, crimson_hyphae, stripped_crimson_hyphae, crimson_planks, warped_planks, crimson_slab, warped_slab, crimson_pressure_plate, warped_pressure_plate, crimson_fence, warped_fence, crimson_trapdoor, warped_trapdoor, crimson_fence_gate, warped_fence_gate, crimson_stairs, warped_stairs, crimson_button, warped_button, crimson_door, warped_door, crimson_sign, warped_sign
  • Items in this tag cannot be used as fuel in a furnace.
  • If items are removed from this tag, they can be used as fuel only if they are part of a tag that can be used as fuel.
oak_logs oak_log, oak_wood, stripped_oak_log, stripped_oak_wood
  • Used in the 'oak_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
occludes_vibration_signals #wool
  • As thrown entities, items in this tag do not trigger vibrations.
piglin_food porkchop, cooked_porkchop
  • Piglins can "eat" items in this tag.
    • Eating refers to the piglin seeking out and picking up an item without appearing in its inventory, thus vanishing.
piglin_loved #gold_ores, gold_block, gilded_blackstone, light_weighted_pressure_plate, gold_ingot, bell, clock, golden_carrot, glistering_melon_slice, golden_apple, enchanted_golden_apple, golden_helmet, golden_chestplate, golden_leggings, golden_boots, golden_horse_armor, golden_sword, golden_pickaxe, golden_shovel, golden_axe, golden_hoe, raw gold, raw_gold_block
  • Piglins actively seek out items in this tag
  • Piglins view players holding items in this tag as holding a "loved" item
  • Used in the distract_piglin.json advancement file
piglin_repellents soul_torch, soul_lantern, soul_campfire
  • Piglins do not attempt to pick up items in this tag.
planks oak_planks, spruce_planks, birch_planks, jungle_planks, acacia_planks, dark_oak_planks, crimson_planks, warped_planks
  • Items in this tag can be used to repairs shields in an anvil.
  • Used in various checks to either skip or progress with the "craft_planks" tutorial step.
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in these 3 advancement files and these 39 recipe files.
rails rail, powered_rail, detector_rail, activator_rail
redstone_ores redstone_ore, deepslate_redstone_ore
sand sand, red_sand
  • Used in the 'glass.json' advancement and recipe files.
saplings oak_sapling, spruce_sapling, birch_sapling, jungle_sapling, acacia_sapling, dark_oak_sapling, azalea, flowering_azalea
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
signs oak_sign, spruce_sign, birch_sign, acacia_sign, jungle_sign, dark_oak_sign, crimson_sign, warped_sign
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 200.
slabs #wooden_slabs, stone_slab, smooth_stone_slab, stone_brick_slab, sandstone_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_brick_slab, dark_prismarine_slab, polished_granite_slab, smooth_red_sandstone_slab, mossy_stone_brick_slab, polished_diorite_slab, mossy_cobblestone_slab, end_stone_brick_slab, smooth_sandstone_slab, smooth_quartz_slab, granite_slab, andesite_slab, red_nether_brick_slab, polished_andesite_slab, diorite_slab, cut_sandstone_slab, cut_red_sandstone_slab, blackstone_slab, polished_blackstone_brick_slab, polished_blackstone_slab, cobbled_deepslate_slab, polished_deepslate_slab, deepslate_tile_slab, deepslate_brick_slab, waxed_weathered_cut_copper_slab, waxed_exposed_cut_copper_slab, waxed_cut_copper_slab, oxidized_cut_copper_slab, weathered_cut_copper_slab, exposed_cut_copper_slab, cut_copper_slab, waxed_oxidized_cut_copper_slab
small_flowers dandelion, poppy, blue_orchid, allium, azure_bluet, red_tulip, orange_tulip, white_tulip, pink_tulip, oxeye_daisy, cornflower, lily_of_the_valley, wither_rose
  • Used in the suspicious stew recipe. Adding items does not allow them to be used in suspicious stew, but removing them disallows them from being used.
  • Items in this tag that give suspicious stew an effect can be fed to brown mooshrooms.
  • Used in the #flowers item tag.
soul_fire_base_blocks soul_sand, soul_soil
  • Used in the 'soul_campfire.json' and 'soul_torch.json' advancement and recipe files.
spruce_logs spruce_log, spruce_wood, stripped_spruce_log, stripped_spruce_wood
  • Used in the 'spruce_planks.json' advancement and recipe files.
  • Used in the #logs_that_burn item tag.
stairs #wooden_stairs, cobblestone_stairs, sandstone_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_brick_stairs, prismarine_stairs, dark_prismarine_stairs, polished_granite_stairs, smooth_red_sandstone_stairs, mossy_stone_brick_stairs, polished_diorite_stairs, mossy_cobblestone_stairs, end_stone_brick_stairs, stone_stairs, smooth_sandstone_stairs, smooth_quartz_stairs, granite_stairs, andesite_stairs, red_nether_brick_stairs, polished_andesite_stairs, diorite_stairs, blackstone_stairs, polished_blackstone_brick_stairs, polished_blackstone_stairs, cobbled_deepslate_stairs, polished_deepslate_stairs, deepslate_tile_stairs, deepslate_brick_stairs, oxidized_cut_copper_stairs, weathered_cut_copper_stairs, exposed_cut_copper_stairs, cut_copper_stairs, waxed_weathered_cut_copper_stairs, waxed_exposed_cut_copper_stairs, waxed_cut_copper_stairs, waxed_oxidized_cut_copper_stairs
stone_bricks stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks
  • Used in these 3 advancement files.
stone_crafting_materials cobblestone, blackstone, cobbled_deepslate
  • Used in the 'furnace.json' advancement and recipe files and the 'brewing_stand.json' recipe file.
stone_tool_materials cobblestone, blackstone, cobbled_deepslate
  • Used in these 6 advancement and recipe files.
  • Items in this tag can be used to repair stone tools in an anvil.
tall_flowers sunflower, lilac, peony, rose_bush
terracotta‌[upcoming: JE 1.18] terracotta, white_terracotta, orange_terracotta, magenta_terracotta, light_blue_terracotta, yellow_terracotta, lime_terracotta, pink_terracotta, gray_terracotta, light_gray_terracotta, cyan_terracotta, purple_terracotta, blue_terracotta, brown_terracotta, green_terracotta, red_terracotta, black_terracotta
trapdoors #wooden_trapdoors, iron_trapdoor
walls cobblestone_wall, mossy_cobblestone_wall, brick_wall, prismarine_wall, red_sandstone_wall, mossy_stone_brick_wall, granite_wall, stone_brick_wall, nether_brick_wall, andesite_wall, red_nether_brick_wall, sandstone_wall, end_stone_brick_wall, diorite_wall, blackstone_wall, polished_blackstone_brick_wall, polished_blackstone_wall, cobbled_deepslate_wall, polished_deepslate_wall, deepslate_tile_wall, deepslate_brick_wall
warped_stems warped_stem, stripped_warped_stem, warped_hyphae, stripped_warped_hyphae
  • Used in the 'warped_planks.json' advancement and recipe files.
wooden_buttons oak_button, spruce_button, birch_button, jungle_button, acacia_button, dark_oak_button, crimson_button, warped_button
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
  • Used in the #buttons item tag.
wooden_doors oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door, crimson_door, warped_door
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 200.
  • Used in the #doors item tag.
wooden_fences oak_fence, acacia_fence, dark_oak_fence, spruce_fence, birch_fence, jungle_fence, crimson_fence, warped_fence
wooden_pressure_plates oak_pressure_plate, spruce_pressure_plate, birch_pressure_plate, jungle_pressure_plate, acacia_pressure_plate, dark_oak_pressure_plate, crimson_pressure_plate, warped_pressure_plate
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
wooden_slabs oak_slab, spruce_slab, birch_slab, jungle_slab, acacia_slab, dark_oak_slab, crimson_slab, warped_slab
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 150.
  • Used in the 'barrel.json' and 'composter.json advancement and recipe files.
  • Used in the 'daylight_detector.json' and 'lectern.json' recipe files.
  • Used in the #slabs item tag.
wooden_stairs oak_stairs, spruce_stairs, birch_stairs, jungle_stairs, acacia_stairs, dark_oak_stairs, crimson_stairs, warped_stairs
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the #stairs item tag.
wooden_trapdoors acacia_trapdoor, birch_trapdoor, dark_oak_trapdoor, jungle_trapdoor, oak_trapdoor, spruce_trapdoor, crimson_trapdoor, warped_trapdoor
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 300.
  • Used in the #trapdoors item tag.
wool white_wool, orange_wool, magenta_wool, light_blue_wool, yellow_wool, lime_wool, pink_wool, gray_wool, light_gray_wool, cyan_wool, purple_wool, blue_wool, brown_wool, green_wool, red_wool, black_wool
  • Used to check if an item can go in the fuel slot of a furnace and to return a burn time of 100.
  • Used in the 'painting.json' advancement and recipe files.
  • Used in the #occludes_vibration_signals item tag.

History

This section is missing information about
  • Dragon and wither immune? When were these added?. 
Please expand the section to include this information. Further details may exist on the talk page.
Java Edition
1.13
{{Extension DPL}}<ul><li>[[Knowledge Book|Knowledge Book]]<br/>{{exclusive|java}}
{{Item
| image = Knowledge Book.png
| renewable = No
| stackable = No
| rarity = Epic
}}
A '''knowledge book''' is a utility item that reveals available [[crafting]] recipes to the player when {{control|used|use}}.

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

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

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

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

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

{{Items}}

[[Category:Non-renewable resources]]

[[de:Buch des Wissens]]
[[es:Enciclopedia]]
[[fr:Livre des connaissances]]
[[ja:知恵の本]]
[[ko:지식의 책]]
[[lzh:天工開物]]
[[pl:Księga wiedzy]]
[[pt:Enciclopédia]]
[[ru:Книга знаний]]
[[zh:知识之书]]</li><li>[[Spyglass|Spyglass]]<br/>{{Item
| title = Spyglass
| image = Spyglass.png
| durability = 
| rarity = Common
| renewable = Yes
| stackable = No
}}
 
A '''spyglass''' is a [[tool]] used to zoom in on distant objects.

== Obtaining ==
=== Crafting ===
{{Crafting
  |B1=Amethyst Shard
  |B2=Copper Ingot
  |B3=Copper Ingot
  |Output=Spyglass
  |type=Tool
}}

== Usage ==
[[File:Steve scoping Spyglass.png|right|100px]] [[File:Alex scoping Spyglass.png|right|100px]]

To use a spyglass, the player selects it from the hotbar and clicks {{control|use}} while looking in the desired direction.

Spyglasses are used to zoom in on a specific location in the player's field of view (FOV). The spyglass changes the FOV to {{frac|1|10}} of the FOV set in [[options]]. By default, the FOV is set to 70° in ''Java Edition'' and 60° in Bedrock Edition, resulting in an FOV of 7° in ''Java Edition'' and 6° in Bedrock Edition through the spyglass. The player's FOV can be set from 30° to 110°, so the spyglass FOV can  range from 3° to 11°. Regardless of the situation, or status effects the player has, using the Spyglass always shows a FOV {{frac|1|10}} of the FOV set in [[options]].

A square vignette is applied when in use, similar to the effect when wearing a [[carved pumpkin]]. Pressing {{key|F1}} removes the vignette,{{only|java}}<ref>{{bug|MC-203575||The spyglass overlay goes away when pressing F1|WAI}}</ref><ref>{{bug|MCPE-125869||Spyglass's overlay don't go away even if the player toggles Hide GUI on/ Pressing F1|}}</ref> similar to a carved pumpkin. 

Hazy distant objects remain hazy when viewed in the spyglass. Mobs too distant to render also do not render in the spyglass. The spyglass shows a magnified view of what the player already sees.

The player is slowed down while watching through the spyglass. When the player uses the spyglass continuously for {{convert|1|minute|game tick}}, the interface is automatically closed.

If the player has a certain effect on their screen like [[fire]], the spyglass does not remove that effect on the player's screen.

[[File:Spyglass Zooming.gif|thumb|center|A spyglass being used to zoom in on a [[block of gold]] starting from normal FOV (70°).]]

== Sounds ==
{{edition|java}}:
{{Sound table
|sound=Spyglass use.ogg
|subtitle=Spyglass expands
|source=player
|description=When a player uses a spyglass
|id=item.spyglass.use
|translationkey=subtitles.item.spyglass.use
|volume=0.5
|pitch=''varies'' <ref group=sound>Can be 1.15, 1.33, 1.4, or 1.55</ref>
|distance=16}}
{{Sound table
|sound=Spyglass stop.ogg
|subtitle=Spyglass retracts
|source=player
|description=When a player stops using a spyglass
|id=item.spyglass.stop_using
|translationkey=subtitles.item.spyglass.stop_using
|volume=0.5
|pitch=''varies'' <ref group=sound>Can be 1.0, 0.8, or 0.9</ref>
|distance=16
|foot=1}}

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Spyglass use.ogg
|source=player
|description=When a player uses a spyglass
|id=item.spyglass.use
|volume=0.5
|pitch=1.15-1.55}}
{{Sound table
|sound=Spyglass stop.ogg
|source=player
|description=When a player stops using a spyglass
|id=item.spyglass.stop_using
|volume=0.5
|pitch=0.8-1.0
|foot=1}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Spyglass
|spritetype=item
|nameid=spyglass
|form=item
|foot=1|id=626}}

== Advancements ==
{{load advancements|Is it a Bird?;Is it a Balloon?;Is it a Plane?}}

== History ==
{{History||October 3, 2020|link={{ytl|DBvZ2Iqmm3M|t=25m21s}}|[[File:Spyglass JE1.png|32px]]<!-- [[File:Spyglass scope (pre-release).png|32px]]--> Spyglasses are revealed at [[Minecraft Live 2020]]. They were originally named "telescopes" and had an oval vignette.}}
{{History|java}}
{{History||1.17|snap=20w45a|[[File:Spyglass JE1.png|32px]] Added spyglasses.
|[[File:Spyglass scope JE1.png|32px]] The scope texture is currently a circle with glare spots.}}
{{History|||snap=20w46a|[[File:Spyglass scope JE2.png|32px]] The scope texture is now a [[glass]] square with a [[copper]] border.}}
{{History|||snap=20w48a|[[File:Spyglass JE2 BE1.png|32px]] The spyglass is now a 3D model instead of a flat sprite.
|[[File:Spyglass (texture) JE2.png|32px]] The texture of the spyglass has changed.
|A spyglass in use is anchored better to the player's "eye" when viewed in 3rd person.}}
{{History|||snap=21w05a|Copper ingots are now renewable via [[drowned]], making spyglasses renewable.}}
{{History|||snap=21w10a|[[File:Spyglass (item) JE3 BE1.png|32px]] Spyglasses have a new texture in the inventory. The 3D model is still used in the hand, similar to [[tridents]].}}
{{History||1.17.1|snap=Pre-release 1|[[File:Spyglass (texture) JE3.png|32px]] The texture of the spyglass model has changed.}}
{{History|bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Spyglass JE2 BE1.png|32px]] [[File:Spyglass (item) JE3 BE1.png|32px]] Added spyglasses.}}
{{History|||snap=beta 1.17.0.52|Spyglasses are now available without enabling [[experimental gameplay]].}}
{{History|foot}}

== Issues ==
{{Issue list}}

== Trivia ==
*If {{command|item replace}} is used to place a spyglass on a player's head, the item appears stuck to the center of the player's face.

== Gallery ==
<gallery>
Villager Spyglass.png|Spying on [[villager]]s through a spyglass.
After using the spyglass at FOV 30 F1.png|Hiding the HUD removes the spyglass overlay.
Panda eating a spyglass.png|When eaten by a [[panda]], spyglasses cause [[missing texture]] particles to be produced.<ref>{{bug|MC-206684}}</ref>
JE 1.17 Development Telescope.jpg|The spyglass was originally called the telescope.
JE 1.17 Development Telescope 2.jpg|The telescope's overlay was originally round instead of square.
File:Ari Spyglass.jpg|How the spyglass looks in the third person.
Steve scoping Spyglass JE1.png|Steve using a spyglass before its 3D model was added.
Alex scoping Spyglass JE1.png|Alex using a spyglass before its 3D model was added.
File:Mangrove Portal.jpg|An [[allay]] peeking into view of [[Noor]]’s spyglass.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory--spyglass Taking Inventory: Spyglass] – Minecraft.net on February 17, 2022

{{Items}}

[[Category:Renewable resources]]

[[de:Fernrohr]]
[[es:Catalejo]]
[[fr:Longue-vue]]
[[it:Cannocchiale]]
[[ja:望遠鏡]]
[[pl:Luneta]]
[[pt:Luneta]]
[[ru:Подзорная труба]]
[[zh:望远镜]]</li></ul>
17w49aAdded tags for blocks and items.
Added the block and item tags planks and wool.
17w49bFunction can now be tagged.
Functions tagged in tick now run every tick in the beginning of the tick.
Added the block tag flower_pots.
Added the block and item tags buttons, carpets, doors, logs, saplings and stone_bricks.
17w50aAdded the block and item tags wooden_buttons and wooden_doors.
Updated the block and item tags buttons and doors to include stone_button and iron_door respectively.
18w01aFunctions tagged in load now runs once after a (re)load.
Added the block tag anvil.
18w02aAdded the block tag enderman_holdable.
18w06aAdded the block and item tags banners, wooden_pressure_plates, wooden_slabs, and wooden_stairs.
Added the item tag boats.
18w07aAdded the block tags slabs, stairs and water_hacked.
Added the block and item tags acacia_logs, birch_logs, dark_oak_logs, jungle_logs, oak_logs, and spruce_logs
18w07bAdded the block tag waterlogged.
Added the block and item tags rails and sand.
18w09aAdded block and item tag coral.
The water_hacked tag now includes chests.
18w10aAdded the block and item tag coral_plants.
The waterlogged block tag now includes coral plants.
18w10cRemoved the block tags water_hacked and waterlogged.
18w16aThe coral block tag has been renamed to corals.
18w19aAdded the block tag leaves, the fluid tags water and lava, and the item tags fishes and leaves.
pre8Added the block tag wall_corals and impermeable.
pre10Added the block and item tag trapdoors.
1.13.1
{{Extension DPL}}<ul><li>[[Flint and Steel|Flint and Steel]]<br/>{{Item
| image = Flint and Steel.png
| rarity = Common
| renewable = Yes
| durability = 64
| stackable = No
}}

'''Flint and steel''' is a [[tool]] used to create [[fire]] or to ignite certain blocks, structures and mobs.

== Obtaining ==

=== Crafting ===

{{Crafting
|head=1
|showname=0
|showdescription=1
|Iron Ingot
|Flint
|Output=Flint and Steel
|type=Tool
}}
{{crafting
|foot=1
|ignoreusage=1
|Damaged Flint and Steel
|Damaged Flint and Steel
|Output= Flint and Steel
|description= The durability of the two tools is added together, plus an extra 5% durability.
|type= Tool
}}

=== Chest loot ===

{{LootChestItem|flint-and-steel}}

== Usage ==
=== Igniting ===

When {{control|use|text=used}} on the space above any solid top surface, on any side of any flammable block or any side of any [[obsidian]] block within a valid unlit [[nether portal]] frame regardless of if there is a solid top surface available, the flint and steel places a [[fire]] there.

Flint and steel can be used to light unlit [[campfire]]s, [[candle]]s and [[cake|cakes with candles]].

Flint and steel can be used to light [[nether portal]]s, as any fire existing within an appropriate [[obsidian]] frame will instantly be replaced with [[Nether Portal (block)|nether portal blocks]] that occupy the entirety of the frame.

Using flint and steel on [[TNT]] ignites it. The explosion damage dealt by TNT ignited with flint and steel in this specific way counts as the player's attack. If the player is {{Control|sneak|text=sneaking}} a fire is instead placed on the side of the TNT the flint and steel was used on.

A flint and steel can be used on a [[creeper]] to force it to explode. Explosions initiated in this way cannot be cancelled.

When powered, a [[dispenser]] containing flint and steel can place fires or ignite relevant blocks such as TNT or campfires in the space directly in front of it. This reduces the flint and steel's durability. A dispenser containing a flint and steel cannot detonate creepers.

=== Enchantments ===

Flint and steel can receive the following [[enchantment]]s:
{|class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Anvil}}   
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}   
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}   
|}

== Sounds ==
{{edition|java}}:
{{Sound table
|rowspan=2
|sound=Flint and steel click.ogg
|subtitle=Flint and Steel click
|source=block
|description=When a flint and steel is used to place fire
|id=item.flintandsteel.use|idnote=<ref name=incorrecteventnames group=sound>{{Cite bug|MC|177457|Fire charge and flint and steel sound event names do not follow item IDs|date=April 5, 2020}}</ref>
|translationkey=subtitles.item.flintandsteel.use|translationkeynote=<ref name=incorrecteventnames group=sound/>
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|subtitle=Flint and Steel click
|source=hostile
|description=When a flint and steel is used to light a creeper
|id=item.flintandsteel.use|idnote=<ref name=incorrecteventnames group=sound/>
|translationkey=subtitles.item.flintandsteel.use|translationkeynote=<ref name=incorrecteventnames group=sound/>
|volume=1.0
|pitch=0.8-1.2
|distance=16}}
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a flint and steel's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{edition|bedrock}};
{{Sound table
|type=bedrock
|sound=Flint and steel click.ogg
|source=block
|description=When a flint and steel is used to place fire
|id=fire.ignite
|volume=1.0
|pitch=0.8-1.2}}
{{Sound table
|sound=Random break.ogg
|source=player
|description=When a flint and steel's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Flint and Steel
|spritetype=item
|nameid=flint_and_steel
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Flint and Steel
|spritetype=item
|nameid=flint_and_steel
|id=299
|form=item
|foot=1}}

== Achievements ==
{{Load achievements|Into the Nether}}

== Advancements ==
{{load advancements|We Need To Go Deeper}}

== Video ==

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

== History ==
{{more sounds|type=old|There is within the possible realm a different use sound from 2015-era Pocket Edition, can this be uploaded?}}
{{History|java indev}}
{{History||0.31|snap=20100110|[[File:Flint and Steel JE1.png|32px]] Added flint and steel.
|Flint and steel can be used to set [[fire]].}}
{{History|||snap=20100129|[[File:Flint and Steel JE2.png|32px]] The steel part of the texture has been brightened.
|Flint and steel can be used alongside [[lava]] to [[smelting|smelt]] [[ores]] and cook [[food]].<ref>http://www.youtube.com/watch?v=OpmK7rDU5bA</ref>}}
{{History|||snap=20100201-2|Flint and steel can now sometimes be dropped as loot from killing [[mobs]].}}
{{History||20100219|[[File:Flint and Steel JE3 BE1.png|32px]] The texture of flint and steel has been changed, due to its new crafting recipe.
|Flint and steel can no longer drop from mobs.
|Flint and steel can now be crafted from an [[iron ingot]] and the newly added [[flint]].
|[[Furnace]]s have been added to replace the cooking and [[smelting]] function of flint and steel.}}
{{History|java beta}}
{{History||1.7|Flint and steel, along with [[fire]] itself, [[explosion]]s and [[Mechanics/Redstone/Circuit|redstone]] are now the only ways to activate [[TNT]].<ref>{{tweet|jeb_|78154891637436416}}</ref>}}
{{History|java}}
{{History||1.3.1|snap=12w21a|The [[player]] can now [[trading|buy]] 1 flint and steel from farmer [[villager]]s for 3 [[emerald]]s, making flint and steel [[renewable]].}}
{{History||1.4.2|snap=12w38a|The [[sound]] when using flint and steel has been changed.}}
{{History||1.5|snap=13w04a|[[Dispenser]]s are now able to use flint and steel on the [[block]] in front of them.}}
{{History||1.6.1|snap=13w18a|Flint and steel can now be found in the new [[chest]]s in [[nether fortress]]es.}}
{{History|||snap=13w25a|Flint and steel now loses [[durability]] when igniting [[TNT]].}}
{{History||1.7.2|snap=13w36a|Flint and steel now has a shapeless crafting recipe.
{{{!}} class{{=}}"collapsible collapsed" data-description{{=}}"Old recipe"
! Old recipe
{{!}}-
{{!}}
{{Crafting
|A1=Iron Ingot
|B2=Flint
|Output=Flint and Steel
|ignoreusage=1
}}
{{!}}}
|Using flint and steel on a [[creeper]] now causes it to [[explosion|explode]].}}
{{History||1.8|snap=14w02a|[[Villager]]s no longer [[trading|sell]] flint and steel, making it no longer renewable. However, if a villager selling flint and steel already exists in the world, it can be continuously traded with to obtain flint and steel renewably.}}
{{History||1.9|snap=15w43a|The average yield of flint and steel in [[nether fortress]] [[chest]]s has been slightly reduced.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 259.}}
{{History||1.14|snap=18w43a|[[File:Flint and Steel JE4 BE2.png|32px]] The texture of flint and steel has been changed.}}
{{History||1.16|snap=20w07a|[[Gravel]] now can be given by the [[piglin]]s when [[bartering]], making flint and steel renewable again.}}
{{History|||snap=20w16a|Flint and steel can now be found inside [[ruined portal]] chests.}}

{{History|pocket alpha}}
{{History||v0.4.0|[[File:Flint and Steel JE3 BE1.png|32px]] Added flint and steel.}}
{{History||v0.7.0|Flint and steel can now be used to set [[fire]].}}
{{History||v0.7.4|Using flint and steel on a [[creeper]] now causes it to [[explosion|explode]].}}
{{History||v0.8.0|snap=build 1|Added flint and steel to the [[creative]] [[inventory]].}}
{{History||v0.12.1|snap=build 1|Flint and steel can now be used to activate a [[nether portal]].
|Flint and steel can now be found in [[nether fortress]]es.
|Flint and steel can now be [[enchanted]] in [[anvil]]s.}}
{{History||v0.14.0|snap=build 1|Flint and steel can now be used inside [[dispenser]]s when powered.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Flint and Steel JE4 BE2.png|32px]] The texture of flint and steel has been changed.}}
{{History||1.16.0|snap=beta 1.16.0.51|Flint and steel can now be obtained by [[bartering]] with [[piglin]]s.|Flint and steel can now be enchanted with [[Curse of Vanishing]] through an [[anvil]].}}
{{History|||snap=beta 1.16.0.57|Flint and steel are no longer obtainable from [[bartering]].
|Flint and steel can now be found inside [[ruined portal]] chests.}}

{{History|console}}
{{History||xbox=TU1|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Flint and Steel JE3 BE1.png|32px]] Added flint and steel.}}
{{History||xbox=TU3|Flint and steel, along with [[fire]] itself, [[explosion]]s and [[redstone (disambiguation)|redstone]] are now the only ways to activate [[TNT]].}}
{{History||xbox=TU31|xbone=CU19|ps=1.22|wiiu=Patch 3|Flint and steel now makes [[sound]]s when igniting [[block]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Flint and Steel JE4 BE2.png|32px]] The texture of flint and steel has been changed.}}

{{History|New 3DS}}
{{History||0.1.0|[[File:Flint and Steel JE3 BE1.png|32px]] Added flint and steel.}}
{{History|foot}}

Historical sounds:

{| class="wikitable"
! Sound
! From
! to
! Pitch
|-
| {{sound||Flint and Steel old.ogg}}
| ?
| ?
| ?
|}

== Issues ==
{{issue list}}

== Trivia ==

* In [[Adventure mode]], flint and steel cannot light fires, nor can it ignite nether portals (unless it has the tag {{cd|CanPlaceOn:obsidian}}). However, it can still ignite TNT and creepers.
* The name "Flint and Steel" may be misleading and is inaccurate considering the game doesn’t have and possibly will have [[Java Edition mentioned features#Steel|steel]] in the game and it's crafted with iron instead. This is similar to the [[Old Growth Taiga|Old Growth Pine Taiga]], as there are no pines in the game and they have [[Spruce|Spruce Trees]] instead.
**In real life, Iron can’t be used as a fire striker, so Mojang had to rename it to Flint and Steel so it makes more sense. This explains why it is called Flint and Steel, but there is no steel in the game.
**Steel was mentioned by Mojang, as a “stronger” iron, but shortly rejected, and there are no currently no plans to add it to the game.
* Flint and steel cannot light end portals.
* Flint and Steel is the first item to mention another item that is not in the game.
*In the April Fools Snapshot, [[Java Edition 23w13a or b]], one of the possible voted was “Flint and Steel can ignite any block”.


==References==

{{Reflist}}

{{Items}}

[[Category:Renewable resources]]

[[cs:Křesadlo]]
[[de:Feuerzeug]]
[[es:Mechero]]
[[fr:Briquet]]
[[hu:Kovakő acéllal]]
[[ja:火打石と打ち金]]
[[ko:부싯돌과 부시]]
[[nl:Vuursteen en staal]]
[[pl:Krzesiwo]]
[[pt:Pederneira]]
[[ru:Огниво]]
[[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>
18w31aAdded the block tag underwater_bonemeals.
1.14
{{Extension DPL}}<ul><li>[[Carrot on a Stick|Carrot on a Stick]]<br/>{{Item
| image = Carrot on a Stick.png
| rarity = Common
| renewable = Yes
| durability = 25
| stackable = No
}}
A '''carrot on a stick''' is an item that can be used to control saddled [[pig]]s.

== Obtaining ==

=== Crafting ===

It is possible to craft a carrot on a stick without a [[crafting table]].
{{Crafting
|head=1
|showname=0
|showdescription=1
|B2=Fishing Rod; Damaged Fishing Rod
|C3=Carrot
|Output= Carrot on a Stick
|type= Transportation
|description= The fishing rod must be diagonally above the carrot to craft the carrot on a stick.
}}
{{crafting
|foot=1
|ignoreusage=1
|Damaged Carrot on a Stick
|Damaged Carrot on a Stick
|Output= Carrot on a Stick
|description= The durability of the two carrots on sticks is added together, plus an extra 5% durability.
|type= Transportation
}}

== Usage ==

=== Riding a pig ===

To use a carrot on a stick, the player must first [[saddle]] a [[pig]], and ride it while holding the carrot on a stick. The pig then moves in the direction of the carrot. Also, if the player holds a carrot on a stick, all nearby pigs (but not [[rabbit]]s<ref>{{bug|MC-207993}}</ref>) follow the player, but they can't breed using carrot on a stick.

To make the pig run faster, the player can press {{control|use}} while holding the carrot on a stick. This is called "boosting". Each boost costs 7 durability. If the carrot on a stick's durability is depleted, it turns back into a fishing rod. 

The speed of a mounted pig is 2.42 m/s. Boosting a pig causes its speed to slowly ramp up until it reaches 2.15 times its normal speed, 5.20 m/s. Then speed slowly declines until the pig reaches normal speed again. The boost lasts between 140 and 980 game [[tick]]s (7 seconds and 49 seconds respectively), chosen randomly. No matter how many ticks the boost lasts, the average speed of pig during a full boost cycle is roughly 4.19 m/s. These boosted speeds are applied only while holding the carrot on a stick. These speeds are affected by the [[speed]] effect.

=== Enchantments ===

A carrot on a stick can receive the following enchantments, but only through an [[anvil]]:

{|class="wikitable col-2-center col-3-right"
|+
!Name
!Max Level
![[Enchanting|Method]]
|-
|[[Unbreaking]]
|III
|{{Inventory slot|Anvil}}
|-
|[[Mending]]
|I
|{{Inventory slot|Anvil}}
|-
|[[Curse of Vanishing]]
|I
|{{Inventory slot|Anvil}}
|}

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Random break.ogg
|subtitle=Item breaks
|source=player
|description=When a carrot on a stick's durability is exhausted
|id=entity.item.break
|translationkey=subtitles.entity.item.break
|volume=0.8
|pitch=0.8-1.2
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Random break.ogg
|source=player
|description=When a carrot on a stick's durability is exhausted
|id=random.break
|volume=1.0
|pitch=0.9
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Carrot on a Stick
|spritetype=item
|nameid=carrot_on_a_stick
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Carrot on a Stick
|spritetype=item
|nameid=carrot_on_a_stick
|aliasid=carrotonastick
|id=517
|form=item
|translationkey=item.carrotOnAStick.name
|foot=1}}

== Video ==

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

== History ==

{{History|java}}
{{History||August 28, 2012|link={{tweet|Dinner|240428477856231424}}|Dinnerbone released images of saddled pigs being controlled with carrots.<ref>{{tweet|dinner|240428477856231424}}</ref> They start slow but end up traveling up to 5 blocks per second.<ref>{{tweet|dinner|240429280469856256}}</ref> [[Wheat]] was considered as a "fuel" along with carrots,<ref>{{tweet|dinner|240188453789257728}}</ref> and Dinnerbone eventually decided upon [[carrot]]s.<ref>{{tweet|dinner|240355810650247168}}</ref>}}
{{History||1.4.2|snap=12w36a|[[File:Carrot on a Stick JE1 BE1.png|32px]] Added carrot on a stick. 
|The [[player]] does not get back a [[fishing rod]] once the carrot on a stick is used up.}}
{{History|||snap=12w37a|Carrots on sticks now have a [[item durability|durability meter]], and can be used to give [[saddle]]d [[pig]]s a burst of speed when right-clicked. The carrot on a stick no longer needs to be held when pigs have the burst of speed.}}
{{History|||snap=12w38a|Using up a carrot on a stick now returns a [[fishing rod]].}}
{{History||1.4.6|snap=12w50a|A carrot on a stick can now be [[enchanting|enchanted]] with [[Unbreaking]] via an [[enchanted book]] and an [[anvil]].}}
{{History||1.8.2|snap=pre7|Crafting a carrot on a stick now removes all enchantments on the original fishing rod.}}
{{History||1.9|snap=16w05b|[[Item durability|Durability]] is no longer reduced merely by riding a [[pig]], but only by using the speed boost.{{testingame}}}}
{{History||1.13|snap=17w47a|[[Crafting]] a carrot on a stick no longer requires the [[fishing rod]] to be at full durability.<ref>[https://bugs.mojang.com/browse/MC-123196 MC-123196 resolved as "Works as Intended"]</ref>
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 398.}}
{{History||1.14|snap=18w43a|[[File:Carrot on a Stick.png|32px]] The texture of carrot on a stick has been changed.}}
{{History||1.16|snap=20w06a|Carrot on a stick can now be used up.<ref>[https://bugs.mojang.com/browse/MC-112630 MC-112630]</ref>}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Carrot on a Stick JE1 BE1.png|32px]] Added carrot on a stick.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Carrot on a Stick.png|32px]] The texture of carrot on a stick has been changed.}}
{{History||1.16.100|snap=beta 1.16.100.56|The ID of carrot on a stick has been changed from <code>carrotonastick</code> to <code>carrot_on_a_stick</code>.}}

{{History|console}}
{{History||xbox=TU14|xbone=CU1|ps=1.04|wiiu=Patch 1|switch=1.0.1|[[File:Carrot on a Stick JE1 BE1.png|32px]] Added carrot on a stick.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Carrot on a Stick.png|32px]] The texture of carrot on a stick has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Carrot on a Stick JE1 BE1.png|32px]] Added carrot on a stick.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
PigControl.png|First image of carrot on a stick released by Dinnerbone.
pigstairs.png|Pigs can climb [[stairs]] and [[slabs]].
Jebpig.png|[[Jeb]] riding a pig.<ref>http://www.mojang.com/2012/09/minecraft-snapshot-12w37a/</ref>
Enchanted Carrot on a Stick.gif|An enchanted carrot on a stick.
Grum Carrot on a Stick 1.png|Image from [[Grum]] of a carrot on a stick's texture changing with its durability.
Grum Carrot on a Stick 2.png|Another image showing the same.
Grum Carrot on a Stick 3.png|Another image.
</gallery>

== See also ==
* [[Warped Fungus on a Stick]]

== References ==
{{reflist}}

{{Items}}

[[Category:Renewable resources]]

[[cs:Mrkev na prutu]]
[[de:Karottenrute]]
[[es:Caña con zanahoria]]
[[fr:Carotte sur un bâton]]
[[hu:Répa horgászboton]]
[[it:Bastone e carota]]
[[ja:ニンジン付きの棒]]
[[ko:당근 낚싯대]]
[[nl:Wortel aan een stok]]
[[pl:Marchewka na patyku]]
[[pt:Vara com cenoura]]
[[ru:Удочка с морковью]]
[[th:แคร์รอตติดเบ็ด]]
[[uk:Морква на паличці]]
[[zh:胡萝卜钓竿]]</li><li>[[Pumpkin Pie|Pumpkin Pie]]<br/>{{redirect|Pie|the other craftable dessert|Cake|the terrain features|Pile}}
{{Item
| title = Pumpkin Pie
| image = Pumpkin Pie.png
| renewable = Yes
| heals = {{hunger|8}}
| stackable = Yes (64)
}}

'''Pumpkin pie''' is a [[food]] item that can be eaten by the [[player]].

== Obtaining ==
{{see also
 | Tutorials/Pumpkin and melon farming |title1= Pumpkin and melon farming
 | Tutorials/Sugar Cane farming |title2= Sugar cane farming
 | Tutorials/Egg farming |title3= Egg farming
}}

=== Crafting ===

{{Crafting
|Pumpkin
|Sugar
|Egg
|Output= Pumpkin Pie
|type=Foodstuff
}}

=== Trading ===

Apprentice-level farmer [[villager]]s have a 50%{{only|bedrock}} or {{frac|2|3}}{{only|java}} chance to sell 4 pumpkin pies for an emerald as part of their trades.

{{in|java}}, farmer villagers throw pumpkin pies at players under the [[Hero of the Village]] effect.

=== Natural generation ===

{{LootChestItem|pumpkin-pie}}

== Usage ==

=== Food ===

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

To eat pumpkin pie, press and hold {{control|use}} while it is selected in the hotbar. Eating one restores {{hunger|8}} [[hunger]] and 4.8 [[:en:Hunger#Mechanics|saturation]].

=== Composting ===
Placing pumpkin pie into a [[composter]] raises the compost level by 1.

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Pumpkin Pie
|spritetype=item
|nameid=pumpkin_pie
|id=284
|form=item
|foot=1}}

== Video ==

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

== History ==

{{History|java}}
{{History||September 11, 2012|link=http://twitter.com/jeb_/status/245503714167750656|The first screenshot of pumpkin pie was posted on [[Jens Bergensten|Jeb's]] Twitter.<ref>{{Tweet|jeb|245503714167750656}}</ref><ref>{{Tweet|jeb|245506498099298305}}</ref>}}
{{History||1.4.2|snap=12w37a|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pies.}}
{{History||1.8|snap=14w02a|Pumpkin pie can now be [[trading|bought]] from farmer [[villager]]s, at 2–3 pumpkin pies for 1 [[emerald]].}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 400.}}
{{History||1.14|snap=18w43a|[[File:Pumpkin Pie JE2 BE2.png|32px]] The texture of pumpkin pie has been changed.}}
{{History|||snap=18w50a|Pumpkin pies now generate in chests in taiga [[village]] houses.}}
{{History|||snap=19w03a|Placing pumpkin pie into the new [[composter]] raises the compost level by 1.}}
{{History|||snap=19w13a|Farmer villagers now give pumpkin pies to players under the [[Hero of the Village]] effect.}}

{{History|pocket alpha}}
{{History||v0.8.0|snap=build 1|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pie.}}
{{History||v0.12.1|snap=build 1|Pumpkin pie now restores [[hunger]] instead of [[health]].}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Pumpkin Pie JE2 BE2.png|32px]] The texture of pumpkin pie has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Pumpkin pie can now be found in [[taiga]] and [[snowy taiga]] [[village]] house [[chest]]s.
|Pumpkin pie can now be used to fill up [[composter]]s.}}
{{History|||snap=beta 1.11.0.4|Farmer [[villager]]s now have a 50% chance to [[trading|sell]] 4 pumpkin pies for an [[emerald]].}}

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

{{History|New 3DS}}
{{History||0.1.0|[[File:Pumpkin Pie JE1 BE1.png|32px]] Added pumpkin pie.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Gallery ==

<gallery>
File:Twitter Pumpkin Pie.png|The first screenshot of pumpkin pies, posted on Jeb's twitter.
</gallery>

== References ==

{{reflist}}


{{Items}}

[[cs:Dýňový koláč]]
[[de:Kürbiskuchen]]
[[es:Tarta de calabaza]]
[[fr:Tarte à la citrouille]]
[[it:Torta di zucca]]
[[ja:パンプキンパイ]]
[[ko:호박 파이]]
[[lzh:南瓜餅]]
[[nl:Pompoentaart]]
[[pl:Placek dyniowy]]
[[pt:Torta de abóbora]]
[[ru:Тыквенный пирог]]
[[zh:南瓜派]]
[[Category:Food]]
[[Category:Renewable resources]]</li></ul>
18w43aAdded the block tags bamboo_plantable_on, dirt_like, signs, small_flowers, standing_signs, wall_signs, walls.
Modified block tags enderman_holdable,flower_pots,slabs,stairs.
Added the entity type tag skeletons.
Added the item tags music_discs,signs,small_flowers,walls.
Modified item tags slabs,stairs.
18w44aAdded block and item tag beds.
18w46aAdded block and item tag fences.
1.14.1
{{Extension DPL}}<ul><li>[[Scute|Scute]]<br/>{{about|the item used to craft turtle shell helmets|the helmet|Turtle Shell}}
{{Item
| image = Scute.png
| renewable = Yes
| stackable = Yes (64)
}}

'''Scutes''' are [[item]]s that baby [[turtle]]s drop when they grow into adults. They can be used to craft [[turtle shell]]s which can be used to brew the [[potion of the Turtle Master]].

== Obtaining ==

=== Mob loot ===

Baby [[turtle]]s drop a single scute when they grow up into adults, which is the only way possible to obtain the [[item]].

== Usage ==

Scutes can be crafted into [[turtle shell]]s.

=== Crafting ingredient ===

{{crafting usage}}

=== Repairing ===
Scutes are the [[repair]] items for the turtle [[armor material]], and thus can be used to repair [[turtle shell]]s in an [[anvil]].

=== Trading ===
Expert-level cleric [[villager]]s have a {{frac|2|3}} chance to buy 4 scutes for an [[emerald]] as part of their [[trading|trades]].{{only|java}}

Expert-level cleric villagers have a 50% chance to buy 4 scutes for an emerald as part of their seventh trades.{{only|bedrock}}

Expert-level leatherworker villagers buy 4 scutes for an emerald as part of their trades.

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Scute
|spritetype=item
|nameid=scute
|aliasid=turtle_shell_piece
|id=572
|form=item
|translationkey=item.turtle_shell_piece.name
|foot=1}}

== History ==

{{History|java}}
{{History||1.13|snap=18w07a|[[File:Scute JE1 BE1.png|32px]] Added turtle shell pieces.}}
{{History|||snap=18w07b|"Turtle Shell Pieces" have now been renamed to "Scutes."}}
{{History||1.14|snap=19w11a|Cleric and leatherworker [[villager]]s now [[trading|buy]] scutes.}}

{{History|bedrock}}
{{History||1.5.0|snap=beta 1.5.0.4|[[File:Scute JE1 BE1.png|32px]] Added scutes.}}
{{History||1.11.0|snap=beta 1.11.0.4|Scutes can be [[trading|sold]] to cleric and leatherworker [[villager]]s.}}

{{History|console}}
{{History||xbox=TU69|ps=1.76|wiiu=Patch 38|[[File:Scute JE1 BE1.png|32px]] Added scutes.}}
{{history|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Scutes used to be called "Turtle Shell Pieces", they were renamed after it was pointed out that "Scute" was a more technical term.<ref>https://www.reddit.com/r/minecraftsuggestions/comments/7xnp2o/rename_turtle_shell_pieces_to_scutes/</ref>

== References ==
{{reflist}}

{{Items}}

[[Category:Renewable resources]]

[[de:Hornschild]]
[[es:Escama de tortuga]]
[[fr:Écaille de tortue]]
[[ja:カメのウロコ]]
[[ko:인갑]]
[[lzh:鱗]]
[[pl:Tarczka]]
[[pt:Escama de tartaruga]]
[[ru:Щиток]]
[[th:เกล็ดเต่า]]
[[uk:Черепок]]
[[zh:鳞甲]]</li><li>[[Banner|Banner]]<br/>{{for|the image|Banner (image)}}
{{Block
| image = <gallery>
White Banner.gif | Banner
White Wall Banner.png | Wall Banner
</gallery>
| rarity = Common
| transparent = Yes
| light = No
| tool = axe
| renewable = Yes
| stackable = Yes (16)
| flammable = No
| lavasusceptible = Yes
}}

'''Banners''' are tall decorative [[blocks]], featuring a field that is highly customizable using [[dye]]s and [[banner pattern]]s.

== Obtaining ==

=== Breaking ===

Banners can be broken with or without a [[tool]], but an [[axe]] is fastest.
{{breaking row|horizontal=1|Banners|Axe}}

A banner also breaks and drops itself as an [[Item (entity)|item]] if the block the banner is attached to is moved, removed, or destroyed.

=== Natural generation ===

{| class="wikitable collapsible"
! Name !! Location !! Appearance !! Design
|-
! Magenta Banner
| Outside of [[end cities]].
| style="text-align: center" | [[File:End City Banner.png|32px]]
| Magenta Banner
* Black Inverted Chevron
* Black Chevron
|-
! Gray Banner
| In banner room in [[woodland mansion]]s.
| style="text-align: center" | [[File:Gray Banner.png|32px]]
| Gray Banner
|-
! Light Gray Banner
| In master bedroom in [[woodland mansion]]s.
| style="text-align: center" | [[File:Master Bedroom Banner.png|32px]]
| Light Gray Banner
* White Flower Charge
|- id="Ominous Banner"
! Ominous Banner{{only|java|short=1}} 
Illager Banner{{only|bedrock|education|short=1}}
| Carried by [[raid captain]]s.<br> Located in [[pillager outpost]]s.

{{IN|java}}, the ominous banner cannot be crafted or copied because the design uses 8 patterns.

{{IN|bedrock}}, the illager banner is a separate type that cannot be placed in a loom.
| style="text-align: center" | [[File:Ominous Banner.png|32px]]<br/>[[File:Ominous Banner BE.png|32px]]
| White Banner{{only|java|short=1}}
* Cyan Lozenge
* Light Gray Base
* Gray Pale
* Light Gray Bordure
* Black Fess
* Light Gray Per Fess
* Light Gray Roundel
* Black Bordure
Separate type entirely{{only|bedrock|short=1}}
|-
! Brown Banner
| Outside of some houses, meeting points, and pillar fountains in savanna [[village]]s. 
| style="text-align: center" | [[File:Brown Banner.png|32px]]
| Brown Banner
|-
! Black Banner
| In altar room in [[woodland mansions]].
| style="text-align: center" | [[File:Black Banner.png|32px]]
| Black Banner
|}

=== Crafting ===

Banners can be crafted from six [[wool]] and a [[stick]] in a pattern resembling a [[sign]].
{{Crafting
|head=1
|showdescription=1
|A1=Matching Wool |B1=Matching Wool |C1=Matching Wool
|A2=Matching Wool |B2=Matching Wool |C2=Matching Wool
|B3=Stick
|Output=Matching Banner
|Olink=Banner
|type=Decoration block
|description=Once the banner is crafted, its base color cannot be changed.{{only|java}}
}}
{{Crafting
|showdescription=1
|Any Banner
|Bleach
|Output=White Banner
|type=Decoration block
|description=Bleach can be used to remove the color of a banner, resulting in a white banner. This includes removing patterns from a white banner.{{only|bedrock|education}}
|foot=1
}}

=== Trading ===
Expert-level cartographer [[villager]]s always offer to [[trading|sell]] 1 or 2 blank banners of a random color for 3 [[emeralds]]. Expert-level shepherd villagers have a {{frac|2|7}} chance of offering the same trade.{{only|java}}

{{IN|bedrock}}, expert-level cartographer and shepherd villagers both offer to sell one of 16 blank banners for 3 emeralds as part of their trades.

=== Mob loot ===

[[Illager]]s that spawn carrying an ominous banner{{only|java|short=1}} / illager banner{{only|bedrock|education|short=1}} always drop it upon death.

== Usage ==

[[File:Standing banner with block.png|thumb|upright|Overlapping block on a banner.]]
[[File:Wall banner with block.png|thumb|upright|Overlapping on a wall mounted banner.]]

There are 16 colored blank banners, and numerous patterns each available in each of the 16 colors. A banner can feature up to 6 different patterns. The top layer of a banner (or the last pattern added) can be washed off by {{control|using}} it on a [[cauldron]] containing water.

Banners, much like signs, can be placed both on the ground facing in any direction, or on a wall. They gently sway as if affected by a breeze, regardless of dimension or location. 

Banners have no collision mask as they are completely non-solid, so [[entities]] can move through them.

Other blocks (including other banners) can be placed on any edge of a banner's hitbox, which is only one block high despite the banner appearing as two blocks tall. This makes it possible to overlap another solid block on the top half of a banner for floor banners, or the bottom half of wall banners.

When a banner is placed on the side of a block, its position is set by the top block, and it is possible to place it so it appears half buried.

Banners can also be placed in [[item frame]]s, where they simply appear as their item model.

[[Water]] and [[lava]] flow around banners. {{IN|bedrock}}, banners can be [[waterlogged]].

<gallery>
File:Wall banner with water below.png| Water can be placed below wall banners
File:Water flowing around banner.png| Water flows around a banner on the ground
</gallery>

Lava can create [[fire]] in air blocks next to banners as if the banners were flammable, but the banners do not burn (and cannot be burned by other methods). Banners also cannot be moved by [[piston]]s.

If a banner is renamed on an [[anvil]], it retains its name when a pattern is added, but not when a pattern is removed.

=== Helmet ===
{{exclusive|java|section=13}}
While a banner cannot be equipped in the [[Helmet|head slot]] in [[Survival]] mode, equipping it using commands causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|java|short=1}}.

=== Chestplate ===
{{exclusive|bedrock|section=13}}
While a banner cannot be equipped in the [[chestplate]] slot in Survival mode, equipping it using NBT editors causes it to appear on top of the player. This is how [[raid captain]]s wear banners{{only|bedrock|education|short=1}}.
<gallery>
Steve wearing White Banner.png|
Alex wearing White Banner.png|
Pillager with Ominous Banner.png|
Vindicator with Ominous Banner.png|
Evoker with Ominous Banner.png|Illusioner with Ominous Banner.png|
</gallery>

=== Crafting ingredient ===

[[Shield]]s can have patterns applied to them using banners. The shield pattern has a smaller resolution than the banner pattern, causing them to look different or offset. Banners that have more than six patterns, such as Ominous Banners or banners obtained through inventory editors, will be reduced to six patterns on the shield.

{{Crafting
|showdescription=1
|Shield
|Matching Banner; Ominous Banner
|Output=Matching Shield; Ominous Shield
|B2link=Banner
|type=Combat
|description=Applies the banner pattern to the shield. The banner is consumed.<br>The shield must have no pre-existing patterns.<br>Does not change existing durability or enchantments on the shield.
}}

=== Copying ===

Banners can be copied with a blank banner to make multiple identical banners. Banners with more than 6 patterns applied using commands cannot be copied in this manner.

{{Crafting
|showdescription=1
|Matching Banner
|Matching Banner
|Output=Matching Banner
|A2link=Banner
|B2link=Banner
|Olink=Banner
|type=Decoration block
|ignoreusage=1
|description=Copies pattern; both banners must have the same base color, and the one having a pattern copied onto it must have no preexisting pattern.
}}

=== Map marker ===
[[File:Banner marked map.png|alt=All banners marked on a map, alongside a named banner.|thumb|right|How every banner appears {{IN|java}} on a map, including named banners.]]

{{exclusive|java|section=13}}
{{IN|java}}, {{control|using}} on a standing banner with a [[map]] selected places a marker of the banner's position on the selected map, and {{control|using}} on the banner again removes the marker. Note that wall banners cannot serve as map markers. The marker has the same color as the banner's base without decorations. The marker is removed if the banner is destroyed unless the map is locked using a [[cartography table]]. If the banner is renamed, the name appears below the marker.

=== Patterns ===
{{see also|Banner/Patterns|title1=List of patterned banners}}
[[File:Spawned-in Banner.png|thumb|100px|Example of a banner with more than 6 patterns, a result of using the {{cmd|give}} command.]]

A banner may have up to six layers of patterns, which are overlaid with the last-crafted on top. A banner can have up to 16 layers of patterns with the use of commands. The total number of unique banners is approximately 2.3x10^16 (or 23 quadrillion).

Any color banner can be used; the pattern overlays the color. {{IN|java}}, a [[loom]] is used to make patterns. However, {{in|bedrock}}, the patterns can be made in a [[loom]] or a [[crafting table]].

A banner can have more than six layers of patterns through the commands <code>/[[Commands/give|give]]</code>, <code>/[[Commands/setblock|setblock]]</code> or <code>/[[Commands/fill|fill]]</code>. This only works in ''Java Edition'', as Bedrock Edition doesn't have any NBT commands. Here is an example of a mining banner with seven different patterns. There is specific codes for the [[Banner#Item data:~:text=white-,Item,-In Java Edition|colors]] and [[Banner/Patterns|patterns]] that you have to input. 

<code><nowiki>/give @p white_banner{display:{Name:"\"Mining Industries Banner\""},BlockEntityTag:{Patterns:[{Pattern:"cr",Color:15},{Pattern:"bs",Color:15},{Pattern:"sc",Color:12},{Pattern:"ms",Color:0},{Pattern:"hh",Color:15},{Pattern:"bo",Color:15},{Pattern:"tts",Color:8}]}} 1</code>

{{LoadPage|Template:Banner pattern loom recipes|Loom recipes|h4}}
{{LoadPage|Banner/Banner pattern crafting recipes|Crafting recipes|h4|transcluded=1}}

=== Renaming ===
{{IN|java}}, a banner can be given a custom name that remains as the banner is placed and retrieved. The player can use an [[anvil]] to rename the banner item, or may change the <code>CustomName</code> tag using the {{cmd|data}} command on the banner block.

=== Fuel ===
Banners can be used as a fuel in [[furnace]]s, smelting 1.5 items per banner.

=== Note Blocks ===
Banners can be placed under [[note block]]s to produce "bass" sounds.

== Sounds ==
=== Generic ===
{{Sound table/Block/Wood}}
=== Unique ===
{{edition|java}}: ''None''

{{edition|bedrock}}:
{{Sound table
|type=bedrock
|sound=Water Splash Old.ogg
|source=block
|description=When all patterns are removed from a banner using a cauldron
|id=cauldron.cleanbanner
|volume=0.1
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showblocktags=y
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=White Banner
|spritetype=block
|nameid=white_banner
|blocktags=banners, wall_post_override
|itemtags=banners
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner
}}
{{ID table
|displayname=Orange Banner
|spritetype=block
|nameid=orange_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Magenta Banner
|spritetype=block
|nameid=magenta_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Blue Banner
|spritetype=block
|nameid=light_blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Yellow Banner
|spritetype=block
|nameid=yellow_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Lime Banner
|spritetype=block
|nameid=lime_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Pink Banner
|spritetype=block
|nameid=pink_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Gray Banner
|spritetype=block
|nameid=gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Light Gray Banner
|spritetype=block
|nameid=light_gray_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Cyan Banner
|spritetype=block
|nameid=cyan_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Purple Banner
|spritetype=block
|nameid=purple_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Blue Banner
|spritetype=block
|nameid=blue_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Brown Banner
|spritetype=block
|nameid=brown_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Green Banner
|spritetype=block
|nameid=green_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Red Banner
|spritetype=block
|nameid=red_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=Black Banner
|spritetype=block
|nameid=black_banner
|blocktags=banners, wall_post_override
|itemtags=banners}}
{{ID table
|displayname=White Wall Banner
|spritetype=block
|nameid=white_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.white_banner,block.minecraft.ominous_banner}}
{{ID table
|displayname=Orange Wall Banner
|spritetype=block
|nameid=orange_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.orange_banner}}
{{ID table
|displayname=Magenta Wall Banner
|spritetype=block
|nameid=magenta_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.magenta_banner}}
{{ID table
|displayname=Light Blue Wall Banner
|spritetype=block
|nameid=light_blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_blue_banner}}
{{ID table
|displayname=Yellow Wall Banner
|spritetype=block
|nameid=yellow_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.yellow_banner}}
{{ID table
|displayname=Lime Wall Banner
|spritetype=block
|nameid=lime_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.lime_banner}}
{{ID table
|displayname=Pink Wall Banner
|spritetype=block
|nameid=pink_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.pink_banner}}
{{ID table
|displayname=Gray Wall Banner
|spritetype=block
|nameid=gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.gray_banner}}
{{ID table
|displayname=Light Gray Wall Banner
|spritetype=block
|nameid=light_gray_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.light_gray_banner}}
{{ID table
|displayname=Cyan Wall Banner
|spritetype=block
|nameid=cyan_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.cyan_banner}}
{{ID table
|displayname=Purple Wall Banner
|spritetype=block
|nameid=purple_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.purple_banner}}
{{ID table
|displayname=Blue Wall Banner
|spritetype=block
|nameid=blue_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.blue_banner}}
{{ID table
|displayname=Brown Wall Banner
|spritetype=block
|nameid=brown_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.brown_banner}}
{{ID table
|displayname=Green Wall Banner
|spritetype=block
|nameid=green_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.green_banner}}
{{ID table
|displayname=Red Wall Banner
|spritetype=block
|nameid=red_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.red_banner}}
{{ID table
|displayname=Black Wall Banner
|spritetype=block
|nameid=black_wall_banner
|blocktags=banners, wall_post_override
|form=block
|translationkey=block.minecraft.black_banner
|foot=1}}
{{ID table
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=banner
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Banner
|shownumericids=y
|showforms=y
|generatetranslationkeys=y
|displayname=Standing
|spritename=Banners
|spritetype=block
|nameid=standing_banner
|translationkey=tile.standing_banner.black.name, tile.standing_banner.red.name, tile.standing_banner.green.name, tile.standing_banner.brown.name, tile.standing_banner.blue.name, tile.standing_banner.purple.name, tile.standing_banner.cyan.name, tile.standing_banner.silver.name, tile.standing_banner.gray.name, tile.standing_banner.pink.name, tile.standing_banner.lime.name, tile.standing_banner.yellow.name, tile.standing_banner.lightBlue.name, tile.standing_banner.magenta.name, tile.standing_banner.orange.name, tile.standing_banner.white.name
|id=176
|form=block}}
{{ID table
|displayname=Wall
|spritename=Banners
|spritetype=block
|nameid=wall_banner
|id=177
|form=block
|translationkey=-}}
{{ID table
|displayname=Item
|spritename=Banners
|spritetype=item
|nameid=banner
|translationkey=item.banner.black.name, item.banner.red.name, item.banner.green.name, item.banner.brown.name, item.banner.blue.name, item.banner.purple.name, item.banner.cyan.name, item.banner.silver.name, item.banner.gray.name, item.banner.pink.name, item.banner.lime.name, item.banner.yellow.name, item.banner.lightBlue.name, item.banner.magenta.name, item.banner.orange.name, item.banner.white.name
|id=567
|form=item
|foot=1}}
{{ID table
|notnamespaced=y
|displayname=Block entity
|spritename=Banners
|spritetype=block
|nameid=Banner
|foot=1}}

=== Metadata ===
==== Item ====
{{IN|Bedrock}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 0 || black
|-
|| 1 || red
|-
|| 2 || green
|-
|| 3 || brown
|-
|| 4 || blue
|-
|| 5 || purple
|-
|| 6 || cyan
|-
|| 7 || light gray
|-
|| 8 || gray
|-
|| 9 || pink
|-
|| 10 || lime
|-
|| 11 || yellow
|-
|| 12 || light blue
|-
|| 13 || magenta
|-
|| 14 || orange
|-
|| 15 || white
|}

=== Item ===
{{IN|Java}}, banner items use the following data values:
{| class="wikitable"
! DV !! Banner color
|-
|| 15 || black
|-
|| 14 || red
|-
|| 13 || green
|-
|| 12 || brown
|-
|| 11 || blue
|-
|| 10 || purple
|-
|| 9 || cyan
|-
|| 8 || light gray
|-
|| 7 || gray
|-
|| 6 || pink
|-
|| 5 || lime
|-
|| 4 || yellow
|-
|| 3 || light blue
|-
|| 2 || magenta
|-
|| 1 || orange
|-
|| 0 || white
|}

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

=== Block data ===

A banner has a block entity associated with it that holds additional data about the block. 

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

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

=== Item data ===

{{el|java}}:
{{main|Player.dat format}}
Banners, as items, use an NBT tag <code>BlockEntityTag</code> to indicate the patterns and details when it is placed.

<div class="treeview" style="margin-top: 0;">
* {{nbt|compound|Item}}: The item
** {{nbt|compound|tag}}: Additional information about the item. This tag is optional for most items.
*** {{nbt|compound|BlockEntityTag}}: The details of the shulker box.
**** All block data, except tags common to all block entities.
</div>

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

== Achievements ==
{{load achievements|Fruit on the Loom}}

== Advancements ==
{{load advancements|Voluntary Exile}}

== History ==
{{info needed section|The Nether Update}}
{{History|java}}
{{History||1.8|snap=July 21, 2014|slink=https://twitter.com/jeb_/status/491238882789572608|[[Jeb]] posted a picture of banners, and stated that he is working on them.}}
{{History|||snap=14w30a|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History|||snap=14w30c|Added four additional patterns: Cross (+), Border, Curly Border and Thing (Mojang logo).}}
{{History|||snap=14w31a|Added two additional patterns: Inverted Halves and Base Gradient.
|The banner pattern terminology has been changed based on vexillology advice [[Jeb]] received from [http://www.reddit.com/r/Minecraft/comments/2bkxej/i_made_a_huge_mistake_banners/ his Reddit post].
|Banners can now be used as a [[fuel]] in [[furnace]]s.}}
{{History||1.8.8|snap=pre|The number of layers attainable by using [[commands]] is now limited to 16 per banner.}}
{{History||1.9|snap=15w31a|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History|||snap=15w33c|Banners can be used to apply patterns to [[shield]]s.}}
{{History||1.11|snap=16w33a|Banners now require a [[dye]] when applying a pattern that uses a non-dye [[item]], such as a [[mob head|creeper head]] or [[golden apple|enchanted golden apple]]. Previously, the lack of a dye would have applied the black variant of the pattern.}}
{{History|||snap=16w39a|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.12|snap=January 24, 2017|slink={{tweet|jeb_|823817090511601664}}|[[Jeb]] tweets a screenshot of the changes to the banner color palette.}}
{{History|||snap=17w06a|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History|||snap=pre6|"Chief fess" and "base fess" banners are now just "chief" and "base" banners.}}
{{History||1.13|snap=17w47a|The colors for the <code>banner</code>, <code>wall_banner</code> and <code>standing_banner</code> ID have been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], these [[block]]s' numeral IDs were 176 and 177, and the [[item]]'s 425.}}
{{History|||snap=18w10a|{{control|Using}} a [[map]] on a banner now mark the spot of the banner on the map.}}
{{History||1.14|snap=18w43a|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|All recipes for banner patterns have been removed.}}
{{History|||snap=18w45a|[[File:Ominous Banner Revision 1.png|17px]] Added [[illager patrol]]s, where the leader of an illager patrol carries an [[illager]] banner.}}
{{History|||snap=18w46a|[[File:Ominous Banner.png|17px]] The pattern of [[illager]] banner now has a black border.}}
{{History|||snap=19w11a|Cartographer and shepherd [[villager]]s now [[trading|sell]] banners.}}
{{History|||snap=Pre-Release 2|"Illager Banners" have been renamed to "Ominous Banners".}}
{{History||1.17|snap=20w46a|The unused "base" pattern has been renamed to the "field" pattern and given proper translation strings (its ID is still "base").}}
{{History||1.19.3|snap=22w43a|The ominous banner is now available in the Creative inventory.}}

{{History|bedrock}}
{{History||1.2.0|snap=beta 1.2.0.2|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Added banners.
|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].
|Black and gray banners, and light gray banners with a white flower charge are now naturally generated in rooms of [[woodland mansion]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|The white banner can now be crafted from a colored banner and [[bleach]], which also removes all patterns, if used on a white banner.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[Loom]]s have been added to help the [[player]] edit banners more easily.
|Brown banners now generate in new [[savanna]] [[village]]s.
|Black banners now generate in [[pillager outpost]] watchtowers.}}
{{History||1.11.0|snap=beta 1.11.0.1|Gray banners now generate in pillager outpost watchtowers, instead of black banners.
|[[File:Ominous Banner BE.png|17px]] Added [[illager captain]]s, which drop an [[illager]] banner upon [[death]].}}
{{History|||snap=beta 1.11.0.3|Illager banners now generate in [[pillager outpost]] watchtowers, instead of gray banners.}}
{{History|||snap=beta 1.11.0.4|Banners can now be [[trading|bought]] from cartographer and shepherd [[villager]]s.}}
{{History||1.20.0|snap=beta 1.20.0.20|Banners can now be used to customise [[shield]]s.}}

{{History|console}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|switch=1.0.1|[[File:White Banner Revision 1.png|22px]][[File:Light Gray Banner Revision 1.png|22px]][[File:Gray Banner Revision 1.png|22px]][[File:Black Banner Revision 1.png|22px]][[File:Brown Banner Revision 1.png|22px]][[File:Red Banner Revision 1.png|22px]][[File:Orange Banner Revision 1.png|22px]][[File:Yellow Banner Revision 1.png|22px]][[File:Lime Banner Revision 1.png|22px]][[File:Green Banner Revision 1.png|22px]][[File:Cyan Banner Revision 1.png|22px]][[File:Light Blue Banner Revision 1.png|22px]][[File:Blue Banner Revision 1.png|22px]][[File:Purple Banner Revision 1.png|22px]][[File:Magenta Banner Revision 1.png|22px]][[File:Pink Banner Revision 1.png|22px]] Added banners.}}
{{History||xbox=TU46|xbone=CU36|ps=1.38|wiiu=Patch 15|switch=1.0.1|[[File:End City Banner.png|17px]] Magenta banners with a black chevron and inverted chevron are now naturally generated on the outside walls of [[end city|end cities]].}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|[[File:White Banner.png|17px]] [[File:Light Gray Banner.png|17px]] [[File:Gray Banner.png|17px]] [[File:Black Banner.png|17px]] [[File:Brown Banner.png|17px]] [[File:Red Banner.png|17px]] [[File:Orange Banner.png|17px]] [[File:Yellow Banner.png|17px]] [[File:Lime Banner.png|17px]] [[File:Green Banner.png|17px]] [[File:Cyan Banner.png|17px]] [[File:Light Blue Banner.png|17px]] [[File:Blue Banner.png|17px]] [[File:Purple Banner.png|17px]] [[File:Magenta Banner.png|17px]] [[File:Pink Banner.png|17px]] Changed banners' [[tint]]s.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[Loom]]s have been added to help the [[player]] edit banners more easily.}}
{{History||ps=1.91|[[File:Ominous Banner BE.png|17px]] Added [[illager]] banners, which generate with [[pillager outpost]]s and are [[drops|dropped]] by [[illager captain]]s upon [[death]].}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==
* With 16 blank banners, 38 patterns of 16 colors each (608 uniquely-colored patterns), and 0 to 6 patterns per banner, the number of uniquely crafted banners is 16 × (608<sup>0</sup> + 608<sup>1</sup> + 608<sup>2</sup> + 608<sup>3</sup> + 608<sup>4</sup> + 608<sup>5</sup> + 608<sup>6</sup>) ≈ 809 quadrillion - 809 with 15 zeros (809,573,616,779,945,488). The number of visually distinct banners is smaller, because one or more patterns may completely cover other patterns, or the entire banner, or be duplicated due to the symmetric set of patterns (e.g. field or (yellow) + per pale azure (blue) = field azure + per pale or inverted).
** Not 38 patterns are available on BE, but 40 patterns of 16 colors each (640 uniquely-colored patterns), so the number is even greater. 16 × (640<sup>0</sup> + 640<sup>1</sup> + 640<sup>2</sup> + 640<sup>3</sup> + 640<sup>4</sup> + 640<sup>5</sup> + 640<sup>6</sup>) ≈ 1 quintillion - 1 with 18 zeros (1,101,232,303,249,827,856). This increases the number by almost 1.4 times, or almost 292 quadrillion, despite the addition of only 2 patterns.
* If a banner has over 6 patterns, only the six bottom-most patterns are displayed when hovered over in the [[inventory]].
* The Mojang logo is called "Thing" in-game, which could be considered an alternate translation for [[wiktionary:mojäng|mojäng]]. If [[wikipedia:Google Translate|Google Translate]] is used, it translates to "thingys" or "contraption".
** In the Swedish translation of the game, this pattern is, in fact, called ''mojäng''.
* [[List of block textures#Banner Textures|Banner textures]] are located in \assets\minecraft\textures\entity\banner.
** There are 40 monochrome textures, each containing all 6 sides of the banner.
** The texture of the back side is the mirrored texture of the front side.
** Compared to the texture files, textures' colors are inverted in-game due to them acting as masks for the re-colored base texture, base.png. That means white is visible, while black is transparent.
* Banners that have the purple NBT+ line in the bottom (obtained by holding Ctrl and middle-clicking the banner, which also copies the NBT [[tag]] of anything that the player points their crosshair to) actually have no difference with the base banner obtained by middle click.
*The Illager Banner in Bedrock Edition is available as a separate item but is just a second variant of the white banner.
**Standard variant of white banner is set to type 0.
**Illager variant is set to type 1.

== Gallery ==
<gallery>
Banners Jeb.png|The first image of banners, as tweeted by Jens Bergensten.
Iceland and Norway Flags.png|Another banner image from Jeb.
Searge Banners.png|Several banners made by Searge.
The Bountiful Update.png|Banners in the official 1.8 poster.
BannersBeforeAndAfter.png|An image, tweeted by Jeb, showcasing the changes he made to the banner color palette in the 1.12 update.
Gradients Overlay.png|The result of using gradient different numbers of times, each time increasing the level of gradient by 1.
All positions and rotations of a banner.png|All positions and rotations of a banner
Item Frame with Banner.png|A banner with the [[Mojang]] logo in an [[item frame]].
EndCityBanners.png|Banners floating outside of an [[End city]] tower.
Woodland mansion 1x2 d1.png|Banners hanging above the doorway of a [[woodland mansion]] master bedroom.
Replaceitembanner.png|Banner put in the helmet slot by using the command {{cmd|replaceitem}}{{Only|BE}} or {{cmd|item replace}}{{Only|JE}}.
Better Together Banners.jpg|Banners in ''Bedrock Edition''.
Better Together Banner Crafting 1.jpg|A banner in the hand.
Better Together Banner Crafting 2.jpg|A banner in the inventory.
Better Together Banner Crafting 3.jpg|A banner in the crafting grid.
Better Together Banner Crafting 4.jpg|A banner being given a pattern.
</gallery>

=== Renders ===
<gallery>
Ominous Banner.gif
White Banner.gif
Light Gray Banner.gif
Gray Banner.gif
Black Banner.gif
Brown Banner.gif
Red Banner.gif
Orange Banner.gif
Yellow Banner.gif
Lime Banner.gif
Green Banner.gif
Cyan Banner.gif
Light Blue Banner.gif
Blue Banner.gif
Purple Banner.gif
Magenta Banner.gif
Pink Banner.gif
Ominous Wall Banner.png| 
White Wall Banner.png| 
Light Gray Wall Banner.png| 
Gray Wall Banner.png| 
Black Wall Banner.png| 
Brown Wall Banner.png| 
Red Wall Banner.png| 
Orange Wall Banner.png| 
Yellow Wall Banner.png| 
Lime Wall Banner.png| 
Green Wall Banner.png| 
Cyan Wall Banner.png| 
Light Blue Wall Banner.png| 
Blue Wall Banner.png| 
Purple Wall Banner.png| 
Magenta Wall Banner.png| 
Pink Wall Banner.png
</gallery>

<gallery>
File:Ominous Banner.gif|Ominous banner pattern in Java Edition.
File:Ominous Banner BE.gif|Illager banner pattern in Bedrock Edition.
File:Ominous Banner Revision 1.gif|Old Ominous banner pattern.
File:Ominous Banner washing.gif|Washing with cauldron shows how to apply the ominous banner pattern.
</gallery>

=== [[Lego Minecraft]] Banners ===
<gallery>
File:Lego Red Creeper Banner Collage.jpg|Lego banners from 21127 and 21131
File:Lego Melon Banner.png|Lego banner from 21138
File:Lego Fish Banner.png|Lego banner from 21142
File:Lego Beetroot Banner.png|Lego banner from 21144
File:Lego Wheat Banner.png|Another lego banner from 21144
File:Lego Carrot Banner.png|A third lego banner from 21144
File:Lego Crossbones Banner.png|Lego banner from 21152
File:Lego Green Creeper Banner Collage.jpg|Lego banners from 21155
File:Lego Ominous Banner.png|Lego ominous banner from 21160
</gallery>

== References ==
{{reflist}}

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

[[Category:Generated structure blocks]]
[[Category:Manufactured blocks]]
[[Category:Block entities]]
[[Category:Non-solid blocks]]

[[cs:Prapor]]
[[de:Banner]]
[[es:Estandarte]]
[[fr:Bannière]]
[[ja:旗]]
[[ko:현수막]]
[[nl:Banier]]
[[pl:Sztandar]]
[[pt:Estandarte]]
[[ru:Флаг]]
[[uk:Стяг]]
[[zh:旗帜]]</li></ul></nowiki>
Pre-Release 1Functions in a tag are now executed in the order they are listed.
1.15
{{Extension DPL}}<ul><li>[[Le Tricolore|Le Tricolore]]<br/>{{Exclusive|Java}}
{{Joke feature}}
{{Item
| image = 
| renewable = Yes
| stackable = Yes (64)
}}

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

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

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

== Data values ==

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

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

{{Items}}
{{Jokes}}

[[Category:Joke items]]

[[ja:Le Tricolore]]
[[pt:Le Tricolore]]</li><li>[[Map|Map]]<br/>{{about|the craftable map|maps showing the locations of certain structures|Explorer Map|other uses|Map (disambiguation)}}
{{distinguish|World}}
{{Item
| image = Map Zoom 4.png
| renewable = Yes
| stackable = Yes (64)
}}

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

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

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

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

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

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

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

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

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

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

=== Mapping ===

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

To record the world on a map, that specific map must be held in the player's hands while the player moves around the world. The world is recorded as-is during exploration, meaning that if the world is modified, a player must revisit the area while holding the map to update the map's view. Maps can also be [[Map#Cloning|cloned]]. If a player holds a map whose one or more clones are on display in item frames, updates are made on all clone-connected maps. 

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{{/BE|clone}}

=== Crafting ingredient ===

{{crafting usage|Map, Empty Map}}

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

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

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

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

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

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

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

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

{{-}}

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

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

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

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

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

{{/DV}}

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

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

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

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

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

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

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

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

== Issues ==
{{issue list}}

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

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

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

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

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

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

== References ==
{{Reflist}}

{{Items}}

[[cs:Mapa]]
[[de:Karte]]
[[es:Mapa]]
[[fr:Carte (objet)]]
[[hu:Térkép (tárgy)]]
[[ja:地図]]
[[ko:지도]]
[[nl:Kaart]]
[[pl:Mapa]]
[[pt:Mapa]]
[[ru:Карта]]
[[tr:Harita]]
[[th:แผนที่]]
[[uk:Мапа]]
[[zh:地图]]
[[Category:Renewable resources]]</li></ul></nowiki>
19w34aAdded bee_growables, beehives, crops, flowers, and tall_flowers block tags.
Added flowers, and tall_flowers item tags.
19w36aAdded beehive_inhabitors entity tag.
19w41aRemoved dirt_like block tag.
19w42aAdded lectern_books item tag.
19w44aAdded shulker_boxes block tag.
19w45aAdded arrows entity tag.
Pre-Release 2Added portals block tag.
1.16
{{Extension DPL}}<ul><li>[[Fish|Fish]]<br/>{{About|the type of mob|the action|Fishing}}
'''Fish''' are aquatic creatures that are found in [[river]] and [[ocean]] biomes.

== Mobs ==
There are four categories of fish mobs in ''Minecraft'': 
*{{EntityLink|Cod}}
*{{EntityLink|Salmon}}
*{{EntityLink|Pufferfish}}
*{{EntityLink|Tropical Fish}} - many color and pattern varieties

In addition, there are other fish-like mobs that have different characteristics from fish: {{EntityLink|Axolotl}}, {{EntityLink|Guardian}}, and {{EntityLink|Elder Guardian}}.

==Obtaining and transporting==
A live fish can be captured by using a [[water bucket]] on a fish, to obtain a [[bucket of fish]], which is the only way to obtain the live mob in item form. Using the bucket of fish on a water source block transfers the fish from the bucket to the body of water. A water bucket may also be used on [[axolotl]]s in this manner.

==Items==
Fish exist in several different item forms. Upon death, fish drop their item form equivalent (cooked if on fire), with a chance to drop a [[bone]]{{only|bedrock}} or [[bone meal]].{{only|java}}

;Non-living
*{{ItemLink|Raw Cod}}
*{{ItemLink|Cooked Cod}}
*{{ItemLink|Raw Salmon}}
*{{ItemLink|Cooked Salmon}}
*{{ItemLink|Pufferfish|link=Pufferfish (item)}}
*{{ItemLink|Tropical Fish|link=Tropical Fish (item)}}
;Living
*{{ItemLink|Bucket of Cod}}
*{{ItemLink|Bucket of Salmon}}
*{{ItemLink|Bucket of Pufferfish}}
*{{ItemLink|Bucket of Tropical Fish}}

== Spawning ==
Various fish can be found in different [[ocean]] [[biomes]], but only [[salmon]] appear in rivers. Fish can also spawn in player-created bodies of water, as long as they are within a river or ocean biome.

{| class="wikitable sortable" style="text-align:left" data-description="Fish biomes"
!'''Fish'''
! style="text-align:left" |{{BiomeLink|Warm Ocean}}
! style="text-align:left" |{{BiomeLink|Lukewarm Ocean}}<br>{{BiomeLink|Deep Lukewarm Ocean}}
! style="text-align:left" |{{BiomeLink|Ocean}}<br>{{BiomeLink|Deep Ocean}}
! style="text-align:left" |{{BiomeLink|Cold Ocean}}<br>{{BiomeLink|Deep Cold Ocean}}
! style="text-align:left" |{{BiomeLink|Frozen Ocean}}<br>{{BiomeLink|Deep Frozen Ocean}}
! style="text-align:left" |{{BiomeLink|River}}<br>{{BiomeLink|Frozen River}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Cod}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Salmon}}
| rowspan=2 {{tc|no}}
| {{tc|no|No{{only|je|short=1}}}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
| {{tc|yes|Yes{{only|be|short=1}}}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Pufferfish}}
| rowspan=2 {{tc|yes}}
| {{tc|yes|Yes{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
|-
| {{tc|no|No{{only|be|short=1}}}}
|-
! style="text-align:left" |{{EntityLink|Tropical Fish}}<ref group="note">Also spawns in {{BiomeLink|Lush Caves}} at any Y-level.</ref>
| {{tc|yes}}
| {{tc|yes}}
| {{tc|no}}
| {{tc|no}}
| {{tc|no}}
| {{tc|no}}
|-
! style="text-align:left" |{{EntityLink|Squid}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
| {{tc|yes}}
|-
! rowspan=2 style="text-align:left" |{{EntityLink|Dolphin}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| rowspan=2 {{tc|yes}}
| {{tc|no|No{{only|je|short=1}}}}
| rowspan=2 {{tc|no}}
| rowspan=2 {{tc|no}}
|-
| {{tc|yes|Yes{{only|be|short=1}}}}
|}
{{notelist}}

In ''Java Edition'', fish can spawn inside a water block at Y-level 50 to 63 (from 13 blocks below sea level up to inside the block one above it), that also has water above and below it. The spawn block and the block below can be any kind of water, such as a source block, falling water, bubble column, kelp, or even a waterlogged block (as long as the fish can be placed at the bottom center of the spawn block without colliding with anything solid). The block above must be pure water, such as a source block, falling water, or flowing water of any depth. Particularly, the block above cannot also be a bubble column, so fish no longer spawn inside bubble elevators.<ref>{{cite bug|MC|244683|Tropical fish spawn in bubble columns (fixed in 22w07a)}}</ref> 

''Bedrock Edition'' does permit fish to spawn in bubble columns.<ref>{{cite bug|MCPE|73967|Squids, Dolphins, and fish not spawning in bubble columns (fixed in 1.16.20)}}</ref>

Fish can spawn between 24 and 64 block spherical range away from the player.{{only|java}} 

=== Despawning ===
As of [[1.16]], fish can despawn at range of 40 blocks or more from the player, and will instantly despawn more than 64 blocks away, except when spawned using a [[bucket of fish]].

{{Items}}
{{Entities}}

[[cs:Ryba]]
[[de:Fisch (Begriffsklärung)]]
[[es:Pez]]
[[fr:Poisson]]
[[it:Pesce]]
[[ja:魚]]
[[ko:물고기]]
[[nl:Vis]]
[[pl:Ryba (ujednoznacznienie)]]
[[pt:Peixe]]
[[ru:Рыба]]
[[th:ปลา (แก้ความกำกวม)]]
[[uk:Риба]]
[[zh:鱼]]</li><li>[[Echo Shard|Echo Shard]]<br/>{{Item
| title = Echo Shard
| image = Echo Shard.png
| renewable = No
| stackable = Yes (64)
}}
An '''echo shard''' is an item found in [[ancient cities]] which can be used to craft [[recovery compass]]es.

== Obtaining ==
=== Chest loot ===
{{LootChestItem|echo-shard}}

== Usage ==
=== Crafting ingredient ===
{{crafting usage|Echo Shard}}

== History ==
{{History|java}}
{{History||1.19|snap=22w14a|[[File:Echo Shard JE1 BE1.png|32px]] Added echo shards.}}
{{History|bedrock}}
{{History||1.19.0|snap=beta 1.19.0.24|[[File:Echo Shard JE1 BE1.png|32px]] Added echo shards.
|Currently cannot be found inside [[ancient city]] chests due to outdated structures and loot chests.}}
{{History||1.19.0|snap=beta 1.19.0.26|Echo shards now generate inside [[ancient city]] loot chests.}}
{{History|foot}}

== Issues ==

{{issue list}}

{{Items}}

[[Category:Non-renewable resources]]

[[de:Echoscherbe]]
[[es:Fragmento resonante]]
[[fr:Éclat d'écho]]
[[ja:残響の欠片]]
[[lzh:回音殘片]]
[[pt:Fragmento de eco]]
[[pl:Odłamek pogłosu]]
[[ru:Осколок эха]]
[[th:เศษเอคโค]]
[[uk:Уламок відлуння]]
[[zh:回响碎片]]</li></ul>
20w06aAdded crimson_stems, fire, nylium, warped_stems, and wart_blocks block tags.
Added crimson_stems, and warped_stems item tags.
Added crimson and warped items to planks, standing_signs, wall_signs, wooden_buttons, wooden_doors, wooden_fences, wooden_pressure_plates, wooden_slabs, wooden_stairs, and wooden_trapdoors block tags.
Added crimson and warped items to planks, signs, wooden_buttons, wooden_doors, wooden_fences, wooden_pressure_plates, wooden_slabs, wooden_stairs, and wooden_trapdoors item tags.
The slabs block and item tags now use the respective wooden_slabs tag.
20w07aAdded beacon_base_blocks, wall_post_override, and wither_summon_base_blocks block tags.
Added beacon_payment_items item tag.
Removed netherrack and added fungi, roots, and nylium variants to the enderman_holdable block tag.
20w09aAdded climbable block tag.
Added impact_projectiles entity tag.
Added potted crimson fungus, warped fungus, nether sprouts, and crimson roots to the flower_pots block tag.
20w10aAdded hoglin_repellents, and piglin_repellents block tags.
Added crimson hyphae, warped hyphae, and the stripped variants to their respective stem block and item tags.
20w11aAdded gold_ores, and soul_speed_blocks block tags.
Added gold_ores, and piglin_repellents item tags.
Added twisted vines to the climbable block tag.
Added crying obsidian to the dragon_immune block tag.
Added potted warped fungus to the hoglin_repellents block tag.
20w12aAdded soul_fire_base_blocks block tag.
20w13aAdded the logs_that_burn, and non_flammable_wood block and item tags.
Added the strider_warm_blocks block tag.
The logs block and item tags now contain the logs_that_burn, crimson_stems, and warped_stems block and item tags.
Added the respawn anchor to the dragon_immune block tag.
20w14aAdded nether portals and respawn anchors to the hoglin_repellents block tag.
20w15aAdded the campfires, and guarded_by_piglins block tags.
Added the furnace_materials, soul_fire_base_blocks, and stone_tool_materials item tags.
Added polished blackstone, and (where applicable) blackstone blocks and items to the buttons, slabs, stairs, and walls block and item tags.
Added soul campfires to the piglin_repellents block tag.
Added the #signs block tag and removed lanterns and soul fire lanterns from the wall_post_override block tag.
20w16aAdded the creeper_drop_music_discs item tag.
Changed the music_discs item tag to use the #creeper_drop_music_discs item tag and the pigstep music disc.
20w17aAdded the pressure_plates, and stone_pressure_plates block tags.
Added the banners, and signs block tags to the wall_post_override block tag.
20w18aAdded soul campfires to the piglin_repellents item tag.
20w19aAdded the prevent_mob_spawning_inside block tag.
The slabs block and item tags now use the respective wooden_slabs tag.
20w20aAdded the piglin_loved item tag.
20w21aRemoved wither roses from the prevent_mob_spawning_inside block tag.
20w22aAdded the fence_gates, and unstable_bottom_center block tags.
Pre-release 1Added gold nuggets to the piglin_loved item tag.
The piglin_loved item tag now uses the gold_ores item tag.
Removed sweet berry bushes from the prevent_mob_spawning_inside block tag.
Pre-release 3Added infiniburn_end, infiniburn_nether, and infiniburn_overworld block tags.
Removed gold nuggets from the piglin_loved item tag.
1.16.2
{{Extension DPL}}<ul><li>[[Debug fourj item|Debug fourj item]]<br/>{{DISPLAYTITLE:<samp>debug_fourj_item</samp>}}
{{exclusive|Legacy Console}}{{Unobtainable||edition=console|section=}}{{Item
| image = Barrier (held) JE1 BE1.png
| renewable = No
| stackable = Yes (64)
| rarity = Common
| title = <samp>debug_fourj_item</samp>
}}
<samp>'''debug_fourj_item'''</samp> is an unobtainable item exclusive to the [[Legacy Console Edition]] and can only be obtained through modding the game. It has the texture of a [[barrier]], no "What's this?" hint and no display name.

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

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

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

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

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

==See also==

*[[Debug Stick]]

==References==
<references />

{{Items}}
{{Unused features}}
[[Category:Articles missing historical information]]</li><li>[[Lime Dye|Lime Dye]]<br/>{{Item
| image = Lime_Dye_JE2_BE2.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Lime dye''' is a [[Dye#Quasi-Primary|quasi-primary dye]] obtained by combining one [[green dye]] and one [[white dye]] in a crafting square, or by smelting a [[sea pickle]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showname=0
  |showdescription=1
  |Green Dye
  |White Dye
  |Output=Lime Dye,2
  |type=Material
}}
{{Crafting
  |foot=1
  |Green Dye
  |Bone Meal
  |Output=Lime Dye,2
  |description={{only|bedrock|education}}
  |type=Material
}}

=== Smelting ===

{{Smelting
|head=1
|foot=1
|Sea Pickle
|Lime Dye
|0,2
}}

=== Trading ===

[[Wandering trader]]s sell 3 lime [[dye]] for 1 [[emerald]].

== Usage  ==

{{dye usage}}

=== Crafting ingredient ===

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

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

=== Trading ===

Journeyman-level shepherd villagers have a 20% chance to buy 12 lime dye for an emerald as part of their trades.‌

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lime Dye
|spritetype=item
|nameid=lime_dye
|aliasid=dye / 10
|id=405
|form=item
|translationkey=item.dye.lime.name
|foot=1}}

== Video ==

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

== History ==

{{History|java beta}}
{{History||1.2|[[File:Lime Dye JE1 BE1.png|32px]] Added lime dye.}}
{{History|java}}
{{History||1.4.2|snap=12w34a|Added the ability to [[Armor#Dyeing|dye]] leather [[armor]] and [[wolf]] collars.}}
{{History||1.4.6|snap=12w49a|Lime dye can now be [[crafting|crafted]] with [[gunpowder]] to create a [[firework star]].}} 
{{History||1.6.1|snap=13w19a|[[Stained clay]] can now be crafted.}}
{{history||1.7.2|snap=13w41a|[[Stained glass]] can now be crafted.}}
{{History||1.8|snap=14w30a|Added [[banner]]s, which can be dyed.}}
{{History||1.11|snap=16w39a|Added the ability to dye [[shulker box]]es.}}
{{History||1.12|snap=17w15a|Added the ability to dye [[bed]]s.}}
{{History||1.13|snap=17w47a|The different data values for the <code>dye</code> ID have now been split up into their own IDs.
|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 351.}}
{{History|||snap=18w14b|Lime dye can now be smelted from [[sea pickle]]s.}}
{{History||1.14|snap=18w43a|Lime dye is now crafted using [[white dye]], instead of [[bone meal]].
|[[File:Lime_Dye_JE2_BE2.png|32px]] The texture of lime dye has now been changed.}}
{{History|||snap=18w44a|Lime dye can now change the text color on [[sign]]s to lime.}}
{{History|||snap=19w05a|Added the [[wandering trader]], which sells lime dye.}}
{{History|||snap=19w11a|Lime dye can now be [[trading|bought]] by shepherd villagers.}}
{{History||1.17|snap=20w45a|Lime dye can now be used to craft [[lime candle]]s.}}
{{History|||snap=21w19a|Lime dye can no longer be used to craft lime candles.}}
{{History|||snap=Pre-release 1|Lime dye can now once again be used to craft lime candles.}}
{{History||1.20<br>(Experimental)|link=1.19.3|snap=22w42a|Lime dye can now change the text color on [[hanging sign]]s to lime.}}

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

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

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

== Issues ==

{{issue list}}

== References ==
{{Reflist}}

{{Items}}

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

[[cs:Světle zelené barvivo]]
[[de:Hellgrüner Farbstoff]]
[[es:Tinte verde lima]]
[[fr:Teinture vert clair]]
[[hu:Neonzöld festék]]
[[ja:黄緑色の染料]]
[[ko:연두색 염료]]
[[nl:Lichtgroene kleurstof]]
[[pl:Jasnozielony barwnik]]
[[pt:Corante verde-limão]]
[[ru:Лаймовый краситель]]
[[zh:黄绿色染料]]</li></ul>
20w27aAdded the mushroom_grow_block block tag.
20w28aAdded the base_stone_nether, and base_stone_overworld block tags.
Added the stone_crafting_materials item tag.
Removed the furnace_materials item tag.
20w30aAdded the replace function tag property.
1.17
{{Extension DPL}}<ul><li>[[Pottery Sherd|Pottery Sherd]]<br/>{{Item
| image=Angler Pottery Sherd.png
| extratext = View [[#Items|all items]]
| renewable = No
| stackable = Yes (64)
}}
<!-- IT IS SHERD, NOT SHARD! DO NOT CHANGE TO SHARD, AS IT IS NAMED SHERD IN-GAME! -->
'''Pottery sherds'''<ref group="note">The word "[[wiktionary:sherd#English|sherd]]" or "[[wiktionary:potsherd#English|potsherd]]" is used by archaeologists to refer to fragments of pottery or other ceramics in order to differentiate them from "shards" of glass, metal, minerals and other materials.
</ref> are a set of twenty [[item]]s used to craft [[decorated pot]]s with ornamental designs. They can be obtained only by [[brush]]ing [[suspicious block]]s, with the variants of sherd obtainable being dependent on the structure.

== Obtaining ==

=== Breaking ===
When a [[decorated pot]] is broken with a [[pickaxe]], [[axe]], [[shovel]], [[hoe]] or [[sword]] that is ''not'' enchanted with [[Silk Touch]], it drops all of the pottery sherds and [[brick]]s used to craft it.

=== Suspicious block loot ===
Pottery sherds can be found as [[suspicious block]] loot in [[trail ruins]], [[ocean ruins]], [[desert pyramids]] and [[desert well]]s, and can be extracted from these blocks using a [[brush]].

{{#invoke:LootChest|base3|angler-pottery-sherd,archer-pottery-sherd,arms-up-pottery-sherd,blade-pottery-sherd,brewer-pottery-sherd,burn-pottery-sherd,danger-pottery-sherd,explorer-pottery-sherd,friend-pottery-sherd,heart-pottery-sherd,heartbreak-pottery-sherd,howl-pottery-sherd,miner-pottery-sherd,mourner-pottery-sherd,plenty-pottery-sherd,prize-pottery-sherd,sheaf-pottery-sherd,shelter-pottery-sherd,skull-pottery-sherd,snort-pottery-sherd}}

== Usage ==
=== Crafting ingredient ===
{{Crafting
|ingredients=Any Pottery Sherd or [[Brick]]
|B1= Any Pottery Sherd
|A2= Any Pottery Sherd |C2= Any Pottery Sherd
|B3= Any Pottery Sherd
|Output= Decorated Pot
|type= Decoration block
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Angler Pottery Sherd
|spritetype=item
|nameid=angler_pottery_sherd
|form=item}}
{{ID table
|displayname=Archer Pottery Sherd
|spritetype=item
|nameid=archer_pottery_sherd
|form=item}}
{{ID table
|displayname=Arms Up Pottery Sherd
|spritetype=item
|nameid=arms_up_pottery_sherd
|form=item}}
{{ID table
|displayname=Blade Pottery Sherd
|spritetype=item
|nameid=blade_pottery_sherd
|form=item}}
{{ID table
|displayname=Brewer Pottery Sherd
|spritetype=item
|nameid=brewer_pottery_sherd
|form=item}}
{{ID table
|displayname=Burn Pottery Sherd
|spritetype=item
|nameid=burn_pottery_sherd
|form=item}}
{{ID table
|displayname=Danger Pottery Sherd
|spritetype=item
|nameid=danger_pottery_sherd
|form=item}}
{{ID table
|displayname=Explorer Pottery Sherd
|spritetype=item
|nameid=explorer_pottery_sherd
|form=item}}
{{ID table
|displayname=Friend Pottery Sherd
|spritetype=item
|nameid=friend_pottery_sherd
|form=item}}
{{ID table
|displayname=Heart Pottery Sherd
|spritetype=item
|nameid=heart_pottery_sherd
|form=item}}
{{ID table
|displayname=Heartbreak Pottery Sherd
|spritetype=item
|nameid=heartbreak_pottery_sherd
|form=item}}
{{ID table
|displayname=Howl Pottery Sherd
|spritetype=item
|nameid=howl_pottery_sherd
|form=item}}
{{ID table
|displayname=Miner Pottery Sherd
|spritetype=item
|nameid=miner_pottery_sherd
|form=item}}
{{ID table
|displayname=Mourner Pottery Sherd
|spritetype=item
|nameid=mourner_pottery_sherd
|form=item}}
{{ID table
|displayname=Plenty Pottery Sherd
|spritetype=item
|nameid=plenty_pottery_sherd
|form=item}}
{{ID table
|displayname=Prize Pottery Sherd
|spritetype=item
|nameid=prize_pottery_sherd
|form=item}}
{{ID table
|displayname=Sheaf Pottery Sherd
|spritetype=item
|nameid=sheaf_pottery_sherd
|form=item}}
{{ID table
|displayname=Shelter Pottery Sherd
|spritetype=item
|nameid=shelter_pottery_sherd
|form=item}}
{{ID table
|displayname=Skull Pottery Sherd
|spritetype=item
|nameid=skull_pottery_sherd
|form=item}}
{{ID table
|displayname=Snort Pottery Sherd
|spritetype=item
|nameid=snort_pottery_sherd
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Angler Pottery Sherd
|spritetype=item
|nameid=angler_pottery_sherd
|id=664
|form=item}}
{{ID table
|displayname=Archer Pottery Sherd
|spritetype=item
|nameid=archer_pottery_sherd
|id=665
|form=item}}
{{ID table
|displayname=Arms Up Pottery Sherd
|spritetype=item
|nameid=arms_up_pottery_sherd
|id=666
|form=item}}
{{ID table
|displayname=Blade Pottery Sherd
|spritetype=item
|nameid=blade_pottery_sherd
|id=667
|form=item}}
{{ID table
|displayname=Brewer Pottery Sherd
|spritetype=item
|nameid=brewer_pottery_sherd
|id=668
|form=item}}
{{ID table
|displayname=Burn Pottery Sherd
|spritetype=item
|nameid=burn_pottery_sherd
|id=669
|form=item}}
{{ID table
|displayname=Danger Pottery Sherd
|spritetype=item
|nameid=danger_pottery_sherd
|id=670
|form=item}}
{{ID table
|displayname=Explorer Pottery Sherd
|spritetype=item
|nameid=explorer_pottery_sherd
|id=671
|form=item}}
{{ID table
|displayname=Friend Pottery Sherd
|spritetype=item
|nameid=friend_pottery_sherd
|id=672
|form=item}}
{{ID table
|displayname=Heart Pottery Sherd
|spritetype=item
|nameid=heart_pottery_sherd
|id=673
|form=item}}
{{ID table
|displayname=Heartbreak Pottery Sherd
|spritetype=item
|nameid=heartbreak_pottery_sherd
|id=674
|form=item}}
{{ID table
|displayname=Howl Pottery Sherd
|spritetype=item
|nameid=howl_pottery_sherd
|id=675
|form=item}}
{{ID table
|displayname=Miner Pottery Sherd
|spritetype=item
|nameid=miner_pottery_sherd
|id=676
|form=item}}
{{ID table
|displayname=Mourner Pottery Sherd
|spritetype=item
|nameid=mourner_pottery_sherd
|id=677
|form=item}}
{{ID table
|displayname=Plenty Pottery Sherd
|spritetype=item
|nameid=plenty_pottery_sherd
|id=678
|form=item}}
{{ID table
|displayname=Prize Pottery Sherd
|spritetype=item
|nameid=prize_pottery_sherd
|id=679
|form=item}}
{{ID table
|displayname=Sheaf Pottery Sherd
|spritetype=item
|nameid=sheaf_pottery_sherd
|id=680
|form=item}}
{{ID table
|displayname=Shelter Pottery Sherd
|spritetype=item
|nameid=shelter_pottery_sherd
|id=681
|form=item}}
{{ID table
|displayname=Skull Pottery Sherd
|spritetype=item
|nameid=skull_pottery_sherd
|id=682
|form=item}}
{{ID table
|displayname=Snort Pottery Sherd
|spritetype=item
|nameid=snort_pottery_sherd
|id=683
|form=item
|foot=1}}

== Achievements ==
{{Load achievements|Careful restoration}}

== Advancements ==
{{Load advancements|Respecting the Remnants;Careful Restoration}}

== History ==
{{History||October 3, 2020|[[File:Blue Ceramic Shard.png|32px]][[File:Orange Ceramic Shard.png|32px]][[File:Ceramic Shard 1.png|32px]][[File:Ceramic Shard 2.png|32px]][[File:Ceramic Shard 3.png|32px]][[File:Ceramic Shard 4.png|32px]] Ceramic shards were announced at [[Minecraft Live 2020]].|link=https://youtu.be/DBvZ2Iqmm3M?t=2216}}
{{History||February 10, 2023|[[Sofia Dankis]] posted an article about upcoming archaeology features, including pottery shards.|link=https://www.minecraft.net/en-us/article/archeology-coming-minecraft-120}}
{{History|java}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w07a|[[File:Archer Pottery Sherd JE1.png|32px]] [[File:Arms Up Pottery Sherd JE1 BE2.png|32px]] [[File:Prize Pottery Sherd JE1 BE2.png|32px]] [[File:Skull Pottery Sherd JE1 BE2.png|32px]] Added pottery shards behind the [[Java Edition 1.20|Update 1.20 experimental datapack]].}}
{{History|||snap=1.19.4 Pre-release 3|[[File:Archer Pottery Sherd JE2 BE2.png|32px]] Changed the texture of archer pottery shard.}}
{{History||1.20|snap=23w12a|Pottery shards are now out of the 1.20 experimental data pack.|[[File:Angler Pottery Sherd JE1 BE1.png|32px]] [[File:Blade Pottery Sherd JE1 BE1.png|32px]] [[File:Brewer Pottery Sherd JE1 BE1.png|32px]] [[File:Burn Pottery Sherd JE1 BE1.png|32px]] [[File:Danger Pottery Sherd JE1 BE1.png|32px]] [[File:Explorer Pottery Sherd JE1 BE1.png|32px]] [[File:Friend Pottery Sherd JE1 BE1.png|32px]] [[File:Heart Pottery Sherd JE1 BE1.png|32px]] [[File:Heartbreak Pottery Sherd JE1 BE1.png|32px]] [[File:Howl Pottery Sherd JE1 BE1.png|32px]] [[File:Miner Pottery Sherd JE1 BE1.png|32px]] [[File:Mourner Pottery Sherd JE1 BE1.png|32px]] [[File:Plenty Pottery Sherd JE1 BE1.png|32px]] [[File:Sheaf Pottery Sherd JE1 BE1.png|32px]] [[File:Shelter Pottery Sherd JE1 BE1.png|32px]] [[File:Snort Pottery Sherd JE1 BE1.png|32px]] Added another sixteen pottery shards.
|The probability for the archer, prize, and skull pottery shards to generate in the [[suspicious sand]] in [[desert temple]] and in [[desert well]] has been changed from 1/7 to 1/8, for the arms up pottery sherd to generate in the suspicious sand in [[desert well]] has been changed from 3/7 to 1/4.}}
{{History|||snap=23w16a|Renamed "Pottery Shard" to "Pottery Sherd".|Burn, danger, friend, heart, heartbreak, howl and sheaf pottery sherds 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]]; burn, danger, friend, heart, heartbreak, howl and sheaf pottery sherds now are in the rare loot.}}
{{History|||snap=23w17a|The probability of the burn, danger, friend, heart, heartbreak, howl, and sheaf pottery sherds to generate in [[suspicious gravel]] in [[trail ruins]] has been changed from 1/11 to 1/12.{{verify}}|The player now gets the [[advancement]] "Respecting the remnants" when they brush a [[suspicious sand]] or a [[suspicious gravel]] to obtain a pottery sherd, "Careful restoration" when they craft a decorated pot using 4 pottery sherds.}}

{{History|bedrock}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.19.70|snap=beta 1.19.70.23|[[File:Archer Pottery Sherd BE1.png|32px]] [[File:Arms Up Pottery Sherd BE1.png|32px]] [[File:Prize Pottery Sherd BE1.png|32px]] [[File:Skull Pottery Sherd BE1.png|32px]] Added pottery shards behind the "[[Bedrock Edition 1.20.0|Next Major Update]]" [[experimental]] toggle.}}
{{History|||snap=beta 1.19.80.20|[[File:Archer Pottery Sherd JE2 BE2.png|32px]] Changed the texture of archer pottery shard.}}
{{h|||snap=beta 1.19.80.22|[[File:Angler Pottery Sherd JE1 BE1.png|32px]] [[File:Blade Pottery Sherd JE1 BE1.png|32px]] [[File:Brewer Pottery Sherd JE1 BE1.png|32px]] [[File:Burn Pottery Sherd JE1 BE1.png|32px]] [[File:Danger Pottery Sherd JE1 BE1.png|32px]] [[File:Explorer Pottery Sherd JE1 BE1.png|32px]] [[File:Friend Pottery Sherd JE1 BE1.png|32px]] [[File:Heart Pottery Sherd JE1 BE1.png|32px]] [[File:Heartbreak Pottery Sherd JE1 BE1.png|32px]] [[File:Howl Pottery Sherd JE1 BE1.png|32px]] [[File:Miner Pottery Sherd JE1 BE1.png|32px]] [[File:Mourner Pottery Sherd JE1 BE1.png|32px]] [[File:Plenty Pottery Sherd JE1 BE1.png|32px]] [[File:Sheaf Pottery Sherd JE1 BE1.png|32px]] [[File:Shelter Pottery Sherd JE1 BE1.png|32px]] [[File:Snort Pottery Sherd JE1 BE1.png|32px]] Added another sixteen pottery shards.
|[[File:Arms Up Pottery Sherd JE1 BE2.png|32px]] [[File:Prize Pottery Sherd JE1 BE2.png|32px]] [[File:Skull Pottery Sherd JE1 BE2.png|32px]] Changed the texture of arms up, prize and skull pottery shards.<ref>{{bug|MCPE-167202}}</ref>}}
{{History||Next Major Update<br>(Experimental)|link=Bedrock Edition 1.20.0|snap=beta 1.20.0.20|Miner pottery shard can generate in desert pyramids.}}
{{History||1.20.0|snap=beta 1.20.0.21|Pottery shards are now available without using the "Next Major Update" experimental toggle.}}
{{History|||snap=beta 1.20.0.22|Renamed "Pottery Shard" to "Pottery Sherd".}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
* Many pottery sherds are based on another in-game mob or item:
** The angler pottery sherd depicts a [[fishing rod]].
** The archer pottery sherd depicts a [[bow]] and [[arrow]].
** The blade pottery sherd depicts a [[sword]].
** The brewer pottery sherd depicts a [[potion]].
** The burn pottery sherd depicts [[fire]].
** The danger pottery sherd depicts a [[creeper]].
** The explorer pottery sherd depicts a [[map]].
** The friend pottery sherd depicts the unibrow and nose of a [[villager]] or [[iron golem]].
** The howl pottery sherd depicts a [[wolf]].
** The miner pottery sherd depicts a [[pickaxe]].
** The mourner pottery sherd depicts an early design for the [[warden]].
** The plenty pottery sherd depicts a [[chest]].
** The sheaf pottery sherd depicts [[wheat]].
** The skull pottery sherd depicts a [[skeleton]].
** The snort pottery sherd depicts a [[sniffer]].
**The prize pottery sherd depicts a diamond cut [[diamond]]
***It could depict a [[MCE:Ruby|ruby]] from ''Minecraft Earth'', as well.
**The arms up pottery sherd depicts a [[character]] with their arms up.
**The heart and heartbreak pottery sherds depict a [[Health|heart]] and broken heart respectively.
**The shelter pottery sherd depicts a [[tree]].

==Gallery==
=== Items ===
<gallery>
Angler Pottery Sherd.png|Angler Pottery Sherd
Archer Pottery Sherd.png|Archer Pottery Sherd
Arms Up Pottery Sherd.png|Arms Up Pottery Sherd
Blade Pottery Sherd.png|Blade Pottery Sherd
Brewer Pottery Sherd.png|Brewer Pottery Sherd
Burn Pottery Sherd.png|Burn Pottery Sherd
Danger Pottery Sherd.png|Danger Pottery Sherd
Explorer Pottery Sherd.png|Explorer Pottery Sherd
Friend Pottery Sherd.png|Friend Pottery Sherd
Heart Pottery Sherd.png|Heart Pottery Sherd
Heartbreak Pottery Sherd.png|Heartbreak Pottery Sherd
Howl Pottery Sherd.png|Howl Pottery Sherd
Miner Pottery Sherd.png|Miner Pottery Sherd
Mourner Pottery Sherd.png|Mourner Pottery Sherd
Plenty Pottery Sherd.png|Plenty Pottery Sherd
Prize Pottery Sherd.png|Prize Pottery Sherd
Sheaf Pottery Sherd.png|Sheaf Pottery Sherd
Shelter Pottery Sherd.png|Shelter Pottery Sherd
Skull Pottery Sherd.png|Skull Pottery Sherd
Snort Pottery Sherd.png|Snort Pottery Sherd
</gallery>

=== Development images ===
<gallery>
JE 1.17 Development Archeology.jpg|Blue ceramic shard.
JE 1.17 Development Archeology 2.jpg|Ceramic shards.
</gallery>

=== Official artwork ===
<gallery>
Pottery Sherd Pixel Art.png|Pixel artwork of [[Ari]] holding a skull pottery sherd.
File:T&T Thumbnail.jpg|Ari holding up a different sherd.
</gallery>

== References ==
<references />

== Notes ==
<references group="note"/>

{{Items}}

[[Category:Non-renewable resources]]

[[de:Töpferscherbe]]
[[es:Fragmento de cerámica]]
[[fr:Tesson de poterie]]
[[ja:壺の欠片]]
[[pt:Óstraco]]
[[zh:陶片]]</li><li>[[Crossbow|Crossbow]]<br/>{{For}}
{{Item
| title = Crossbow
| image = <gallery>
Crossbow.png | Crossbow
Crossbow Pull 0.png | Pull (state 0)
Crossbow Pull 1.png | Pull (state 1)
Crossbow Pull 2.png | Pull (state 2)
Arrow Loaded Crossbow.png | Arrow loaded
Firework Loaded Crossbow.png | Firework loaded
</gallery>
| rarity = Common
| renewable = Yes
| durability = 465{{only|JE|short=yes}}<br>464{{only|BE|short=1}}
| stackable = No
}}

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

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

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

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

=== Mob loot ===

==== Pillagers ====

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

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

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

=== Chest loot ===

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

=== Trading ===

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

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

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

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

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

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

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

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

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

In order to use the crossbow, at least one arrow or firework rocket must be present in the inventory. The player can choose the type of arrow to fire based on its location in their [[inventory]]:
* Arrows in the off-hand, or the selected [[hotbar]] slot if the crossbow is in the off-hand, are prioritized first. 
* If there are no arrows in the off-hand or selected hotbar slot, the arrow closest to slot 0 is selected. 
Crossbows take 1.25 seconds (25 ticks) to load. 

The player can load either an arrow, spectral arrow, tipped arrow (of any effect) or a firework (of any color/type).

[[Endermen]] teleport away from projectile paths, so they cannot be hit with crossbow [[arrow]]s. However, they can still get harmed by [[firework rocket]] explosions, if they can't detect the firework rocket.

;Attack strength

''Java Edition'':

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

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

=== Fireworks ===

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

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

=== Repair ===

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

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

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

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

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

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

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

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

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

===Item data===

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

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

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

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

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

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

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

==Issues==
{{issue list}}

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

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

== References ==
{{reflist}}

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

{{Items}}

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

[[de:Armbrust]]
[[es:Ballesta]]
[[fr:Arbalète]]
[[it:Balestra]]
[[ja:クロスボウ]]
[[ko:쇠뇌]]
[[pl:Kusza]]
[[pt:Besta]]
[[ru:Арбалет]]
[[th:หน้าไม้]]
[[zh:弩]]</li></ul>
20w45aAdded the candle_cakes, candles, cauldrons, and crystal_sound_blocks block tags.
Added the candles, ignored_by_piglin_babies, and piglin_food item tags.
20w46aAdded the snow_step_sound_blocks block tag.
Added the powder_snow_walkable_mobs entity type tag.
Added powder snow cauldrons to the cauldrons block tag.
20w48aAdded the freeze_immune_wearables item tag.
The snow_step_sound_blocks block tag has been renamed to inside_step_sound_block.
20w49aAdded the dripstone_replaceable_blocks, and occludes_vibration_signals block tags.
Added the new game events tag type.
Added the ignore_vibrations_stepping_carefully, and vibrations game event tags.
20w51aAdded the axolotl_tempt_items, and occludes_vibration_signals item tags.
Added the axolotl_always_hostiles, and axolotl_tempt_hostiles entity type tags.
Removed the eating_start game event from the vibrations game event tag.
21w03aAdded glow squids to the axolotl_always_hostiles entity type tag.
21w05aAdded the azalea_log_replaceable, cave_vines, and lush_plants_replaceable block tags.
Added the fox_food item tag.
Added azalea leaves and azalea leaves flowers to the leaves block and item tags.
Added foxes to the powder_snow_walkable_mobs entity type tag.
Changed the ignore_vibrations_stepping_carefully game event tag to ignore_vibrations_sneaking, and added the swim event.
Changed the vibrations game event tag to reflect the current list of game events.
21w07aAdded grimstone to the base_stone_overworld block tag and the stone_crafting_materials, and stone_tool_materials item tags.
Added various grimstone variants to the slabs, stairs, and walls block and item tags.
21w08aAdded deepslate_ore_replaceables, and stone_ore_replaceables block tags.
Added diamond_ores, iron_ores, lapis_ores, and redstone_ores block and item tags.
Added tuff to the base_stone_overworld block tag.
Added deepslate gold ore to the gold_ores block and item tags.
21w10aAdded coal_ores, copper_ores, and emerald_ores block and item tags.
Added the lush_ground_replaceable block tag.
Removed moss block, the #flowers block tag, grass, tall grass, moss carpet, small dripleaf, big dripleaf, big dripleaf stem, and vines from the lush_plants_replaceable block tag.
Removed the azalea_log_replaceable block tag.
21w11aAdded the cluster_max_harvestables item tag.
Added both cave vine blocks to the climbable block tag.
Added tuff to the deepslate_ore_replaceables block tag, and removed it from the stone_ore_replaceables block tag.
Added tinted glass to the impermeable block tag.
21w13aAdded the dirt, and snow block tags.
Added the axolotl_hunt_targets, freeze_hurts_extra_types, and freeze_immune_entity_types entity tags.
Changed the bamboo_plantable_on, and enderman_holdable block tags to use the dirt block tag.
Added copper slab and stair variants to the slabs, and stairs block and item tags, respectively.
Added flowering azaleas and flowering azalea leaves to the small_flowers block and item tags.
Removed the axolotl_tempted_hostiles entity tag, moving its contents to the axolotl_always_hostiles entity tag.
Added leather horse armor to the freeze_immune_wearables item tag.
21w14aAdded waxed oxidized cut copper stairs and slabs to the stairs, and slabs block and item tags, respectively.
Added raw gold to the piglin_loved item tag.
21w16aAdded the moss_replaceable block tag.
Removed the lush_plants_replaceable block tag.
Tweaked the lush_ground_replaceable block tag to call the moss_replaceable tag instead of the lush_plants_replaceable tag, as well as adding gravel and sand.
Added grass blocks, mycelium, and moss blocks to the dirt block tag.
Tweaked some tags to no longer unnecessarily mention blocks if they're in the dirt block tag.
21w17aAdded the small_dripleaf_placeable block tag.
Added the wither to the freeze_immune_entity_types entity type tag.
21w19aAdded the mineable/axe, mineable/hoe, mineable/pickaxe, mineable/shovel, needs_diamond_tool, needs_iron_tool, and needs_stone_tool block tags.
Added cave vines to the bee_growables block tag.
Removed moss blocks from the lush_ground_replaceables block tag.
Added azaleas and flowering azaleas to the saplings block and item tags.
21w20aAdded the features_cannot_replace block tag.
Added the cave_vines_plant block to the bee_growables block tag.
Removed the tropical fish item from the axolotl_tempt_items item tag.
1.17 Pre-release 1Added the geode_invalid_blocks, and lava_pool_stone_replaceable block tags.
Added flowering azaleas and flowering azalea leaves to the flowers block and item tags.
Removed flowering azaleas and flowering azalea leaves from the small_flowers block and item tags.
Added potted azaleas and potted flowering azaleas to the flower_pots block tag.
Added non-waxed oxidized copper variants to the needs_stone_tool block tag.
Removed moss carpet from the mineable/axe block tag.
Upcoming Java Edition
1.18
{{Extension DPL}}<ul><li>[[Axe|Axe]]<br/>{{For}}
{{Item
| image = <gallery>
Wooden Axe.png | Wooden
Stone Axe.png | Stone
Iron Axe.png | Iron
Golden Axe.png | Golden
Diamond Axe.png | Diamond
Netherite Axe.png | Netherite
</gallery>
| rarity = Common
| renewable = 
* '''Netherite''': No 
* '''Others''': Yes
| durability = 
'''Bedrock Edition'''
* Golden: 33
* Wooden: 60 
* Stone: 132
* Iron: 251
* Diamond: 1562
* Netherite: 2032
'''Java Edition'''
* Golden: 32
* Wooden: 59
* Stone: 131
* Iron: 250
* Diamond: 1561
* Netherite: 2031
| stackable = No
}}

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

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

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

===Repairing===

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

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

===Mob loot===

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

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

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

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

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

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

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

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

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

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

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

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

==Usage==

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

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

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

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

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

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

====Java Edition====

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

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

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

{{notelist}}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

==Issues==
{{issue list}}

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

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

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

==References==
{{Reflist}}

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

{{items}}

[[Category:Combat]]

[[cs:Sekera]]
[[de:Axt]]
[[es:Hacha]]
[[fr:Hache]]
[[hu:Balta]]
[[ja:斧]]
[[ko:도끼]]
[[nl:Bijl]]
[[pl:Siekiera]]
[[pt:Machado]]
[[ru:Топор]]
[[th:ขวาน]]
[[uk:Сокира]]
[[zh:斧]]</li><li>[[Magenta Dye|Magenta Dye]]<br/>{{Item
| image = Magenta Dye.png
| renewable = Yes
| stackable = Yes (64)
}}
'''Magenta dye''' is a [[Dye#Quasi-Primary|quasi-primary color dye]].

== Obtaining ==

=== Crafting ===

{{Crafting
  |head=1
  |showdescription=1
  |showname=0
  |Allium
  |Output=Magenta Dye
  |type=Material
}}
{{Crafting
  |Lilac
  |Output=Magenta Dye,2
  |type=Material
}}
{{Crafting
  |Purple Dye
  |Pink Dye
  |Output=Magenta Dye,2
  |type=Material
}}
{{Crafting
  |Blue Dye
  |Red Dye
  |Pink Dye
  |Output=Magenta Dye,3
  |type=Material
}}
{{Crafting
  |Lapis Lazuli
  |Red Dye
  |Pink Dye
  |Output=Magenta Dye,3
  |type=Material
  |description={{only|bedrock|education}}
}}
{{Crafting
  |Blue Dye
  |Red Dye
  |Red Dye
  |White Dye
  |Output=Magenta Dye,4
  |type=Material
}}
{{Crafting
  |Lapis Lazuli;Lapis Lazuli;Blue Dye
  |Red Dye;Red Dye;Red Dye
  |Red Dye;Red Dye;Red Dye
  |Bone Meal;White Dye;Bone Meal
  |Output=Magenta Dye,4
  |type=Material
  |description={{only|bedrock|education}}
  |foot=1
}}

=== Trading ===

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

== Usage ==

{{dye usage}}

=== Crafting ingredient ===

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

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|showaliasids=y
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Magenta Dye
|spritetype=item
|nameid=magenta_dye
|aliasid=dye / 13
|id=408
|form=item
|translationkey=item.dye.magenta.name
|foot=1}}

== Video ==
{{yt|IkaIFDQJNUU}}

== History ==

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

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

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

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

== Issues ==
{{issue list}}

== References ==
{{reflist}}

{{Items}}

[[Category:Dyes]]

[[cs:Purpurové barvivo]]
[[de:Magenta Farbstoff]]
[[es:Tinte magenta]]
[[fr:Teinture magenta]]
[[hu:Bíborvörös festék]]
[[ja:赤紫色の染料]]
[[ko:자홍색 염료]]
[[nl:Magenta kleurstof]]
[[pl:Karmazynowy barwnik]]
[[pt:Corante magenta]]
[[ru:Сиреневый краситель]]
[[zh:品红色染料]]
[[Category:Renewable resources]]</li></ul>
21w37aRenamed the lava_pool_stone_replaceables block tag to lava_pool_stone_cannot_replace.
21w43aAdded big_dripleaf_placeable block tag.
21w44aAdded the animals_spawnable_on, axolotls_spawnable_on, foxes_spawnable_on, goats_spawnable_on, mooshrooms_spawnable_on, parrots_spawnable_on, polar_bears_spawnable_on_in_frozen_ocean, rabbits_spawnable_on, and wolves_spawnable_on block tags.
1.18 Pre-release 1Added conduit to the mineable/pickaxe block tag.
1.18 Pre-release 5Added the azalea_grows_on, azalea_root_replaceable, replaceable_plants, and terracotta block tags.
Removed the #flowers block tag from the mineable/axe block tag.
Added the dirt and terracotta item tags.

Issues

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

Advertisement