Java Edition data values

This article is about values from the latest PC version of Minecraft. For values from Classic, see Data values/Classic. For values from the Pocket Edition, see Data values (Pocket Edition).

These data values refer to the different types of blocks and items. They are used in many, many places in Minecraft. Block IDs are used to define blocks placed in the world and inventory items (including items in chests and items dropped in the world). Item IDs are only valid for items. There are also Entity IDs for entities such as mobs and projectiles. Block data further defines blocks placed, describing for example the height of water or the direction a torch points.

Picture reference.

IDs

Template:ID table/key

Block IDs

Main article: Data values/Block IDs

[edit]

Item IDs

Main article: Data values/Item IDs

[edit]

Entity IDs

Main article: Data values/Entity IDs

[edit]

Horse Variants

Horse/ID

Biome IDs

Biomes have been present in Minecraft since the Halloween Update, and the Biome ID is included in the Anvil file format since 1.2. The Biome ID for worlds stored in the older McRegion file format is calculated on the fly, which could lead to a discrepancy between the earlier generated world, and the features (such as grass color, snow) based on the calculated biome IDs. The Biome page has more technical details on how color is computed for blocks in various biomes.

Dec	Biome
0	Ocean
1	Plains
2	Desert
3	Extreme Hills
4	Forest
5	Taiga
6	Swampland
7	River
8	Nether
9	End
10	Frozen Ocean
11	Frozen River
12	Ice Plains
13	Ice Mountains
14	Mushroom Island
15	Mushroom Island Shore
16	Beach
17	Desert Hills
18	Forest Hills
19	Taiga Hills
20	Extreme Hills Edge
21	Jungle
22	Jungle Hills
23	Jungle Edge
24	Deep Ocean
25	Stone Beach
26	Cold Beach
27	Birch Forest
28	Birch Forest Hills
29	Roofed Forest
30	Cold Taiga
31	Cold Taiga Hills
32	Mega Taiga
33	Mega Taiga Hills
34	Extreme Hills+
35	Savanna
36	Savanna Plateau
37	Mesa
38	Mesa Plateau F
39	Mesa Plateau
129	Sunflower Plains
130	Desert M
131	Extreme Hills M
132	Flower Forest
133	Taiga M
134	Swampland M
140	Ice Plains Spikes
149	Jungle M
151	JungleEdge M
155	Birch Forest M
156	Birch Forest Hills M
157	Roofed Forest M
158	Cold Taiga M
160	Mega Spruce Taiga
161	Redwood Taiga Hills M
162	Extreme Hills+ M
163	Savanna M
164	Savanna Plateau M
165	Mesa (Bryce)
166	Mesa Plateau F M
167	Mesa Plateau M
-1	(Uncalculated)

Enchantment IDs

Used in commands such as /enchant, /give and /replaceitem.

Enchanting/ID

Status effects

Used in /effect command.

Icon	Value	Name	Effect type	In source code	Particle color
	1	minecraft:speed	Speed	potion.moveSpeed	0x7cafc6
	2	minecraft:slowness	Slowness	potion.moveSlowdown	0x5a6c81
	3	minecraft:haste	Haste	potion.digSpeed	0xd9c043
	4	minecraft:mining_fatigue	Mining Fatigue	potion.digSlowDown	0x4a4217
	5	minecraft:strength	Strength	potion.damageBoost	0x932423
-	6	minecraft:instant_health	Instant Health	potion.heal	0xf82423
-	7	minecraft:instant_damage	Instant Damage	potion.harm	0x430a09
	8	minecraft:jump_boost	Jump Boost	potion.jump	0x786297
	9	minecraft:nausea	Nausea	potion.confusion	0x551d4a
	10	minecraft:regeneration	Regeneration	potion.regeneration	0xcd5cab
	11	minecraft:resistance	Resistance	potion.resistance	0x99453a
	12	minecraft:fire_resistance	Fire Resistance	potion.fireResistance	0xe49a3a
	13	minecraft:water_breathing	Water Breathing	potion.waterBreathing	0x2e5299
	14	minecraft:invisibility	Invisibility	potion.invisibility	0x7f8392
	15	minecraft:blindness	Blindness	potion.blindness	0x1f1f23
	16	minecraft:night_vision	Night vision	potion.nightVision	0x1f1fa1
	17	minecraft:hunger	Hunger	potion.hunger	0x587653
	18	minecraft:weakness	Weakness	potion.weakness	0x484d48
	19	minecraft:poison	Poison	potion.poison	0x4e9331
	20	minecraft:wither	Wither	potion.wither	0x352a27
	21	minecraft:health_boost	Health Boost	potion.healthBoost	0xf87d23
	22	minecraft:absorption	Absorption	potion.absorption	0x2552a5
-	23	minecraft:saturation	Saturation	potion.saturation	0xf82423

Data

Up to 4 bits of special data are used for certain block and item types. Blocks that need more than 4 bits of data beyond the block ID use a block entity or are split into two blocks. Storage differs according to level format.

