Minecraft Wiki
Advertisement
This article is about the definition of the block states. For the files that determine block models, see Models § Block states.

Block states are extra pieces of data that further define a block.

List of block states

Anvils

anvil
chipped_anvil
damaged_anvil

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
An anvil pointing north or south is aligned with its long dimension pointing north–south.
An anvil pointing east or west is aligned with its long dimension pointing east–west.
This value is 90° clockwise from the direction a player faces while placing an anvil.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
damage0x4
0x8
undamaged broken3 Broken Anvil (inaccessible, uses anvil base texture)
slightly_damaged1 Slightly Damaged Anvil.
undamaged0 Anvil.
very_damaged2 Very Damaged Anvil.
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the anvil is facing.
  • 0: facing West
  • 1: facing North
  • 2: facing East
  • 3: facing South
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedAn anvil pointing north or south is aligned with its long dimension pointing north–south.
An anvil pointing east or west is aligned with its long dimension pointing east–west.
This value is 90° clockwise from the direction a player faces while placing an anvil.

Bamboo

Java Edition:
Bamboo

Name Default value Allowed values Description
age00
1
The age of the bamboo, if this is 1 the bamboo appears thicker.
leavesnonelarge
none
small
The size of the leaves on this bamboo block.
stage00
1
The stage is incremented at random intervals.
At stage 1, bamboo may try to grow more bamboo above it.

Bedrock Edition:
Bamboo:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age_bit0x8falsefalse
true
0
1
The stage is incremented at random intervals.
When true, bamboo may try to grow more bamboo above it.
bamboo_leaf_size0x2
0x4
no_leavesno_leaves
small_leaves
large_leaves
0
1
2
The size of the leaves on this bamboo block.
bamboo_stalk_thickness0x1thinthin
thick
0
1
The thickness of the bamboo, if this is thick the bamboo appears thicker.

Bamboo Sapling:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age_bit0x1falsefalse
true
0
1
Specifies the sapling's growth stage.
sapling_typeNot Supportedoakacacia
birch
dark_oak
jungle
oak
spruce
UnsupportedUnused.

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

Java Edition:
Floor

Name Default value Allowed values Description
rotation0 0The block is facing south.
1The block is facing south-southwest.
2The block is facing southwest.
3The block is facing west-southwest.
4The block is facing west.
5The block is facing west-northwest.
6The block is facing northwest.
7The block is facing north-northwest.
8The block is facing north.
9The block is facing north-northeast.
10The block is facing northeast.
11The block is facing east-northeast.
12The block is facing east.
13The block is facing east-southeast.
14The block is facing southeast.
15The block is facing south-southeast.

Wall

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the block is facing. For example, a block facing east is attached to a block to its west.
Opposite from the direction a player faces when placing the block.

Bedrock Edition:

Standing
NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
ground_sign_direction0x1
0x2
0x4
0x8
0 00The block is facing south.
11The block is facing south-southwest.
22The block is facing southwest.
33The block is facing west-southwest.
44The block is facing west.
55The block is facing west-northwest.
66The block is facing northwest.
77The block is facing north-northwest.
88The block is facing north.
99The block is facing north-northeast.
1010The block is facing northeast.
1111The block is facing east-northeast.
1212The block is facing east.
1313The block is facing east-southeast.
1414The block is facing southeast.
1515The block is facing south-southeast.
Wall
NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
02
3
4
5
2
3
4
5
The direction the block is facing. For example, a block facing east is attached to a block to its west.
  • 2: north
  • 3: south
  • 4: west
  • 5: east
0
1
0
1
Unused

Barrel

Java Edition:

Name Default value Allowed values Description
facingnorthdown
east
north
south
up
west
The direction the barrel is facing.
openfalsefalse
true
Whether the barrel is currently being looked at by a player; changes the texture on the top face.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction the barrel is facing.
  • 0:Down facing barrel
  • 1:Up facing barrel
  • 2:East facing barrel
  • 3:West facing barrel
  • 4:South facing barrel
  • 5:North facing barrel
open_bit0x800
1
0
1
Whether the barrel is currently being looked at by a player; changes the texture on the top face.

Beds

white_bed
orange_bed
magenta_bed
light_blue_bed
yellow_bed
lime_bed
pink_bed
gray_bed
light_gray_bed
cyan_bed
purple_bed
blue_bed
brown_bed
green_bed
red_bed
black_bed

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the head of the bed is pointing.
The same direction the player faces when placing the bed.
occupiedfalsefalse
true
True when a player or villager is using the bed.
partfootfoot
head
The half of the bed in the current block.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the head of the bed is pointing.
  • 0:Head facing South
  • 1:Head facing West
  • 2:Head facing North
  • 3:Head facing East
head_piece_bit0x8truefalse
true
0
1
If the current block is the head part.
occupied_bit0x4falsefalse
true
0
1
True when a player or villager is using the bed.


Beetroots

Java Edition:

Name Default value Allowed values Description
age0 0
1
2
3 Fully grown.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 0
1
0
1
2
3
2
3
4
5
6
4
5
6
77 Fully grown.

Bell

Java Edition:

Name Default value Allowed values Description
attachmentfloorceiling
double_wall
floor
single_wall
What the bell is attached to.
facingnortheast
north
south
west
The direction the bell is facing.
Opposite from the direction the player faces when placing a bell.
poweredfalsetrue
false
Whether the bell is attached to a power source, such as a redstone torch.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
attachment0x4
0x8
standingstanding
hanging
side
multiple
0
1
2
3
What the bell is attached to.
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the bell is facing. Opposite from the direction a player faces when placing the block.
  • 0: South facing bell
  • 1: West facing bell
  • 2: North facing bell
  • 3: East facing bell
toggle_bit0x10falsefalse
true
0
1
Each time the bell is rung, this value toggles between true and false.

Blast Furnace

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the blast furnace's opening faces.
The opposite from the direction the player faces while placing the blast furnace.
litfalsefalse
true
If the blast furnace is lit.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Deprecated)
0x1
0x2
0x4
32
3
4
5
2
3
4
5
The direction the blast furnace's opening faces.
  • 2: facing north
  • 3: facing south
  • 4: facing west
  • 5: facing east
0
1
0
1
Unused
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the blast furnace's opening faces.
The opposite from the direction the player faces while placing the blast furnace.

Bone Block

Java Edition:

Name Default value Allowed values Description
axisy xThe bone block is oriented east–west.
yThe bone block is oriented vertically.
zThe bone block is oriented north–south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axis0x4
0x8
yy
x
z
0
1
2
The axis along which the block is oriented
deprecated0x1
0x2
00
1
2
3
0
1
2
3
Unused, has no effect in game.

Brewing Stand

Java Edition:

Name Default value Allowed values Description
has_bottle_0falsefalse
true
True when a bottle is in slot 1.
has_bottle_1falsefalse
true
True when a bottle is in slot 2.
has_bottle_2falsefalse
true
True when a bottle is in slot 3.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
brewing_stand_slot_a_bit0x1falsefalse
true
0
1
True when a bottle is in slot 1.
brewing_stand_slot_b_bit0x2falsefalse
true
0
1
True when a bottle is in slot 2.
brewing_stand_slot_c_bit0x4falsefalse
true
0
1
True when a bottle is in slot 3.

Bubble Column

Java Edition:

Name Default value Allowed values Description
dragtruefalse
true
Determines whether the bubble column is upward or whirlpool.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
drag_down0x1falsefalse
true
0
1
Determines whether the bubble column is upward or whirlpool.

Buttons

stone_button
oak_button
spruce_button
birch_button
jungle_button
acacia_button
dark_oak_button

Java Edition:

Name Default value Allowed values Description
facewallceiling
floor
wall
The face of the block it's placed on.
Floor is on top of a block, ceiling is on the bottom, and wall is on one of its sides.
facingnortheast
north
south
west
The direction it's facing.
Opposite to the direction the player is facing if placed on the side of a block.
poweredfalsefalse
true
If true, the button is currently activated.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
button_pressed_bit0x8falsefalse
true
0
1
If the button is currently activated.
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction it's facing.
  • 0: Button on block bottom facing down
  • 1: Button on block top facing up
  • 2: Button on block side facing north
  • 3: Button on block side facing south
  • 4: Button on block side facing west
  • 5: Button on block side facing east

Cactus

Java Edition

Name Default value Allowed values Description
age00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
A freshly-planted cactus – and a cactus that has just grown cactus above it – each have an age of 0.
The age is incremented at random intervals.
At age 15, a cactus may try to grow more cactus above it.

Bedrock Edition

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
A freshly-planted cactus – and a cactus that has just grown cactus above it – each have an age of 0.
The age is incremented at random intervals.
At age 15, a cactus may try to grow more cactus above it.

Campfire

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the campfire is facing.
The opposite from the direction the player faces while placing the campfire.
littruefalse
true
Whether the campfire is lit.
signal_firefalsefalse
true
Whether the campfire has a hay bale below it.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this campfire.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the campfire is facing.
  • 0: east
  • 1: west
  • 2: south
  • 3: north
extinguished0x4falsefalse
true
0
1
Whether the campfire is put out.
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the campfire is facing.
The opposite from the direction the player faces while placing the campfire.

Cake

Java Edition Cakes:

Name Default value Allowed values Description
bites00
1
2
3
4
5
6
Number of bites taken from the cake.

Candle cakes:

Name Default value Allowed values Description
litfalsefalse
true
Whether the candle on the cake is lit.

Bedrock Edition Cakes:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
bite_counter0x1
0x2
0x4
00
1
2
3
4
5
6
0
1
2
3
4
5
6
Number of bites taken from the cake.

Candle cakes:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
lit0x1falsefalse
true
0
1
Whether the candle on the cake is lit.

Carrots

Java Edition:

Name Default value Allowed values Description
age0 0
1
2
3
4
5
6
7 Fully grown.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 0
1
0
1
2
3
2
3
4
5
6
4
5
6
77 Fully grown.

Carved Pumpkin

Java Edition:
Carved pumpkin:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the pumpkin's carved face is facing.
The opposite from the direction the player faces while placing the pumpkin.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the pumpkin is facing.
  • 0: facing south
  • 1: facing west
  • 2: facing north
  • 3: facing east
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the pumpkin and carved pumpkin are facing.
The opposite from the direction the player faces while placing the pumpkins. Though it doesn't affect the pumpkin at all.


Cauldron

Java Edition:
Water cauldron and powder snow cauldron:

Name Default value Allowed values Description
level00
1
2
3
Fullness of a cauldron, 0 is empty and 3 is full.

Bedrock Edition:
Cauldron and brighting cauldron:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
fill_level0x1
0x2
0x4
00
1
2
3
4
5
6
0
1
2
3
4
5
6
Fullness of a cauldron, 0 is empty and 6 is full.
cauldron_liquid0x8waterwater0The cauldron contains water
lava1The cauldron contains lava
powder_snowUnsupported [sic]The cauldron contains powder snow.

Chests

chest
trapped_chest

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the chest's latch is on.
The opposite from the direction the player faces when placing a chest.
typesingleleft
right
single
The direction the chest has a connection with.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this chest.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Hidden‌[upcoming: BE 1.20.40])
0x1
0x2
0x4
22
3
4
5
2
3
4
5
The direction the chest's latch is on.
  • 2: Chest facing north
  • 3: Chest facing south
  • 4: Chest facing west
  • 5: Chest facing east
0
1
0
1
Unused
minecraft:cardinal_direction‌[upcoming: BE 1.20.40]Not Supportednortheast
north
south
west
UnsupportedThe direction the chest's latch is on.
The opposite from the direction the player faces when placing a chest.

Ender Chest

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the ender chest's latch is on.
The opposite from the direction the player faces when placing an ender chest.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this ender chest.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Hidden‌[upcoming: BE 1.20.40])
0x1
0x2
0x4
22
3
4
5
2
3
4
5
The direction the chest's latch is on.
  • 2: Chest facing north
  • 3: Chest facing south
  • 4: Chest facing west
  • 5: Chest facing east
0
1
0
1
Unused
minecraft:cardinal_direction‌[upcoming: BE 1.20.40]Not Supportednortheast
north
south
west
UnsupportedThe direction the ender chest's latch is on.
The opposite from the direction the player faces when placing an ender chest.

Chorus Flower

Java Edition

Name Default value Allowed values Description
age0 0
1
2
3
4
A freshly planted chorus flower starts at age 0. The age is incremented when a chorus flower turns horizontally and/or generates additional chorus flowers on the same plant.
5 At age 5, the chorus flower does not grow further. A chorus flower can become age 5 at any time.

Bedrock Edition

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0x4
0 0
1
2
3
4
0
1
2
3
4
A freshly planted chorus flower starts at age 0. The age is incremented when a chorus flower turns horizontally and/or generates additional chorus flowers on the same plant.
55 At age 5, the chorus flower does not grow further. A chorus flower can become age 5 at any time.
6
7
8
9
10
11
12
13
14
15
UnsupportedUnused

Chorus Plant

Chorus Plant/BS

Cocoa

Cocoa/BS

Command Blocks

command_block
chain_command_block
repeating_command_block

Java Edition:

Name Default value Allowed values Description
conditionalfalsefalse
true
True if the command block is in conditional mode.
facingnorthdown
east
north
south
up
west
The direction the command block is pointing.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
conditional_bit0x8falsefalse
true
0
1
True if the command block is in conditional mode.
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction the command block is pointing.
  • 0: facing down
  • 1: facing up
  • 2: facing north
  • 3: facing south
  • 4: facing west
  • 5: facing east

Composter

Java Edition:

Name Default value Allowed values Description
level00
1
2
3
4
5
6
7
8
When at level 8, bone meal is able to be collected from the composter.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
composter_fill_level0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
0
1
2
3
4
5
6
7
8
When at level 8, bone meal is able to be collected from the composter.

