Leaves

Transparent	Partial (diffuses sky light)
Luminance	0
Blast resistance	1
Tool
Renewable	Yes
Stackable	Yes (64)
Flammable	Yes
Drops	Saplings (0–1) Apple (0–1) (from oak and dark oak leaves) Stick (0–2)
Data values	Oak/Spruce/Birch/Jungle dec: 18 hex: 12 bin: 10010 Acacia/Dark Oak dec: 161 hex: A1 bin: 10100001
Namespaced ID	See § Data values

	“	Leaves were one of Minecraft's earliest additions, arriving alongside logs, ores and sand way back in 2009 ... They've changed a lot over time, first being tweaked to drop saplings, then to decay when deprived of their trunk, then to drop apples, then even to have water drip through them when it's raining!	„
		— Duncan Geere^[1]

Leaves are blocks which grow as part of trees.

Obtaining[edit]

Leaves can only be obtained with shears or Silk Touch enchanted tools.

Block	Leaves
Hardness	0.2
Breaking time
Hand	0.35
Shears	0.05
Sword	0.2

Natural generation[edit]

Leaves occur naturally on trees throughout the Overworld. Oak leaves also generate in woodland mansions.

Usage[edit]

Leaves from trees spontaneously decay (disappear) when they receive a block tick if they are not connected to any log, either directly or via other leaf block, with a maximum distance of 6 blocks. Player-placed leaf blocks will never decay.

Leaves which decay or are destroyed without using shears yield saplings or sticks 5% (1/20) of the time, and otherwise drop nothing. Jungle leaves drop saplings 2.5% (1/40) of the time. Oak and dark oak leaves also have a separate but additional 0.5% (1/200) chance of dropping an apple, making it extremely rare but possible for a single leaf to drop both an apple and a sapling simultaneously. Rates are increased by the Fortune enchantment. Leaves that are burned do not yield saplings or apples.

Leaves take on a different shade of green depending on the biome in which they are placed.

Leaves are always transparent to light, but cannot be seen through when the graphics mode is set to "Fast"; the transparent regions are instead black. They diffuse sky light, causing the shadows they cast under trees.

Redstone Component^{[Java Edition only]}[edit]

The state of a leaves block --including a player-placed block-- changes instantly when the distance to the nearest Log or Wood block changes, up to 6 blocks of leaves away. Observers facing away from the leaves will detect this change and transmit a redstone signal in the same game tick, making leaves useful for instant redstone signal transmission.

Composting[edit]

Leaves have a 30% chance of increasing the compost level in a composter by 1.

List of colors[edit]

^{[more information needed]}

Java Edition[edit]

Hard-coded colors

In the inventory, Leaves have a color: #48B518.
Spruce Leaves have a color: #619961. Not affects from biomes and the inventory color.
Birch Leaves have a color: #80a755. Not affects from biomes and the inventory color.

Biome Colors