Block	dec	hex	Use
Wood	0-15	0-F	Wood Texture/Rotation
Fire	0-15	0-F	Age in ticks (1/20th of a second)
Leaves	0-15	0-F	Leaves texture, decay counter
Jukebox	0-1	0-1	Disc in jukebox or not
Saplings	0-15	0-F	Age / Tree Type
Cactus	0-15	0-F	Age
Sugar Cane	0-15	0-F	Age
Water and Lava	0-15	0-F	Fluid level
Sand	0-1	0-1	Color of sand
Soil/Farmland	0-8	0-8	Wetness
Crops	0-7	0-7	Crop size
Nether Wart	0-3	0-3	Nether Wart Size
Pumpkin and melon stem	0-7	0-7	Growth stage
Wool, Stained Clay, Stained Glass and Carpet	0-15	0-F	Color
Dyes	0-15	0-F	Dye Color
Fish	0-3	0-3	Type of fish
Command block	0-1	0-1	Commands
Torches and Redstone Torches	0-5	0-5	Torch orientation
Rails (reg, powered, detect)	0-9	0-9	Rail slope, orientation, power
Stairs	0-7	0-7	Stair orientation
Levers	0-15	0-F	Lever orientation and thrown state
Door	0-15	0-F	Hinge corner position and swing state
Buttons	0-15	0-F	Button orientation, whether it's pressed
Sign Posts	0-15	0-F	Sign orientation
Ladders, Wall Signs, Furnaces, Chests	2-5	2-5	Orientation
Dispensers, Droppers, and Hoppers	0-15	0-F	Orientation
Pumpkins and Jack-O-Lanterns	0-3	0-3	Pumpkin orientation
Pressure Plates	0-1	0-1	Whether it's pressed
Coal	0-1	0-1	Type of coal (mined coal or charcoal)
Tools and Armor	varies		Damage level
Slabs	0-15	0-F	Type of slab
Snow	0-7	0-7	Block height
Cake	0-5	0-5	Pieces eaten
Bed	0-15	0-F	Orientation, whether it's occupied
Redstone Comparator	0-15	0-F	Orientation, mode and power
Redstone Repeater	0-15	0-F	Orientation and delay
Redstone Wire	0-15	0-F	Power level
Daylight sensor	0-15	0-F	Power level
Grass	0-2	0-2	Appearance (grass, fern, shrub)
Flowers	0-8	0-8	Type of flower
Large Flowers	0-5, 8-13	0-5, 8-D	Type of flower
Trapdoors	0-7	0-7	Orientation and "swung" state
Piston	0-5, 8-13	0-5, 8-D	Orientation and "extended" state
Piston Extension	0-5, 8-13	0-5, 8-D	Orientation and "sticky" state
Stone Brick	0-3	0-3	Stronghold texture
Huge brown and red mushroom	0-10	0-A	Texture
Vines	0-15	0-F	Attached Surface
Fence Gates	0-7	0-7	Open/Closed, and direction
Potions	0-65535	0-FFFF	Potion Type
Brewing Stand	0-7	0-7	Slots used
Cauldron	0-3	0-3	Amount of water
End Portal Frame	0-7	0-7	Orientation, broken/fixed state
Cobblestone Wall	0-1	0-1	Cobblestone or Moss Stone
Flower Pot	0-11	0-B	Plant inside flower pot
Heads	0-4	0-4	Type of head
Anvil	0-2	0-2	Damage value
Golden Apple	0-1	0-1	Type of Golden Apple (regular or enchanted)
Wood Planks	0-5	0-5	Wood Planks texture
Block of Quartz	0-4	0-4	Block of Quartz texture/rotation

Wood Planks

	DV	Description
	0	Oak Wood Planks
	1	Spruce Wood Planks
	2	Birch Wood Planks
	3	Jungle Wood Planks
	4	Acacia Wood Planks
	5	Dark Oak Wood Planks

Stone

	DV	Description
	0	Stone
	1	Granite
	2	Polished Granite
	3	Diorite
	4	Polished Diorite
	5	Andesite
	6	Polished Andesite

Dirt

	DV	Description
	0	Dirt
	1	Coarse Dirt

Saplings

The data value is split in half. The bottom three bits determine the type of sapling (and thus the eventual tree type), according to the following table:

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value of 0 to 5 specifying the type of sapling: 0: Oak Sapling 1: Spruce Sapling 2: Birch Sapling 3: Jungle Sapling 4: Acacia Sapling 5: Dark Oak Sapling
0x8	Set if sapling is ready to grow into a tree.

The 0x8 bit functions as the counter. The counter is cleared when a sapling is dropped as an item.

Water and Lava

If bit 0x8 is set, this liquid is "falling" and only spreads downward. At this level, the lower bits are essentially ignored, since this block is then at its highest fluid level.

The lower three bits are the fluid block's level. 0x0 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: 0x1 is next highest, 0x2 lower, on through 0x7, the lowest fluid level. Along a line on a flat plane, water drops one level per meter from the source, lava drops one in the nether and two everywhere else.

The stationary versions of each fluid are "stable" and currently not being checked by the engine for further level changes. Oddly the in-code names for stationary water and lava are "water" and "lava" and the regular versions are "flowing_water" and "flowing_lava".

Sand

	DV	Description
	0	Sand
	1	Red sand

Wood

Block 17

	DV	Description
	0	Oak Wood
	1	Spruce Wood
	2	Birch Wood
	3	Jungle Wood
	4	Acacia Wood
	5	Dark Oak Wood
	8	Stripped Oak Wood
	9	Stripped Spruce Wood
	10	Stripped Birch Wood
	11	Stripped Jungle Wood
	12	Stripped Acacia Wood
	13	Stripped Dark Oak Wood

Block 162 Wood/DV2

Leaves

If bit 0x4 is set, the leaves are permanent and will never decay. This bit is set on player-placed leaf blocks and overrides the meaning of bit 0x8.

If bit 0x8 is set, the leaves will be checked for decay. The bit will be cleared after the check if the leaves do not decay. The bit will be set again whenever a block adjacent to the leaves is changed.

Block 18

	DV	Description
	0	Oak Leaves
	1	Spruce Leaves
	2	Birch Leaves
	3	Jungle Leaves
	4	Oak Leaves, check for decay
	5	Spruce Leaves, check for decay
	6	Birch Leaves, check for decay
	7	Jungle Leaves, check for decay
	8	Oak Leaves, persistent
	9	Spruce Leaves, persistent
	10	Birch Leaves, persistent
	11	Jungle Leaves, persistent
	12	Oak Leaves, persistent + check for decay
	13	Spruce Leaves, persistent + check for decay
	14	Birch Leaves, persistent + check for decay
	15	Jungle Leaves, persistent + check for decay

Block 161

	DV	Description
	0	Acacia Leaves
	1	Dark Oak Leaves
	4	Acacia Leaves, check for decay
	5	Dark Oak Leaves, check for decay
	8	Acacia Leaves, persistent
	9	Dark Oak Leaves, persistent
	12	Acacia Leaves, persistent + check for decay
	13	Dark Oak Leaves, persistent + check for decay

