Overview#
Rapid Leaf Decay is a streamlined utility mod designed to solve one of Minecraft's most common annoyances: lingering foliage. In vanilla Minecraft, leaves can take several minutes to decay after their supporting logs are removed. This mod significantly accelerates that process, causing leaves to disappear within seconds of a tree being felled.
Key features include:
- Instantaneous Feedback: Leaves begin decaying almost immediately after the last log is broken.
- Server-Side Only: The mod only needs to be installed on the server. Clients do not need the mod to see the effects, making it ideal for public and private multiplayer servers.
- Drop Integrity: The mod does not change the loot tables of leaves. You will still receive the standard amount of saplings, apples, and sticks as if the leaves had decayed naturally.
- Mod Compatibility: It automatically supports any leaf block from other mods (such as Biomes O' Plenty or Twilight Forest) as long as they are correctly tagged with the
minecraft:leavesblock tag.
Mechanics#
The mod operates by monitoring block updates related to logs. When a log block is broken, the mod identifies adjacent leaf blocks and checks their distance from the nearest log. If a leaf block is no longer within the valid range of a log (typically 7 blocks in vanilla), the mod schedules it for rapid removal.
Decay Logic
Unlike vanilla decay, which relies on random ticks, Rapid Leaf Decay uses a scheduled task system. This ensures that decay happens predictably and quickly without putting excessive strain on the server's CPU. The mod processes leaf blocks in a chain-like fashion, often resulting in a satisfying 'wave' of decay that moves from the trunk area outward.
| Feature | Vanilla Behavior | Rapid Leaf Decay Behavior |
|---|---|---|
| Decay Start | Random (can take minutes) | Near-instant (configurable) |
| Decay Speed | Slow and staggered | Rapid and synchronized |
| Performance | Low (Random Ticks) | Optimized (Scheduled Tasks) |
| Modded Trees | Varies | Full support via Tags |
Configuration#
Rapid Leaf Decay is highly customizable. The configuration file allows server administrators to fine-tune the speed and delay of the decay process to suit their server's performance or aesthetic preferences.
File Location
The configuration file is located at:
world/serverconfig/rapid_leaf_decay-server.toml
(Note: In single-player, this is found within the specific world save folder).
Configuration Options
| Option | Default Value | Description |
|---|---|---|
decay_delay |
2 | The number of ticks to wait between each decay action. Lower values result in faster decay. |
decay_speed |
1 | Determines how many leaf blocks are processed per tick. Increasing this will make large trees disappear faster but may impact performance on very weak hardware. |
Compatibility#
The mod is designed with maximum compatibility in mind. Because it utilizes the standard Minecraft tagging system, it works out of the box with the vast majority of world-generation and flora mods.
- Modded Leaves: Any block added to the
#minecraft:leavestag is automatically handled. - Modded Logs: Any block added to the
#minecraft:logstag is recognized as a valid support for leaves, preventing accidental decay of player-built structures. - Tree Farms: The mod is compatible with most automated tree farms. However, if a farm relies on specific vanilla decay timings, the
decay_delaymay need to be adjusted in the config.
Installation Requirements#
To use Rapid Leaf Decay, ensure the following requirements are met:
- Environment: Server-side (required), Client-side (optional for single-player).
- Version Support: Currently supports Minecraft through 1.21.11.
No additional library mods are required for the base functionality of Rapid Leaf Decay.