Conduit

Java Edition:

Name Default value Allowed values Description
waterloggedtruefalse
true
Whether or not there's water in the same place as this conduit.

Daylight Detector

Java Edition:

Name Default value Allowed values Description
invertedfalsefalse
true
If true, the daylight detector is inverted.
power00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The current redstone power level produced by the daylight sensor.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
redstone_signal0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The current redstone power level produced by the daylight sensor.

Dispenser and Dropper

Java Edition:

Name Default value Allowed values Description
facingnorthdown
east
north
south
up
west
The direction in which contents are shot or dropped.
The opposite from the direction the player faces while placing the block.
triggeredfalsefalse
true
True if this block is activated.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
6
7
0
1
2
3
4
5
6
7
The direction in which contents are shot or dropped.
  • 0: facing down
  • 1: facing up
  • 2: facing north
  • 3: facing south
  • 4: facing west
  • 5: facing east
triggered_bit0x8falsefalse
true
0
1
True if this block is activated.

Doors

iron_door
oak_door
spruce_door
birch_door
jungle_door
acacia_door
dark_oak_door

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the door's "inside" is facing.
The direction the player faces while placing the door.
For example, a door facing east occupies the west part of its block when closed.
halflowerlower
upper
Identifies which part of the door the block is.
hingeleftleft
right
Identifies the side the hinge is on (when facing the same direction as the door's inside).
openfalsefalse
true
True if the door is currently open.
poweredfalsefalse
true
True if the door is currently powered by redstone.

Bedrock Edition:
Lower Door Block:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the door's "inside" is facing.
The direction the player faces while placing the door.
For example, a door facing east occupies the west part of its block when closed.
  • 0: Facing east
  • 1: Facing south
  • 2: Facing west
  • 3: Facing north
door_hinge_bit [sic]falsefalse
true
0
0 [sic]
Identifies the side the hinge is on (when facing the same direction as the door's inside). false if hinge is on the left (the default), true if on the right.
Lower door block has the same aux value when it is opened and closed.
open_bit0x4falsefalse
true
0
1
True if the door is currently open.
upper_block_bit0x8falsefalse
true
0
1
Always false for the lower part of a door.

Upper Door Block:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction [sic]00
1
2
3
0
0
0
0 [sic]
The direction the door's "inside" is facing.
The direction the player faces while placing the door.
For example, a door facing east occupies the west part of its block when closed.
  • 0: Facing east
  • 1: Facing south
  • 2: Facing west
  • 3: Facing north
Upper door block has the same aux value no matter what it faces.
door_hinge_bit [sic]falsefalse
true
0
Unsupported
Identifies the side the hinge is on (when facing the same direction as the door's inside). false if hinge is on the left (the default), true if on the right.
Upper door block doesn't support aux value when its hinge is on the right.
open_bit [sic]falsefalse
true
0
0 [sic]
True if the door is currently open.
Lower door block has the same aux value when it is opened and closed.
upper_block_bit0x8falsefalse
true
0
1
Always true for the upper part of a door.

End Portal Frame

Java Edition:

Name Default value Allowed values Description
eyefalsefalse
true
If true, the portal frame block contains an eye of ender.
facingnortheast
north
south
west
The direction of the end portal frame block.
The opposite from the direction the player faces while placing the block.
In order to activate a portal, all 12 blocks must be facing inward;
for example, the northern three blocks must all face south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction that the end portal frame block is facing.
  • 0: South
  • 1: West
  • 2: North
  • 3: East
end_portal_eye_bit0x4falsefalse
true
0
1
If the portal frame block contains an eye of ender.
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction of the end portal frame block.
The opposite from the direction the player faces while placing the block.
In order to activate a portal, all 12 blocks must be facing inward;
for example, the northern three blocks must all face south.

End Rod

Java Edition:

Name Default value Allowed values Description
facingupdown
east
north
south
up
west
The direction to the end rod, from the block it is attached to; also the direction the white end points.
Opposite from the direction the player faces when placing an end rod, and opposite from the wider end.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction to the end rod, from the block it is attached to; also the direction the white end points.
  • 0: Facing down
  • 1: Facing up
  • 2: Facing north
  • 3: Facing south
  • 4: Facing west
  • 5: Facing east

Farmland

Java Edition

Name Default value Allowed values Description
moisture0 0
1
2
3
4
5
6
7
Increasing levels of wetness. The wetness value counts down to 0 while the farmland does not have access to water. The wet texture is used only on level 7. Newly hydrated farmland jumps from 0 to 7.[1]

Bedrock Edition

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
moisturized_amount0x1
0x2
0x4
0 0
1
2
3
4
5
6
7
0
1
2
3
4
5
6
7
Increasing levels of wetness. The wetness value counts down to 0 while the farmland does not have access to water. The wet texture is used only on level 7. Newly hydrated farmland jumps from 0 to 7.

Fences

oak_fence
spruce_fence
birch_fence
jungle_fence
acacia_fence
dark_oak_fence
nether_brick_fence

Java Edition:

Name Default value Allowed values Description
eastfalsefalse
true
When true, the fence extends from the center post to the east.
northfalsefalse
true
When true, the fence extends from the center post to the north.
southfalsefalse
true
When true, the fence extends from the center post to the south.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this fence.
westfalsefalse
true
When true, the fence extends from the center post to the west.

Bedrock Edition:
Wooden fence (oak, spruce, birch, jungle, acacia, and dark oak):

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
wood_type
(Deprecated)
0x1
0x2
0x4
oakoak
spruce
birch
jungle
acacia
dark_oak
0
1
2
3
4
5
The type of wood this fence is made of.

Fence Gates

oak_fence_gate
spruce_fence_gate
birch_fence_gate
jungle_fence_gate
acacia_fence_gate
dark_oak_fence_gate

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
For an open gate, the direction the gates swing open.
For a closed gate, the direction the player was facing when the gate was placed, or the last direction the gates have swung.
in_wallfalsefalse
true
If true, the gate is lowered by three pixels, to accommodate attaching more cleanly with walls.
openfalsefalse
true
If true, the gate is opened.
poweredfalsefalse
true
If true, the gate is receiving redstone power.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the gate is facing
  • 0: Facing south
  • 1: Facing west
  • 2: Facing north
  • 3: Facing east
For an open gate, it's the direction the gates swing open.
For a closed gate, it's the direction the player was facing when the gate was placed, or the last direction the gates have swung.
in_wall_bit0x8falsefalse
true
0
1
If the gate is lowered by three pixels, to accommodate attaching more cleanly with walls.
open_bit0x4falsefalse
true
0
1
If the gate is opened.

Fire

Java Edition:
Fire:

Name Default value Allowed values Description
age00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Newly placed fire has an age of 0, and has a 13 chance of incrementing with each block tick.
This factor affects how the fire extinguishes.
eastfalsefalse
true
When true, fire texture shows on that face of the block to the east; false if there's a block below this fire.
northfalsefalse
true
When true, fire texture shows on that face of the block to the north; false if there's a block below this fire.
southfalsefalse
true
When true, fire texture shows on that face of the block to the south; false if there's a block below this fire.
upfalsefalse
true
When true, fire texture shows on that face of the block above; false if there's a block below this fire.
westfalsefalse
true
When true, fire texture shows on that face of the block to the west; false if there's a block below this fire.

Bedrock Edition:
Fire and Soul Fire:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Newly placed fire has an age of 0.
This factor affects how the fire extinguishes.

Frosted Ice

Java Edition

Name Default value Allowed values Description
age0 0Freshly generated ice.
1
2
3
Ice with spreading cracks.

Bedrock Edition

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0 00Freshly generated ice.
1
2
3
1
2
3
Ice with spreading cracks.
4
5
6
7
8
9
10
11
12
13
14
15
UnsupportedUnused

Furnace

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the furnace's opening faces.
The opposite from the direction the player faces while placing the furnace.
litfalsefalse
true
If the furnace is lit.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Deprecated)
0x1
0x2
0x4
32
3
4
5
2
3
4
5
The direction the furnace's opening faces.
  • 2: facing north
  • 3: facing south
  • 4: facing west
  • 5: facing east
0
1
0
1
Unused
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the furnace's opening faces.
The opposite from the direction the player faces while placing the furnace.

Glass Panes

glass_pane
white_stained_glass_pane
orange_stained_glass_pane
magenta_stained_glass_pane
light_blue_stained_glass_pane
yellow_stained_glass_pane
lime_stained_glass_pane
pink_stained_glass_pane
gray_stained_glass_pane
light_gray_stained_glass_pane
cyan_stained_glass_pane
purple_stained_glass_pane
blue_stained_glass_pane
brown_stained_glass_pane
green_stained_glass_pane
red_stained_glass_pane
black_stained_glass_pane

Java Edition:

Name Default value Allowed values Description
eastfalsefalse
true
When true, the glass pane extends from the center post to the east.
northfalsefalse
true
When true, the glass pane extends from the center post to the north.
southfalsefalse
true
When true, the glass pane extends from the center post to the south.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this glass pane.
westfalsefalse
true
When true, the glass pane extends from the center post to the west.

Bedrock Edition:
Stained glass pane:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
color
(Deprecated)
0x1
0x2
0x4
0x8
white white0 White
orange1 Orange
magenta2 Magenta
light_blue3 Light Blue
yellow4 Yellow
lime5 Lime
pink6 Pink
gray7 Gray
silver8 Light Gray
cyan9 Cyan
purple10 Purple
blue11 Blue
brown12 Brown
green13 Green
red14 Red
black15 Black

Glazed Terracotta

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

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The opposite from the direction the player faces while placing the block.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
02
3
4
5
2
3
4
5
The direction the block faces.
Opposite from the direction a player faces when placing the block.
  • 2: North
  • 3: South
  • 4: West
  • 5: East
0
1
0
1
Unused

Grass Block, Mycelium, and Podzol

Java Edition:

Name Default value Allowed values Description
snowyfalsefalse
true
If true, the block uses a snowy side and top texture.
In-game, this is true when a snow block or snow is on top.

Grindstone

Java Edition:

Name Default value Allowed values Description
facewallceiling
floor
wall
What the grindstone is attached to.
facingnortheast
north
south
west
The direction the grindstone is facing.
Opposite from the direction the player faces when placing a grindstone on the floor or ceiling.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
attachment0x4
0x8
standingstanding
hanging
side
multiple
0
1
2
3
What the grindstone is attached to.
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the grindstone is facing. Opposite from the direction a player faces when placing the block.
  • 0: South facing
  • 1: West facing
  • 2: North facing
  • 3: East facing

Hay Bale

Java Edition:

Name Default value Allowed values Description
axisy xThe hay block is oriented east–west.
yThe hay block is oriented vertically.
zThe hay block is oriented north–south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axis0x4
0x8
yx
y
z
1
0
2
The axis along which the block is oriented
deprecated0x1
0x2
00
1
2
3
0
1
2
3
Unused, has no effect in game.

Hopper

Java Edition:

Name Default value Allowed values Description
enabledtruefalse
true
True if hopper can move items to and from its inventory.
When the hopper is being powered by redstone current, this is set to false.
facingdowndown
east
north
south
west
The direction the hopper's output points.
The hopper pushes items into containers in this direction only.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
0
1
2
3
4
The direction the hopper's output points.
The hopper pushes items into containers in this direction only.
  • 0: Output facing down
  • 1: (unused)
  • 2: Output facing north
  • 3: Output facing south
  • 4: Output facing west
  • 5: Output facing east
toggle_bit0x8falsefalse
true
0
1
1 if hopper cannot move items to and from its inventory.
When the hopper is being powered by redstone current, this is set to true.

Iron Bars

Java Edition:

Name Default value Allowed values Description
eastfalsefalse
true
When true, the iron bars extend from the center post to the east.
northfalsefalse
true
When true, the iron bars extend from the center post to the north.
southfalsefalse
true
When true, the iron bars extend from the center post to the south.
waterloggedfalsefalse
true
Whether or not there's water in the same place as these iron bars.
westfalsefalse
true
When true, the iron bars extend from the center post to the west.

Jigsaw Block

Java Edition:

Name Default value Allowed values Description
orientationnorth_updown_east
down_north
down_south
down_west
east_up
north_up
south_up
up_east
up_north
up_south
up_west
west_up
The direction the jigsaw block is facing.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_directionNot Supported00
1
2
3
4
5
UnsupportedThe direction the jigsaw block is facing.
rotationNot Supported00
1
2
3
UnsupportedThe rotation around the axis.

Jack o'Lantern

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the jack o'lantern's carved face is facing.
The opposite from the direction the player faces while placing the jack o'lantern.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the jack o' lantern is facing.
  • 0: Jack o'lantern facing south
  • 1: Jack o'lantern facing west
  • 2: Jack o'lantern facing north
  • 3: Jack o'lantern facing east

Jukebox

Java Edition:

Name Default value Allowed values Description
has_recordfalsefalse
true
True when the jukebox contains a music disc.

Kelp

Java Edition:
Top kelp block:

Name Default value Allowed values Description
age00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
A freshly planted kelp starts with a random age between 0 and 24.
Below age 25, a kelp may try go grow more kelp above it with the same age value incremented by one.
Kelp stops growing at age 25.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
kelp_age0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The age of the kelp. The kelp renders as a non-top piece if there's another kelp above it.
16
17
18
19
20
21
22
23
24
25
UnsupportedUnused

Ladder

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction from the block the ladder is attached to, to the ladder.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this ladder.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
22
3
4
5
2
3
4
5
The direction from the block the ladder is attached to, to the ladder.
  • 2: Ladder facing north
  • 3: Ladder facing south
  • 4: Ladder facing west
  • 5: Ladder facing east
0
1
0
1
Unused

Lantern

Java Edition:

Name Default value Allowed values Description
hangingfalsefalse
true
If the lantern is hanging from a block.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this lantern.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
hanging0x1falsefalse
true
0
1
If the lantern is hanging from a block.

Large Flowers

Java Edition:
Sunflower, lilac, rose bush, and peony

Name Default value Allowed values Description
halflowerlower
upper
The half of the plant contained in this block.

Bedrock Edition:
All small flowers except dandelion

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
flower_type0x1
0x2
0x4
0x8
poppy poppy0 Poppy
orchid1 Blue Orchid
allium2 Allium
houstonia3 Azure Bluet
tulip_red4 Red Tulip
tulip_orange5 Orange Tulip
tulip_white6 White Tulip
tulip_pink7 Pink Tulip
oxeye8 Oxeye Daisy
cornflower9 Cornflower
lily_of_the_valley10 Lily of the Valley

Sunflower, lilac, rose bush, and peony

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
double_plant_type0x1
0x2
0x4
sunflower sunflower0 Sunflower
syringa1 Lilac
grass2 Double Tallgrass
fern3 Large Fern
rose4 Rose Bush
paeonia5 Peony
upper_block_bit0x8falsefalse
true
0
1
If it is the upper half of the plant. For items, it is 0.

Lava

Java Edition:

Name Default value Allowed values Description
level0 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

If bit 0x8 is set, this fluid is "falling" and spreads only downward. At this level, the lower bits are essentially ignored, since this block is then at its highest fluid level. This level is equal to the falling lava above, equal to 8 plus the level of the non-falling lava above it.

The lower three bits are the fluid block's level. 0 is the highest fluid level (not necessarily filling the block - this depends on the neighboring fluid blocks above each upper corner of the block). Data values increase as the fluid level of the block drops: 1 is the next highest, 2 lower, on through 7, the lowest fluid level. Along a line on a flat plane, lava drops one level per meter in the Nether and two everywhere else. So in the End and Overworld, only 2, 4 and 6 are used.

Bedrock Edition:
Lava and flowing lava

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
liquid_depth0x1
0x2
0x4
0x8
0 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

If bit 0x8 is set, this fluid is "falling" and spreads only downward. At this level, the lower bits are essentially ignored, since this block is then at its highest fluid level. This level is equal to the falling lava above, equal to 8 plus the level of the non-falling lava above it.

The lower three bits are the fluid block's level. 0 is the highest fluid level (not necessarily filling the block - this depends on the neighboring fluid blocks above each upper corner of the block). Data values increase as the fluid level of the block drops: 1 is the next highest, 2 lower, on through 7, the lowest fluid level. Along a line on a flat plane, lava drops one level per meter in the Nether and two everywhere else. So in the End and Overworld, only 2, 4 and 6 are used.

Leaves

oak_leaves
spruce_leaves
birch_leaves
jungle_leaves
acacia_leaves
dark_oak_leaves

Java Edition:

Name Default value Allowed values Description
distance71
2
3
4
5
6
7
How far away this block is from the nearest log or wood, in taxicab distance.
persistentfalsefalse
true
If the block persists regardless of having no wood nearby.
true for player-placed leaves.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this leaves.

Bedrock Edition:
Leaves:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
old_leaf_type0x1
0x2
oak oak0Oak Leaves
spruce1Spruce Leaves
birch2Birch Leaves
jungle3Jungle Leaves
persistent_bit0x8falsefalse
true
0
1
If the block persists regardless of having no wood nearby.
update_bit0x4falsefalse
true
0
1
If the block checks for nearby wood and decays.

Leaves2:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
new_leaf_type0x1
0x2
acacia acacia0Acacia Leaves
dark_oak1Dark Oak Leaves
persistent_bit0x8falsefalse
true
0
1
If the block persists regardless of having no wood nearby.
update_bit0x4falsefalse
true
0
1
If the block checks for nearby wood and decays.

Azalea leaves and flowering azalea leaves:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
persistent_bitNot Supportedfalsefalse
true
UnsupportedIf the block persists regardless of having no wood nearby.
update_bitNot Supportedfalsefalse
true
UnsupportedIf the block checks for nearby wood and decays.

Lectern

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the lectern is facing.
The opposite from the direction the player faces while placing the lectern.
has_bookfalsefalse
true
If the lectern currently has a book.
poweredfalsefalse
true
If the lectern is currently outputting a redstone signal.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the lectern is facing.
  • 0: South facing
  • 1: West facing
  • 2: North facing
  • 3: East facing
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the lectern is facing.
The opposite from the direction the player faces while placing the lectern.
powered_bit0x4falsefalse
true
0
1
If the lectern is currently outputting a redstone signal.

Lever

Java Edition:

Name Default value Allowed values Description
facewallceiling
floor
wall
The face of the block the lever placed on.
Floor is on top of a block, ceiling is on the bottom, and wall is on one of its sides.
facingnortheast
north
south
west
The direction the lever is facing.
Opposite to the direction the player is facing if placed on the side of a block.
poweredfalsefalse
true
If true, the lever is currently activated.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
open_bit0x8falsefalse
true
0
1
If the lever is currently activated.
lever_direction0x1
0x2
0x4
down_east_west down_east_west0Lever on block bottom points east when off
east1Lever on block side facing east
west2Lever on block side facing west
south3Lever on block side facing south
north4Lever on block side facing north
up_north_south5Lever on block top points south when off.
up_east_west6Lever on block top points east when off.
down_north_south7Lever on block bottom points south when off.

Logs

oak_log
spruce_log
birch_log
jungle_log
acacia_log
dark_oak_log
stripped_oak_log
stripped_spruce_log
stripped_birch_log
stripped_jungle_log
stripped_acacia_log
stripped_dark_oak_log

Java Edition:

Name Default value Allowed values Description
axisy xThe log or stem is oriented east–west.
yThe log or stem is oriented vertically.
zThe log or stem is oriented north–south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axis0x1
0x2
y y0The log is oriented vertically.
x1The log is oriented east–west.
z2The log is oriented north–south.

Loom

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the loom is facing.
Opposite from the direction the player faces when placing a loom.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the loom is facing.
  • 0: South facing loom
  • 1: West facing loom
  • 2: North facing loom
  • 3: East facing loom

Melon Stem

Java Edition:
Growing

Name Default value Allowed values Description
age0 0A newly planted stem.
1
2
3
4
5
6
Intermediate growth stages of the stem.
7A fully mature stem, capable of producing melons.

Attached

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction from the stem to the melon.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 00A newly planted stem.
1
2
3
4
5
6
1
2
3
4
5
6
Intermediate growth stages of the stem.
77A fully mature stem, capable of producing melons.
facing_directionNot Supported0 0
1
UnsupportedUnused
2UnsupportedStem pointing north.
3UnsupportedStem pointing south.
4UnsupportedStem pointing west.
5UnsupportedStem pointing east.

Mob heads

skeleton_skull
wither_skeleton_skull
zombie_head
player_head
creeper_head
dragon_head
skeleton_wall_skull
wither_skeleton_wall_skull
zombie_wall_head
player_wall_head
creeper_wall_head
dragon_wall_head

Java Edition:
Floor

Name Default value Allowed values Description
rotation0 0The block is facing south.
1The block is facing south-southwest.
2The block is facing southwest.
3The block is facing west-southwest.
4The block is facing west.
5The block is facing west-northwest.
6The block is facing northwest.
7The block is facing north-northwest.
8The block is facing north.
9The block is facing north-northeast.
10The block is facing northeast.
11The block is facing east-northeast.
12The block is facing east.
13The block is facing east-southeast.
14The block is facing southeast.
15The block is facing south-southeast.

Wall

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the head is facing.
Opposite from the direction a player is facing when placing it.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
0 11On the floor (rotation is stored in the tile entity)
22On a wall, facing north
33On a wall, facing south
44On a wall, facing east
55On a wall, facing west
00Unused
nodrop_bit0x8false false
true
0
1
If true, the skull does not drop as an item.

Mushroom Blocks

brown_mushroom_block
red_mushroom_block
mushroom_stem

Java Edition:

Name Default value Allowed values Description
easttruefalse
true
/ If true, the east face has the cap/stem texture.
If false, it has the pores texture instead.
downtruefalse
true
/ If true, the bottom face has the cap/stem texture.
If false, it has the pores texture instead.
northtruefalse
true
/ If true, the north face has the cap/stem texture.
If false, it has the pores texture instead.
southtruefalse
true
/ If true, the south face has the cap/stem texture.
If false, it has the pores texture instead.
uptruefalse
true
/ If true, the top face has the cap/stem texture.
If false, it has the pores texture instead.
westtruefalse
true
/ If true, the west face has the cap/stem texture.
If false, it has the pores texture instead.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
huge_mushroom_bits0x1
0x2
0x4
0x8
0 00 All six faces have the pores texture.
11 Cap texture on top, west and north; pores on other sides.
22 Cap texture on top and north; pores on other sides.
33 Cap texture on top, north and east; pores on other sides.
44 Cap texture on top and west; pores on other sides.
55 Cap texture on top; pores on other sides.
66 Cap texture on top and east; pores on other sides.
77 Cap texture on top, south and west; pores on other sides.
88 Cap texture on top and south; pores on other sides.
99 Cap texture on top, east and south; pores on other sides.
1010 The four side faces have the stem texture,
and the top and bottom faces have the pores texture.
11
12
13
11
12
13
All six faces have the pores texture.
1414 All six faces have the cap texture.
1515 All six faces have the stem texture.

Nether Wart

Name Default value Allowed values Description
age0 0
1
2
3 Fully grown.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0 00
1
2
1
2
33 Fully grown.
4
5
6
7
8
9
10
11
12
13
14
15
UnsupportedUnused

Nether Portal

Java Edition:

Name Default value Allowed values Description
axisx xThe portal's long edge runs east–west.
zThe portal's long edge runs north–south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
portal_axis0x1
0x2
unknown unknown0If placed with this state, the portal's long edge runs north–south. If set to it, its direction will be tied to that of adjacent portals.
x1The portal's long edge runs east–west.
z2The portal's long edge runs north–south.


Note Block

Java Edition:

Name Default value Allowed values Description
instrumentharpbanjo
basedrum
bass
bell
bit
chime
cow_bell
creeper
custom_head
didgeridoo
dragon
flute
guitar
harp
hat
iron_xylophone
piglin
pling
skeleton
snare
wither_skeleton
xylophone
zombie
The instrument of the note block.
note00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
The pitch of the note block
poweredfalsefalse
true
True if the note block is currently activated.

Observer

Java Edition:

Name Default value Allowed values Description
facingsouthdown
east
north
south
up
west
The direction the observer is observing. The same direction the player faces when placing the block.
poweredfalsefalse
true
True while the observer is observing a change and emitting a pulse.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Hidden)
0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction the observer is observing.
  • 0: Observer facing down
  • 1: Observer facing up
  • 2: Observer facing north
  • 3: Observer facing south
  • 4: Observer facing west
  • 5: Observer facing east
minecraft:facing_directionNot Supporteddowndown
east
north
south
up
west
UnsupportedThe direction the observer is observing.
powered_bit0x8falsefalse
true
0
1
True while the observer is observing a change and emitting a pulse.

Pistons

piston
sticky_piston

Java Edition:

Name Default value Allowed values Description
extendedfalsefalse
true
If true, the piston is extended.
facingnorthdown
east
north
south
up
west
The direction the piston head is pointing.
The opposite from the direction the player faces while placing the piston.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction the piston is pointing.
  • 0: facing down
  • 1: facing up
  • 2: facing south
  • 3: facing north
  • 4: facing east
  • 5: facing west

Moving Piston

Java Edition:

Name Default value Allowed values Description
facingnorthdown
east
north
south
up
west
The direction the block is being pushed by the piston.
typenormalnormal
sticky
What piston base this has.

Piston Head

Java Edition:

Name Default value Allowed values Description
facingnorthdown
east
north
south
up
west
The direction the piston head is pointing.
shortfalsefalse
true
If true, the piston arm is shorter than usual, by 4 pixels.
typenormalnormal
sticky
The type of piston head.

Bedrock Edition: Piston Head:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
00
1
2
3
4
5
0
1
2
3
4
5
The direction the piston head is pointing.
  • 0: facing up
  • 1: facing down
  • 2: facing south
  • 3: facing north
  • 4: facing east
  • 5: facing west

Sticky Piston Head:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_directionNot Supported00
1
2
3
4
5
UnsupportedThe direction the piston head is pointing.
  • 0: facing up
  • 1: facing down
  • 2: facing south
  • 3: facing north
  • 4: facing east
  • 5: facing west

Potatoes

Java Edition:

Name Default value Allowed values Description
age0 0
1
2
3
4
5
6
7 Fully grown.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 0
1
0
1
2
3
2
3
4
5
6
4
5
6
77 Fully grown.

Pressure Plates

stone_pressure_plate
oak_pressure_plate
spruce_pressure_plate
birch_pressure_plate
jungle_pressure_plate
acacia_pressure_plate
dark_oak_pressure_plate
heavy_weighted_pressure_plate
light_weighted_pressure_plate

Java Edition:
Stone and wooden pressure plates

Name Default value Allowed values Description
poweredfalsefalse
true
True if pressure plate is depressed, providing power.

Weighted pressure plates

Name Default value Allowed values Description
power00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Specifies the redstone power level currently being produced by the weighted pressure plate.

Bedrock Edition:
Stone and wooden pressure plates

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
redstone_signal0x100
1
0
1
Specifies whether the pressure plate is pressed.
2
3
4
5
6
7
8
9
10
11
12
13
14
15
UnsupportedUnused

Weighted pressure plates

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
redstone_signal0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
Specifies the redstone power level currently being produced by the pressure plate.

Pumpkin Stem

Java Edition:
Growing

Name Default value Allowed values Description
age0 0A newly planted stem.
1
2
3
4
5
6
Intermediate growth stages of the stem.
7A fully mature stem, capable of producing pumpkins.

Attached

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction from the stem to the pumpkin.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 00A newly planted stem.
1
2
3
4
5
6
1
2
3
4
5
6
Intermediate growth stages of the stem.
77A fully mature stem, capable of producing pumpkins.
facing_directionNot Supported0 0
1
UnsupportedUnused
2UnsupportedStem pointing north.
3UnsupportedStem pointing south.
4UnsupportedStem pointing west.
5UnsupportedStem pointing east.

Purpur and Quartz Pillar

Java Edition:

Name Default value Allowed values Description
axisy xThe pillar is oriented east–west.
yThe pillar is oriented vertically.
zThe pillar is oriented north–south.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
chisel_type0x1
0x2
default default0The main block type.
chiseled1The chiseled type.
lines2The pillar type.
smooth3The smooth type.
pillar_axis0x4
0x8
yx
y
z
1
0
2
The axis along which the block is oriented. Normally applies only to the pillar type.

Rails

Rail

Java Edition:

Name Default value Allowed values Description
shapenorth_south east_west
north_east
north_south
north_west
south_east
south_west
The two directions a rail connects to.
For example, a south_east rail is a curved rail that connects to the south and to the east.
ascending_east
ascending_north
ascending_south
ascending_west
A rail that ascends toward the direction noted.
For example, an ascending_west rail is a straight rail that goes upward from the east toward the west.
waterloggedfalsetrue
false
Whether or not there's water in the same place as this rail.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
rail_direction0x1
0x2
0x4
0x8
0 00Straight rail connecting to the north and south.
11Straight rail connecting to the east and west.
22Sloped rail ascending to the east.
33Sloped rail ascending to the west.
44Sloped rail ascending to the north.
55Sloped rail ascending to the south.
66Curved rail connecting to the south and east.
77Curved rail connecting to the south and west.
88Curved rail connecting to the north and west.
99Curved rail connecting to the north and east.

Activator Rail, Detector Rail, and Powered Rail

Java Edition:

Name Default value Allowed values Description
poweredfalsefalse
true
True if rail is activated.
shapenorth_south east_west
north_south
Specifies the rail's orientation.
ascending_east
ascending_north
ascending_south
ascending_west
A rail that ascends toward the direction noted.
For example, an ascending_west rail is a straight rail that goes upward from the east toward the west.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this rail.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
rail_data_bit0x8falsefalse
true
0
1
True if rail is activated.
rail_direction0x1
0x2
0x4
0 00 flat track going north-south
11 flat track going east-west
22 sloped track ascending to the east
33 sloped track ascending to the west
44 sloped track ascending to the north
55 sloped track ascending to the south
6
7
8
9
UnsupportedUnused

Redstone Comparator

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction from the output side to the input side of the comparator,
or the opposite from the direction the player faces while placing the comparator.
modecomparecompare
subtract
Specifies the current mode of the redstone comparator.
poweredfalsefalse
true
True if the redstone comparator is being powered.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the repeater directs power.
  • 0: Facing north.
  • 1: Facing east.
  • 2: Facing south.
  • 3: Facing west.
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction from the output side to the input side of the comparator,
or the opposite from the direction the player faces while placing the comparator.
output_lit_bit0x8falsefalse
true
0
1
True if the redstone comparator is being powered.
output_subtract_bit0x4falsefalse
true
0
1
Specifies the current mode of the redstone comparator.

Redstone Dust

Java Edition:

Name Default value Allowed values Description
eastnonenone
side
up
The way redstone dust connects to the east, side can also mean down.
northnonenone
side
up
The way redstone dust connects to the north, side can also mean down.
power00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The redstone dust's current power level.
southnonenone
side
up
The way redstone dust connects to the south, side can also mean down.
westnonenone
side
up
The way redstone dust connects to the west, side can also mean down.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
redstone_signal0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The redstone dust's current power level.

Redstone Lamp

Java Edition:

Name Default value Allowed values Description
litfalsefalse
true
If the redstone lamp is lit.

Redstone Ore

Java Edition:

Name Default value Allowed values Description
litfalsefalse
true
If the redstone ore is lit.

Redstone Repeater

Java Edition:

Name Default value Allowed values Description
delay11
2
3
4
The redstone repeater's delay in redstone ticks.
facingnortheast
north
south
west
The direction from the output side to the input side of a repeater.
The opposite from the direction the player faces while placing the repeater.
lockedfalsefalse
true
True if the repeater is currently locked.
poweredfalsefalse
true
If the redstone repeater is lit.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction
(Deprecated)
0x1
0x2
00
1
2
3
0
1
2
3
The direction the repeater directs power.
  • 0: Facing north.
  • 1: Facing east.
  • 2: Facing south.
  • 3: Facing west.
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction from the output side to the input side of a repeater.
The opposite from the direction the player faces while placing the repeater.
repeater_delay0x4
0x8
00
1
2
3
0
1
2
3
The redstone repeater's delay in redstone ticks minus 1.

Redstone Torch

Java Edition:
Floor:

Name Default value Allowed values Description
littruefalse
true
If the torch is lit.

Wall:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the top of the torch is facing.
littruefalse
true
If the torch is lit.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
torch_facing_direction0x1
0x2
0x4
west west
east
north
south
top
1
2
3
4
5
The face of the block that the torch is attached to. If the torch is a wall torch, the top of the torch faces opposite to this direction.[2]
unknown0Unused

Saplings

oak_sapling
spruce_sapling
birch_sapling
jungle_sapling
acacia_sapling
dark_oak_sapling

Java Edition:

Sapling
Name Default value Allowed values Description
stage00
1
Specifies the sapling's growth stage.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age_bit0x8falsefalse
true
0
1
Specifies the sapling's growth stage.
sapling_type0x1
0x2
0x4
oak acacia4Acacia Sapling
birch2Birch Sapling
dark_oak5Dark Oak Sapling
jungle3Jungle Sapling
oak0Oak Sapling
spruce1Spruce Sapling

Scaffolding

Java Edition:

Name Default value Allowed values Description
bottomfalsefalse
true
If this scaffolding is floating.
distance70
1
2
3
4
5
6
7
The distance from a center scaffolding horizontally. If it is 7, it becomes a falling block entity.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this scaffolding.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
stability0x2
0x4
0x8
70
1
2
3
4
5
6
7
0
1
2
3
4
5
6
7
The distance from a center scaffolding horizontally. If it is 7, it becomes a falling block entity.
stability_check0x1falsefalse
true
0
1
If a scaffolding block has been checked for stability.[more information needed]

Sea Pickle

Java Edition:

Name Default value Allowed values Description
pickles11
2
3
4
Number of pickles.
waterloggedtruefalse
true
Whether or not there's water in the same place as these pickles.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
cluster_count0x1
0x2
00
1
2
3
0
1
2
3
Number of additional pickles.
dead_bit0x4falsefalse
true
0
1
True if there's no water in the same place as these pickles.

Shulker Boxes

shulker_box
white_shulker_box
orange_shulker_box
magenta_shulker_box
light_blue_shulker_box
yellow_shulker_box
lime_shulker_box
pink_shulker_box
gray_shulker_box
light_gray_shulker_box
cyan_shulker_box
purple_shulker_box
blue_shulker_box
brown_shulker_box
green_shulker_box
red_shulker_box
black_shulker_box

Java Edition:

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

Bedrock Edition:
Dyed shulker box:

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

Sign

Java Edition:

  • Non-hanging:
Standing
Name Default value Allowed values Description
rotation0 0The block is facing south.
1The block is facing south-southwest.
2The block is facing southwest.
3The block is facing west-southwest.
4The block is facing west.
5The block is facing west-northwest.
6The block is facing northwest.
7The block is facing north-northwest.
8The block is facing north.
9The block is facing north-northeast.
10The block is facing northeast.
11The block is facing east-northeast.
12The block is facing east.
13The block is facing east-southeast.
14The block is facing southeast.
15The block is facing south-southeast.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this sign.
Wall
Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the block is facing. For example, a block facing east is attached to a block to its west.
Opposite from the direction a player faces when placing the block.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this sign.
  • Hanging:
Hanging
Name Default value Allowed values Description
attachedfalsefalse
true
[more information needed]
rotation0 0The block is facing south.
1The block is facing south-southwest.
2The block is facing southwest.
3The block is facing west-southwest.
4The block is facing west.
5The block is facing west-northwest.
6The block is facing northwest.
7The block is facing north-northwest.
8The block is facing north.
9The block is facing north-northeast.
10The block is facing northeast.
11The block is facing east-northeast.
12The block is facing east.
13The block is facing east-southeast.
14The block is facing southeast.
15The block is facing south-southeast.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this hanging sign.
Wall
Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the block is facing.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this hanging sign.

Bedrock Edition:

Standing
NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
ground_sign_direction0x1
0x2
0x4
0x8
0 00The block is facing south.
11The block is facing south-southwest.
22The block is facing southwest.
33The block is facing west-southwest.
44The block is facing west.
55The block is facing west-northwest.
66The block is facing northwest.
77The block is facing north-northwest.
88The block is facing north.
99The block is facing north-northeast.
1010The block is facing northeast.
1111The block is facing east-northeast.
1212The block is facing east.
1313The block is facing east-southeast.
1414The block is facing southeast.
1515The block is facing south-southeast.
Wall
NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction0x1
0x2
0x4
22
3
4
5
2
3
4
5
The direction the block is facing. For example, a block facing east is attached to a block to its west.
  • 2: north
  • 3: south
  • 4: west
  • 5: east
0
1
0
1
Unused
Hanging
NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
attached_bitNot Supportedfalsefalse
true
UnsupportedWhether or not the hanging block is attached to face in a specific direction.
facing_directionNot Supported22
3
4
5
UnsupportedThe direction the block is facing. For example, a block facing east is attached to a block to its west.
  • 2: north
  • 3: south
  • 4: west
  • 5: east
0
1
UnsupportedUnused
ground_sign_directionNot Supported0 0UnsupportedThe hanging block is facing south.
1UnsupportedThe hanging block is facing south-southwest.
2UnsupportedThe hanging block is facing southwest.
3UnsupportedThe hanging block is facing west-southwest.
4UnsupportedThe hanging block is facing west.
5UnsupportedThe hanging block is facing west-northwest.
6UnsupportedThe hanging block is facing northwest.
7UnsupportedThe hanging block is facing north-northwest.
8UnsupportedThe hanging block is facing north.
9UnsupportedThe hanging block is facing north-northeast.
10UnsupportedThe hanging block is facing northeast.
11UnsupportedThe hanging block is facing east-northeast.
12UnsupportedThe hanging block is facing east.
13UnsupportedThe hanging block is facing east-southeast.
14UnsupportedThe hanging block is facing southeast.
15UnsupportedThe hanging block is facing south-southeast.
hangingNot Supportedfalsefalse
true
UnsupportedWhether or not the block is hanging under another block.


Slabs

stone_slab
sandstone_slab
petrified_oak_slab
cobblestone_slab
brick_slab
stone_brick_slab
nether_brick_slab
quartz_slab
red_sandstone_slab
prismarine_slab
prismarine_brick_slab
dark_prismarine_slab
oak_slab
spruce_slab
birch_slab
jungle_slab
acacia_slab
dark_oak_slab
prismarine_slab
prismarine_brick_slab
dark_prismarine_slab

Java Edition:

Name Default value Allowed values Description
typebottom bottom
top
Where the slab is within its block.
doubleThe block is a double slab.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this slab.

Bedrock Edition:
Stone slab and double stone slab:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
stone_slab_type0x1
0x2
0x4
smooth_stone smooth_stone0Smooth Stone Slab
sandstone1Sandstone Slab
wood2Petrified Oak Slab
cobblestone3Cobblestone Slab
brick4Brick Slab
stone_brick5Stone Brick Slab
quartz6Quartz Slab
nether_brick7Nether Brick Slab
top_slot_bit
(Deprecated)
0x8falsefalse
true
0
1
Whether or not this slab is an upper slab.

Wood slab and double wood slab:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
wood_type0x1
0x2
0x4
oak oak0Oak Slab
spruce1Spruce Slab
birch2Birch Slab
jungle3Jungle Slab
acacia4Acacia Slab
dark_oak5Dark Oak Slab
top_slot_bit
(Deprecated)
0x8falsefalse
true
0
1
Whether or not this slab is an upper slab.

Stone slab 2 and double stone slab 2:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
stone_slab_type_20x1
0x2
0x4
red_sandstone red_sandstone0Red Sandstone Slab
purpur1Purpur Slab
prismarine_rough2Prismarine Slab
prismarine_dark3Dark Prismarine Slab
prismarine_brick4Prismarine Brick Slab
mossy_cobblestone5Mossy Cobblestone Slab
smooth_sandstone6Smooth Sandstone Slab
red_nether_brick7Red Nether Brick Slab
top_slot_bit
(Deprecated)
0x8falsefalse
true
0
1
Whether or not this slab is an upper slab.

Stone slab 3 and double stone slab 3:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
stone_slab_type_30x1
0x2
0x4
end_stone_brick end_stone_brick0End Stone Brick Slab
smooth_red_sandstone1Smooth Red Sandstone Slab
polished_andesite2Polished Andesite Slab
andesite3Andesite Slab
diorite4Diorite Slab
polished_diorite5Polished Diorite Slab
granite6Granite Slab
polished_granite7Polished Granite Slab
top_slot_bit
(Deprecated)
0x8falsefalse
true
0
1
Whether or not this slab is an upper slab.

Stone slab 4 and double stone slab 4:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
stone_slab_type_40x1
0x2
0x4
mossy_stone_brick mossy_stone_brick0Mossy Stone Brick Slab
smooth_quartz1Smooth Quartz Slab
stone2Stone Slab
cut_sandstone3Cut Sandstone Slab
cut_red_sandstone4Cut Red Sandstone Slab
top_slot_bit
(Deprecated)
0x8falsefalse
true
0
1
Whether or not this slab is an upper slab.

Other slabs and double slabs:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
minecraft:vertical_halfNot Supportedbottom bottom
top
UnsupportedWhere the slab is within its block.
top_slot_bit
(Deprecated)
0x1falsefalse
true
0
1
Whether or not this slab is an upper slab.

Smoker

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the smoker's opening faces.
The opposite from the direction the player faces while placing the smoker.
litfalsefalse
true
If the smoker is lit.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Deprecated)
0x1
0x2
0x4
30
1
2
3
4
5
0
1
2
3
4
5
The direction the smoker's opening faces.
  • 2: facing north
  • 3: facing south
  • 4: facing west
  • 5: facing east