Wool, Stained Clay, Stained Glass and Carpet

These values specify the color of the wool, stained clay, stained glass and carpet. This data is stored in block metadata for placed wool, stained clay, stained glass or carpet, and as the "damage" for the item in the inventory.

Carpet

	DV	Description
	0	White Carpet
	1	Orange Carpet
	2	Magenta Carpet
	3	Light Blue Carpet
	4	Yellow Carpet
	5	Lime Carpet
	6	Pink Carpet
	7	Gray Carpet
	8	Light Gray Carpet
	9	Cyan Carpet
	10	Purple Carpet
	11	Blue Carpet
	12	Brown Carpet
	13	Green Carpet
	14	Red Carpet
	15	Black Carpet

Wool

	Data value		Description	Color Code
	Dec	Hex		old	new
	0	0x0	White wool	#DDDDDD	#E9ECEC
	1	0x1	Orange wool	#DB7D3E	#F07613
	2	0x2	Magenta wool	#B350BC	#BD44B3
	3	0x3	Light blue wool	#6B8AC9	#3AAFD9
	4	0x4	Yellow wool	#B1A627	#F8C627
	5	0x5	Lime wool	#41AE38	#70B919
	6	0x6	Pink wool	#D08499	#ED8DAC
	7	0x7	Gray wool	#404040	#3E4447
	8	0x8	Light gray wool	#9AA1A1	#8E8E86
	9	0x9	Cyan wool	#2E6E89	#158991
	10	0xA	Purple wool	#7E3DB5	#792AAC
	11	0xB	Blue wool	#2E388D	#35399D
	12	0xC	Brown wool	#4F321F	#724728
	13	0xD	Green wool	#35461B	#546D1B
	14	0xE	Red wool	#963430	#A12722
	15	0xF	Black wool	#191616	#141519

Stained Clay

Stained Clay/DV

Stained Glass

	DV	Description
	0	White Stained Glass
	1	Orange Stained Glass
	2	Magenta Stained Glass
	3	Light Blue Stained Glass
	4	Yellow Stained Glass
	5	Lime Stained Glass
	6	Pink Stained Glass
	7	Gray Stained Glass
	8	Light Gray Stained Glass
	9	Cyan Stained Glass
	10	Purple Stained Glass
	11	Blue Stained Glass
	12	Brown Stained Glass
	13	Green Stained Glass
	14	Red Stained Glass
	15	Black Stained Glass

Torches and Redstone Torches

	DV	Description
	0	(unused)
	1	Facing east (attached to a block to its west)
	2	Facing west (attached to a block to its east)
	3	Facing south (attached to a block to its north)
	4	Facing north (attached to a block to its south)
	5	Facing up (attached to a block beneath it)

Slabs

Single slabs can be either "right-side-up" or "upside-down"; this information is stored in the most significant metadata bit 0x8 as follows:

• 0: Slab is right-side-up, occupying the bottom half of its voxel.
• 1: Slab is upside-down, occupying the top half of its voxel.

Thus a right-side-up birch wood slab has metadata value 0x2 (binary 0010), while an upside-down birch slab is represented by metadata 0xA (binary 1010).

Double slabs with the high-order bit set render the top texture on all six sides.

The wooden slab in the stone slabs has the properties of stone, and the texture of oak wood planks. They are unavailable in game and can only be obtained through commands.

Double Stone Slabs

Block 43

	DV	Description
	0	Double Stone Slab
	1	Double Sandstone Slab
	2	Double Wooden Slab
	3	Double Cobblestone Slab
	4	Double Bricks Slab
	5	Double Stone Bricks Slab
	6	Double Quartz Slab
	7	Double Nether Brick Slab
	8	Double Upper Stone Slab
	9	Double Upper Sandstone Slab
	10	Double Upper Wooden Slab
	11	Double Upper Cobblestone Slab
	12	Double Upper Bricks Slab
	13	Double Upper Stone Bricks Slab
	14	Double Upper Quartz Slab
	15	Double Upper Nether Brick Slab

Block 181

	DV	Description
	0	Double Red Sandstone Slab
	1	Double Purpur Slab
	2	Double Prismarine Slab
	3	Double Prismarine Bricks Slab
	4	Double Dark Prismarine Slab
	5	Double Mossy cobblestone Slab
	6	Double Smooth Sandstone Slab
	7	Double Red Nether Brick Slab
	8	Double Upper Red Sandstone Slab
	9	Double Upper Purpur Slab
	10	Double Upper Prismarine Slab
	11	Double Upper Prismarine Bricks Slab
	12	Double Upper Dark Prismarine Slab
	13	Double Upper Mossy cobblestone Slab
	14	Double Upper Smooth Sandstone Slab
	15	Double Upper Red Nether Brick Slab

The full stone, quartz, sandstone, and red sandstone Slabs have a top texture on all sides.

Stone Slabs

Block 44

	DV	Description
	0	Smooth Stone Slab
	1	Sandstone Slab
	2	Wooden Slab
	3	Cobblestone Slab
	4	Bricks Slab
	5	Stone Bricks Slab
	6	Quartz Slab
	7	Nether Brick Slab
	8	Upper Smooth Stone Slab
	9	Upper Sandstone Slab
	10	Upper Wooden Slab
	11	Upper Cobblestone Slab
	12	Upper Bricks Slab
	13	Upper Stone Bricks Slab
	14	Upper Quartz Slab
	15	Upper Nether Brick Slab

Block 182

	DV	Description
	0	Red Sandstone Slab
	1	Purpur Slab
	2	Prismarine Slab
	3	Dark Prismarine Slab
	4	Prismarine Bricks Slab
	5	Mossy cobblestone Slab
	6	Smooth Sandstone Slab
	7	Red Nether Brick Slab
	8	Upper Red Sandstone Slab
	9	Upper Purpur Slab
	10	Upper Prismarine Slab
	11	Upper Dark Prismarine Slab
	12	Upper Prismarine Bricks Slab
	13	Upper Mossy cobblestone Slab
	14	Upper Smooth Sandstone Slab
	15	Upper Red Nether Brick Slab

