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

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.

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.


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.


Beetroot

Beetroot/BS

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.

Button

minecraft:stone_button
minecraft:wooden_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.

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.

Carpet

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
color
(Deprecated)
0x1
0x2
0x4
0x8
white white0
orange1
magenta2
light_blue3
yellow4
lime5
pink6
gray7
silver8
cyan9
purple10
blue11
brown12
green13
red14
black15

Carrot

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.

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.

Chest, Ender Chest and 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.

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

Cobblestone Wall and Mossy Cobblestone Wall

Cobblestone Wall/BS

Cocoa

Cocoa/BS

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

Daylight Sensor

minecraft:daylight_detector
minecraft:daylight_detector_inverted

Daylight Sensor/BS

Dirt

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
dirt_type0x1normal normal0Dirt
coarse1Coarse Dirt

Dispenser

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.

Door

minecraft:wooden_door
minecraft:iron_door
minecraft:spruce_door
minecraft:birch_door
minecraft:jungle_door
minecraft:acacia_door
minecraft: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.

Dropper

Dropper/BS

End Portal

End Portal (block)/BS

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.

Fence

minecraft:fence
minecraft:spruce_fence
minecraft:birch_fence
minecraft:jungle_fence
minecraft:acacia_fence
minecraft:dark_oak_fence
minecraft: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 Gate

minecraft:fence_gate
minecraft:spruce_fence_gate
minecraft:birch_fence_gate
minecraft:jungle_fence_gate
minecraft:acacia_fence_gate
minecraft: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.

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.

Flower Pot

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
update_bit0x1falsefalse
true
0
1
  • false: Empty flower pot.
  • true: Flower pot with contents.

Furnace

minecraft:furnace
minecraft:lit_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 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

Grass

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.

Grass Block

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.

Hay Block

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.

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.

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

Lava and Flowing 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

minecraft: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.
minecraft:leaves2

Leaves/BS2

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.

Melon Stem

Melon Stem/BS

Monster Egg

Monster Egg/BS

Mushroom (block)

minecraft:brown_mushroom_block
minecraft:red_mushroom_block

Mushroom (block)/BS

Mycelium

Mycelium/BS

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

Pistons and Sticky Pistons

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

minecraft:piston_head

Piston Head/BS

minecraft:piston_extension

Piston Extension/BS

Portal

Nether Portal/BS

Potato

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 Plate

minecraft:stone_pressure_plate
minecraft:wooden_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.

Prismarine

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
prismarine_block_type0x1
0x2
default bricks2 Prismarine Bricks
dark1 Dark Prismarine
default0 Prismarine

Pumpkin

minecraft: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.


Pumpkin Stem

Pumpkin Stem/BS

Purpur 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.

Quartz

Block of Quartz/BS

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

Red Sandstone

Sandstone/BS2

Redstone Comparator

minecraft:powered_comparator
minecraft:unpowered_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

Redstone/BS

Redstone Repeater

minecraft:powered_repeater
minecraft:unpowered_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 and 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.[2]
unknown0Unused

Sand

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
sand_type0x1normal normal0Sand
red1Red Sand

Sandstone

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
sand_stone_type0x1
0x2
default default0Sandstone
heiroglyphs1Chiseled Sandstone
cut2Cut Sandstone
smooth3Smooth Sandstone

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

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.


Skull

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.

Slabs

minecraft:stone_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.

minecraft:stone_slab2

Slab/BS2

minecraft:wooden_slab

Slab/BS3

minecraft:purpur_slab

Slab/BS8

minecraft:double_stone_slab

Slab/BS4

minecraft:double_stone_slab2

Slab/BS5

minecraft:double_wooden_slab

Slab/BS6

minecraft:purpur_double_slab

Slab/BS7

Snow (layer)

Snow (layer)/BS

Sponge

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
sponge_type0x1dry dry0Sponge
wet1Wet Sponge

Stained Clay

Stained Clay/BS

Stained Glass

Stained Glass/BS

Stained Glass Pane

Stained Glass Pane/BS

Stairs

These block states are used by blocks identified by the following ID names:

  • minecraft:acacia_stairs
  • minecraft:birch_stairs
  • minecraft:brick_stairs
  • minecraft:dark_oak_stairs
  • minecraft:jungle_stairs
  • minecraft:nether_brick_stairs
  • minecraft:oak_stairs
  • minecraft:purpur_stairs
  • minecraft:quartz_stairs
  • minecraft:red_sandstone_stairs
  • minecraft:sandstone_stairs
  • minecraft:spruce_stairs
  • minecraft:stone_brick_stairs
  • minecraft:stone_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