Biome	Category	Rainfall	Foliage Color	Temperature Affects	Render
Badlands	Mesa	No	#9e814d	No
Badlands Plateau	Mesa	No	#9e814d	No
Beach	Beach	Rain	#77ab2f
Birch Forest	Forest	Rain	#6ba941
Birch Forest Hills	Forest	Rain	#6ba941
Cold Ocean	Ocean	Rain	#71a74d
Dark Forest	Forest	Rain	#59ae30
Dark Forest Hills	Forest	Rain	#59ae30
Deep Cold Ocean	Ocean	Rain	#71a74d
Deep Frozen Ocean	Ocean	Rain	#71a74d
Deep Lukewarm Ocean	Ocean	Rain	#71a74d
Deep Ocean	Ocean	Rain	#71a74d
Deep Warm Ocean	Ocean	Rain	#71a74d
Desert	Desert	No	#aea42a
Desert Hills	Desert	No	#aea42a
Desert Lakes	Desert	No	#aea42a
End Barrens	The End	No	#71a74d
End Highlands	The End	No	#71a74d
End Midlands	The End	No	#71a74d
Eroded Badlands	Mesa	No	#9e814d	No
Flower Forest	Forest	Rain	#59ae30
Forest	Forest	Rain	#59ae30
Frozen Ocean	Ocean	Snow	#60a17b
Frozen River	River	Snow	#60a17b
Giant Spruce Taiga	Taiga	Rain	#68a464
Giant Spruce Taiga Hills	Taiga	Rain	#68a464
Giant Tree Taiga	Taiga	Rain	#68a55f
Giant Tree Taiga Hills	Taiga	Rain	#68a55f
Gravelly Mountains	Extreme Hills	Rain	#6da36b
Gravelly Mountains+	Extreme Hills	Rain	#6da36b
Ice Spikes	Icy	Snow	#60a17b
Jungle	Jungle	Rain	#30bb0b
Jungle Edge	Jungle	Rain	#3eb80f
Jungle Hills	Jungle	Rain	#30bb0b
Lukewarm Ocean	Ocean	Rain	#71a74d
Modified Badlands Plateau	Mesa	No	#9e814d	No
Modified Jungle	Jungle	Rain	#30bb0b
Modified Jungle Edge	Jungle	Rain	#3eb80f
Modified Wooded Badlands Plateau	Mesa	No	#9e814d	No
Mountain Edge	Extreme Hills	Rain	#6da36b
Mountains	Extreme Hills	Rain	#6da36b
Mushroom Fields	Mushroom	Rain	#2bbb0f
Mushroom Field Shore	Mushroom	Rain	#2bbb0f
Nether	Nether	No	#aea42a
Ocean	Ocean	Rain	#71a74d
Plains	Plains	Rain	#77ab2f
River	River	Rain	#71a74d
Savanna	Savanna	No	#aea42a
Savanna Plateau	Savanna	No	#aea42a
Shattered Savanna	Savanna	No	#aea42a
Shattered Savanna Plateau	Savanna	No	#aea42a
Small End Islands	The End	No	#71a74d
Snowy Beach	Beach	Snow	#64a278
Snowy Mountains	Icy	Snow	#60a17b
Snowy Taiga	Taiga	Snow	#60a17b
Snowy Taiga Hills	Taiga	Snow	#60a17b
Snowy Taiga Mountains	Taiga	Snow	#60a17b
Snowy Tundra	Icy	Snow	#60a17b
Stone Shore	None	Rain	#6da36b
Sunflower Plains	Plains	Rain	#77ab2f
Swamp	Swamp	Rain	#6a7039	If temperature below -0.1, used #4C763C.	/
Swamp Hills	Swamp	Rain	#6a7039	If temperature below -0.1, used #4C763C.	/
Taiga	Taiga	Rain	#68a464
Taiga Hills	Taiga	Rain	#68a464
Taiga Mountains	Taiga	Rain	#68a464
Tall Birch Forest	Forest	Rain	#6ba941
Tall Birch Hills	Forest	Rain	#6ba941
The End	The End	No	#71a74d
The Void	None	No	#71a74d
Warm Ocean	Ocean	Rain	#71a74d
Wooded Badlands Plateau	Mesa	No	#9e814d	No
Wooded Hills	Forest	Rain	#59ae30
Wooded Mountains	Extreme Hills	Rain	#6da36b

Data values[edit]

ID[edit]

Java Edition:

Name	Namespaced ID
Oak Leaves	`oak_leaves`
Spruce Leaves	`spruce_leaves`
Birch Leaves	`birch_leaves`
Jungle Leaves	`jungle_leaves`
Acacia Leaves	`acacia_leaves`
Dark Oak Leaves	`dark_oak_leaves`

Bedrock Edition:

Name	Namespaced ID	Numeric ID
Leaves (oak to jungle)	`leaves`	18
Leaves (acacia to dark oak)	`leaves2`	161

Block data[edit]

Block states[edit]

History[edit]