minecraft:cardinal_directionNot Supportedsoutheast
north
south
west
UnsupportedThe direction the smoker's opening faces.
The opposite from the direction the player faces while placing the smoker.

Snow

Java Edition:

Name Default value Allowed values Description
layers11
2
3
4
5
6
7
8
The number of layers thick.
Each layer adds two pixels to the block height, and each layer after the first adds two pixels to the collision box.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
height0x1
0x2
0x4
00
1
2
3
4
5
6
7
0
1
2
3
4
5
6
7
The number of layers in addition to the bottom layer.
covered_bit0x8falsetrue
false
0
1
True if the snow is covering a plant.

Stairs

  • acacia_stairs
  • birch_stairs
  • brick_stairs
  • dark_oak_stairs
  • jungle_stairs
  • nether_brick_stairs
  • oak_stairs
  • purpur_stairs
  • quartz_stairs
  • red_sandstone_stairs
  • sandstone_stairs
  • spruce_stairs
  • stone_brick_stairs
  • cobblestone_stairs
  • prismarine_stairs
  • prismarine_brick_stairs
  • dark_prismarine_stairs

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the stairs' full-block side faces.
When placed in-game by a player, this matches the direction the player faces.
halfbottombottom
top
Top if the stairs are upside-down.
shapestraightinner_left
inner_right
outer_left
outer_right
straight
"straight" is the default stairs shape.
"inner" is an "inside corner" stair shape, with two full-block and two stair-shaped side faces.
"outer" is an "outside corner" stair shape, with two stair-shaped and two half-block side faces.
"left" and "right" specify in which direction is the higher part of the step.
waterloggedfalsefalse
true
Whether or not there's water in the same place as these stairs.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
upside_down_bit0x4falsefalse
true
0
1
True if the stairs are upside-down.
weirdo_direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the stairs' full-block side faces.
  • 0: East
  • 1: West
  • 2: South
  • 3: North

