Blocks#

For empty data values, assume it to always be 0.

ID is an i8, and metadata is an i8 where the final 4 bits are the metadata nibble.

Bed Metadata#

• Bit Usage: H O F F
• Valid range: 0..15

Bit Definitions:#

• FF: Facing direction

  • 0 (00): Positive Z (South)
  • 1 (01): Negative X (West)
  • 2 (10): Negative Z (North)
  • 3 (11): Positive X (East)

• O: Occupied status

  • 0: Unoccupied
  • 1: Occupied

• H: Head piece

  • 0: Foot piece
  • 1: Head piece

Examples:#

• 0 (0000): Foot, unoccupied, facing South
• 5 (0101): Foot, unoccupied, facing West
• 11 (1011): Head, unoccupied, facing East
• 15 (1111): Head, occupied, facing East

Fluid Metadata#

• Bit Usage: F D D D
• Valid range: 0..15

Bit Definitions:#

• DDD: Distance to source

  • 0: Source block or adjacent to source
  • 1-7: Distance from source

• F: Falling state

  • 0: Normal horizontal flow
  • 1: Falling vertically (acts like source for spreading)

Examples:#

• 0 (0000): Source block
• 3 (0011): Distance 3 from source, flowing horizontally
• 8 (1000): Falling fluid (acts like source)
• 11 (1011): Falling fluid with distance 3 (rare edge case)

Dispenser Metadata#

• Bit Usage: F F F F
• Valid range: 0..5

Bit Definitions:#

• FFFF: Facing direction
  • 0: Negative Y (Down)
  • 1: Positive Y (Up)
  • 2: Negative Z (North)
  • 3: Positive Z (South)
  • 4: Negative X (West)
  • 5: Positive X (East)

Examples:#

• 0 (0000): Facing down
• 2 (0010): Facing north
• 4 (0100): Facing west
• 5 (0101): Facing east

Rail Metadata#

• Bit Usage: D D D D
• Valid range: 0..9

Bit Definitions:#

• DDDD: Direction/Shape
  • 0: North-South straight
  • 1: East-West straight
  • 2: East ascending (going up towards +X)
  • 3: West ascending (going up towards -X)
  • 4: North ascending (going up towards -Z)
  • 5: South ascending (going up towards +Z)
  • 6: South-East curve
  • 7: South-West curve
  • 8: North-West curve
  • 9: North-East curve

Examples:#

• 0 (0000): North-South straight
• 6 (0110): South-East curve
• 8 (1000): North-West curve
• 9 (1001): North-East curve

Powered Rail Metadata#

• Bit Usage: P D D D
• Valid range: 0..13

Bit Definitions:#

• DDD: Direction/Shape

  • 0: North-South straight
  • 1: East-West straight
  • 2: East ascending (going up towards +X)
  • 3: West ascending (going up towards -X)
  • 4: North ascending (going up towards -Z)
  • 5: South ascending (going up towards +Z)

• P: Powered state

  • 0: Unpowered
  • 1: Powered

Examples:#

• 0 (0000): North-South straight, unpowered
• 1 (0001): East-West straight, unpowered
• 8 (1000): North-South straight, powered
• 10 (1010): East ascending, powered

Detector Rail Metadata#

• Bit Usage: A D D D
• Valid range: 0..13

Bit Definitions:#

• DDD: Direction/Shape

  • 0: North-South straight
  • 1: East-West straight
  • 2: East ascending (going up towards +X)
  • 3: West ascending (going up towards -X)
  • 4: North ascending (going up towards -Z)
  • 5: South ascending (going up towards +Z)

• A: Active/Triggered state

  • 0: No minecart detected
  • 1: Minecart detected

Examples:#

• 0 (0000): North-South straight, no minecart
• 1 (0001): East-West straight, no minecart
• 8 (1000): North-South straight, minecart detected (powering)
• 10 (1010): East ascending, minecart detected (powering)

Piston Head Metadata#

• Bit Usage: S D D D
• Valid range:** 0..13

Bit Definitions:#