Stone

Bedrock Edition:

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
stone_type0x1
0x2
0x4
stone stone0Stone
granite1Granite
granite_smooth2Polished Granite
diorite3Diorite
diorite_smooth4Polished Diorite
andesite5Andesite
andesite_smooth6Polished Andesite

Stone Bricks

Bedrock Edition

NameMetadata Bits Default value Allowed valuesValues for
Metadata Bits
Description
stone_brick_type0x1
0x2
0x4
default default0 Stone Bricks
mossy1 Mossy Stone Bricks
cracked2 Cracked Stone Bricks
chiseled3 Chiseled Stone Bricks
smooth4 Smooth Stone Bricks (same texture as regular ones)

Structure Block

[upcoming]

Name Default value Allowed values Description
modesave Save Structure Blockload
Load Structure Blockcorner
Corner Structure Blockdata
Data Structure Block

Sugar Canes

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.

Tall Grass and Flowers

Grass/DoubleTall/BS

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.


Trapdoor

minecraft:trapdoor
minecraft:iron_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.

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.

Water and Flowing 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.

Weighted Pressure Plate

minecraft:heavy_weighted_pressure_plate
minecraft:light_weighted_pressure_plate

Weighted Pressure Plate/BS

Wheat

Wheat/BS

Wood

minecraft:log

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.

minecraft:log2

Wood/BS2

Wood Planks

Wood Planks/BS

Wool

Wool/BS

History