Double Wooden Slabs

Block 125

	DV	Description
	0	Double Oak Wood Slab
	1	Double Spruce Wood Slab
	2	Double Birch Wood Slab
	3	Double Jungle Wood Slab
	4	Double Acacia Wood Slab
	5	Double Dark Oak Wood Slab
	8	Double Upper Oak Wood Slab
	9	Double Upper Spruce Wood Slab
	10	Double Upper Birch Wood Slab
	11	Double Upper Jungle Wood Slab
	12	Double Upper Acacia Wood Slab
	13	Double Upper Dark Oak Wood Slab

Wooden Slabs

Block 126

	DV	Description
	0	Oak Wood Slab
	1	Spruce Wood Slab
	2	Birch Wood Slab
	3	Jungle Wood Slab
	4	Acacia Wood Slab
	5	Dark Oak Wood Slab
	8	Upper Oak Wood Slab
	9	Upper Spruce Wood Slab
	10	Upper Birch Wood Slab
	11	Upper Jungle Wood Slab
	12	Upper Acacia Wood Slab
	13	Upper Dark Oak Wood Slab

Fire

0x0 is a placed or spread fire. Once it reaches 0xF the eternal fire-trick will work since there will be no further updates of the block.

Sandstone

For normal sandstone the bottom has a cracked pattern. The other types of sandstone have bottom faces same as the tops.

	DV	Description
	0	Sandstone
	1	Chiseled Sandstone
	2	Cut Sandstone
	3	Smooth Sandstone

Red Sandstone

	DV	Description
	0	Red Sandstone
	1	Chiseled Red Sandstone
	2	Cut Red Sandstone
	3	Smooth Red Sandstone

Beds

	DV	Description
	0	White Bed
	1	Orange Bed
	2	Magenta Bed
	3	Light Blue Bed
	4	Yellow Bed
	5	Lime Bed
	6	Pink Bed
	7	Gray Bed
	8	Light Gray Bed
	9	Cyan Bed
	10	Purple Bed
	11	Blue Bed
	12	Brown Bed
	13	Green Bed
	14	Red Bed
	15	Black Bed

Grass

	DV	Description
	0	Grass named "Fern"
	1	Grass
	2	Fern
	3	Fern with NBT variant "snow"

Flowers

	DV	Description
	0	Poppy
	1	Blue Orchid
	2	Allium
	3	Azure Bluet
	4	Red Tulip
	5	Orange Tulip
	6	White Tulip
	7	Pink Tulip
	8	Oxeye Daisy
	9	Cornflower
	10	Lily of the Valley

Large Flowers

	DV	Description
	0	Sunflower
	1	Lilac
	2	Double Tallgrass
	3	Large Fern
	4	Rose Bush
	5	Peony
	8	Top Half of any Large Plant; low three bits 0x7 are derived from the block below.

Piston

The top bit (0x8) is a status bit that determines whether the piston is pushed out or not. 1 for pushed out, 0 for retracted.

The bottom three bits are a value from 0 to 5, indicating the direction of the piston (the direction the piston head is pointing)

• 0: Down
• 1: Up
• 2: Template:F
• 3: Template:F
• 4: Template:F
• 5: Template:F

Piston Extension

The top bit (0x8) is a status bit that determines whether the head is sticky or not (note that the Piston Body actually has completely different block types for Sticky and Regular). 1 is sticky, 0 is regular.

The bottom three bits are a value from 0 to 5, indicating the direction of the piston (the direction the piston head is pointing).

• 0: Down
• 1: Up
• 2: Template:F
• 3: Template:F
• 4: Template:F
• 5: Template:F

Stairs

All but cut copper stairs:

Bits	Description
0x1 0x2	A two-bit field containing a value from 0 to 3 specifying the direction of the stairs' full-block side: 0: East 1: West 2: South 3: North
0x4	Set if stairs are upside-down
0x8	(unused)

Redstone Wire

Redstone/DV

Daylight Sensor

Daylight Sensor/DV

Crops

Crops grow from 0x0 to 0x7. Carrots and potatoes (and Beetroot in MCPE) appear to have 4 stages, but actually grow identically to wheat, merely using the same texture for multiple stages. Note: crops with a data value of 0xF have been spotted; the meaning of the top 0x8 bit is unknown.

Wheat

Seeds/DV

Carrot

Icon	Value
	0, 1
	2, 3
	4, 5, 6
	7

Potato

Icon	Value
	0, 1
	2, 3
	4, 5, 6
	7

Beetroot

Beetroot/DV

Farmland

Value	Meaning
0	Dry land
1 to 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.

Banner

Standing

Bits	Description
0x1 0x2 0x4 0x8	A four-bit field storing a value from 0 to 15 specifying the block's orientation: 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

Bits	Description
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5 specifying the block's orientation: 2: north 3: south 4: west 5: east
0x8	(unused)

Door

Minecraft 1.1 and Earlier

The two least significant bits are the orientation of the door, that is, the corner in which its hinge is positioned:

• 0x0: Template:F corner
• 0x1: Template:F corner
• 0x2: Template:F corner
• 0x3: Template:F corner

The two bits above are flags:

• 0x8: If this bit is set, this is the top half of a door (else the lower half).
• 0x4: If this bit is set, the door has swung counterclockwise around its hinge.

For example, the bottom half of a door with its hinge on the Template:F corner, which is swung so that it is closed when viewed from the Template:F, will have a data value of (3 | 4) = (3 + 4) = 7.

Starting at Minecraft 1.2 (from weekly snapshot 12w06a)

Graphic of possible door data values in 12w06a

The total data needed to accurately describe a single door tile is now contained in both door tiles, so both data values have to be inspected.

Common to both door tiles, the top bit (0x8) is as follows:

