Join us on Discord!

Block states

From Minecraft Wiki
Jump to: navigation, search

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

Contents

List of block states[edit]

Anvil[edit]

Name Value Description

 damage[until 1.13]
0 Grid Anvil.png Anvil
1 Grid Slightly Damaged Anvil.png Slightly Damaged Anvil
2 Grid Very Damaged Anvil.png Very Damaged Anvil

 facing
north
south
east
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.

[edit]

Standing[edit]

Name Value Description

 rotation
0—15 The direction the block is facing:
  • 0: south
  • 1: south-southwest
  • 2: southwest
  • 3: west-southwest
  • 4: west
  • 5: west-northwest
  • 6: northwest
  • 7: north-northwest
  • 8: north
  • 9: north-northeast
  • 10: northeast
  • 11: east-northeast
  • 12: east
  • 13: east-southeast
  • 14: southeast
  • 15: south-southeast

Wall[edit]

Name Value Description

 facing
north
south
east
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.

Bed[edit]

Name Value Description

 facing
north
south
east
west
The direction the head of the bed is pointing.
The same direction the player faces when placing the bed.

 occupied
true
false
True when a player is using the bed.

 part
head
foot
The half of the bed in the current block.

Beetroot[edit]

Name Value Description

 age
0
1
2
3
Fully-grown.

Bone Block[edit]

Name Value Description

 axis
x The bone block is oriented east–west.
y The bone block is oriented vertically.
z The bone block is oriented north–south.

Brewing Stand[edit]

Name Value Description

 has_bottle_0
true
false
True when a bottle is in slot 1.

 has_bottle_1
true
false
True when a bottle is in slot 2.

 has_bottle_2
true
false
True when a bottle is in slot 3.

Button[edit]

minecraft:stone_button
minecraft:wooden_button
Name Value Description

 face[upcoming 1.13]
floor
ceiling
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 it's sides.

 facing
north
west
south
east
up[until 1.13]
down[until 1.13]
The direction it's facing.
Opposite to the direction the player is facing if placed on the side of a block.

 powered
true
false
If true, the button is currently activated.

Cactus[edit]

Name Value Description

 age
0–15 A freshly-planted cactus – and a cactus which 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[edit]

Name Value Description

 bites
0–6 Number of bites taken from the cake.