• DDD: Facing direction

  • 0: Down (Negative Y)
  • 1: Up (Positive Y)
  • 2: North (Negative Z)
  • 3: South (Positive Z)
  • 4: West (Negative X)
  • 5: East (Positive X)

• S: Is Sticky

  • 0: Regular
  • 1: Sticky

Examples:#

• 0 (0000): Regular piston head facing down
• 1 (0001): Regular piston head facing up
• 8 (1000): Sticky piston head facing down
• 13 (1101): Sticky piston head facing south

Piston Metadata#

Piston is pretty much the same as its Piston Head counterpart, just with different uses of the 3rd bit.

• Bit Usage: E D D D
• Valid range: 0..13

Bit Definitions:#

• DDD: Facing direction

  • 0: Down (Negative Y)
  • 1: Up (Positive Y)
  • 2: North (Negative Z)
  • 3: South (Positive Z)
  • 4: West (Negative X)
  • 5: East (Positive X)

• E: Is Extended

  • 0: Retracted
  • 1: Extended

Special Behaviors:#

• Note that stickiness is determined by block ID

Examples:#

• 0 (0000): Facing down, retracted
• 1 (0001): Facing up, retracted
• 8 (1000): Facing down, extended
• 11 (1011): Facing south, extended

Torch Metadata#

• Bit Usage: - A A A
• Valid range: 1..5

Bit Definitions:#

• AAA: Attachment direction
  • 1: Attached to West face (pointing East)
  • 2: Attached to East face (pointing West)
  • 3: Attached to North face (pointing South)
  • 4: Attached to South face (pointing North)
  • 5: Standing on ground/block below

Examples:#

• 1 (0001): Wall torch pointing East (attached to West wall)
• 3 (0011): Wall torch pointing South (attached to North wall)
• 5 (0101): Standing torch (on ground/block below)

Fire Metadata#

• Bit Usage: A A A A
• Valid range: 0..15

Bit Definitions:#

• AAAA: Age/Intensity level (4 bits)
  • 0: Newly created fire
  • 1-14: Aging fire
  • 15: Maximum age (most likely to spread or die out)

Special Behaviors:#

• Age increases by 0 or 1 each tick (randomly)
• Death conditions:
  • Age > 3 and no solid block below = dies
  • Age = 15 and no flammable neighbors = may die randomly
• Younger fires spread more aggressively

Examples:#

• 0 (0000): Fresh fire just lit
• 5 (0101): Moderate age fire
• 15 (1111): Maximum age fire

Stairs Metadata#

• Bit Usage: - - D D
• Valid range: 0..3

Bit Definitions:#

• DD: Facing direction
  • 0: Ascending East (facing West wall)
  • 1: Ascending West (facing East wall)
  • 2: Ascending South (facing North wall)
  • 3: Ascending North (facing South wall)

Examples:#

• 0 (0000): Stairs ascending toward East
• 1 (0001): Stairs ascending toward West
• 2 (0010): Stairs ascending toward South
• 3 (0011): Stairs ascending toward North

Redstone Wire Metadata#

• Bit Usage: P P P P
• Valid range: 0..15

Bit Definitions:#

• PPPP: Power level
  • 0: No power
  • 1-15: Power strength (15 is maximum)

Examples:#

• 0 (0000): Unpowered wire
• 1 (0001): Weak power (far from source)
• 15 (1111): Maximum power (at source or powered by strong source)

Wheat Metadata#

• Bit Usage: - G G G
• Valid range: 0..7

Bit Definitions:#

• GGG: Growth stage
  • 0: Just planted (smallest)
  • 1-6: Growing stages
  • 7: Fully grown (ready to harvest)

Examples:#

• 0 (0000): Newly planted wheat
• 3 (0011): Half-grown wheat
• 7 (0111): Fully mature wheat (harvestable)

Farmland Metadata#

• Bit Usage: - H H H
• Valid range: 0..7

Bit Definitions:#

• HHH: Hydration level
  • 0: Dry farmland (will revert to dirt without crops nearby)
  • 1-6: Partially hydrated
  • 7: Fully hydrated (optimal for crop growth)

Examples:#