• 0: The bottom half of the door
• 1: The top half of the door

Top Sections

The least-significant bit (0x1) is as follows, assuming you're facing the same direction the door faces while closed:

• 0: Hinge is on the right (this is the default for single doors)
• 1: Hinge is on the left (this will be used for the other half of a double-door combo)

The other two bits (0x2 and 0x4) are always zero.

The only valid values for a top section, therefore, are 8 (binary 1000) and 9 (binary 1001).

Bottom Sections

The second bit (0x4) determines the door's state:

• 0: Closed
• 1: Open

The bottom two bits determine which direction the door faces (these directions given for which direction the door faces while closed)

• 0: Facing Template:F
• 1: Facing Template:F
• 2: Facing Template:F
• 3: Facing Template:F

Starting at Minecraft ??

The second bit for the top half of the door (0x2) determines whether the door is Powered or Unpowered.

• 0: Door is Unpowered
• 1: Door is Powered

Which means the top section, now uses values 8, 9, 10, and 11.

Rails

Value	Description
0	Straight rail connecting to the north and south.
1	Straight rail connecting to the east and west.
2	Sloped rail ascending to the east.
3	Sloped rail ascending to the west.
4	Sloped rail ascending to the north.
5	Sloped rail ascending to the south.
6	Curved rail connecting to the south and east.
7	Curved rail connecting to the south and west.
8	Curved rail connecting to the north and west.
9	Curved rail connecting to the north and east.

Activator Rails, Detector Rails, and Powered Rails

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 0 to 5: 0: flat track going north-south 1: flat track going east-west 2: sloped track ascending to the east 3: sloped track ascending to the west 4: sloped track ascending to the north 5: sloped track ascending to the south
0x8	Set if rail is active.

Ladders, Furnaces, Chests, Trapped Chests

Ladder

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5: 2: Ladder facing north 3: Ladder facing south 4: Ladder facing west 5: Ladder facing east Invalid values default to 2.
0x8	Unused.

Furnace

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5: 2: Furnace facing north 3: Furnace facing south 4: Furnace facing west 5: Furnace facing east Invalid values default to 2.
0x8	Unused.

Chest

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5: 2: Chest facing north 3: Chest facing south 4: Chest facing west 5: Chest facing east Invalid values default to 2.
0x8	Unused.

Trapped Chest

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5: 2: Trapped chest facing north 3: Trapped chest facing south 4: Trapped chest facing west 5: Trapped chest facing east Invalid values default to 2.
0x8	Unused.

Sign

Standing

Bits	Description
0x1 0x2 0x4 0x8	A four-bit field storing a value from 0 to 15 specifying the block's orientation: 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

Bits	Description
0x1 0x2 0x4	A three-bit field storing a value from 2 to 5 specifying the block's orientation: 2: north 3: south 4: west 5: east
0x8	(unused)

Dispenser and Dropper

Dropper

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 0 to 5 specifying which direction the dropper is facing: 0: Dropper facing down 1: Dropper facing up 2: Dropper facing north 3: Dropper facing south 4: Dropper facing west 5: Dropper facing east
0x8	Set if dropper is activated.

Dispenser

Bits	Values
0x1 0x2 0x4	Three bits storing a value from 0 to 5: 0: Dispenser facing down 1: Dispenser facing up 2: Dispenser facing north 3: Dispenser facing south 4: Dispenser facing west 5: Dispenser facing east
0x8	If set, the dispenser is activated.

Hopper

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 0 to 5: 0: Output facing down 1: (unused) 2: Output facing north 3: Output facing south 4: Output facing west 5: Output facing east
0x8	Set if activated/disabled.

Levers

Bits	Values
0x1 0x2 0x4	A three-bit field storing a value from 0 to 7: 0: Lever on block bottom points east when off. 1: Lever on block side facing east 2: Lever on block side facing west 3: Lever on block side facing south 4: Lever on block side facing north 5: Lever on block top points south when off. 6: Lever on block top points east when off. 7: Lever on block bottom points south when off.
0x8	If this bit is set, the lever is active.

Pressure Plates

Stone or wooden pressure plate

Bits	Values
0x1	If this bit is set, the pressure plate is active.
0x2 0x4 0x8	Unused.

Weighted pressure plate

Bits	Values
0x1 0x2 0x4 0x8	A four-bit field storing a value from 0 to 15 representing the weighted pressure plate's current redstone power level.

Buttons

Bits	Values
0x1 0x2 0x4	Three bits storing a value from 0 to 5: 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
0x8	If this bit is set, the button is currently active.

Snow

Heights of snow from 0-7, going from left to right

Snow (layer)/DV

Cacti and Sugar Canes

Cactus

Value	Meaning
0	Freshly planted cactus.
1 to 15	The data value is incremented at random intervals. When it becomes 15, a new cactus block is created on top as long as the total height does not exceed 3.

Sugar Canes

Value	Meaning
0	Freshly planted sugar cane.
1 to 15	The data value is incremented at random intervals. When it becomes 15, a new sugar cane block is created on top as long as the total height does not exceed 3.

Jukebox

	DV	Description
	0	No disc inserted
	1	Contains a disc

The associated block entity is used to identify which record has been inserted.

Pumpkins and Jack o'Lanterns

Pumpkin

Lowest two bits value	Facing
0	Pumpkin facing south
1	Pumpkin facing west
2	Pumpkin facing north
3	Pumpkin facing east

Jack o'Lantern

Lowest two bits value	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

Cake

Value	Stage
0	Whole intact cake
1	1 piece eaten
2	2 pieces eaten
3	3 pieces eaten
4	4 pieces eaten
5	5 pieces eaten
6	6 pieces eaten

Redstone Repeater

Bits	Values
0x1 0x2	A two-bit field storing a value from 0 to 3 specifying the direction the redstone repeater is facing: 0: Facing north. 1: Facing east. 2: Facing south. 3: Facing west.
0x4 0x8	A two-bit field storing a value from 0 to 3 specifying the redstone repeater's delay: 0: Delay of 1 redstone tick. 1: Delay of 2 redstone tick. 2: Delay of 3 redstone tick. 3: Delay of 4 redstone tick.