r
1.8
{{Extension DPL}}<ul><li>[[Lead|Lead]]<br/>{{About|the item used for leashing and leading mobs|the element|Element#Lead}}
{{Item
| image = Lead.png
| stackable = Yes (64)
| renewable = Yes
}}
'''Leads''' are [[tool]]s used to leash and lead passive and neutral [[animal]]s, [[golem]]s and some [[monster]]s.

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

=== Crafting ===
{{Crafting
  |A1= String
  |B1= String    
  |A2= String
  |B2= Slimeball
  |C3= String
  |Output= Lead,2
  |type= Tool
}}

=== Mob loot ===
[[Wandering Trader|Wandering trader]]s always spawn with 2 [[llama|trader llama]]s, each held with a lead. When a trader llama is detached, either by killing it or the wandering trader, dragging them far apart, or putting the llama in a [[boat]] or a [[minecart]], the lead drops at the llama's position.

== Usage ==
=== Crafting ingredient ===

{{crafting usage}}

=== Leashing mobs ===
[[File:SuspendedPigs.png|190px|thumb|One block tall mobs, such as pigs, suspend at 7 blocks above the ground.]]
[[File:SuspendedCows.png|190px|thumb|Two block tall mobs, such as cows, also suspend at 7 blocks above the ground.]]

{{control|Using}} a lead on a [[mob]] ties the lead to the mob, allowing it to be moved by the player. Multiple mobs can be held by leads at once, but each mob held requires its own lead.

It is possible to leash the following mobs and other entities:

{{columns-list|colwidth=20em|
* {{EntityLink|Allay}}
* {{EntityLink|Axolotl}}
* {{EntityLink|Bee}}
* {{EntityLink|Boat}}{{only|bedrock}}
* {{EntityLink|Camel}}
* {{EntityLink|Cat}}
* {{EntityLink|Chicken}}
* {{EntityLink|Chicken Jockey}} (only the mount)
* {{EntityLink|Cow}}
* {{EntityLink|Dolphin}}
* {{EntityLink|Donkey}}
* {{EntityLink|Fox}}
* {{EntityLink|Frog}}
* {{EntityLink|Glow Squid}}
* {{EntityLink|Goat}}
* {{EntityLink|Hoglin}}
* {{EntityLink|Horse}}
* {{EntityLink|Iron Golem}}
* {{EntityLink|Llama}}
* {{EntityLink|Mooshroom}}
* {{EntityLink|Mule}}
* {{EntityLink|Ocelot}}
* {{EntityLink|Parrot}}
* {{EntityLink|Pig}}
* {{EntityLink|Polar Bear}}
* {{EntityLink|Rabbit}}
* {{EntityLink|Sheep}}
* {{EntityLink|Skeleton Horse}}
* {{EntityLink|Skeleton Horseman}} (only the mount)
* {{EntityLink|Sniffer}}
* {{EntityLink|Snow Golem}}
* {{EntityLink|Squid}}
* {{EntityLink|Strider}}
* {{EntityLink|Trader Llama}}
* {{EntityLink|Wolf}}
* {{EntityLink|Zoglin}}
* {{EntityLink|Zombie Horse}}}}

Additionally, [[villager]]s, [[wandering trader]]s, and [[monster]]s other than the ones listed above, can be leashed using a map editor or [[NBT]] editor. 

With a mob on a lead held by the player, {{control|using}} the lead on any type of [[fence]] (or [[wall]]{{only|bedrock|short=1}}) attaches the lead to it with a visible knot, tying the mob to it. To attach it to a wall on Bedrock Edition, the player must hold a lead in the main hand.<ref>{{bug|MCPE-108078}}</ref> Multiple leads may be attached to one fence post. A mob tied to a fence tends to stay within 5 blocks of the fence post.

A lead is broken by pressing the {{control|use item}} control on the mob again, hitting the knot, or removing the attached fence post. Leads also break when hit by projectiles. Whenever a lead is removed or broken, it drops as an [[item (entity)|item]] at the location of the mob. However, it does not drop when unleashed in Creative mode.{{only|java}}<ref>{{bug|MCPE-79639}}</ref> A lead does not break if the attached animal dies.

A lead can stretch a maximum of 10 blocks. If the mob is able to move towards the player or fence post, it does so. If not, or if the mob is moving very quickly away from the player, the lead breaks.

When the player or the knot is more than 7 blocks above the ground, the mob being leashed becomes suspended.

Most mobs that can be leashed can still be leashed even if attacking the player leashing them, and any attached leads do not break.

[[Wolf|Wolves]] cannot be leashed after becoming angry. Despite this, if they become angry while already leashed, the lead does not break, but it cannot be reattached when broken through other methods while the wolf is still angry.

A lead attached to a hoglin breaks if it becomes a [[zoglin]].

A lead does not prevent mobs from despawning if they normally would despawn.

When moving downwards and accelerating towards the ground, leashed mobs accumulate fall damage and take it if they hit the ground while still accelerating. When moving up or decelerating (such as when the lead is stretched to its limit), the fall distance is set to one block and the mob therefore does not take any fall damage if it touches the ground.

If the player walks into and back out of a [[nether portal]] while holding a lead connected to a mob, the lead remains attached to the mob. However, if a mob attached to a lead walks into a nether portal, the lead breaks and drops as an item in the other dimension.

A lead can be used to remove a mob from a boat without needing to break the boat, if the mob can normally be leashed.

If a chunk unloads while containing a leashed mob (either by the player walking too far away, or traveling to another dimension via a portal), the lead breaks and drops as an item, leaving the mob free to wander around.

== Sounds ==
{{Edition|Java}}:
{{Sound table
|sound=Lead Knot break1.ogg
|sound2=Lead Knot break2.ogg
|sound3=Lead Knot break3.ogg
|subtitle=Leash Knot breaks
|source=neutral
|description=When a leash knot is destroyed
|id=entity.leash_knot.break
|translationkey=subtitles.entity.leashknot.break
|volume=1.0
|pitch=1.0
|distance=16}}
{{Sound table
|sound=Lead Knot place1.ogg
|sound2=Lead Knot place2.ogg
|sound3=Lead Knot place3.ogg
|subtitle=Leash Knot tied
|source=neutral
|description=When a leash knot is placed on a fence
|id=entity.leash_knot.place
|translationkey=subtitles.entity.leashknot.place
|volume=1.0
|pitch=1.0
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Lead Knot break1.ogg
|sound2=Lead Knot break2.ogg
|sound3=Lead Knot break3.ogg
|source=neutral
|description=When a leash knot is broken by {{ctrl|interacting}} with it
|id=leashknot.break
|volume=1.0
|pitch=1.0}}
{{Sound table
|sound=Lead Knot place1.ogg
|sound2=Lead Knot place2.ogg
|sound3=Lead Knot place3.ogg
|source=neutral
|description=When a leash knot is placed on a fence or wall
|id=leashknot.place
|volume=1.0
|pitch=1.0
|foot=1}}

== Leash Knot ==
'''Leash knot''' is an entity created when the [[player]] right-clicks the fence while having a mob leashed.
{{Entity| title = Leash Knot| image = Knot.png|imagesize= 100px|networkid='''[[JE]]''': 77}}
=== Data values ===
==== ID ====
{{edition|java}}:
{{ID table
|edition=java
|generatetranslationkeys=y
|displayname=Leash Knot
|spritetype=entity
|nameid=leash_knot
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Leash Knot
|spritetype=entity
|nameid=leash_knot
|id=88
|foot=1}}

==== Entity data ====

Leash knots have entity data that define various properties of the entity.

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

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

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

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Lead
|spritetype=item
|nameid=lead
|id=547
|form=item
|foot=1}}