• 0 (0000): Dry farmland
• 4 (0100): Moderately hydrated farmland
• 7 (0111): Fully hydrated farmland

Furnace Metadata#

• Bit Usage: - - D D
• Valid range: 2..5

Bit Definitions:#

• DD: Facing direction
  • 2: North (Negative Z)
  • 3: South (Positive Z)
  • 4: West (Negative X)
  • 5: East (Positive X)

Special Behaviors:#

• Note that idle/active state is determined by block ID

Examples:#

• 2 (0010): Furnace facing North
• 3 (0011): Furnace facing South
• 4 (0100): Furnace facing West
• 5 (0101): Furnace facing East

Standing Sign Metadata#

• Bit Usage: D D D D
• Valid range: 0..15

Bit Definitions:#

• DDDD: Rotation direction
  • 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

Examples:#

• 0 (0000): Sign facing South
• 4 (0100): Sign facing West
• 8 (1000): Sign facing North
• 12 (1100): Sign facing East

Wall Sign Metadata#

• Bit Usage: - - D D
• Valid range: 2..5

Bit Definitions:#

• DD: Attached wall direction
  • 2: Attached to North wall (facing South)
  • 3: Attached to South wall (facing North)
  • 4: Attached to West wall (facing East)
  • 5: Attached to East wall (facing West)

Examples:#

• 2 (0010): Wall sign facing South (attached to North wall)
• 3 (0011): Wall sign facing North (attached to South wall)
• 4 (0100): Wall sign facing East (attached to West wall)
• 5 (0101): Wall sign facing West (attached to East wall)

Door Metadata#

• Bit Usage: T O F F
• Valid range: 0..15

Bit Definitions:#

• FF: Facing direction

  • 0: North (Negative Z)
  • 1: East (Positive X)
  • 2: South (Positive Z)
  • 3: West (Negative X)

• O: Is Open

  • 0: Closed
  • 1: Open

• T: Half

  • 0: Bottom half of door
  • 1: Top half of door

Examples:#

• 0 (0000): Bottom half, closed, facing North
• 4 (0100): Bottom half, open, facing North
• 8 (1000): Top half, closed, facing North
• 12 (1100): Top half, open, facing North

Ladder Metadata#

• Bit Usage: - - D D
• Valid range: 2..5

Bit Definitions:#

• DD: Attached wall direction
  • 2: Attached to South wall (facing North)
  • 3: Attached to North wall (facing South)
  • 4: Attached to East wall (facing West)
  • 5: Attached to West wall (facing East)

Examples:#

• 2 (0010): Ladder on South wall (climb facing North)
• 3 (0011): Ladder on North wall (climb facing South)
• 4 (0100): Ladder on East wall (climb facing West)
• 5 (0101): Ladder on West wall (climb facing East)

Lever Metadata#

• Bit Usage: A A A A
• Valid range: 1..14

Bit Definitions:#

• AAA: Attachment orientation

  • 1: Attached to West wall (lever points East)
  • 2: Attached to East wall (lever points West)
  • 3: Attached to North wall (lever points South)
  • 4: Attached to South wall (lever points North)
  • 5: On ground/ceiling (random orientation)
  • 6: On ground/ceiling (alternate orientation)