Effectively, add the repeater's facing value (0 to 3) to 4×(delay-1). For example, a repeater facing west with a delay of 3 redstone ticks would have a block data value of 3 + 4×(3-1) = 11.

Redstone Comparator

A redstone comparator's block data specifies its orientation, mode, and powered status.

Bits	Values
0x1 0x2	A two-bit field storing a value from 0 to 3 specifying the redstone comparator's orientation: 0: Facing north. 1: Facing east. 2: Facing south. 3: Facing west.
0x4	Set if in subtraction mode (front torch up and powered).
0x8	Set if powered (at any power level).

Trapdoors

Bits	Values
0x1 0x2	A two-bit field storing a value from 0 to 3: 0: Trapdoor on the south side of a block 1: Trapdoor on the north side of a block 2: Trapdoor on the east side of a block 3: Trapdoor on the west side of a block
0x4	If this bit is set, the trapdoor is on the top half of a block. Otherwise, it is on the bottom half.
0x8	If this bit is set, the trapdoor is open.

Monster Egg

	DV	Description
	0	Infested Stone
	1	Infested Cobblestone
	2	Infested Stone Bricks
	3	Infested Mossy Stone Bricks
	4	Infested Cracked Stone Bricks
	5	Infested Chiseled Stone Bricks

Stone Bricks

	DV	Description
	0	Stone bricks
	1	Mossy stone bricks
	2	Cracked stone bricks
	3	Chiseled stone bricks
	4	Smooth stone bricks

Prismarine

	DV	Description
	0	Prismarine
	1	Dark Prismarine
	2	Prismarine Bricks

Sponge

	DV	Description
	0	Sponge
	1	Wet Sponge

Brown and red mushroom blocks

Mushroom blocks consist of the same blocks throughout their structure, the data value of each block decides the texture. The default texture on all sides is porous flesh. The cap texture can be either the brown mushroom or red mushroom texture, the textures for porous and stem sides are identical. Although data values 11-13 are unused they have the same texture as data value 0 as placeholders (to keep people from destroying their maps).

Mushroom (block)/DV

Pumpkin stem and Melon stem

Pumpkin Stem/DV

Vines

Determines the face against which the vine is anchored. Note that (except for Top) these are testable as bit flags, unlike most of the other directional data for other block types. Multiple sides can contain vines. The "top" attachment is assumed to be present if data is 0 or there is solid block above.

• 1: Template:F
• 2: Template:F
• 4: Template:F
• 8: Template:F

Fence Gates

The left circle was opened from the outside, the right one from the inside. Facing directions: Red = North; Green = East; Yellow = South; Blue = West

Bits	Description
0x1 0x2	Two bits storing a value from 0 to 3 specifying the direction the gate is facing: 0: Facing south 1: Facing west 2: Facing north 3: Facing east
0x4	0 if the gate is closed, 1 if open.
0x8	If 1, the gate is lowered by three pixels, to accommodate attaching more cleanly with Walls.

Nether Wart

Like Crops, the data value is related to the size of the Nether Wart. There are three distinct visual stages to Nether Wart's growth (the associated data values are given):

Icon	Value
	0
	1–2
	3

Brewing Stand

The bottom three bits are bit flags for which bottle slots actually contain bottles.

Bits	Values
0x1	The slot pointing east
0x2	The slot pointing southwest
0x4	The slot pointing northwest

Cauldron

The data value stores the amount of water kept in the cauldron, in units of glass bottles that can be filled.

DV	Description
0	Empty
1	⅓ filled
2	⅔ filled
3	Fully filled

End Portal Frame

The bottom two bits determine which "side" of the whole portal frame this block is a part of. To make the frame activate, each of the portal frame blocks in the pattern must "face" toward the middle. Since the image is near-symmetrical, it is difficult to tell which direction an individual block is actually facing, but if the block isn't facing in that direction and that is the last frame block where the Eye of Ender is placed, the frame won't activate.

Direction vectors for the blocks are the following:

• 0: To the Template:F
• 1: To the Template:F
• 2: To the Template:F
• 3: To the Template:F

0x4 is a bit flag: 0 is an "empty" frame block, 1 is a block with an Eye of Ender inserted.

Cocoas

Cocoa/DV

Tripwire Hook

Bits	Values
0x1 0x2	A two-bit field storing a value from 0 to 3: 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
0x4	If set, the tripwire hook is connected and ready to trip ("middle" position).
0x8	If set, the tripwire hook is currently activated ("down" position)

Tripwire

Bits	Description
0x1	Set if tripwire is activated (an entity is intersecting its collision mask).
0x2	Set if tripwire is "suspended" (makes hitbox larger when set). Unclear what this is used for. Set by default on newly placed tripwires.
0x4	Set if tripwire is attached to a valid tripwire circuit.
0x8	Set if tripwire is disarmed.

Cobblestone Walls

Cobblestone Wall/DV

Flower Pots

For Flower Pot blocks placed from Minecraft version 1.7, the plant contained in the pot is stored in the associated Tile Entity. See Tile Entity Format for details. The absence of a tile entity indicates either an empty Flower Pot, or one whose block was placed prior to version 1.7.

For Flower Pot blocks placed before version 1.7 the plant contained in the pot is indicated by the data value, according to the following table:

	DV	Description
	0	Empty flower pot.
	1	Flower pot with contents.

Heads

For the item and for the tile entity, data values determine the skull type:

	DV	Description
	0	Skeleton Skull
	1	Wither Skeleton Skull
	2	Zombie Head
	3	Head
	4	Creeper Head
	5	Dragon Head