Stonecutter

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the stonecutter is facing.
The opposite from the direction the player faces when placing a stonecutter.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
facing_direction
(Hidden‌[upcoming: BE 1.20.40])
0x1
0x2
0x4
02
3
4
5
2
3
4
5
The direction the stonecutter is facing.
Opposite from the direction the player faces when placing a stonecutter.
  • 2: North facing stonecutter
  • 3: South facing stonecutter
  • 4: West facing stonecutter
  • 5: East facing stonecutter
0
1
0
1
Unused
minecraft:cardinal_direction‌[upcoming: BE 1.20.40]Not Supportednortheast
north
south
west
UnsupportedThe direction the stonecutter is facing.
The opposite from the direction the player faces when placing a stonecutter.

Structure Block

Java Edition:

Name Default value Allowed values Description
modedata corner Corner Structure Block
data Data Structure Block
load Load Structure Block
save Save Structure Block

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
structure_block_type0x1
0x2
0x4
data corner3 Corner Structure Block
data0 Data Structure Block
export5 Export Structure Block
invalid4 Inventory Structure Block
load2 Load Structure Block
save1 Save Structure Block

Sugar Cane

Java Edition:

Name Default value Allowed values Description
age00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
A freshly planted cane – and a cane that has just grown cane above it – each have an age of 0.
The age is incremented at random intervals.
At age 15, a cane may try to grow more cane above it.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
age0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
A freshly planted cane – and a cane that has just grown cane above it – each have an age of 0.
The age is incremented at random intervals.
At age 15, a cane may try to grow more cane above it.