• A:` Is Activated

  • 0: Lever off
  • 1: Lever on

Examples:#

• 1 (0001): Wall lever off, pointing East
• 9 (1001): Wall lever on, pointing East
• 5 (0101): Ground lever off
• 13 (1101): Ground lever on

Pressure Plate Metadata#

• Bit Usage: - - - A
• Valid range: 0..1

Bit Definitions:#

• A: Activation state
  • 0: Not pressed
  • 1: Pressed

Examples:#

• 0 (0000): Pressure plate not pressed
• 1 (0001): Pressure plate pressed (providing power)

Redstone Torch Metadata#

• Bit Usage: - A A A
• Valid range: 1..5

Bit Definitions:#

• AAA: Attachment direction
  • 1: Attached to West face (pointing East)
  • 2: Attached to East face (pointing West)
  • 3: Attached to North face (pointing South)
  • 4: Attached to South face (pointing North)
  • 5: Standing on ground/block below

Special Behaviors:#

• Note that on/off state is determined by block ID

Examples:#

• 1 (0001): Redstone torch pointing East (attached to West wall)
• 3 (0011): Redstone torch pointing South (attached to North wall)
• 5 (0101): Standing redstone torch (on ground/block below)

Snow Layer Metadata#

• Bit Usage: - D D D
• Valid range: 0..7

Bit Definitions:#

• DDD: Snow depth/thickness
  • 0: 1 layer thick (2/16 blocks high)
  • 1: 2 layers thick (4/16 blocks high)
  • 2: 3 layers thick (6/16 blocks high)
  • 3: 4 layers thick (0.5 blocks high, starts having collision)
  • 4: 5 layers thick (10/16 blocks high)
  • 5: 6 layers thick (12/16 blocks high)
  • 6: 7 layers thick (14/16 blocks high)
  • 7: 8 layers thick (1 block high)

Examples:#

• 0 (0000): Thin snow layer (2/16 block high)
• 3 (0011): Half-block snow (8/16 block high, has collision)
• 7 (0111): Full-block snow (16/16 block high)

Button Metadata#

• Bit Usage: A D D D
• Valid range: 1..12

Bit Definitions:#

• DDD: Attached wall direction

  • 1: Attached to West wall (button faces East)
  • 2: Attached to East wall (button faces West)
  • 3: Attached to North wall (button faces South)
  • 4: Attached to South wall (button faces North)

• A: Activated state

  • 0: Button not pressed
  • 1: Button pressed

Examples:#

• 1 (0001): Button on West wall, not pressed
• 9 (1001): Button on West wall, pressed (providing power)
• 4 (0100): Button on South wall, not pressed
• 12 (1100): Button on South wall, pressed (providing power)

Pumpkin Metadata#

• Bit Usage: - - D D
• Valid range: 0..3

Bit Definitions:#

• DD: Facing direction
  • 0: South (Positive Z)
  • 1: West (Negative X)
  • 2: North (Negative Z)
  • 3: East (Positive X)

Examples:#

• 0 (0000): Pumpkin facing South
• 1 (0001): Pumpkin facing West
• 2 (0010): Pumpkin facing North
• 3 (0011): Pumpkin facing East

Cake Metadata#

• Bit Usage: - B B B
• Valid range: 0..5

Bit Definitions:#

• BBB: Slices eaten
  • 0: Whole cake
  • 1-5: Number of slices eaten so far

Examples:#

• 0 (0000): Full cake, uneaten
• 3 (0011): 3 slices eaten (half cake left)
• 5 (0101): 5 slices eaten (last visible slice)

Redstone Repeater Metadata#

• Bit Usage: D D F F
• Valid range: 0..15

Bit Definitions:#

• FF: Facing (output direction)

  • 0: South (Positive Z)
  • 1: West (Negative X)
  • 2: North (Negative Z)
  • 3: East (Positive X)

• DD: Delay setting

  • 0: 1 redstone tick (2 ticks)
  • 1: 2 redstone ticks (4 ticks)
  • 2: 3 redstone ticks (6 ticks)
  • 3: 4 redstone ticks (8 ticks)

Special Behaviors:#

• Note that powered/unpowered state is determined by block ID.

Examples:#

• 0 (0000): Facing South, 1-tick delay
• 5 (0101): Facing West, 2-tick delay
• 10 (1010): Facing North, 3-tick delay
• 15 (1111): Facing East, 4-tick delay

Trapdoor Metadata#

• Bit Usage: O D D
• Valid range: 0..7

Bit Definitions:#

• DD: Attached wall

  • 0: Attached to South wall (block at +Z)
  • 1: Attached to North wall (block at −Z)
  • 2: Attached to East wall (block at +X)
  • 3: Attached to West wall (block at −X)

• O: Open state

  • 0: Closed
  • 1: Open

Examples:#

• 0 (000): Closed, attached to South wall
• 1 (001): Closed, attached to North wall
• 4 (100): Open, attached to South wall
• 7 (111): Open, attached to West wall