Block of Quartz

	DV	Description
	0	Block of Quartz
	1	Chiseled Quartz Block (vertical)
	2	Pillar Quartz Block (vertical)
	3	Smooth Quartz Block
	4	Block of Quartz (east-west)
	5	Chiseled Quartz Block (east-west)
	6	Pillar Quartz Block (east-west)
	7	Smooth Quartz (east-west)
	8	Block of Quartz (north-south)
	9	Chiseled Quartz Block (north-south)
	10	Pillar Quartz Block (north-south)
	11	Smooth Quartz (north-south)

Coal

Coal/DV

Dyes

Template:Dyes

Fish

Both raw and cooked fish use the same data values. Note that clownfish and pufferfish cannot be cooked.

Fish/DV

Anvil

Anvil data values differ between the item and block.

	DV	Description
	0	Anvil, facing West
	1	Anvil, facing North
	2	Anvil, facing East
	3	Anvil, facing South
	4	Slightly Damaged Anvil, facing West
	5	Slightly Damaged Anvil, facing North
	6	Slightly Damaged Anvil, facing East
	7	Slightly Damaged Anvil, facing South
	8	Very Damaged Anvil, facing West
	9	Very Damaged Anvil, facing North
	10	Very Damaged Anvil, facing East
	11	Very Damaged Anvil, facing South
	12	Broken Anvil, facing West
	13	Broken Anvil, facing North
	14	Broken Anvil, facing East
	15	Broken Anvil, facing South

For an anvil in the world, 0x1 is the bit that determines whether the anvil is orientated in a north-south (0) or a west-east (1) direction. 0x4 and 0x8 are bits which determine whether the anvil is a regular (0x4 & 0x8 = 0), a slightly damaged (0x4 = 1) or a very damaged (0x8 = 1) one. For an anvil in the inventory, the data value is a counter of how damaged it is.

Potions

A glass bottle filled with a potion. Potion type is stored in item's damage value as a 16-bit number. Potion effect, name, and other flags are encoded on bits. Effect duration itself isn't there, but can be calculated from other values.

Current meaning of bits is described below. Note that potion name overlaps with potion effect and tier.

Bit	Dec	Hex	Meaning
0	1	0001	Potion effect	Potion name
1	2	0002
2	4	0004
3	8	0008
4	16	0010
5	32	0020	Tier
6	64	0040	Extended duration
7	128	0080	(ignored)
8	256	0100
9	512	0200
10	1024	0400
11	2048	0800
12	4096	1000
13	8192	2000	Can become splash potion
14	16384	4000	Splash potion
15	32768	8000	(ignored)

To calculate damage value of potion with desired effect use the following formula:

DV = potion_effect + tier_bit + extended_bit + splash_bit

for example:

• potion with "Instant Health" effect has damage value 5 (= 5 + 0 + 0 + 0);
• potion with extended "Slowness" effect has value 74 (= 10 + 0 + 64 + 0);
• splash potion with tier II "Strength" effect has value 16425 (= 9 + 32 + 0 + 16384).

To get potion with certain name, use the following formula:

DV = potion_name + extended_bit + splash_bit

for example:

• Splash version of "Charming Potion" has damage value 16423 (= 39 + 0 + 16384)

"Potion name" bits

Dec	Hex	Potion
0	00	Water Bottle / Mundane Potion
1	01	Potion of Regeneration
2	02	Potion of Swiftness
3	03	Potion of Fire Resistance
4	04	Potion of Poison
5	05	Potion of Healing
6	06	Potion of Night Vision
7	07	Clear Potion
8	08	Potion of Weakness
9	09	Potion of Strength
10	0a	Potion of Slowness
11	0b	Potion of Leaping
12	0c	Potion of Harming
13	0d	Potion of Water Breathing
14	0e	Potion of Invisibility
15	0f	Thin Potion

Dec	Hex	Potion
16	10	Awkward Potion
17	11	Potion of Regeneration
18	12	Potion of Swiftness
19	13	Potion of Fire Resistance
20	14	Potion of Poison
21	15	Potion of Healing
22	16	Potion of Night Vision
23	17	Bungling Potion
24	18	Potion of Weakness
25	19	Potion of Strength
26	1a	Potion of Slowness
27	1b	Potion of Leaping
28	1c	Potion of Harming
29	1d	Potion of Water Breathing
30	1e	Potion of Invisibility
31	1f	Debonair Potion

Dec	Hex	Potion
32	20	Thick Potion
33	21	Potion of Regeneration
34	22	Potion of Swiftness
35	23	Potion of Fire Resistance
36	24	Potion of Poison
37	25	Potion of Healing
38	26	Potion of Night Vision
39	27	Charming Potion
40	28	Potion of Weakness
41	29	Potion of Strength
42	2a	Potion of Slowness
43	2b	Potion of Leaping
44	2c	Potion of Harming
45	2d	Potion of Water Breathing
46	2e	Potion of Invisibility
47	2f	Sparkling Potion

Dec	Hex	Potion
48	30	Potent Potion
49	31	Potion of Regeneration
50	32	Potion of Swiftness
51	33	Potion of Fire Resistance
52	34	Potion of Poison
53	35	Potion of Healing
54	36	Potion of Night Vision
55	37	Rank Potion
56	38	Potion of Weakness
57	39	Potion of Strength
58	3a	Potion of Slowness
59	3b	Potion of Leaping
60	3c	Potion of Harming
61	3d	Potion of Water Breathing
62	3e	Potion of Invisibility
63	3f	Stinky Potion

Note: potion with name set to 0 is called "Water Bottle" only if no other bit is set. Otherwise, it is called "Mundane Potion".

Note: potions with an effect and splash potion bit set have additional "Splash " prefix.

"Potion effect" bits