Sweet Berry Bush

Java Edition:

Name Default value Allowed values Description
age0 0 Young plant
1 No berries
2 Some berries, using the bush gives 1–2 sweet berries and sets the age back to 1.
3 Full berries, using the bush gives 2–3 sweet berries and sets the age back to 1.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 0
1
0
1
Young plant
2
3
2
3
No berries
4
5
6
4
5
6
Some berries, using the bush gives 1–2 sweet berries and sets the growth back to 2.
77 Full berries, using the bush gives 2–3 sweet berries and sets the growth back to 2.

Tall Grass and Large Fern

Java Edition:
Tall grass and large fern

Name Default value Allowed values Description
halflowerlower
upper
The half of the plant contained in this block.

Bedrock Edition:
Grass and fern

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
tall_grass_type0x1
0x2
default default0 Fern (Unused variant which looks identical to grass)
tall1 Grass
fern2 Fern
snow3 Fern (looks identical to actual fern)

Tall grass and large fern

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
double_plant_type0x1
0x2
0x4
sunflowersunflower
syringa
grass
fern
rose
paeonia
0
1
2
3
4
5
The flower type.
upper_block_bit0x8falsefalse
true
0
1
If it is the upper half of the plant. For items, it is 0.

Tall Seagrass

Java Edition:
Tall

Name Default value Allowed values Description
halflowerlower
upper
The half of the plant contained in this block.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
sea_grass_type0x1
0x2
default default0This is seagrass.
double_bot1This is the bottom half of tall seagrass.
double_top2This is the top half of tall seagrass.

TNT

Java Edition:

Name Default value Allowed values Description
unstablefalse falseHitting the TNT block breaks it, dropping it as an item that can be picked up.
trueHitting the TNT block causes it to ignite and then explode.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
allow_underwater_bit0x2false false0This is normal TNT.
true1This is Underwater TNT.
explode_bit0x1false false0Hitting the TNT block breaks it, dropping it as an item that can be picked up.
true1Hitting the TNT block causes it to ignite and then explode.


Trapdoors

iron_trapdoor
oak_trapdoor
spruce_trapdoor
birch_trapdoor
jungle_trapdoor
acacia_trapdoor
dark_oak_trapdoor

Java Edition:

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the trapdoor swings open.
The opposite from the side its hinge is attached to.
halfbottombottom
top
Whether the trapdoor occupies the top or bottom part of a block.
openfalsefalse
true
True if the trapdoor is currently open (may differ from powered).
poweredfalsefalse
true
True if the trapdoor is currently powered (may differ from open).
waterloggedfalsefalse
true
Whether or not there's water in the same place as this trapdoor.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction the trapdoor is facing.
  • 0: Trapdoor on the west side of a block
  • 1: Trapdoor on the east side of a block
  • 2: Trapdoor on the north side of a block
  • 3: Trapdoor on the south side of a block
open_bit0x8falsefalse
true
0
1
True if the trapdoor is currently open.
upside_down_bit0x4falsefalse
true
0
1
Whether the trapdoor occupies the top or bottom part of a block.

Tripwire

Java Edition:

Name Default value Allowed values Description
attachedfalsefalse
true
True if the tripwire is connected to a valid tripwire circuit.
disarmedfalsefalse
true
True if the tripwire is disarmed, that is, broken using shears.
eastfalsefalse
true
True if the tripwire connects to other tripwire or tripwire hooks to the east.
northfalsefalse
true
True if the tripwire connects to other tripwire or tripwire hooks to the north.
poweredfalsefalse
true
True if the tripwire is active.
southfalsefalse
true
True if the tripwire connects to other tripwire or tripwire hooks to the south.
westfalsefalse
true
True if the tripwire connects to other tripwire or tripwire hooks to the west.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
attached_bit0x4falsefalse
true
0
1
True if the tripwire is connected to a valid tripwire circuit.
disarmed_bit0x8falsefalse
true
0
1
True if the tripwire is disarmed, that is, broken using shears.
powered_bit0x1falsefalse
true
0
1
True if the tripwire is active.
suspended_bit0x2truefalse
true
0
1
True if the tripwire hasn't connected to a valid tripwire circuit. (makes hitbox larger when true)

Tripwire Hook

Java Edition:

Name Default value Allowed values Description
attachedfalsefalse
true
True if the tripwire hook is connected to a valid tripwire circuit.
facingnortheast
north
south
west
The direction in which the tripwire hook juts out from the block it is attached to.
For example, a tripwire hook facing north is attached to a block to its south.
poweredfalsefalse
true
True if the tripwire hook is active.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
attached_bit0x4falsefalse
true
0
1
True if the tripwire hook is connected to a valid tripwire circuit.
direction0x1
0x2
00
1
2
3
0
1
2
3
The direction in which the tripwire hook juts out from the block it is attached to.
  • 0: Tripwire hook on block side facing south
  • 1: Tripwire hook on block side facing west
  • 2: Tripwire hook on block side facing north
  • 3: Tripwire hook on block side facing east
powered_bit0x8falsefalse
true
0
1
True if the tripwire hook is active.

Turtle Egg

Java Edition:

Name Default value Allowed values Description
eggs11
2
3
4
Number of eggs.
hatch00
1
2
Determines how close an egg is to hatching; starts at 0 and is randomly incremented.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
turtle_egg_count0x1
0x2
one_eggone_egg
two_egg
three_egg
four_egg
0
1
2
3
Number of eggs.
cracked_state0x4
0x8
no_cracksno_cracks
cracked
max_cracked
0
1
2
Determines how close an egg is to hatching; starts at no cracks and is randomly incremented.

Vines

Java Edition:

Name Default value Allowed values Description
eastfalsefalse
true
When true, a vine texture is displayed on the east.
northfalsefalse
true
When true, a vine texture is displayed on the north.
southfalsefalse
true
When true, a vine texture is displayed on the south.
upfalsefalse
true
When true, a vine texture is displayed on the top.
westfalsefalse
true
When true, a vine texture is displayed on the west.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
vine_direction_bits0x1
0x2
0x4
0x8
00
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
The directions the vine exists, excluding up. Each bit determines one direction:
  • 0x1: Vines at the south
  • 0x2: Vines at the west
  • 0x4: Vines at the north
  • 0x8: Vines at the east

Note: Vines gain the ceiling vines if there's a block above, block state doesn't change.

Wall Torch

Java Edition:
Wall

Name Default value Allowed values Description
facingnortheast
north
south
west
The direction the top of the torch is facing.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
torch_facing_direction0x1
0x2
0x4
west west
east
north
south
top
1
2
3
4
5
The face of the block that the torch is attached to. If the torch is a wall torch, the top of the torch faces opposite to this direction.[3]
unknown0Unused

Walls

cobblestone_wall
mossy_cobblestone_wall

Java Edition

Name Default value Allowed values Description
eastnonelow
none
tall
How the wall extends from the center post to the east.
northnonelow
none
tall
How the wall extends from the center post to the north.
southnonelow
none
tall
How the wall extends from the center post to the south.
uptruefalse
true
When true, the wall has a center post.
waterloggedfalsefalse
true
Whether or not there's water in the same place as this wall.
westnonelow
none
tall
How the wall extends from the center post to the west.

Bedrock Edition Non-blackstone and deepslate wall:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
wall_block_type0x1
0x2
0x4
0x8
cobblestonecobblestone
mossy_cobblestone
granite
diorite
andesite
sandstone
brick
stone_brick
mossy_stone_brick
nether_brick
end_brick
prismarine
red_sandstone
red_nether_brick
0
1
2
3
4
5
6
7
8
9
10
11
12
13
The type of wall; for example, stone_brick denotes a stone brick wall.
wall_connection_type_eastNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the east.
wall_connection_type_northNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the north.
wall_connection_type_southNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the south.
wall_connection_type_westNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the west.
wall_post_bitNot Supportedtruefalse
true
UnsupportedWhether or not the wall has a center post.

Blackstone and deepslate wall:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
wall_connection_type_eastNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the east.
wall_connection_type_northNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the north.
wall_connection_type_southNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the south.
wall_connection_type_westNot Supportednonenone
short
tall
UnsupportedHow the wall extends from the center post to the west.
wall_post_bitNot Supportedtruefalse
true
UnsupportedWhether or not the wall has a center post.

Water

Java Edition:

Name Default value Allowed values Description
level0 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

If bit 0x8 is set, this fluid is "falling" and spreads only downward. At this level, the lower bits are essentially ignored, since this block is then at its highest fluid level. This level is equal to the falling water above, equal to 8 plus the level of the non-falling lava above it.

The lower three bits are the fluid block's level. 0 is the highest fluid level (not necessarily filling the block - this depends on the neighboring fluid blocks above each upper corner of the block). Data values increase as the fluid level of the block drops: 1 is the next highest, 2 lower, on through 7, the lowest fluid level. Along a line on a flat plane, water drops one level per meter.

Bedrock Edition:
Water and flowing water

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
liquid_depth0x1
0x2
0x4
0x8
0 0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
0
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

If bit 0x8 is set, this fluid is "falling" and spreads only downward. At this level, the lower bits are essentially ignored, since this block is then at its highest fluid level. This level is equal to the falling water above, equal to 8 plus the level of the non-falling lava above it.

