Quick Leaf Decay Mod — Guide

Mechanics

The mod modifies the standard leaf decay logic to be more aggressive and thorough. Unlike the vanilla system which relies on infrequent random ticks, Quick Leaf Decay triggers a rapid check sequence as soon as a log block is broken.

Decay Logic

When a log is removed, the mod scans nearby leaf blocks. If a leaf block is no longer within a valid range of a log (typically 7 blocks), it is scheduled for immediate decay. The process is staggered slightly to create a visual "falling" effect rather than an instant disappearance of the entire canopy.

Diagonal Checking

One of the standout features of this version is Diagonal Neighbor Checking. Vanilla Minecraft often leaves behind "stray" leaves because the decay check only looks at adjacent blocks. Quick Leaf Decay includes diagonal blocks in its search radius, ensuring that even complex or modded tree shapes are fully cleared without leaving floating remnants.

Azalea Support

The mod includes specialized handling for Azalea trees, which feature two distinct types of leaves (Flowering and Regular). It correctly identifies both types as part of the same tree structure, preventing the common bug where one type fails to decay when the other is present.

Comparison of standard decay versus quick leaf decay

Technical Specifications

Requirements

Minecraft Version: 1.21.1

Performance Impact

Because the mod only activates when a log is broken and uses a localized scanning algorithm, its impact on TPS (Ticks Per Second) is negligible. It is significantly more efficient than older "instant decay" mods that would attempt to break hundreds of blocks in a single tick, which often caused server-wide lag spikes.