# 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_. | Name | ID | Data | | ------------------------ | --- | ------------------------------ | | Air | 0 | | | Stone | 1 | | | Grass Block | 2 | | | Dirt | 3 | | | Cobblestone | 4 | | | Wooden Planks | 5 | | | Oak Sapling | 6 | `0` | | Spruce Sapling | 6 | `1` | | Birch Sapling | 6 | `2` | | Bedrock | 7 | | | Water (Flowing) | 8 | [See below][fluid] | | Water (Still) | 9 | | | Lava (Flowing) | 10 | [See below][fluid] | | Lava (Still) | 11 | | | Sand | 12 | | | Gravel | 13 | | | Gold Ore | 14 | | | Iron Ore | 15 | | | Coal Ore | 16 | | | Oak Log | 17 | `0` | | Spruce Log | 17 | `1` | | Birch Log | 17 | `2` | | Oak Leaves | 18 | `0` | | Spruce Leaves | 18 | `1` | | Birch Leaves | 18 | `2` | | Sponge | 19 | | | Glass | 20 | | | Lapis Lazuli Ore | 21 | | | Lapis Lazuli Block | 22 | | | Dispenser | 23 | [See below][dispenser] | | Sandstone | 24 | | | Note Block | 25 | | | Bed | 26 | [See below][bed] | | Powered Rail | 27 | [See below][powered_rail] | | Detector Rail | 28 | [See below][detector_rail] | | Sticky Piston | 29 | [See below][piston] | | Cobweb | 30 | | | Dead Shrub | 31 | `0` | | Grass | 31 | `1` | | Fern | 31 | `2` | | Dead Bush | 32 | | | Piston | 33 | [See below][piston] | | Piston Head | 34 | [See below][piston_head] | | White Wool | 35 | `0` | | Orange Wool | 35 | `1` | | Magenta Wool | 35 | `2` | | Light Blue Wool | 35 | `3` | | Yellow Wool | 35 | `4` | | Lime Wool | 35 | `5` | | Pink Wool | 35 | `6` | | Gray Wool | 35 | `7` | | Light Gray (Silver) Wool | 35 | `8` | | Cyan Wool | 35 | `9` | | Purple Wool | 35 | `10` | | Blue Wool | 35 | `11` | | Brown Wool | 35 | `12` | | Green Wool | 35 | `13` | | Red Wool | 35 | `14` | | Black Wool | 35 | `15` | | Moving Piston | 36 | | | Dandelion | 37 | | | Rose | 38 | | | Brown Mushroom | 39 | | | Red Mushroom | 40 | | | Gold Block | 41 | | | Iron Block | 42 | | | Double Stone Slab | 43 | `0` | | Double Sandstone Slab | 43 | `1` | | Double Wooden Slab | 43 | `2` | | Double Cobblestone Slab | 43 | `3` | | Stone Slab | 44 | `0` | | Sandstone Slab | 44 | `1` | | Wooden Slab | 44 | `2` | | Cobblestone Slab | 44 | `3` | | Bricks | 45 | | | TNT | 46 | | | Bookshelves | 47 | | | Mossy Cobblestone | 48 | | | Obsidian | 49 | | | Torch | 50 | [See below][torch] | | Fire | 51 | [See below][fire] | | Monster Spawner | 52 | | | Wooden Stairs | 53 | [See below][stairs] | | Chest | 54 | | | Redstone Wire | 55 | [See below][redstone_wire] | | Diamond Ore | 56 | | | Diamond Block | 57 | | | Crafting Table | 58 | | | Wheat | 59 | [See below][wheat] | | Farmland | 60 | [See below][farmland] | | Furnace | 61 | [See below][furnace] | | Lit Furnace | 62 | [See below][furnace] | | Standing Sign | 63 | [See below][standing_sign] | | Wooden Door | 64 | [See below][door] | | Ladder | 65 | [See below][ladder] | | Rail | 66 | [See below][rail] | | Cobblestone Stairs | 67 | [See below][stairs] | | Wall-Mounted Sign | 68 | [See below][wall_sign] | | Lever | 69 | [See below][lever] | | Stone Pressure Plate | 70 | [See below][pressure_plate] | | Iron Door | 71 | [See below][door] | | Wooden Pressure Plate | 72 | [See below][pressure_plate] | | Redstone Ore | 73 | | | Glowing Redstone Ore | 74 | | | Redstone Torch (Off) | 75 | [See below][redstone_torch] | | Redstone Torch (On) | 76 | [See below][redstone_torch] | | Button | 77 | [See below][button] | | Snow Layer | 78 | [See below][snow_layer] | | Ice | 79 | | | Snow Block | 80 | | | Cactus | 81 | | | Clay Block | 82 | | | Sugar Cane | 83 | | | Jukebox | 84 | | | Fence | 85 | | | Pumpkin | 86 | [See below][pumpkin] | | Netherrack | 87 | | | Soul Sand | 88 | | | Glowstone | 89 | | | Nether Portal | 90 | | | Jack O Lantern | 91 | [See below][pumpkin] | | Cake | 92 | [See below][cake] | | Redstone Repeater (Off) | 93 | [See below][redstone_repeater] | | Redstone Repeater (On) | 94 | [See below][redstone_repeater] | | Locked Chest | 95 | | | Trapdoor | 96 | [See below][trapdoor] | ## 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][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 [wheat]: #wheat-metadata [trapdoor]: #trapdoor-metadata [redstone_repeater]: #redstone-repeater-metadata [cake]: #cake-metadata [pumpkin]: #pumpkin-metadata [button]: #button-metadata [snow_layer]: #snow-layer-metadata [redstone_torch]: #redstone-torch-metadata [pressure_plate]: #pressure-plate-metadata [lever]: #lever-metadata [ladder]: #ladder-metadata [door]: #door-metadata [standing_sign]: #standing-sign-metadata [wall_sign]: #wall-sign-metadata [furnace]: #furnace-metadata [farmland]: #farmland-metadata [redstone_wire]: #redstone-wire-metadata [stairs]: #stairs-metadata [fire]: #fire-metadata [torch]: #torch-metadata [piston]: #piston-metadata [piston_head]: #piston-head-metadata [fluid]: #fluid-metadata [dispenser]: #dispenser-metadata [bed]: #bed-metadata [rail]: #rail-metadata [powered_rail]: #powered-rail-metadata [detector_rail]: #detector-rail-metadata