The lower three bits are the fluid block's level. 0 is the highest fluid level (not necessarily filling the block - this depends on the neighboring fluid blocks above each upper corner of the block). Data values increase as the fluid level of the block drops: 1 is the next highest, 2 lower, on through 7, the lowest fluid level. Along a line on a flat plane, water drops one level per meter.

Wheat

Java Edition:

Name Default value Allowed values Description
age0 0
1
2
3
4
5
6
7 Fully grown.

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
growth0x1
0x2
0x4
0 00
11
22
33
44
55
66
77 Fully grown.

Wood

oak_wood
spruce_wood
birch_wood
jungle_wood
acacia_wood
dark_oak_wood
stripped_oak_wood
stripped_spruce_wood
stripped_birch_wood
stripped_jungle_wood
stripped_acacia_wood
stripped_dark_oak_wood

Java Edition:

Name Default value Allowed values Description
axisy xThe wood or hyphae is oriented east–west.
yThe wood or hyphae is oriented vertically.
zThe wood or hyphae is oriented north–south.

Bedrock Edition:

Wood

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axisNot Supportedy xUnsupportedThe wood is oriented east–west.
yUnsupportedThe wood is oriented vertically.
zUnsupportedThe wood is oriented north–south.
stripped_bit0x8falsefalse
true
0
1
Whether the wood is stripped or not.
wood_type0x1
0x2
0x4
oak acacia4Acacia Wood
birch2Birch Wood
dark_oak5Dark Oak Wood
jungle3Jungle Wood
oak0Oak Wood
spruce1Spruce Wood

Warped Hyphae, Stripped Crimson Hyphae, Stripped Warped Hyphae

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axis0x1
0x2
y x1The hyphae is oriented east–west.
y0The hyphae is oriented vertically.
z2The hyphae is oriented north–south.

Crimson Hyphae

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
pillar_axisNot Supportedy xUnsupportedThe hyphae is oriented east–west.
yUnsupportedThe hyphae is oriented vertically.
zUnsupportedThe hyphae is oriented north–south.

History

Java Edition
1.8
{{Extension DPL}}<ul><li>[[Book|Book]]<br/>{{For}}
{{Item
| image = Book.png
| renewable = Yes
| stackable = Yes (64)
|effects=Read}}

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

== Obtaining ==

=== Block loot ===

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

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

=== Chest loot ===

{{LootChestItem|book}}

=== Grindstones ===

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

=== Villager gifts ===

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

== Usage ==

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

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

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

=== Trading ===

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

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

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


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

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

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

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

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

== Video ==

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

== History ==

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

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

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

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

== Issues ==

{{issue list}}

== See also ==

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

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

[[Category:Renewable resources]]

[[cs:Kniha]]
[[de:Buch]]
[[es:Libro]]
[[fr:Livre]]
[[hu:Könyv]]
[[it:Libro]]
[[ja:本]]
[[ko:책]]
[[nl:Boek]]
[[pl:Książka]]
[[pt:Livro]]
[[ru:Книга]]
[[th:หนังสือ]]
[[uk:Книга]] 
[[zh:书]]</li><li>[[Glow Ink Sac|Glow Ink Sac]]<br/>{{For|the regular sac dropped by squids|Ink Sac}}
{{Item
|Image=Glow Ink Sac.png
| renewable = Yes
| stackable = Yes (64)
|}}

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

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

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

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

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

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

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

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

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

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

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

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

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

== Issues ==
{{Issue list}}

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

{{Items}}

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