== Achievements ==

{{load achievements|So I Got That Going for Me}}

== Advancements ==

{{load advancements|When the Squad Hops into Town}}

== History ==
{{missing information|The history of a lot of mobs be leashed}}
{{History|java}}
{{History||1.6.1|snap=13w16a|[[File:Lead JE1 BE1.png|32px]] Added leads. 
|Leads do not currently have a tooltip and are called “leashes” in [http://www.mojang.com/2013/04/minecraft-snapshot-13w16a-and-new-launcher/ the change notes].}}
{{History|||snap=13w16b|Leads have been given a tooltip.}}
{{History|||snap=13w18a|Leads have been given a [[crafting]] recipe.}}
{{History||1.9|snap=15w50a|Added a [[sound]] for leads: <code>entity.leashknot.place</code>.}}
{{History||1.11|snap=16w32a|The [[entity]] ID of the knot has been changed from <code>LeashKnot</code> to <code>leash_knot</code>.}}
{{History|||snap=16w39a|Leads can now be found in [[woodland mansion]] chests.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 420.}}
{{History||1.14|snap=18w43a|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.}}
{{History|||snap=19w05a|Added [[wandering trader]]s, which are naturally equipped with leads.}}
{{History||1.15|snap=?|[[Bee]]s can now be leashed.}}
{{History||1.16|snap=20w09a|[[Skeleton horse]]s and [[zombie horse]]s can now be leashed.<ref>{{bug|MC-166246}}</ref>}}
{{History|||snap=?|[[Hoglin]]s can now be leashed.}}
{{History||1.16.2|snap=20w27a|[[Zoglin]]s can now be leashed.}}
{{History||1.17|snap=21w19a|[[Squid]]s and [[glow squid]]s can now be leashed.<ref>{{bug|MC-136647}}</ref>}}
{{History|||snap=?|[[Axolotl]]s can now be leashed.}}
{{History||1.19|snap=22w13a|Lead may now be found in [[ancient city]] [[chest]]s.}}
{{History|||snap=?|[[Frog]]s can now be leashed.}}
{{History||1.19.3|snap=22w42a|[[Camel]]s can now be leashed.|Mobs no longer accumulate fall damage when dangling on leads.<ref>{{bug|MC-14167||Mobs build up fall damage when dangling on a lead|Fixed}}</ref>}}
{{History||1.20 (Experimental)|link=1.19.4|snap=?|[[Sniffer]]s can now be leashed.}}
{{History||1.20|snap=23w12a|Lead can now be found in [[suspicious gravel]] and [[suspicious sand]] in [[trail ruins]].}}
{{History|||snap=23w16a|Lead no longer generates in [[suspicious sand]] in [[trail ruins]].|Due to the split of the archaeological loot tables for the suspicious gravel within the [[trail ruins]]; lead now is in the common loot.}}

{{History|pocket alpha}}
{{History||v0.15.0|snap=build 1|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History|pocket}}
{{History||1.1.0|snap=alpha 1.1.0.0|Leads now have better "physics".
|The [[entity]] ID of the knot has been changed from <code>leashknot</code> to <code>leash_knot</code>.
|Leads can now be found inside [[woodland mansion]] [[chest]]s.}}
{{History|bedrock}}
{{History||1.4.0|snap=beta 1.2.14.2|Leads can now be found inside [[buried treasure]] [[chest]]s.
|Leads can now be used on [[boat]]s.}}
{{History||1.4.0|snap=beta 1.2.20.1|Leads can now be used to craft [[balloon]]s.}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.
|[[Wandering trader]]s now [[drops|drop]] leads after they are detached from trader [[llama]]s.}}
{{History||1.14.0|snap=beta 1.14.0.1|Leads can now be used on [[polar bear]]s, [[ocelot]]s, [[parrot]]s, [[dolphin]]s and old [[villager]]s.}}
{{History||1.19.0|snap=beta 1.19.0.20|Allays can now be leashed.}}

{{History|console}}
{{History||xbox=TU19|xbone=CU7|ps=1.12|wiiu=Patch 1|switch=1.0.1|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History||xbox=TU43|xbone=CU33|ps=1.36|wiiu=Patch 13|[[Sound]]s have been added for leads.}}
{{History|Ps4}}
{{History||1.90|[[File:Lead JE2 BE2.png|32px]] The texture of leads has been changed.}}

{{History|3ds}}
{{History||0.1.0|[[File:Lead JE1 BE1.png|32px]] Added leads.}}
{{History|foot}}

== Issues ==
{{issue list|Lead|Leash}}

== Trivia ==
[[File:Steve wearing Lead.png|100px]] [[File:Alex wearing Lead.png|100px]]
* The lead is named as "leash" in the texture file.
* If a [[player]] goes to sleep while holding a mob on a lead, the lead remains attached.
* {{IN|Java}}, when using the {{cmd|item}} command to put a lead in a player's head slot, the item gets rotated and positioned in such a way that it looks like the player is wearing a monocle.

== Gallery ==
<gallery>
Multiple_Leash.png|Many animals can be tied to one fence post.
HorseLeashedOnAFence.png|A [[horse]] wearing [[golden horse armor]] that is leashed to a fence post.
ThreeTiedSheep.png|Three sheep tied to the same fence.
More accurate lead mobs.png|A shot of all the mobs that could be tied with leads as of 1.6.1, except donkeys and mules.
Yo Yo.png|With the use of the leash, it is possible to suspend animals in the air by tying the leash on high-up fence posts.
YoYo.png|A [[donkey]] with the Grumm/Dinnerbone [[name tag]] [[easter egg]] tied to a fence with a lead to make a yo-yo.
Flying_Sheep.png|Several [[sheep]] hanging in the air in [[Creative]] mode.
Pocket Edition Lead.jpg|First image of a lead in ''Bedrock Edition''.
</gallery>

== References ==
{{Reflist}}

== External Links ==
*[https://www.minecraft.net/en-us/article/taking-inventory-lead Taking Inventory: Lead] – Minecraft.net on April 8, 2022

{{items}}

{{entities}}

[[Category:Tools]]

[[de:Leine]]
[[es:Rienda]]
[[fr:Laisse]]
[[hu:Lasszó]]
[[it:Guinzaglio]]
[[ja:リード]]
[[ko:끈]]
[[nl:Leidtouw]]
[[pl:Smycz]]
[[pt:Laço]]
[[ru:Поводок]]
[[th:เชือกจูง]]
[[zh:拴绳]]
[[Category:Renewable resources]]</li><li>[[Ender Pearl|Ender Pearl]]<br/>{{Update|[[game rule]] <code>enderPearlsVanishOnDeath</code>}}
{{ItemEntity
|image=Ender Pearl.png
|renewable=Yes
|stackable=Yes (16)
|size=Height: 0.25 Blocks<br>Width: 0.25 Blocks
}}
An '''ender pearl''' is an [[item]] that can be thrown to [[teleport]] to where it lands, or used to craft [[eye of ender|eyes of ender]] which are required to access [[the End]].

== Obtaining ==
=== Mob loot ===
An [[enderman]] has a 50% chance to drop 1 ender pearl when killed. The drop is increased by 1 per level of [[Looting]], with a maximum of 4 with Looting III.

=== Chest loot ===
{{LootChestItem|ender-pearl}}

A [[trapped chest]] always containing 2 ender pearls can be found in the "fake end portal" room of [[woodland mansion]]s.

=== Trading ===
{{IN|java}}, expert-level [[Trading#Cleric|cleric villagers]] have a {{frac|2|3}} chance to sell an ender pearl for 5 [[emerald]]s.

{{IN|bedrock}}, expert-level cleric villagers sell one ender pearl for 5 emeralds.

=== Bartering ===
[[Piglin]]s have a {{frac|10|459}} (2.18%) chance to [[barter]] 2–4 ender pearls when given a [[gold ingot]].

== Usage ==
Ender pearls can be thrown by pressing {{control|use}}. After it is thrown, the ender pearl is consumed, and the player teleports to where it lands, taking {{hp|5}} [[fall damage]]. Wearing armor enchanted with [[Protection]] and/or [[Feather Falling]] reduces the damage taken from the ender pearl. 

Ender pearls have a small cone of travel; they do not all follow the same path when thrown in the same direction. The direction and velocity of ender pearl throws is slightly randomized. They can travel about 30 blocks when thrown straight up, and up to 54 blocks forward when thrown at an optimum launch angle of ~35° (on even ground).

The thrower's vertical velocity influences the throw. Hence timing a throw with a jump can increase the throwing range to 42 blocks when thrown straight up and 64 blocks forward at a 35° angle. Throwing while falling significantly decreases the range. Ender pearls collide with all [[minecart]] types, [[boat]]s, [[end crystal]]s and [[nether portal]]s, and travel through [[end portal]]s. Ender pearls that fall into the [[void]] disappear, and do not trigger the player to teleport. However, ender pearl entities (instead of dropped items) are ''not'' destroyed by lava and will teleport the player to the bottom of lava pools/lava oceans.

Ender pearls have a cooldown of one second before they can be used again. The cooldown is shown in the hotbar by a white overlay on the ender pearl that shrinks and must disappear before the player can use it again. If there are other inventory or hotbar slots containing ender pearls, they are covered with the white overlay as well.<ref>{{bug|MC-88236|||WAI}}</ref> 

Ender pearls can be thrown into [[end gateway]]s to reach the outer islands of the End. They can also be thrown into the [[exit portal]] to reach the player's spawn point.

Ender pearl teleportation makes no sound ''itself''{{only|java}}, but does emit a "small fall" sound at the destination when applying teleportation damage to the player.

=== Stasis chamber ===
Ender pearls are affected by [[bubble column]]s. An ender pearl can remain afloat on top of an upward bubble column, allowing it to be stored indefinitely. A mechanism can then be triggered to make the ender pearl hit a solid surface (e.g. by closing a [[trapdoor]]), teleporting the thrower back to the setup wherever they are.

=== Spawning endermites ===
An ender pearl has a 5% chance to spawn an [[endermite]] when it lands. This is the only way through which endermites can spawn, without using cheats. The endermite spawns at ''the player's position'' when the pearl lands{{only|je}}, or at the pearl's landing site{{only|be}}.

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

== Sounds ==
{{edition|java}}:<br>
Thrown ender pearls use the Friendly Creatures sound category for entity-dependent sound events.
{{Sound table
|sound=Bow shoot.ogg
|subtitle=Ender Pearl flies
|source=neutral
|description=When an ender pearl is thrown
|id=entity.ender_pearl.throw
|translationkey=subtitles.entity.ender_pearl.throw
|volume=0.5
|pitch={{frac|1|3}}-0.5
|distance=16
|foot=1}}

{{Edition|Bedrock}}:
{{Sound table
|type=bedrock
|sound=Bow shoot.ogg
|source=player
|description=When an ender pearl is thrown
|id=random.bow
|volume=0.5
|pitch=0.33-0.5
|foot=1}}

== Data values ==
=== ID ===
{{edition|java}}:
{{ID table
|edition=java
|firstcolumnname=Item
|showforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|form=item
|foot=1}}
{{ID table
|edition=java
|firstcolumnname=Entity
|generatetranslationkeys=y
|displayname=Thrown Ender Pearl
|spritetype=entity
|spritename=Ender Pearl
|nameid=ender_pearl
|foot=1}}

{{edition|bedrock}}:
{{ID table
|edition=bedrock
|firstcolumnname=Item
|shownumericids=y
|showforms=y
|notshowbeitemforms=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=item
|nameid=ender_pearl
|id=422
|form=item
|foot=1}} 
{{ID table
|edition=bedrock
|firstcolumnname=Entity
|shownumericids=y
|generatetranslationkeys=y
|displayname=Ender Pearl
|spritetype=entity
|nameid=ender_pearl
|id=87
|foot=1}}

===Entity Data===
Thrown ender pearls have entity data that define various properties of the entity.

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

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

== Achievements ==
{{Load achievements|Beam Me Up}}

== Advancements ==
{{load advancements|Remote Getaway;Bullseye}}

== History ==
{{History|java beta}}
{{History||1.8|snap=Pre-release|[[File:Ender Pearl JE1.png|32px]] Added ender pearls along with [[endermen]]. 
|Ender pearls have no use, but can stack up to 64.}}
{{History|java}}
{{History||1.0.0|snap=Beta 1.9 Prerelease|Ender pearls are now less commonly found near bodies of [[water]] since [[endermen]] now teleport away when in contact with water. Before this version, endermen didn't attempt to teleport and were [[damage]]d/killed from water much more frequently, causing numerous ender pearls to occur around bodies of water.
|Later, on a suggestion from [[wikipedia:Reddit|Reddit]] user isJesus, [[Notch]] implemented the teleporting feature for ender pearls.<ref>http://www.reddit.com/r/Minecraft/comments/kpsay/eggsnowballender_pearl_suggestiongif/c2mabfj</ref><ref>{{Tweet|notch|118614580539826176}}</ref><ref>http://www.reddit.com/r/Minecraft/comments/kss7n/twitter_ender_pearls_have_a_unique_ability_now/c2mwldd</ref>}}
{{History|||snap=Beta 1.9 Prerelease 2|Added teleporting feature to ender pearls.
|Using an ender pearl to teleport resulted in being kicked from servers for "hacking". This is due to a check triggering that was supposed to prevent modified clients from moving too quickly.
|Ender pearls now only stack up to 16.}}
{{History|||snap=Beta 1.9 Prerelease 3|Ender pearls are now used to craft [[eyes of ender]].
|Ender pearls can now be found in the new [[stronghold]] altar [[chest]]s.}}
{{History||1.3.1|snap=12w24a|[[File:Ender Pearl JE2 BE1.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.8|snap=14w02a|As part of the revamp of the trading system, cleric [[villager]]s now [[trading|buy]] ender pearls.}}
{{History|||snap=14w03a|Villager clerics no longer buy ender pearls.}}
{{History|||snap=14w11b|Ender pearls have a 5% chance to spawn [[endermite]]s when used.}}
{{History||1.9|snap=15w31a|Ender pearls can now be thrown in [[Creative]] mode.}}
{{History|||snap=15w34c|Ender pearls now have a cooldown after using them.}}
{{History|||snap=15w41a|[[Villager]] clerics now [[trading|sell]] ender pearls for 4–7 [[emerald]]s, as one of their tier III trades.}}
{{History|||snap=15w49a|Thrown ender pearls now take the user's motion into account. For example, an ender pearl thrown forward will land closer if the player is falling, and land farther if the player is ascending.}}
{{History||1.10|snap=16w21a|Ender pearls can now teleport riders off their mounts.}}
{{History||1.11|snap=16w32a|The entity ID of ender pearls has been changed from <code>ThrownEnderpearl</code> to <code>ender_pearl</code>.}}
{{History|||snap=16w39a|Ender pearls can now be found in [[woodland mansion]]s' fake portal room [[chest]]s.}}
{{History||1.13|snap=17w47a|Prior to [[1.13/Flattening|''The Flattening'']], this [[item]]'s numeral ID was 368.}}
{{History||1.14|snap=18w43a|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.16|snap=20w07a|Ender pearls have a {{frac|2|109}} (~1.83%) chance of being offered by [[piglin]]s when [[bartering]], in a stack size of 2–4.}}
{{History|||snap=20w09a|Ender pearls now have a {{frac|10|226}} (~4.42%) chance of being offered by piglins when bartering, in a stack size of 1–5.}}
{{History|||snap=20w10a|Ender pearls now have a {{frac|20|411}} (~4.87%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History|||snap=20w20a|Ender pearls now have a {{frac|20|423}} (~4.73%) chance of being offered by piglins when bartering, in a stack size of 4–8.}}
{{History||1.16.2|snap=20w28a|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}
{{History|||snap=Pre-Release 1|Ender pearls are now affected by [[bubble column]]s.<ref>{{bug|MC-125758|||Fixed}}</ref>
|Ender pearls no longer get destroyed at contact with non-solid blocks.<ref>{{bug|MC-73884|||Fixed}}</ref>}}

{{History|pocket alpha}}
{{History||v0.14.0|snap=build 1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls. 
|While fully implemented, ender pearls currently have no assigned ID and are currently unobtainable in-game.}}
{{History|pocket}}
{{History||1.0.0|snap=alpha 0.17.0.1|Ender pearls are now obtainable in-game.
|Ender pearls can now be used to craft [[eyes of ender]].}}
{{History|||snap=alpha 1.0.0.0|Ender pearls now require a 1-second cooldown.}}
{{History|||snap=alpha 1.0.0.1|Ender pearl cooldown now has an animation.}}
{{History||1.0.4|snap=alpha 1.0.4.0|Ender pearls can now be [[trading|bought]] from cleric [[villager]]s for 4-7 [[emerald]]s.}}
{{History||1.1.0|snap=alpha 1.1.0.0|Ender pearls can now be found in [[woodland mansion]]s' [[chest]]s.}}
{{History|bedrock}}
{{History||1.10.0|snap=beta 1.10.0.3|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}
{{History||1.11.0|snap=beta 1.11.0.4|[[Trading]] has been changed, expert-level cleric [[villager]]s now [[trading|sell]] an ender pearl for 5 [[emerald]]s as part of their trade.}}
{{History||1.16.0|snap=beta 1.16.0.57|Ender pearls can now be obtained from [[bartering]] with [[piglin]]s.}}
{{History||1.16.100|snap=beta 1.16.100.54|Ender pearls now have a {{frac|10|459}} (~2.18%) chance of being offered by piglins when bartering, in a stack size of 2–4.}}

{{History|console}}
{{History||xbox=TU5|xbone=CU1|ps=1.0|wiiu=Patch 1|switch=1.0.1|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History||xbox=TU7|A teleporting feature has been added to ender pearls.}}
{{History||xbox=none|xbone=none|ps=1.90|wiiu=none|switch=none|[[File:Ender Pearl JE3 BE2.png|32px]] The texture of ender pearls has been changed.}}

{{History|new 3ds}}
{{History||1.7.10|[[File:Ender Pearl JE2 BE1.png|32px]] Added ender pearls.}}
{{History|foot}}

== Issues ==
{{issue list}}

== Trivia ==
*Ender pearls can be used to teleport/move through non-[[solid block]]s without suffocation and solid blocks by pressing against the blocks and using the ender pearl at the player's feet until the player goes through.<ref>{{bug|MC-2164}}</ref><ref>{{ytl|KA1UmxraeUg}}</ref>
*In ''Java Edition'', it is possible to spawn a thrown ender pearl using commands, but it does not teleport, unless it is assigned an owner.
*If the player throws an ender pearl and then dies before impact while the pearl is in a loaded chunk, the pearl disappears and the player is not teleported. Pearls in unloaded chunks do not disappear if their owner dies.
*If the player throws an ender pearl in Survival mode and changes to Creative mode before the pearl lands, the player is still teleported.
*The player is still teleported by throwing an ender pearl and entering [[the Nether]] before it lands. The pearl is not lost if an ender pearl is thrown into a [[nether portal]] and the player travels through the portal; the pearl lands and teleports the player as usual.
*If multiple ender pearls are thrown in succession, the player can be hurt only once from fall damage within about a one-second span.
*If a [[player]] dies from ender pearl teleportation, the [[death message]] says: "<player> hit the ground too hard".
*A thrown ender pearl faces toward the player in first-person view, while it appears rotated horizontal in [[third-person view]]. This is the case for all throwable items (ender pearl, [[egg]], [[snowball]], and all throwable [[potion]]s).
*Ender pearls and [[snowball]]s have the exact same range when fired. Therefore, snowballs can be used to predict the trajectory of ender pearls, or simply for practicing ender pearl throwing. This can be very helpful when the player has to throw ender pearls in dangerous environments, such as the Nether or the End.
*Despite the fact that ender pearls deal no damage to anything they're thrown at, provokable mobs (such as iron golems and piglins) will be provoked by the player if one is thrown at them.

== Gallery ==
<gallery>
Ender Pearl Suggestion.gif|The original suggestion image for teleporting with ender pearls.
Enderlake.png|Ender pearls were formerly found in [[water]], however endermen now teleport out to prevent damage.
</gallery>

== References ==
{{reflist}}

== See also ==
*[[The End]]
*[[Ender Dragon]]
*[[End Portal]]
*[[Enderman]]

{{Items}}
{{entities}}

[[cs:Endová perla]]
[[de:Enderperle]]
[[es:Perla de ender]]
[[fr:Perle de l'Ender]]
[[hu:Véggyöngy]]
[[ja:エンダーパール]]
[[ko:엔더 진주]]
[[nl:Enderparel]]
[[pl:Enderperła]]
[[pt:Pérola de ender]]
[[ru:Жемчуг Края]]
[[th:ไข่มุกเอนเดอร์]]
[[tr:Ender İncisi]]
[[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. MC-265476 — resolved as "Works As Intended".
  2. https://bugs.mojang.com/browse/MCPE-152036
Advertisement