Dec	Hex	Effect	Potion suffix	Duration	Bottles	Icon	Effect color	Tier II?
0	0	-	-	-	File:Grid Mundane Potion.pngFile:Grid Splash Mundane Potion.png	-	-	-
1	1	Regeneration	Regeneration	0:45	File:Grid Potion of Regeneration.pngFile:Grid Splash Potion of Regeneration.png		Pink	Yes
2	2	Speed	Swiftness	3:00	File:Grid Potion of Swiftness.pngFile:Grid Splash Potion of Swiftness.png		Sky blue	Yes
3	3	Fire Resistance	Fire Resistance	3:00	File:Grid Potion of Fire Resistance.pngFile:Grid Splash Potion of Fire Resistance.png		Orange	No
4	4	Poison	Poison	0:45	File:Grid Potion of Poison.pngFile:Grid Splash Potion of Poison.png		Green	Yes
5	5	Instant Health	Healing	instant	File:Grid Potion of Healing.pngFile:Grid Splash Potion of Healing.png	-	-	Yes
6	6	Night Vision	Night Vision	3:00	File:Grid Potion of Night Vision.pngFile:Grid Splash Potion of Night Vision.png		Navy blue	No
7	7	-	-	-	File:Grid Mundane Potion.pngFile:Grid Splash Mundane Potion.png	-	-	-
8	8	Weakness	Weakness	1:30	File:Grid Potion of Weakness.pngFile:Grid Splash Potion of Weakness.png		Gray	No
9	9	Strength	Strength	3:00	File:Grid Potion of Strength.pngFile:Grid Splash Potion of Strength.png		Dark red	Yes
10	a	Slowness	Slowness	1:30	File:Grid Potion of Slowness.pngFile:Grid Splash Potion of Slowness.png		Blue-gray	No
11	b	Jump Boost	Leaping	3:00	File:Grid Potion of Leaping.pngFile:Grid Splash Potion of Leaping.png		Bright green	Yes
12	c	Instant Damage	Harming	instant	File:Grid Potion of Harming.pngFile:Grid Splash Potion of Harming.png	-	-	Yes
13	d	Water Breathing	Water Breathing	3:00	File:Grid Splash Potion of Water Breathing.png		Blue	No
14	e	Invisibility	Invisibility	3:00	File:Grid Potion of Invisibility.pngFile:Grid Splash Potion of Invisibility.png		Light gray	No
15	f	-	-	-	File:Grid Mundane Potion.pngFile:Grid Splash Mundane Potion.png	-	-	-

"Tier" bit

Dec	Hex	Meaning
0	0000	Tier I effect.
32	0020	Tier II effect. Multiply duration by 1/2.

Note: Fire Resistance, Weakness and Slowness effects have no second tier. Their strength and duration are unaffected by this bit.

"Extended duration" bit

Dec	Hex	Meaning
0	0000	Base duration.
64	0040	Multiply duration by 8/3.

"Splash potion" bit

Dec	Hex	Meaning
0	0000	Drinkable potion.
16384	4000	Splash potion. Multiply duration by 3/4.

Spawn Eggs

Damage values on spawn eggs will cause it to spawn the entity of that id. For example; "/give [playername] spawn_egg 1 50" (a damage value of 50) would cause the spawn egg to create creepers.

Spawn Egg/DV

Maps

Each map item's damage value corresponds to the map ID saved in each world's NBT data. The map's parameters, such as the scale of the map, its location in the world and what areas are explored are saved in separate .dat files, unlike written books or fireworks which store their additional data directly into the item itself. If a map is cloned they will both share the same damage value and newly explored areas will appear on both instances.

Golden Apple

Golden Apple/DV

Trivia

• Using /give command or inventory editors, an item can be spawned with its data value out of normal bounds. This can cause a normal looking item to appear, but will be unusable and unstackable with an identical item that has a different data value. In the case of Wool colors, data values "rotate" when out of bounds. Examples are provided:
  • Example 1 - Stacking: If the player were to type /give <PLAYERNAME> 351 1 1, an Ink Sac would be given to the player like normal. However, if the player were to type /give <PLAYERNAME> 351 1 -4 afterward, another Ink Sac would be given, but it won't stack with the first Ink Sac, because the two Ink Sacs have different data values, despite the fact that both items appear to be the same thing.
  • Example 2 - Value Defaults: Using the /give command to spawn an item with data values that are out of valid bounds will "default" to the lowest or highest valid data value closest to it. Typing /give <PLAYERNAME> 351 1 -23 will spawn an Ink Sac, due to -23 being closest to 0, the lowest possible valid data value for dye, being the Ink Sac. Typing /give <PLAYERNAME> 351 1 43 will spawn Bone Meal, because 43 is closest to the dye's highest valid data value, being 15, which is what Bone Meal is.
  • Example 3 - Non-usable: Note that the valid data values for dye are between the numbers 0 and 15. Any type of dye that's spawned with an data value lower than 0 or higher than 15 cannot be used. So if one is using the /give command to spawn a dye with a data value above 15, which would spawn Bone Meal, the said Bone Meal can not be used to mix with other dyes or be used as a quick plant growing agent.
  • Example 4 - Rotation: Data value rotation has been confirmed for Wool, but only the colors seem to rotate. Using a Wool data value of 16 (when the highest is 15) (Note: the wool data value of 16 is shown as nether warts in the inventory, but when placed by the player it becomes white wool) will "circle back" to white wool, which is 0. Using an data value of 18 will circle back to Magenta Wool, because 18 is 3 integers higher than the max of 15, it will circle back to 0, but the extra 3 bumps it to the data value of 2. Using /give to hack in wool with a damage value above 255, however, will result in a flat wool block. Additionally, the color rotation is reversed in the inventory; a wool block with a damage value of 256, for example, looks like black wool in the inventory, but converts to white wool when placed. The highest damage value that can be achieved with /give is 2,147,483,647, which appears as white wool that converts to black wool when placed. A similar effect happens with every block/item with damage values, depending on the block. For example, giving yourself a Wood block with a data value of 10 would give a rotated Birch wood block, because wood uses data values to determine their rotation. As with Wool, giving yourself wood with a data value above 15 will cycle round back to a wood block that appears as the matching wood block with a data value 16 less than itself (for example, a wood block with a data value of 16 appears as Oak Wood but cannot be crafted into planks and will not stack with regular Oak Wood). Wood with a data value above 255 does not appear flat; the data rotation happens normally.

Video

Java Edition data values/video