[[de:Leuchttintenbeutel]]
[[es:Saco de tinta luminosa]]
[[it:Sacca d'inchiostro luminescente]]
[[ja:輝くイカスミ]]
[[pl:Torbiel ze świecącym atramentem]]
[[pt:Bolsa de tinta brilhante]]
[[ru:Светящийся чернильный мешок]]
[[uk:Сяйний чорнильний мішок]]
[[zh:荧光墨囊]]</li></ul>
14w11aAdded block states. Only used in the game engine, not saved in world files or used in commands yet.
14w26aSwitched to mostly using block states in the code.
1.11
{{Extension DPL}}<ul><li>[[Raw Iron|Raw Iron]]<br/>{{Item
| image = Raw Iron.png
| renewable = No
| stackable = Yes (64)
}}
'''Raw iron''' is a raw metal resource obtained from mining [[iron ore]].

== Obtaining ==
=== Mining ===
[[Iron ore]] and [[deepslate iron ore]] mined with a [[stone pickaxe]] or higher drops 1 unit of raw iron. If the pickaxe is enchanted with [[Fortune]], it can drop an extra unit per level of Fortune, allowing for a maximum of 4 with Fortune III. If the ore is mined using a pickaxe enchanted with [[Silk Touch]], it drops the ore block instead.

=== Crafting ===
{{Crafting
|showname=1
|Block of Raw Iron
|Output=Raw Iron,9
|type=Material
|foot=1
}}

== Usage ==
The primary usage of raw iron is smelting it into [[iron ingot]]s.

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

=== Smelting ingredient ===
{{Smelting
|showname=2
|Raw Iron
|Iron Ingot
|0.7
}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showitemtags=y
|showforms=y
|generatetranslationkeys=y
|displayname=Raw Iron
|spritetype=item
|nameid=raw_iron
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Raw Iron
|spritetype=item
|nameid=raw_iron
|form=item
|id=505
|foot=1}}

== History ==
{{History|java}}
{{History||1.17|snap=21w14a|[[File:Raw Iron JE1.png|32px]] Added raw iron.}}
{{History|||snap=April 13, 2021|slink={{Tweet|JasperBoerstra|1381991999952277513}}|[[File:Raw Iron JE2.png|32px]] [[JAPPA]] shows a new raw iron texture.}}
{{History|||snap=21w15a|[[File:Raw Iron JE2.png|32px]] The texture of raw iron has been changed.
|Raw iron can now be used to craft [[block of raw iron]].}}
{{History|||snap=April 16, 2021|slink={{Tweet|JasperBoerstra|1383047666037325829}}|[[File:Raw Iron (pre-release).png|32px]] [[JAPPA]] shows a new raw iron texture again.}}
{{History|||snap=21w16a|[[File:Raw Iron JE3.png|32px]] The texture of raw iron has been changed.}}
{{History|Bedrock}}
{{History||1.17.0|snap=beta 1.17.0.50|[[File:Raw Iron JE2.png|32px]] Added raw iron.}}
{{History|||snap=beta 1.17.0.52|Raw iron are now available without enabling [[experimental gameplay]].}}
{{History|||snap=beta 1.17.0.54|[[File:Raw Iron JE3.png|32px]] The texture of raw iron has been changed.}}
{{History|foot}}

== Issues ==
{{Issue list}}

==Gallery==
<gallery>
JE 1.17 Dev Raw Metals.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 1.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 2.png|Jappa shows raw ore textures.
Jappa Raw Ores 3.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 4.jpg|Jappa shows raw ore textures.
Jappa Raw Ores 5.jpg|Jappa shows raw ore textures.
</gallery>

{{Items}}

[[Category:Non-renewable resources]]

[[de:Roheisen]]
[[es:Hierro en bruto]]
[[fr:Fer brut]]
[[it:Ferro grezzo]]
[[ja:鉄の原石]]
[[lzh:砂鐵]]
[[pl:Surowe żelazo]]
[[pt:Ferro bruto]]
[[ru:Необработанное железо]]
[[uk:Необроблене залізо]]
[[zh:粗铁]]</li><li>[[Iron Ingot|Iron Ingot]]<br/>{{About|the ingot|the ore|Iron Ore|the mineral block|Block of Iron|the nugget|Iron Nugget|the raw mineral|Raw Iron}}
{{Item
| image = Iron Ingot.png
|type=
| renewable = Yes
| stackable = Yes (64)
}}

'''Iron ingots''' are versatile [[metal]] ingots used extensively in [[crafting]].

== Obtaining ==
=== Chest loot ===
{{LootChestItem|iron-ingot}}

=== Crafting ===

{{Crafting
|head=1
|showname=0
|Block of Iron
|Output=Iron Ingot,9
|type=Material
}}

{{Crafting
|A1= Iron Nugget
|B1= Iron Nugget
|C1= Iron Nugget
|A2= Iron Nugget
|B2= Iron Nugget
|C2= Iron Nugget
|A3= Iron Nugget
|B3= Iron Nugget
|C3= Iron Nugget
|Output=Iron Ingot
|type= Material
|foot=1
}}

=== Smelting ===
{{see also|Iron Ore#Natural generation}}[[Smelting]] raw iron in a [[furnace]] or [[blast furnace]] is the most common way to obtain iron ingots.

{{Smelting
|head=1
|Iron Ore;Deepslate Iron Ore
|Iron Ingot
|0,7
}}
{{Smelting
|foot=1
|Raw Iron
|Iron Ingot
|0,7
}}

=== Compound creation ===

Iron Ingot can be created from its base [[element]]s, using the [[compound creator]].{{only|bedrock|education}}

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

=== Mob loot ===
{{see also|Tutorials/Iron golem farming}}
[[Iron golem]]s drop 3-5 iron ingots upon death, regardless of the way they die. The looting enchantment does not increase the amount of iron ingots dropped.

[[Zombie]]s, [[husk]]s, and [[zombie villager]]s have a 2.5% ({{frac|1|40}}) chance of dropping either an iron ingot, [[carrot]], or [[potato]] when killed by a player or tamed wolf. This is increased by 1% ({{frac|1|100}}) per level of looting. This gives iron ingots the following chances of dropping:
* {{frac|1|120}} (about 0.83%)
* {{frac|7|600}} (about 1.17%) with Looting I
* {{frac|9|600}} (1.50%) with Looting II
* {{frac|11|600}} (about 1.83%) with Looting III

== Usage ==

=== Crafting ingredient ===

{{crafting usage}}

=== Trading ===
Apprentice-level Armorer, Toolsmith, and Weaponsmith [[Villager|villagers]] buy 3 iron ingots for an [[emerald]] as their third trade.{{only|bedrock}}

Apprentice-level Armorer villagers have a 50% chance to buy 4 iron ingots for one emerald, and apprentice-level Toolsmith and Weaponsmith villagers always offer to buy 4 iron ingots for one emerald.{{only|java}}

=== Repairing ===

Iron ingots are the repair items for the iron [[tier]] and chainmail and iron [[armor material]]s, and thus can be used to [[item repair|repair]] the following items in an [[anvil]]:
* {{ItemLink|Chainmail Helmet}}
* {{ItemLink|Chainmail Chestplate}}
* {{ItemLink|Chainmail Leggings}}
* {{ItemLink|Chainmail Boots}}
* {{ItemLink|Iron Helmet}}
* {{ItemLink|Iron Chestplate}}
* {{ItemLink|Iron Leggings}}
* {{ItemLink|Iron Boots}}
* {{ItemLink|Iron Sword}}
* {{ItemLink|Iron Axe}}
* {{ItemLink|Iron Pickaxe}}
* {{ItemLink|Iron Shovel}}
* {{ItemLink|Iron Hoe}}

=== Healing iron golems ===

{{control|Using}} an iron ingot on an [[iron golem]] restores its health by {{hp|25}}. 

=== Beacons ===

Iron ingots can be used to select powers from a [[beacon]]. The player must select one of the available powers, and then insert an iron ingot in the item slot. 

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

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

;Trim color palette
The following color palettes are shown on the designs on trimmed armor:
*{{TrimPalette|iron ingot}}
*{{TrimPalette|iron ingot|darker=1}} (a darker color palette is used when an iron armor piece is trimmed using an iron ingot).

== Achievements ==
{{load achievements|Acquire Hardware}}

== Advancements ==
{{load advancements|Acquire Hardware}}

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Iron Ingot
|spritetype=item
|nameid=iron_ingot
|id=305
|form=item
|foot=1}}

== History ==

{{History|java indev}}
{{History||0.31|snap=20100128|[[File:Iron Ingot JE1.png|32px]] Added iron ingots.}}
{{History|||snap=20100129|[[File:Iron Ingot JE2 BE1.png|32px]] The texture of iron ingots has been changed.
|Iron ingots can be [[smelting|smelted]] from [[iron ore]] and [[drops|drop]] 3–5 iron ingots. 
|Iron ingots can be used to craft [[iron block]]s, [[flint and steel]] and iron [[sword]]s, [[shovel]]s, [[pickaxe]]s and [[axe]]s.}}
{{History|||snap=20100130|Iron ingots are now used to craft [[arrow]]s.|[[Iron block]]s now require 9 iron ingots (3×3) instead 4 (2×2) to be [[crafting|crafted]], making them much more expensive.}}
{{History||20100206|Iron ingots can now be used to [[crafting|craft]] iron [[hoe]]s.}}
{{History||?|[[Smelting]] now [[drops]] only 1 iron ingot (down from 3–5).}}
{{History||20100218|Iron ingots are now used to craft iron [[helmet]]s, [[chestplate]]s, [[leggings]] and [[boots]].}}
{{History|java infdev}}
{{History||20100615|Iron ingots are now used to craft [[bucket]]s.}}
{{History||20100618|Iron ingots are now used to craft [[rail]]s and [[minecart]]s.}}
{{History||20100625-2|Iron ingots can be found in [[dungeon]] [[chest]]s.}}
{{History|java alpha}}
{{History||v1.0.1|Iron ingots are now used to [[crafting|craft]] iron [[door]]s.}}
{{History||v1.0.14|Iron ingots are no longer used to craft [[arrow]]s.}}
{{History||v1.1.0|Iron ingots are now used to craft [[compass]]es.}}
{{History|java beta}}
{{History||1.5|Iron ingots are now used to craft [[detector rail]]s.}}
{{History||1.7|Iron ingots are now used to craft [[piston]]s and [[shears]].}}
{{History||1.8|snap=Pre-release|Iron ingots are found in the new [[stronghold]] storeroom and [[mineshaft]] [[chest]]s.
|Iron ingots are now used to craft [[iron bars]].}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease 2|Iron ingots are now used to craft [[cauldron]]s.}}
{{History|||snap=Beta 1.9 Prerelease 3|Iron ingots are now found in the new stronghold altar [[chest]]s.}}
{{History||1.1|snap=12w01a|Iron ingots are now found in [[village]] blacksmith chests.}}
{{History||1.2.1|snap=12w06a|[[Zombie]]s now rarely [[drops|drop]] iron ingots, making it a [[renewable resource]].}}
{{History|||snap=12w08a|[[Iron golem]]s now drop 3–5 iron ingots.}}
{{History||1.3.1|snap=12w21a|Added [[desert temple]]s, with a hidden [[chest]] room and loot containing iron ingots.
|Blacksmith [[villager]]s now [[trading|buy]] 8–9 iron ingots for 1 [[emerald]].}}
{{History|||snap=12w22a|Added [[jungle temple]]s, which contain loot [[chest]]s with iron ingots.
|Iron ingots are now used to craft [[tripwire hook]]s.}}
{{History||1.4.2|snap=12w32a|Iron ingots can be used to activate [[beacon]]s.}}
{{History|||snap=12w41a|Iron ingots are now used to craft [[anvil]]s.}}
{{History|||snap=12w42a|Anvils now need 4 iron ingots to [[craft]] instead of 1.}}
{{History||1.5|snap=13w01a|Iron ingots are now used to [[crafting|craft]] heavy [[weighted pressure plate]]s.}}
{{History|||snap=13w02a|Iron ingots are now used to craft [[hopper]]s and [[activator rail]]s.}}
{{History||1.6.1|snap=13w16a|Iron ingot is now used to craft iron [[horse armor]] and [[horse saddle]].}}
{{History|||snap=13w18a|Iron ingot is no longer used to craft iron [[horse armor]] and [[horse saddle]].|Iron ingots are now found in [[nether fortress]] [[chest]]s.}}
{{History||1.8|snap=14w02a|[[Trading]] for iron ingots has been changed: armorer, weapon smith and tool smith [[villager]]s now [[trading|buy]] 7–9 iron ingots for 1 [[emerald]].}}
{{History|||snap=14w07a|Iron ingots are now used to craft [[iron trapdoor]]s.}}
{{History||1.9|snap=15w31a|Iron ingots are now found in [[end city]] ship [[chest]]s.}}
{{History|||snap=15w33c|Iron ingots are now used to craft [[shield]]s.}}
{{History|||snap=15w44a|The average yield from [[dungeon]] and [[desert temple]] chests has been substantially decreased. 
|The average yield from [[mineshaft]] and [[nether fortress]] chests has been slightly decreased.}}
{{History||1.11|snap=16w39a|Iron ingots are now found in the new [[woodland mansion]] chests.}}
{{History||1.11.1|snap=16w50a|Iron ingots are now used to craft [[iron nugget]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 265.}}
{{History|||snap=18w10a|Iron ingots now generate in [[buried treasure]] [[chest]]s.}}
{{History|||snap=18w11a|Iron ingots can now be found in the chests of [[shipwreck]]s.}}
{{History||1.14|snap=18w43a|Iron ingots can now be used to craft [[crossbow]]s.
|[[File:Iron Ingot JE3 BE2.png|32px]] The texture of iron ingots has been changed.}}
{{History|||snap=18w47a|Iron ingots can now be found inside of loot [[chest]]s on top of [[pillager outpost]]s.}}
{{History|||snap=18w50a|Iron ingots can now be found in chests in [[village]] toolsmith houses.
|Iron ingots can now be used to craft a [[blast furnace]].}}
{{History|||snap=19w04a|Iron ingots can now be used to craft [[stonecutter]]s.}}
{{History||1.15|snap=19w41a|Iron ingots can now be used to heal [[iron golem]]s.}}
{{History||1.16|snap=20w16a|Iron ingots now generate in [[bastion remnants]] chests.
|Iron ingots are now used to craft [[chain]]s.}}
{{History||1.16.2|snap=20w30a|The average yield of iron ingots from bastion remnant chests has been slightly increased.}}
{{History||1.17|snap=21w08a|Iron ingots can now be smelted from [[deepslate iron ore]].}}
{{History|||snap=21w14a|Iron ingots can now be smelted from [[raw iron]].}}
{{History||1.20<br>(Experimental)|link=1.19.4|snap=23w04a|Iron ingots can now be used as an armor trim material.}}
{{History|||snap=23w05a|Iron ingots can now be trimmed with iron [[armor]].}}

{{History|pocket alpha}}
{{History||v0.2.0|[[File:Iron Ingot JE2 BE1.png|32px]] Added iron ingots. They are currently unobtainable and serve no purpose.}}
{{History||v0.3.2|Iron ingots are now obtainable by [[smelting]] iron ore in a [[furnace]].
|Iron ingots can be used to craft [[shears]], [[blocks of iron]] and iron [[pickaxe]]s, [[axe]]s, [[sword]]s and [[shovel]]s.}}
{{History||v0.4.0|Iron ingots are now used to craft [[flint and steel]] and iron [[hoe]]s.}}
{{History||v0.5.0|Iron ingots are now used to craft [[nether reactor core]]s.}}
{{History||v0.6.0|Iron ingots are now used to craft iron [[armor]].}}
{{History||v0.7.0|Iron ingots are now used to craft [[bucket]]s.}}
{{History||v0.8.0|snap=build 1|Iron ingots are now used to craft [[compass]]es and [[iron bars]].}}
{{History|||snap=build 2|Iron ingots are now used to craft [[minecart]]s and [[rail]]s.}}
{{History||v0.9.0|snap=build 1|Iron ingots can now be found in [[village]] blacksmith [[chest]]s, [[stronghold]] altar chests and [[dungeon]] chests.
|[[Zombie]]s now rarely drop iron ingots.}}
{{History||v0.12.1|snap=build 1|Iron ingots are no longer used to craft [[nether reactor core]]s and are instead dropped by it.
|Iron ingots are now used to craft [[anvil]]s.
|Iron ingots are now found in [[nether fortress]] chests.
|Added [[iron golem]]s, which [[drops|drop]] iron ingots.
|Iron ingots can now be used to repair iron [[tool]]s, [[armor]] and [[weapon]]s in [[anvil]]s.
|Added [[zombie villager]]s, which rarely drop iron ingots.}}
{{History||v0.13.0|snap=build 1|Iron ingots are now used to craft [[tripwire hook]]s, [[detector rail]]s, [[iron trapdoor]]s and heavy [[weighted pressure plate]]s.
|Added [[desert temple]]s, which have hidden [[chest]] rooms and loot containing iron ingots.}}
{{History||v0.14.0|snap=build 1|Iron ingots are now used to craft [[hoppers]] and [[cauldron]]s.
|Iron ingots can now be found in [[minecart with chest|minecart chests]] generated in [[mineshaft]]s.}}
{{History||v0.15.0|snap=build 1|Iron ingots are now used to craft [[piston]]s.
|Added [[jungle temple]]s, which have hidden [[chest]] rooms and main treasure rooms that have loot containing iron ingots.
|Added [[husk]]s, which rarely [[drops|drop]] iron ingots.}}
{{History||v0.16.0|snap=build 4|Iron ingots can now be used to activate [[beacon]]s.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Iron ingots can now be found in [[end city]] ship [[chest]]s.
|Iron ingots can now be found in [[stronghold]] storeroom chests.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Added [[trading]]—armorer, weaponsmith and toolsmith [[villager]]s now [[trading|buy]] 7–9 iron ingots for 1 [[emerald]].}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron ingots can now be [[crafting|crafted]] using [[iron nugget]]s.
|Iron ingots can now be used to [[crafting|craft]] iron nuggets.
|Iron ingots can now be found in [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Iron ingots now generate in [[buried treasure]] [[chest]]s.
|Iron ingots can now be found in [[shipwreck]] treasure chests.}}
{{History||1.8.0|snap=beta 1.8.0.10|Iron ingots can now be used to craft [[crossbow]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|Iron ingots can now be found inside [[pillager outpost]]s and plains [[village]]s' weaponsmith chests.
|Iron ingots can now be used to craft [[blast furnace]]s, [[stonecutter]]s and [[shield]]s.
|[[File:Iron Ingot JE3 BE2.png|32px]] The texture of iron ingots has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Iron ingots can now be found in [[village]] armorer and toolsmith [[chest]]s.
|Iron ingots can now be found in [[savanna]], [[taiga]], [[desert]] and [[snowy taiga]] village weaponsmiths.}}
{{History|||snap=beta 1.11.0.4|Armorer, toolsmith, and weaponsmith [[villager]]s now [[trading|buy]] 4 iron ingots for an [[emerald]].}}
{{History||1.16.0|snap=beta 1.16.0.57|Iron ingots now generate in bastion remnants chests.}}
{{History||1.17.0|snap=beta 1.16.230.52|Iron ingots can now be smelted from [[deepslate iron ore]].}}
{{History|||snap=beta 1.17.0.50|Iron ingots can now be smelted from [[raw iron]].}}
{{History||1.18.10|snap=beta 1.18.10.26|Iron ingots can now be used to heal iron golems.}}
{{History||1.19.80|snap=beta 1.19.80.21|Iron ingots can now be used as an armor trim material.}}

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

{{History|new3DS}}
{{History||0.1.0|[[File:Iron Ingot JE2 BE1.png|32px]] Added iron ingots.}}
{{History|foot}}

== Issues ==

{{issue list}}

== Trivia ==

* To craft each recipe once, a player would need 152 iron ingots, including 27 for the iron blocks in an [[anvil]], while using the extra tripwire hook for the [[crossbow]] and the [[iron nuggets]] for the [[chain]].

== See also ==

* {{BlockLink|Block of Iron}}
* {{ItemSprite|Iron Chestplate}} [[Iron armor]]
* {{ItemLink|Iron Nugget}}
* {{BlockLink|Iron Ore}}
* [[Ores]]

== External links ==
* {{Mcnet|taking-inventory--iron-ignot|Taking Inventory: Iron Ingot}}

{{Items}}

[[cs:Železný ingot]]
[[de:Eisenbarren]]
[[es:Lingote de hierro]]
[[fr:Lingot de fer]]
[[hu:Vasrúd]]
[[it:Lingotto di ferro]]
[[ja:鉄インゴット]]
[[ko:철괴]]
[[nl:IJzerstaaf]]
[[pl:Sztabka żelaza]]
[[pt:Barra de ferro]]
[[ru:Железный слиток]]
[[uk:Залізний зливок]]
[[zh:铁锭]]
[[Category:Renewable resources]]</li></ul>
16w32aEnabled the use of block states in commands.
1.13
{{Extension DPL}}<ul><li>[[Horse Armor|Horse Armor]]<br/>{{Item
| image = <gallery>
Leather Horse Armor.png | Leather 
Iron Horse Armor.png | Iron
Golden Horse Armor.png | Golden
Diamond Horse Armor.png | Diamond
</gallery>
| image2 = <gallery>
Leather Horse Armor (item).png|Leather
Iron Horse Armor (item).png|Iron
Golden Horse Armor (item).png|Golden
Diamond Horse Armor (item).png|Diamond
</gallery>
| extratext = View [[#Gallery|all renders]]
| renewable = 
* '''Leather''': Yes
* '''All others''': No
| stackable = No
}}

'''Horse armor''' is a special type of [[armor]] that can be given to a [[horse]] to wear.

== Obtaining ==

===Chest loot===
{{LootChestItem|iron-horse-armor}}
{{LootChestItem|golden-horse-armor}}
{{LootChestItem|diamond-horse-armor}}

===Crafting===
{{crafting
|A1= Leather
|C1= Leather
|A2= Leather
|B2= Leather
|C2= Leather
|A3= Leather
|C3= Leather
|Output= Leather Horse Armor
|type=Miscellaneous
}}

Only leather horse armor can be crafted; other horse armor can be obtained only from chest loot from some generated structures.

===Trading===
Expert-level [[leatherworker]] villagers [[trading|sell]] leather horse armor for 6 [[emerald]]s as part of their trade.

==Usage==

Only normal adult horses can wear armor; foals, [[donkey]]s, [[mule]]s, and undead variants such as [[skeleton horse]]s and [[zombie horse]]s cannot be equipped with armor.

=== Types ===
Horse armor has leather, iron, gold, and diamond variants. However, horse armor does not have netherite or chainmail variants.

=== Armor Stands ===
Horse armor cannot be placed or displayed on [[armor stand]]s. 

===Protection===
Horse armor can be equipped to horses either by manually placing it in its respective slot by pressing E while riding the horse ({{SlotSprite|Horse Armor}}), or by right-clicking the horse with it.

There is a gradual increase in the defense given from a horse wearing the different types of armor. Note that golden horse armor provides more protection than iron horse armor, whereas the opposite is true for [[armor|player armor]].
{| class="wikitable" data-description="Armor defense"
|-
! Material !! [[Armor]]
|-
! [[Leather]]
| {{armor|3}} 
|-
! [[Iron]]
| {{armor|5}} 
|-
! [[Gold]]
| {{armor|7}} 
|-
! [[Diamond]]
| {{armor|11}} 
|}
When a horse dies while equipped with any horse armor, it drops its normal loot, saddle (if it had one), and the horse armor.

Leather horse armor protects horses from freezing in [[powder snow]], but it does not negate other powder snow effects (e.g., falling through, inability to jump).

===Durability===
Unlike [[armor|player armor]], horse armor does not have durability. This means a single horse armor can be used infinitely unless destroyed.
=== Enchanting ===
Unlike [[armor|player armor]], horse armor cannot be enchanted in survival mode. However, {{in|java}} Creative mode, horse armor can be used with an [[anvil]] to enchant with [[Depth Strider]], [[Thorns]], [[Respiration]], [[Feather Falling]], and [[Curse of vanishing]]. Other enchantments can be applied, but they have no effect.

=== Dyeing ===
Leather horse armor can be dyed 12,326,391 different colors (using lone dyes or dye combinations) and put onto a horse to display that color. These changes can be reverted by {{control|using}} a filled [[cauldron]] with dyed leather horse armor.

===Smelting usage===
{{Smelting|showname=1|Iron Horse Armor;Golden Horse Armor|Iron Nugget;Gold Nugget|0,1}}

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

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Horse armor.ogg
|subtitle=Horse armor equips
|source=neutral
|description=When armor is equipped to a horse
|id=entity.horse.armor
|translationkey=subtitles.entity.horse.armor
|volume=0.5
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Horse armor.ogg
|source=neutral
|description=When armor is equipped to a horse
|id=mob.horse.armor
|volume=0.6
|pitch=1.0
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|showforms=y
|generatetranslationkeys=y
|displayname=Leather Horse Armor
|spritetype=item
|nameid=leather_horse_armor
|form=item}}
{{ID table
|displayname=Iron Horse Armor
|spritetype=item
|nameid=iron_horse_armor
|form=item}}
{{ID table
|displayname=Diamond Horse Armor
|spritetype=item
|nameid=diamond_horse_armor
|form=item}}
{{ID table
|displayname=Golden Horse Armor
|spritetype=item
|nameid=golden_horse_armor
|form=item
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|showaliasids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leather Horse Armor
|spritetype=item
|nameid=leather_horse_armor
|aliasid=horsearmorleather
|id=530
|form=item
|translationkey=item.horsearmorleather.name}}
{{ID table
|displayname=Iron Horse Armor
|spritetype=item
|nameid=iron_horse_armor
|aliasid=horsearmoriron
|id=531
|form=item
|translationkey=item.horsearmoriron.name}}
{{ID table
|displayname=Diamond Horse Armor
|spritetype=item
|nameid=diamond_horse_armor
|aliasid=horsearmordiamond
|id=533
|form=item
|translationkey=item.horsearmordiamond.name}}
{{ID table
|displayname=Golden Horse Armor
|spritetype=item
|nameid=golden_horse_armor
|aliasid=horsearmorgold
|id=532
|form=item
|translationkey=item.horsearmorgold.name
|foot=1}}

=== Item data ===
When leather horse armor is dyed, it has the following NBT:

{{el|java}}:
{{main|Player.dat format}}
<div class="treeview">
* {{nbt|compound|tag}}: Parent tag.
** {{nbt|compound|display}}: Display properties.
*** {{nbt|int|color}}: The color of the leather armor. The tooltip displays "Dyed" if advanced tooltips are disabled, otherwise it displays the hexadecimal color value. Color codes are calculated from the Red, Green and Blue components using this formula:<br>'''<span style="color:red">Red</span>[[wikipedia:Logical shift|<<]]16 + <span style="color:green">Green</span><<8 + <span style="color:blue">Blue</span>'''<ref>For positive values larger than 0x00FFFFFF, the top byte is ignored. All negative values produce white.</ref>
</div>

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

== History ==
{{History|java}}
{{History||1.6.1|snap=13w16a|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.
|Horse armor can be [[crafting|crafted]] using the following recipe.
{{{!}} class{{=}}"collapsible collapsed"
! Recipe
{{!}}-
{{!}}
{{Crafting Table
  |C1=Iron Ingot; Gold Ingot; Diamond
  |A2=Iron Ingot; Gold Ingot; Diamond 
  |B2=Any Wool
  |C2=Iron Ingot; Gold Ingot; Diamond
  |A3=Iron Ingot; Gold Ingot; Diamond
  |B3=Iron Ingot; Gold Ingot; Diamond
  |C3=Iron Ingot; Gold Ingot; Diamond
  |Output=Iron Horse Armor; Golden Horse Armor; Diamond Horse Armor
}}
{{!}}}
}}
{{History|||snap=13w18a|The crafting recipe for horse armor has been removed.
|Horse armor can now be found in [[chest]]s in [[jungle temple|jungle]] & [[desert temple]]s, [[dungeon]]s, [[nether fortress]]es, [[stronghold]] altar rooms and [[village]] blacksmith buildings.
|Iron horse armor can now additionally be found in [[mineshaft]] chests.}}
{{History|||snap=13w21a|Horse armor is no longer stackable, to be consistent with other types of [[armor]].}}
{{History||1.9|snap=15w31a|Horse armor has been added to [[end city]] [[chest]]s.}}
{{History|||snap=15w43a|The average yield of horse armor in [[nether fortress]] chests has slightly decreased.}}
{{History|||snap=15w44a|The average yield of horse armor in [[desert temple]] chests has increased.
|The average yield of iron horse armor from [[dungeon]] chests has slightly decreased.
|Iron horse armor has been removed from [[mineshaft]] [[chest]]s.}}
{{History||1.11.1|snap=16w50a|Golden and iron horse armor can now be [[smelting|smelted]] down into one of their respective [[nugget]]s.}}
{{History||1.13|snap=17w45a|[[File:Iron Horse Armor JE2.png|32px]] [[File:Golden Horse Armor JE2.png|32px]] [[File:Diamond Horse Armor JE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}}
{{History|||snap=17w46a|[[File:Iron Horse Armor 17w46a.png|32px]] [[File:Golden Horse Armor 17w46a.png|32px]] [[File:Diamond Horse Armor 17w46a.png|32px]] The model of horse armor has been changed, but the textures of horse armor have remained unaltered.}}
{{History|||snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], these [[item]]s' numeral IDs were 417, 418 and 419.}}
{{History|||snap=18w03a|[[File:Iron Horse Armor JE3.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has changed.}}
{{History|||snap=18w22a|[[File:Iron Horse Armor JE4 BE2.png|32px]] The texture of iron horse armor when equipped has been changed.<ref>{{bug|MC-124357}}</ref>}}
{{History|||snap=pre2|A bug with the [[horse]] skin and horse armor textures not applying correctly has been fixed.<ref>{{bug|MC-124364}}</ref>}}
{{History||1.14|snap=18w50a|[[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of horse armor [[item]]s have been changed.}}
{{History|||snap=February 20, 2019|slink=https://twitter.com/_LadyAgnes/status/1098134917299531776?s=19|Leather horse armor announced for {{el|je}}.}}
{{History|||snap=19w08a|[[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of iron, gold and diamond horse armor have been changed.
|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Leather Horse Armor (item) JE1.png|32px]] Added leather horse armor, which can be [[dyeing|dyed]] 12,326,391 different colors, similar to leather [[armor]].}}
{{History|||snap=19w11a|Leatherworker [[villager]]s now [[trading|sell]] leather horse armor.}}
{{History||1.14.1|snap=Pre-Release 1|[[File:Leather Horse Armor (item) JE2.png|32px]] The texture of leather horse armor [[item]] has been changed to be more consistent with the other types of horse armor.
|[[File:Iron Horse Armor (item) JE4 BE3.png|32px]] The texture of iron horse armor item has been changed.}}
{{History||1.16|snap=20w15a|Horse armor placed in a dispenser can now be put on tamed horses.}}
{{History|||snap=20w16a|Golden horse armor now generates in [[ruined portal]] chests.}}
{{History||1.17|snap=21w13a|Leather horse armor now protects [[horse]]s from [[freezing]].}}
{{History||1.19|snap=22w13a|Diamond horse armor may now be found in [[ancient city]] [[chest]]s.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor and [[dyeing|dyeable]] leather horse armor as a version exclusive.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Horse armor can now be found inside [[end city]] [[chest]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Iron and golden horse armor are now [[smelting|smeltable]].}}
{{History|bedrock}}
{{History||1.2.6|snap=beta 1.2.6.2|[[File:Leather Horse Armor BE2.png|32px]] [[File:Iron Horse Armor JE4 BE2.png|32px]] [[File:Golden Horse Armor JE3 BE2.png|32px]] [[File:Diamond Horse Armor JE3 BE2.png|32px]] The textures of horse armor have been changed, as the [[model]] of [[horse]]s has been changed.}}
{{History||1.10.0|snap=beta 1.10.0.3|Horse armor can now be found in [[plains]] [[village]] weaponsmith [[chest]]s.
|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE2.png|32px]] [[File:Iron Horse Armor (item) JE2 BE2.png|32px]] [[File:Golden Horse Armor (item) JE2 BE2.png|32px]] [[File:Diamond Horse Armor (item) JE2 BE2.png|32px]] The textures of all horse armor have been changed.}}
{{History||1.11.0|snap=beta 1.11.0.1|Horse armor can now be found in [[savanna]], [[desert]], [[taiga]], [[snowy taiga]] and [[snowy tundra]] [[village]] weaponsmith [[chest]]s.}}
{{History|||snap=beta 1.11.0.4|Leather horse armor can now be [[trading|bought]] from leatherworker [[villager]]s.}}
{{History|||snap=beta 1.11.0.5|[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE4 BE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of all horse armor [[item]]s have been changed.}}
{{History||1.17.0|snap=beta 1.16.230.54|Leather horse armor now protects [[horse]]s from [[freezing]].}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}}
{{History||xbox=TU53|xbone=CU43|ps=1.49|wiiu=Patch 23|switch=1.0.3|Iron and golden horse armor are now [[smelting|smeltable]].}}
{{History||xbox=TU60|xbone=CU51|ps=1.64|wiiu=Patch 30|switch=1.0.11|[[File:Leather Horse Armor BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] Added leather horse armor.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Leather Horse Armor JE1 BE3.png|32px]] [[File:Iron Horse Armor JE5 BE3.png|32px]] [[File:Golden Horse Armor JE4 BE3.png|32px]] [[File:Diamond Horse Armor JE4 BE3.png|32px]]<br>[[File:Leather Horse Armor (item) BE3.png|32px]] [[File:Iron Horse Armor (item) JE3.png|32px]] [[File:Golden Horse Armor (item) JE3 BE3.png|32px]] [[File:Diamond Horse Armor (item) JE3 BE3.png|32px]] The textures of leather, iron, gold and diamond horse armor have been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Leather Horse Armor BE1.png|32px]] [[File:Iron Horse Armor JE1 BE1.png|32px]] [[File:Golden Horse Armor JE1 BE1.png|32px]] [[File:Diamond Horse Armor JE1 BE1.png|32px]]<br>[[File:Leather Horse Armor (item) BE1.png|32px]] [[File:Iron Horse Armor (item) JE1 BE1.png|32px]] [[File:Golden Horse Armor (item) JE1 BE1.png|32px]] [[File:Diamond Horse Armor (item) JE1 BE1.png|32px]] Added horse armor.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Gallery ==
<gallery>
Leather Horse Armor.png | Undyed Leather armor
White Leather Horse Armor.png | White Leather armor
Light Gray Leather Horse Armor.png | Light Gray Leather armor
Gray Leather Horse Armor.png | Gray Leather armor
Black Leather Horse Armor.png | Black Leather armor
Brown Leather Horse Armor.png | Brown Leather armor
Red Leather Horse Armor.png | Red Leather armor
Orange Leather Horse Armor.png | Orange Leather armor
Yellow Leather Horse Armor.png | Yellow Leather armor
Lime Leather Horse Armor.png | Lime Leather armor
Green Leather Horse Armor.png | Green Leather armor
Cyan Leather Horse Armor.png | Cyan Leather armor
Light Blue Leather Horse Armor.png | Light Blue Leather armor
Blue Leather Horse Armor.png | Blue Leather armor
Purple Leather Horse Armor.png | Purple Leather armor
Magenta Leather Horse Armor.png | Magenta Leather armor
Pink Leather Horse Armor.png | Pink Leather armor
</gallery>

=== Screenshots ===
<gallery>
Armored Horse.png|A [[horse]] equipped with iron horse armor and bound to a fence post by a [[lead]].
13w21a-new-HorseUI-inventory.png|The GUI for horses implemented in [[Java Edition 13w21a|13w21a]], which allows the removal and switching of armor.
GodSpawner.png|A golden horse armor found in a [[dungeon]] chest, which coincidentally contains an [[enchanted golden apple]].
Horses with armor.png|4 [[horse]]s equipped with [[leather]], [[iron]], [[gold]], and [[diamond]] armor.
Leather Horse Armor 1.jpg|First image of leather horse armor.
Leather Horse Armor 2.jpg|Second image of leather horse armor.
Leather Horse Armor 3.jpg|Third image of leather horse armor.
Leather Horse Armor 4.jpg|Fourth image of leather horse armor.
Leather Horse Armor 5.jpg|Fifth image of leather horse armor.
</gallery>

== Notes ==
{{Notelist}}

== References ==
{{Reflist}}

{{items}}

[[Category:Armor]]

[[de:Rossharnisch]]
[[es:Armadura para caballo]]
[[fr:Armure pour cheval]]
[[it:Bardatura]]
[[ja:馬鎧]]
[[ko:말 갑옷]]
[[nl:Paardenharnas]]
[[pl:Zbroja końska]]
[[pt:Armadura para cavalo]]
[[ru:Конская броня]]
[[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>
17w47aMany block states got added, changed and removed due to the Flattening.
Added the debug stick, which is an item used to edit the block states of blocks.
Advertisement