Java Edition Classic
0.0.14a					Leaves were first added to the game.
0.0.15a (Multiplayer Test 1)					The texture of leaves was changed.
August 25, 2009					Demonstrated that leaves will now drop saplings.
0.24_SURVIVAL_TEST					Added the above.^{[needs testing]}
Java Edition Indev
0.31		20091223-2			Leaves will now give off shadows.
Java Edition Alpha
v1.0.6_01					Leaves will now decay again when not connected to the ground or to a tree trunk.
v1.1.0					Torches can no longer be placed on tree leaves, but only in fancy mode.
v1.2.0		preview			With the addition of biomes, the color of leaves have been changed.
v1.2.1					Leaf particle colors will now reflect the biome, instead of the gray scale texture.
v1.2.3					Leaf decay has been re-introduced.
v1.2.3_01					Leaf decay is now disabled, due to an infinite loop in the code.
Java Edition Beta
1.0					Re-introduced leaf decay with the new behavior.
1.2					Birch and spruce trees introduced. Trees pre-dating this update would include multiple types of leaves, as the data indicating leaf type was previously used for decay calculations.
1.6		?			Many disparities between the properties of leaves in Fast and Fancy graphics have been fixed.
1.7					Implemented shears to collect leaves. Before, leaves could only be obtained via inventory editing.
?					Leaves no longer appear gray (blank and uncolored, default texture before the application of biome coloration) in the inventory.
1.8		?			Leaf blocks placed by the player or an enderman no longer decay like normal leaves do.
Java Edition
1.1		11w48a			Oak leaves have a small chance of dropping an apple.
1.2.1		12w03a			Added jungle leaves. Oak trees pre-dating Beta 1.2 could include some jungle leaves, as the data indicating leaf type had previously been used for decay calculations.
1.3.1		12w18a			Jungle leaves have a small chance of dropping cocoa beans.
		12w19a			Jungle leaves no longer drop cocoa beans.
		12w21a			Water now slowly drips through them when it's raining.
1.7.2		13w43a			Acacia and dark oak leaves were added.
1.11		16w39a			Leaves now generate in woodland mansions.
1.13		17w47a			The different variant block states for both the `leaves` and `leaves2` IDs have been split up into their own IDs.
		17w47a			Prior to The Flattening, these blocks' numeral IDs were 18 and 161.
		18w22a			Naturally-generated leaves will now survive at a distance of up to 6 blocks from logs, instead of 4.
1.14		18w43a			Leaves now have a small chance to drop sticks when decaying.
		18w43a			Changed the textures of all leaves.
		19w03a			Placing leaves into the new composter has a 10% chance of raising the compost level by 1.
		19w05a			Leaves now have a 30% chance of increasing the compost level in a composter by 1.
Pocket Edition Alpha
Pre-release					Added leaves.
0.8.0		build 2			Birch leaves now have the proper texture.
					The color of leaves has been changed.
					Added jungle leaves to Creative.
0.9.0		build 1			Added acacia and dark oak leaves.
					Jungle leaves can now be obtained in survival mode as part of jungle trees.
					Jungle leaves are now permanently opaque.
					Smooth lighting added for leaves.
					Leaves will now release spiders, creating a higher amount of spiders in tree-rich biomes at night (version exclusive).
0.12.1		build 1			Version exclusive: Leaves in snowy biomes will now appear frost-covered.
Pocket Edition
1.1.0		alpha 1.1.0.0			Leaves will now generate in woodland mansions.
Bedrock Edition
1.2.0		beta 1.2.0.22			Jungle leaves are now transparent on higher-end devices when Fancy leaves are turned on.
1.10.0		beta 1.10.0.3			Leaves now have a small chance to drop sticks when decaying.
1.10.0		beta 1.10.0.3			Changed the textures of all leaves.
1.11.0		beta 1.11.0.1			Leaves can now be used to fill up composters.
Legacy Console Edition
TU1	CU1	1.0	Patch 1	1.0.1	Added leaves.
TU5					Leaf blocks placed by the player no longer decay like normal leaves do.
TU9					Added birch and spruce leaves.
TU12					Added jungle leaves.
TU14		1.04			Water drip particles appear underneath if it's raining.
PlayStation 4 Edition
1.90					Leaves now have a small chance to drop sticks when decaying.
New Nintendo 3DS Edition
0.1.0					Added leaves.

