Overview#
Quick Leaf Decay (version 26.1.2) is a streamlined utility mod designed to solve the common issue of floating leaf canopies in Minecraft. When a player harvests the wood from a tree, the remaining leaves typically take a significant amount of time to decay through the game's random tick system. This mod forces those leaves to decay within seconds, dropping saplings, sticks, and apples as they would in vanilla gameplay.
The mod is built with performance in mind, utilizing a data-driven approach that minimizes server lag. It is a server-side only mod, meaning it does not need to be installed on the client's machine to function on a multiplayer server, though it works perfectly in single-player worlds as well.
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.
Configuration#
Quick Leaf Decay is highly customizable via its configuration file, typically located at /config/quickleafdecay.json. Users can fine-tune the speed and behavior of the decay to suit their server's performance needs.
| Option | Type | Default | Description |
|---|---|---|---|
decay_delay |
Integer | 2 | The number of ticks between each decay action. Lower values result in faster decay. |
fuzz |
Integer | 5 | Adds a degree of randomness to the decay timing to prevent all leaves from vanishing at the exact same millisecond. |
all_leaves |
Boolean | false | If true, all leaves in the world (including those not broken by players) will decay at the accelerated rate. |
ignore_different_leaves |
Boolean | true | When true, leaves will only check for logs compatible with their own type. |
ignore_different_logs |
Boolean | true | When true, leaves will ignore logs from different tree types when determining whether to decay. |
Compatibility#
The mod is designed to be "plug-and-play" with most other Minecraft mods. It achieves this by using the standard Minecraft Block Tags system.
- Modded Trees: Any leaf block that is added to the
#minecraft:leavestag and any log added to the#minecraft:logstag will automatically benefit from quick decay. - Biomes O' Plenty / Oh The Biomes You'll Go: Fully compatible out of the box as these mods utilize standard tags.
- Custom Tags: Advanced users can add compatibility for unique blocks by creating a data pack that includes their custom blocks in the mod's internal tag system. This allows the mod to handle non-standard "trees" like giant mushrooms or alien flora from other dimensions.
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.