Carpet[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

Carrot[edit]

Name Value Description

 age
0–1
2–3
4–6
7
Fully-grown.

Cauldron[edit]

Name Value Description

 level
0–3 Water level in a Cauldron, "0" being empty and "3" being full.

Chest, Ender Chest and Trapped Chest[edit]

Name Value Description

 facing
north
south
east
west
The direction the chest's latch is on.
Opposite from the direction the player faces when placing a chest.

 type[upcoming 1.13]
single
left
right
The direction the chest has a connection with.

Chorus Flower[edit]

Name Value Description

 age
0–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 will not grow anymore. A chorus flower can become age 5 at any time.

Chorus Plant[edit]

Name Value Description

 north

 south

 east

 west

 up

 down
true
false
When true, the plant extends out from the center of the plant-block in this direction.

Cobblestone Wall and Mossy Cobblestone Wall[edit]

Name Value Description

 north

 south

 east

 west

 up
true
false
When true, the cobblestone wall extends from the center post in that direction.

 variant[until 1.13]
cobblestone
Cobblestone Wall
mossy_cobblestone
Mossy Cobblestone Wall

Cocoa[edit]

Name Value Description

 age
0–2 The stage of the pod's growth, with "2" being fully grown.

 facing
north
south
east
west
The direction from the cocoa bean to the log.
The direction the player faces when placing the cocoa.

Command Block[edit]

Name Value Description

 conditional
true
false
True if the command block is in conditional mode.

 facing
north
south
east
west
up
down
The direction the command block is pointing.

Concrete[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

Concrete Powder[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

Daylight Sensor[edit]

minecraft:daylight_detector
minecraft:daylight_detector_inverted
Name Value Description

 inverted[upcoming 1.13]
true
false
If true, the daylight detector is inverted.

 power
0–15 The current redstone power level produced by the daylight sensor.

Dirt[edit]

Name Value Description

 snowy
true
false
If true, Podzol in particular uses a snowy side and top texture.
In-game, this is true when dirt has snow or snow (layer) on top.

 variant[until 1.13]
dirt
Dirt
coarse_dirt
Coarse Dirt
podzol
Podzol

Dispenser[edit]

Name Value Description

 facing
north
south
east
west
up
down
The direction the dispenser will dispense its contents.
The opposite from the direction the player faces while placing the dispenser.

 triggered
true
false
True if the dispenser is activated.

Door[edit]

minecraft:wooden_door
minecraft:iron_door
minecraft:spruce_door
minecraft:birch_door
minecraft:jungle_door
minecraft:acacia_door
minecraft:dark_oak_door
Name Value Description

 facing
north
south
east
west
The direction the door's "inside" is facing.
The direction the player faces while placing the door.
For example, a door facing east will occupy the west part of its block when closed.

 half
upper
lower
Identifies which part of the door the block is.

 hinge
left
right
Identifies the side the hinge is on (when facing the same direction as the door's inside).

 open
true
false
True if the door is currently open (may differ from powered).

 powered
true
false
True if the door is currently activated (may differ from open).

Dropper[edit]

Name Value Description

 facing
north
south
east
west
up
down
The direction in which the dropper will drop items.
The opposite from the direction the player faces while placing the dropper.

 triggered
true
false
True when the dropper is activated.

End Portal Frame[edit]

Name Value Description

 eye
true
false
If true, the portal frame block contains an eye of ender.

 facing
north
south
east
west
The direction of the end portal frame block.
The opposite from the direction the player faces while placing the block.
A naturally-generated portal frame will have all blocks 'facing' inward,
for example, the northern three blocks will all face south, and so on.
Only the block receiving the final eye of ender is required to be facing correctly; to activate the portal.

End Rod[edit]

Name Value Description

 facing
north
south
east
west
up
down
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 purple end.

Farmland[edit]

Name Value Description

 moisture
0–6
Not fully-hydrated.
7
Fully-hydrated.

Fence[edit]

minecraft:fence
minecraft:spruce_fence
minecraft:birch_fence
minecraft:jungle_fence
minecraft:acacia_fence
minecraft:dark_oak_fence
minecraft:nether_brick_fence
Name Value Description

 north

 south

 east

 west
true
false
When true, the fence extends from the center post in this direction.

Fence Gate[edit]

minecraft:fence_gate
minecraft:spruce_fence_gate
minecraft:birch_fence_gate
minecraft:jungle_fence_gate
minecraft:acacia_fence_gate
minecraft:dark_oak_fence_gate
Name Value Description

 facing
north
south
east
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_wall
true
false
If true, the gate is lowered by three pixels, to accommodate attaching more cleanly with normal and mossy Cobblestone Walls.

 open
true
false
If true, the gate is opened.

 powered
true
false
If true, the gate is receiving redstone power.

Fire[edit]

Name Value Description

 age
0—15 Newly-placed fire has an age of 0, and fire has a 13 chance of incrementing with each block tick.
This factor affects how the fire extinguishes.

 up
true
false
Fire texture shows on the upper face.
In normal gameplay, this occurs when there is a block above the fire, but none below it.

 north

 south

 east

 west
true
false
When true, fire texture shows on that face of the block.
In normal gameplay, this occurs when there is a flammable block in that direction.

Flowers[edit]

minecraft:red_flower

Name Value Description

 type
poppy
Poppy
blue_orchid
Blue Orchid
allium
Allium
houstonia
Azure Bluet
red_tulip
Red Tulip
orange_tulip
Orange Tulip
white_tulip
White Tulip
pink_tulip
Pink Tulip
oxeye_daisy
Oxeye Daisy

minecraft:yellow_flower

Name Value Description

 type
dandelion
Dandelion

Flower Pot[edit]

Name Value Description

 contents
empty The flower pot is empty.
rose
Poppy
blue_orchid
Blue Orchid
allium
Allium
houstonia
Azure Bluet
red_tulip
Red Tulip
orange_tulip
Orange Tulip
white_tulip
White Tulip
pink_tulip
Pink Tulip
oxeye_daisy
Oxeye Daisy
dandelion
Dandelion
oak_sapling
Oak Sapling
spruce_sapling
Spruce Sapling
birch_sapling
Birch Sapling
jungle_sapling
Jungle Sapling
acacia_sapling
Acacia Sapling
dark_oak_sapling
Dark Oak Sapling
mushroom_red
Red Mushroom
mushroom_brown
Brown Mushroom
dead_bush
Dead Bush
fern
Fern
cactus
Cactus

 legacy_data
0–15 The data values that previously described the flower pot, in versions older than 1.7.2.
Values 0–13 had been sufficient for saplings, mushrooms, rose, dandelion, cactus, fern and dead bush.
16 values was ultimately insufficient to include the 8 additional flowers.

Frosted Ice[edit]

Name Value Description

 age
0
Freshly-generated ice.
1–3
Ice with spreading cracks.

Furnace[edit]

minecraft:furnace
minecraft:lit_furnace
Name Value Description

 facing
north
south
east
west
The direction the furnace opening faces.
The opposite from the direction the player faces while placing the furnace.

 lit[upcoming 1.13]
true
false
If the furnace is lit.

Glass Pane[edit]

Name Value Description

 north

 south

 east

 west
true
false
Specifies the directions the panes extend from its center, when attaching to other panes, stained panes or blocks.

Glazed Terracotta[edit]

Name Value Description

 facing
north
south
east
west
The opposite from the direction the player faces while placing the block.

Grass[edit]

Name Value Description

 type[until 1.13]
dead_bush
Dead Bush
tall_grass
Tall Grass
fern
Fern

Grass Block[edit]

Name Value Description

 snowy
true
false
If true, the block uses a snowy side and top texture.
In-game, this is true when grass has snow or snow (layer) on top.

Hay Bale[edit]

Name Value Description

 axis
x The hay block is oriented east–west.
y The hay block is oriented vertically.
z The hay block is oriented north–south.

Hopper[edit]

Name Value Description

 enabled
true
false

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.


 facing
north
south
east
west
down

The direction the hopper's output points.

The hopper will push items into containers in this direction only.

Iron Bars[edit]

Name Value Description

 north

 south

 east

 west
true
false
When true, the bars extend from the center of the block in this direction.

Jack o'Lantern[edit]

Name Value Description

 facing
north
south
east
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.

Jukebox[edit]

Name Value Description

 has_record
true
false
True when the jukebox contains a record.

Kelp [upcoming 1.13][edit]

Name Value Description

 age
0–25 A freshly-planted kelp – and a kelp which has just grown kelp above it – each have a random age between 0 and 21.
The age is incremented at random intervals.
At age 25, a kelp may try to grow more kelp above it.

Ladder[edit]

Name Value Description

 facing
north
south
east
west
The direction from the block the ladder is attached to, to the ladder.

Lava[edit]

Block minecraft:lava
Block minecraft:flowing_lava[until 1.13]

Name Value Description

 level
0 Lava source block.
1–7 Height of the lava, with 1 being highest.
Also represents the distance from a lava source or a falling lava.
In the End and Overworld, only 2, 4 and 6 are used.
8–15 Falling lava.
This level is equal to 8 plus the level of the non-falling lava above it.
For instance a lava of level 2 will produce falling lava below it with level 10.
The distinction makes no difference in behavior.

Fluid minecraft:lava[upcoming 1.13]

Name Value Description

 falling
true
false
Always false.

Fluid minecraft:flowing_lava[upcoming 1.13]

Name Value Description

 falling
true
false
True for falling lava, false for lava flowing sideways.

 level
1–7 Height of the lava when falling is false, with 7 being highest.
8 Always has a value of 8 when falling is true.

Leaves[edit]

minecraft:leaves
Name Value Description

 check_decay[until 1.13]
true The block will be checked for decay.
false The block will not be checked for decay for a while.
Set to this value if the block fails a decay check.

 decayable[until 1.13]
true The block can decay.
Set to this value when grown as part of a tree.
false The block cannot decay.
Set to this value when placed by a player.

 variant[until 1.13]
oak
Oak
spruce
Spruce
birch
Birch
jungle
Jungle

 persistent[upcoming 1.13]
true The block will be decay.
false The block will checked for decay.

 distance[upcoming 1.13]
1—7 How far away this block is from the appropriate wood type
minecraft:leaves2
Name Value Description

 check_decay[until 1.13]
true The block will be checked for decay.
false The block will not be checked for decay for a while.
Set to this value if the block fails a decay check.

 decayable[until 1.13]
true The block can decay.
Set to this value when grown as part of a tree.
false The block cannot decay.
Set to this value when placed by a player.

 variant[until 1.13]
acacia
Acacia
dark_oak
Dark Oak

 persistent[upcoming 1.13]
true The block will be decay.
false The block will checked for decay.

 distance[upcoming 1.13]
1—7 How far away this block is from the appropriate wood type

Lever[edit]

Name Value Description

 face[upcoming 1.13]
floor
ceiling
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 it's sides.

 facing
north
west
south
east
up_x[until 1.13]
up_z[until 1.13]
down_x[until 1.13]
down_z[until 1.13]
The direction it's facing.
Opposite to the direction the player is facing if placed on the side of a block.

 powered
true
false
If true, the lever is currently activated.

Melon Stem[edit]

minecraft:melon_stem

Name Value Description

 age
0 A newly-planted stem.
1–6 Intermediate growth stages of the stem.
7 A fully-mature stem, capable of producing melons.

 facing[until 1.13]
north
south
east
west

The direction from the stem to the melon.
The color of a stem facing in one of these directions depends upon the age, but its height does not vary.
up
A stem not attached to any melon.
The height and color of a stem facing "up" depends upon the age.

minecraft:attached_melon_stem[upcoming 1.13]

Name Value Description

 facing
north
south
east
west

The direction from the stem to the melon.

Monster Egg[edit]

Name Value Description

 variant
stone
Stone Monster Egg
cobblestone
Cobblestone Monster Egg
stone_brick
Stone Brick Monster Egg
mossy_brick
Mossy Stone Brick Monster Egg
cracked_brick
Cracked Stone Brick Monster Egg
chiseled_brick
Chiseled Stone Brick Monster Egg

Mushroom (block)[edit]

minecraft:brown_mushroom_block
minecraft:red_mushroom_block
Name Value Description

 variant[until 1.13]
east
north
north_east
north_west
south
south_east
south_west
west

Only the top face and the specified one or two faces have the cap texture,

and the rest have the pores texture.
center
Only the top face has the cap texture,

and the rest have the pores texture.
stem
The four side faces have the stem texture,

and the top and bottom faces have the pores texture.
all_inside
All six faces have the pores texture.
all_outside
All six faces have the cap texture.
all_stem
All six faces have the stem texture.

 down[upcoming 1.13]
true
false

/
If true, the bottom face has the cap/stem texture.

If false, it has the pores texture instead.

 east[upcoming 1.13]
true
false

/
If true, the east face has the cap/stem texture.

If false, it has the pores texture instead.

 north[upcoming 1.13]
true
false

/
If true, the north face has the cap/stem texture.

If false, it has the pores texture instead.

 south[upcoming 1.13]
true
false

/
If true, the south face has the cap/stem texture.

If false, it has the pores texture instead.

 up[upcoming 1.13]
true
false

/
If true, the top face has the cap/stem texture.

If false, it has the pores texture instead.

 west[upcoming 1.13]
true
false

/
If true, the west face has the cap/stem texture.

If false, it has the pores texture instead.

Mycelium[edit]

Name Value Description

 snowy
true
false
True if the mycelium block has a snow block or some snow layers above it.

Nether Wart[edit]

Name Value Description

 age
0
1–2
3
Fully grown

Pistons and Sticky Pistons[edit]

Name Value Description

 extended
true
false
If true, the piston is extended.

 facing
north
south
east
west
up
down
The direction the piston head is pointing.
The opposite from the direction the player faces while placing the piston.

minecraft:piston_head[edit]

Name Value Description

 facing
north
south
east
west
up
down
The direction the piston head is pointing.

 short
true
false
If true, the piston arm is shorter than usual, by 4 pixels.

 type
normal
sticky
The type of piston head.

minecraft:piston_extension[edit]

Name Value Description

 extended[until 1.13]
true
false
If true, the block is being pushed by the piston.

 facing
north
south
east
west
up
down
The direction the block is being pushed by the piston.

 type[upcoming 1.13]
normal
sticky
What piston base this has.

Nether Portal (block)[edit]

Name Value Description

 axis
x The portal's long edge runs east–west (default).
z The portal's long edge runs north–south.

Observer[edit]

Name Value Description

 facing
north
south
east
west
up
down
The direction the observer is observing. The same direction the player faces, when placing the block.

 powered
true
false
True while the observer is observing a change and emitting a pulse.

Potato[edit]

Name Value Description

 age
0–1
2–3
4–6
7
Fully-grown.

Pressure Plate[edit]

minecraft:stone_pressure_plate
minecraft:wooden_pressure_plate
Stone or wooden pressure plate
Name Value Description

 powered
true
false
True if pressure plate is depressed, providing power.
Weighted pressure plate
Name Value Description

 power
0—15 Specifies the redstone power level currently being produced by the weighted pressure plate.

Prismarine[edit]

Name Value Description

 variant
prismarine
Prismarine
prismarine_bricks
Prismarine Bricks
dark_prismarine
Dark Prismarine

Pumpkin[edit]

minecraft:pumpkin
Name Value Description

 facing
north
south
east
west
The direction the pumpkin's carved face is facing.
The opposite from the direction the player faces while placing the pumpkin.

Pumpkin Stem[edit]

minecraft:pumpkin_stem

Name Value Description

 age
0 A newly-planted stem.
1–6 Intermediate growth stages of the stem.
7 A fully-mature stem, capable of producing pumpkins.

 facing[until 1.13]
north
south
east
west

The direction from the stem to the pumpkin.
The color of a stem facing in one of these directions depends upon the age, but its height does not vary.
up
A stem not attached to any pumpkin.
The height and color of a stem facing "up" depends upon the age.

minecraft:attached_pumpkin_stem[upcoming 1.13]

Name Value Description

 facing
north
south
east
west

The direction from the stem to the pumpkin.

Purpur Pillar[edit]

Name Value Description

 axis
x The pillar is oriented east–west.
y The pillar is oriented vertically.
z The pillar is oriented north–south.

Quartz[edit]

Name Value Description

 variant[until 1.13]
default
Block of Quartz
chiseled
Chiseled Quartz Block
lines_x
Pillar Quartz Block (east–west)
lines_y
Pillar Quartz Block (vertical)
lines_z
Pillar Quartz Block (north–south)

minecraft:pillar_quartz[upcoming 1.13]

Name Value Description

 axis
x The log is oriented east–west.
y The log is oriented vertically.
z The log is oriented north–south.

Rails[edit]

Rail[edit]

Name Value Description

 shape
north_south
east_west
north_east
north_west
south_east
south_west
The two directions a rail connects to.
For example, a south_east rail is a curved rail which connects to the south and to the east.
ascending_north
ascending_south
ascending_east
ascending_west
A rail that ascends towards the direction noted.
For example, an ascending_west rail is a straight rail which goes upwards from the east towards the west.

Activator Rail, Detector Rail, and Powered Rail[edit]

Name Value Description

 powered
true
false
True if rail is activated.

 shape
north_south
east_west
Specifies the rail's orientation.
ascending_north
ascending_south
ascending_east
ascending_west
A rail that ascends towards the direction noted.
For example, an ascending_west rail is a straight rail that goes upwards from the east towards the west.

Red Sandstone[edit]

Name Value Description

 type[until 1.13]
red_sandstone
Red Sandstone
smooth_red_sandstone
Smooth Red Sandstone
chiseled_red_sandstone
Chiseled Red Sandstone

Redstone Comparator[edit]

minecraft:powered_comparator
minecraft:unpowered_comparator
Name Value Description

 facing
north
south
east
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.

 mode
compare
subtract
Specifies the current mode of the redstone comparator.

 powered
true
false
True if the redstone comparator is being powered.

Redstone Dust[edit]

Name Value Description

 north

 south

 east

 west
none The redstone dust does not connect in this direction.
side The redstone dust connects horizontally in this direction.
up The redstone dust connects diagonally upwards in this direction.

 power
0–15 The redstone dust's current power level.

Redstone Repeater[edit]

minecraft:powered_repeater
minecraft:unpowered_repeater
Name Value Description

 delay
1–4 The redstone repeater's delay in redstone ticks.

 facing
north
south
east
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.

 locked
true
false
True if the repeater is currently locked.

 powered[upcoming 1.13]
true
false
If the redstone repeater is lit.

Redstone Torch and Torch[edit]

Name Value Description

 facing
up[until 1.13]
north
east
south
west
The direction the top of the torch is facing.

Sand[edit]

Name Value Description

 variant[until 1.13]
sand
Sand
red_sand
Red Sand

Sandstone[edit]

Name Value Description

 type[until 1.13]
sandstone
Sandstone
chiseled_sandstone
Chiseled Sandstone
smooth_sandstone
Smooth Sandstone

Sapling[edit]

Name Value Description

 stage
0 or 1 Specifies the sapling's growth stage.

 type[until 1.13]
oak
Oak Sapling
spruce
Spruce Sapling
birch
Birch Sapling
jungle
Jungle Sapling
acacia
Acacia Sapling
dark_oak
Dark Oak Sapling

Seagrass [upcoming 1.13][edit]

Name Value Description

 half
upper
lower
The half of the plant contained in this block.

Sea Pickle [upcoming 1.13][edit]

Name Value Description

 pickles
1–4 Number of pickles.

 waterlogged
true
false
Whether or not the pickles are underwater.

Shulker Box[edit]

Name Value Description

 facing
north
south
east
west
up
down
The direction the shulker box is pointing.
The opposite from the direction the player faces while placing the shulker box.

Sign[edit]

Standing[edit]

Name Value Description

 rotation
0—15 The direction the block is facing:
  • 0: south
  • 1: south-southwest
  • 2: southwest
  • 3: west-southwest
  • 4: west
  • 5: west-northwest
  • 6: northwest
  • 7: north-northwest
  • 8: north
  • 9: north-northeast
  • 10: northeast
  • 11: east-northeast
  • 12: east
  • 13: east-southeast
  • 14: southeast
  • 15: south-southeast

Wall[edit]

Name Value Description

 facing
north
south
east
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.

Skull[edit]

Name Value Description

 facing
north
south
east
west
The skull is attached to this side of a block, and the skull's eyes look in this direction.
The direction from the block the skull is attached to, to the skull.
up The skull sits on the floor.
down Not accessible by placing the mob head item.
Appears as an east-facing skull, but with the hit-box of an up-facing skull.

 nodrop
true
false
If true, the skull does not drop as an item.

[until 1.13]

1.13[edit]

Floor[edit]

Name Value Description

 rotation
0—15 The direction the head is facing:
  • 0: north
  • 1: north-northeast
  • 2: northeast
  • 3: east-northeast
  • 4: east
  • 5: east-southeast
  • 6: southeast
  • 7: south-southeast
  • 8: south
  • 9: south-southwest
  • 10: southwest
  • 11: west-southwest
  • 12: west
  • 13: west-northwest
  • 14: northwest
  • 15: north-northwest

Wall[edit]

Name Value Description

 facing
north
south
east
west
The direction the head is facing.
Opposite from the direction a player is facing when placing it.

Slabs[edit]

minecraft:stone_slab[edit]

Name Value Description

 half
top
bottom
Where the slab is within its block.

 variant
stone
Stone Slab
sandstone
Sandstone Slab
wood_old
Wood Slab (with stone properties, no longer craftable)
cobblestone
Cobblestone Slab
brick
Brick Slab
stone_brick
Stone Brick Slab
nether_brick
Nether Brick Slab
quartz
Quartz Slab

minecraft:stone_slab2[edit]

Name Value Description

 half
top
bottom
Where the slab is within its block.

 variant
red_sandstone
Red Sandstone Slab

minecraft:wooden_slab[edit]

Name Value Description

 half
top
bottom
Where the slab is within its block.

 variant
oak
Oak Wood Slab
spruce
Spruce Wood Slab
birch
Birch Wood Slab
jungle
Jungle Wood Slab
acacia
Acacia Wood Slab
dark_oak
Dark Oak Wood Slab

minecraft:purpur_slab[edit]

Name Value Description

 half
top
bottom
Where the slab is within its block.

 variant
default
Purpur Slab

minecraft:double_stone_slab[edit]

Name Value Description

 seamless
true
false
If true, the top texture is used on all sides.

Smooth Double Stone Slab

Smooth Double Sandstone Slab

Tile Double Quartz Slab

 variant
stone
Double Stone Slab
sandstone
Double Sandstone Slab
wood_old
Double Wood Slab (with stone properties, no longer craftable)
cobblestone
Double Cobblestone Slab
brick
Double Brick Slab
stone_brick
Double Stone Brick Slab
nether_brick
Double Nether Brick Slab
quartz
Double Quartz Slab

minecraft:double_stone_slab2[edit]

Name Value Description

 seamless
true
false
If true, the top texture is used on all sides.

Smooth Double Red Sandstone Slab

 variant
red_sandstone
Double Red Sandstone Slab

minecraft:double_wooden_slab[edit]

Name Value Description

 variant
oak
Double Oak Wood Slab
spruce
Double Spruce Wood Slab
birch
Double Birch Wood Slab
jungle
Double Jungle Wood Slab
acacia
Double Acacia Wood Slab
dark_oak
Double Dark Oak Wood Slab

minecraft:purpur_double_slab[edit]

Name Value Description

 variant
default
Purpur Double Slab

Snow (layer)[edit]

Name Value Description

 layers
1—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.

Sponge[edit]

Name Value Description

 wet[until 1.13]
true
Wet Sponge
false
Sponge

Stained Glass[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

Stained Glass Pane[edit]

Name Value Description

 color[until 1.13]
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

 north

 south

 east

 west
true
false
Specifies the directions the pane extends from its center, when attaching to other panes, stained panes or blocks.

Stairs[edit]

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
Name Value Description

 facing
north
south
east
west
The direction the stairs' full-block side faces.

When placed in-game by a player, this matches the direction the player faces.


 half
top
bottom
Top if the stairs are upside-down.

 shape
straight
inner_left
inner_right
outer_left
outer_right
"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.

Stone[edit]

Name Value Description

 variant[until 1.13]
stone
Stone
granite
Granite
smooth_granite
Polished Granite
diorite
Diorite
smooth_diorite
Polished Diorite
andesite
Andesite
smooth_andesite
Polished Andesite

Stone Bricks[edit]

Name Value Description

 variant
stonebrick
Stone Brick
mossy_stonebrick
Mossy Stone Brick
cracked_stonebrick
Cracked Stone Brick
chiseled_stonebrick
Chiseled Stone Brick

Structure Block[edit]

Name Value Description

 mode
save
Save Structure Block
load
Load Structure Block
corner
Corner Structure Block
data
Data Structure Block

Sugar Canes[edit]

Name Value Description

 age
0–15 A freshly-planted cane – and a cane which 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[edit]

minecraft:double_plant[until 1.13]

minecraft:tall_grass[upcoming 1.13]

minecraft:large_fern[upcoming 1.13]

Name Value Description

 half
upper
lower
The half of the plant contained in this block.

 variant[until 1.13]
sunflower
Sunflower
syringa
Lilac
double_grass
Double Tallgrass
double_fern
Large Fern
double_rose
Rose Bush
paeonia
Peony

 facing[until 1.13]
north
south
east
west
The direction the plant is facing. This is currently unused in-game.
Upper-half blocks are always 'north', and lower-half blocks are always 'east'.

Terracotta[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

TNT[edit]

Name Value Description

 explode
true
false
If true, the TNT will drop primed TNT rather than a TNT item when broken. Defaults to false.

Trapdoor[edit]

minecraft:trapdoor
minecraft:iron_trapdoor
Name Value Description

 facing
north
south
east
west
The direction the trapdoor swings open.
The opposite from the side its hinge is attached to.

 half
top
bottom
Whether the trapdoor occupies the top or bottom part of a block.

 open
true
false
True if the trapdoor is currently open (may differ from powered).

 powered[upcoming 1.13]
true
false
True if the trapdoor is currently powered (may differ from open).

 waterlogged[upcoming 1.13]
true
false
True if the trapdoor occupies a water source block.
The water will remain if the trapdoor is destroyed.

Tripwire[edit]

Name Value Description

 attached
true
false
True if the tripwire is connected to a valid tripwire circuit.

 disarmed
true
false
True if the tripwire is disarmed, that is, broken using shears.

 north

 south

 east

 west
true
false

True if the tripwire connects in that direction.

For example, if east, west and south are true the tripwire is connected to either tripwire or tripwire hooks in those directions.

 powered
true
false
True if the tripwire is active.

Tripwire Hook[edit]

Name Value Description

 attached
true
false
True if the tripwire hook is connected to a valid tripwire circuit.

 facing
north
south
east
west

The direction in which the tripwire hook juts out from the block it is attached to.

For example, a tripwire hook facing north will be attached to a block to its south.

 powered
true
false
True if the tripwire hook is active.

Turtle Egg [upcoming 1.13][edit]

Name Value Description

 eggs
1–4 Number of eggs.

 hatch
0–2 Determines how close an egg is to hatching; starts at 0 and is randomly incremented.

Vines[edit]

Name Value Description

 north

 south

 east

 west

 up
true
false
When true, a vine texture is displayed on the specified face of the vine block.

Water[edit]

Block minecraft:water
Block minecraft:flowing_water[until 1.13]

Name Value Description

 level
0 Water source block.
1–7 Height of the water, with 1 being highest.
Also represents the distance from a water source or falling water block.
8–15 Falling water.
This level is equal to 8 plus the level of the non-falling water above it.
For instance a water of level 2 will produce falling water below it with level 10.
The distinction makes no difference in behavior.

Fluid minecraft:water[upcoming 1.13]

Name Value Description

 falling
true
false
Always false.

Fluid minecraft:flowing_water[upcoming 1.13]

Name Value Description

 falling
true
false
True for falling water, false for water flowing sideways.

 level
1–7 Height of the water when falling is false, with 7 being highest.
8 Always has a value of 8 when falling is true.

Wheat[edit]

Name Value Description

 age
0
1
2
3
4
5
6
7
Fully-grown.

Wood[edit]

minecraft:log[edit]

Name Value Description

 axis
none[until 1.13] The block lacks a "top" texture (all sides have the bark texture).
x The log is oriented east–west.
y The log is oriented vertically.
z The log is oriented north–south.

 variant[until 1.13]
oak
Oak
spruce
Spruce
birch
Birch
jungle
Jungle

minecraft:log2[edit]

Name Value Description

 axis
none[until 1.13] The block lacks a "top" texture (all sides have the bark texture).
x The log is oriented east–west.
y The log is oriented vertically.
z The log is oriented north–south.

 variant[until 1.13]
acacia
Acacia
dark_oak
Dark Oak

Wood Planks[edit]

Name Value Description

 variant[until 1.13]
oak
Oak Wood Planks
spruce
Spruce Wood Planks
birch
Birch Wood Planks
jungle
Jungle Wood Planks
acacia
Acacia Wood Planks
dark_oak
Dark Oak Wood Planks

Wool[edit]

Name Value Description

 color
white
orange
magenta
light_blue
yellow
lime
pink
gray
silver
'silver' refers to Light Gray.
cyan
purple
blue
brown
green
red
black

History[edit]

Official release
1.8 14w11a Added block states. Only used in the game engine, not saved in world files or used in commands yet.
14w26a Switched to mostly using block states in the code.
1.11 16w32a Enabled the use of block states in commands.
Upcoming Java Edition
1.13 17w47a Added the debug stick, which is an item used to edit the block states of blocks.
Promotional Content