Original leaf decay algorithm[edit]

This feature is exclusive to Java Edition.

Leaves from the 0.0.15a. The leaves from this version don't decay when standing by themselves.

In Alpha, leaves would decay using an algorithm that checks whether it has a solid or leaf block underneath it or is adjacent to a solid block. If it doesn't, it must be connected to a leaf block that is also supported as long as it is no further than five blocks away from said support.

Alpha-style decay
The extent a single "branch" of leaves can survive.
Leaves can be connected an infinite distance away from a support block.

Issues[edit]

Issues relating to "Leaves" are maintained on the bug tracker. Report issues there.

Trivia[edit]

Occasionally, leaves will grow through other blocks, acting as though they are still connected to the tree. They may also completely replace blocks they try to grow into.
Leaves do not prevent chests from being opened.
Some trees seem to occasionally drop apples or saplings without being destroyed due to creation of leaf blocks not supported by logs.
The frost texture in Bedrock Edition is not an instant transition. Instead, the leaves slowly shift from their original color to the frosty one.
Leaves disappear when pushed by pistons.
Leaves Z-fight with blocks such as carpet that are placed on top; a bug which Mojang decided not to fix.^[2]‌^{[Bedrock Edition only]}

Gallery[edit]

The default texture for snowy jungle leaves have a yellowish tint in some areas.
A red mushroom is seen growing on the top of a block of leaves.
The original texture for the creeper seems to be the leaves texture over a white player texture with a face and slightly distorted.

References[edit]

↑ "Block of the Week: Leaves" – Minecraft.net, August 18, 2017
↑ MCPE-31042

Blocks

View at: Template:Blocks/content [edit]

[1] "Block of the Week: Leaves" – Minecraft.net, August 18, 2017

[2] MCPE-31042

[1]

[2]

	DV	Description
	0	Oak Leaves
	1	Spruce Leaves
	2	Birch Leaves
	3	Jungle Leaves
	4	Oak Leaves (no decay)
	5	Spruce Leaves (no decay)
	6	Birch Leaves (no decay)
	7	Jungle Leaves (no decay)
	8	Oak Leaves (check decay)
	9	Spruce Leaves (check decay)
	10	Birch Leaves (check decay)
	11	Jungle Leaves (check decay)
	12	Oak Leaves (no decay and check decay)
	13	Spruce Leaves (no decay and check decay)
	14	Birch Leaves (no decay and check decay)
	15	Jungle Leaves (no decay and check decay)

	DV	Description
	0	Acacia Leaves
	1	Dark Oak Leaves
	4	Acacia Leaves (no decay)
	5	Dark Oak Leaves (no decay)
	8	Acacia Leaves (check decay)
	9	Dark Oak Leaves (check decay)
	12	Acacia Leaves (no decay and check decay)
	13	Dark Oak Leaves (no decay and check decay)

Name	Default value	Allowed values	Description
distance	`7`	`1` `2` `3` `4` `5` `6` `7`	How far away this block is from the appropriate wood type.
persistent	`false`	`false` `true`	If the block will stay regardless of having no wood nearby.

Name	Default value	Allowed values	Description
old_leaf_type	`oak`	`oak`	Oak Leaves
		`spruce`	Spruce Leaves
		`birch`	Birch Leaves
		`jungle`	Jungle Leaves
persistent_bit	`false`	`false` `true`	If the block will stay regardless of having no wood nearby.
update_bit	`false`	`false` `true`	If the block will check for nearby wood.

Name	Default value	Allowed values	Description
new_leaf_type	`acacia`	`acacia`	Acacia Leaves
new_leaf_type	`acacia`	`dark_oak`	Dark Oak Leaves
persistent_bit	`false`	`false` `true`	If the block will stay regardless of having no wood nearby.
update_bit	`false`	`false` `true`	If the block will check for nearby wood.

Leaves

Contents