Partial (diffuses sky light)
Leaves are a type of block which grow as part of trees. There are six types of leaf blocks, one for each of the six types of trees (oak, birch, spruce, jungle, acacia, and dark oak), which are identical except for their appearance and their drops when destroyed. Leaf blocks are easily destroyed by tools, explosions, and fire, and when destroyed may drop saplings which can be used to plant new trees.
Leaves have no use in crafting.
Leaves take on a different shade of green depending on the biome in which they are placed.
Like cobwebs, leaves do not have any extra effect on block light, but they do diffuse sky light, causing the shadows they cast under trees. The light level from sunlight or moonlight is the same in each block of air in the column of air above the highest obstruction in the column. When placed, leaves obstruct that light column so that the lowest air block above the leaves acts as other light sources do. As you descend below the leaves, the light level diminishes with distance like it would from other light sources such as torches. To control this effect, create an opaque 1x1 chimney with leaves at its opening above you.
Leaves from trees spontaneously decay (disappear) randomly when not connected to a wood (log) block by other leaf blocks, with a maximum distance of 4 blocks. Decaying leaves will drop saplings and apples at the same rate as directly destroyed blocks. The supporting wood block doesn't need to be of the same tree type. Player-placed leaf blocks will never decay and can be used in construction such as tree houses and hedges.
- When harvesting using shears or a Silk Touch tool, leaves drop as themselves and can be placed elsewhere.
- Leaves which decay or are destroyed without using shears usually drop nothing, but yield saplings 5% (1/20) of the time. Jungle leaves drop saplings 2.5% (1/40) of the time.
- Oak leaves also have a 0.5% (1/200) chance of dropping an apple.
- Leaves that are burned do not yield saplings or apples.
|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)|
|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)|
|0.0.14a_01||Trees were first added to the game. They had a different texture:|
|0.0.15a||The texture of leaves was changed:|
|0.24_06||Leaves now drop sapling.|
|December 23, 2009||Leaves give off shadows.|
|1.0.6_01||Leaves decay again when not connected to the ground or to a tree trunk.|
|Seecret Friday 9||Torches can no longer be placed on tree leaves, but only in fancy mode.|
|1.2.0||With the addition of biomes, the color of leaves was changed:|
|1.2.1||Leaf particle colors now reflect the biome instead of the gray scale texture.|
|1.2.3||Re-introduced leaf decay.|
|1.2.3_01||Leaf decay disabled due to an infinite loop in the code.|
|1.0||Reintroduced leaf decay with the new behavior.|
|1.2||Birch and pine trees introduced. Trees pre-dating this update would appear to have multiple types of leaves, as the data indicating tree type was previously used for decay calculations.|
|1.5||Added birch and spruce leaves.|
|1.6||Before, the fact that leaves were marked as transparent when set to Fancy graphics, but marked as opaque when set to Fast, made it possible to place torches and ladders on leaves in "Fast" graphics and switch back to "Fancy" graphics without making them come off. Similarly, in "Fast" graphics, getting stuck inside leaves (usually by using Bone Meal) would suffocate you, while on "Fancy" graphics leaves would not suffocate you. For the full list of things leaves do differently depending on graphics mode, see Opacity. Because of its transparency, leaves were used as windows before glass was implemented. In older versions, hostile mobs could have spawned on leaves on "Fast" graphics. In SMP, leaves had always behaved as if running in "Fast" graphics mode. This meant that torches could be placed on leaves and hostile mobs had a chance to spawn on them, even when running "Fancy" graphics.|
|1.7||Implemented shears to collect leaves. Before, leaves could only be obtained via inventory hacking, or the
|1.8||Leaf blocks placed by the player or an Enderman no longer decay like normal leaves do.|
|1.1||11w48a||Oak leaves have a small chance of dropping a red apple.|
|1.2.1||12w03a||A fourth type of leaves was added, which only naturally occurs in Jungle biomes.|
|1.3.1||12w18a||Jungle leaves have a small chance of dropping cocoa beans.|
|12w19a||Jungle leaves no longer drop cocoa beans.|
|12w21a||Water slowly drips through them when its raining.|
|1.7.1||13w43a||Acacia and Dark Oak leaves were added.|
|Pocket Edition Alpha|
|0.8.0||build 2||Birch leaves now have the proper texture.|
|Color of leaves 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).|
|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||Water drip particles appear underneath if it's raining.|
Original leaf decay algorithm
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.
Issues relating to "Leaves" are maintained on the issue tracker. Report issues there.
- 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 a sapling from growing. As long as the five blocks above a sapling are transparent, the tree will grow (provided it has enough light).
- In the default textures, the leaf to air ratio for the texture is about 3:2 for normal/birch leaves, and about 9:5 for spruce leaves.
- Leaves do not prevent chests from being opened, even when running in "Fast" graphics mode. See Opacity.
- Despite being highly flammable, leaf blocks cannot be used as fuel for a furnace.
- Some trees seem to occasionally drop apples or saplings without being destroyed due to creation of leaf blocks not supported by wood.
- Leaves were the first block in the game that gave you a different item depending on what tool you used to harvest it (shears or hands)
- There is no real difference in amount of apples or saplings dropped from leaves when they decay naturally versus being destroyed by the player.