Leaf Decay Instant

Tired of floating leaves after cutting down a tree? Leaf Decay Instant removes them immediately — no more ugly leaf blobs hovering in the sky.

---

Features

• Instant decay — leaves disappear the moment they lose connection to a log
• Chain decay mode — watch leaves cascade in a satisfying wave from the trunk outwards
• Extra drops — configurable bonus chance for saplings, sticks, and apples
• Sound variety — multiple break sounds with configurable chance and pitch
• Particle options — choose between leaf texture, composter, or happy villager particles
• In-game commands — change any setting at runtime with /leafdecay set <option> <value>
• Performance friendly — uses Minecraft's native tick system, minimal overhead
• Highly configurable — 20+ options to tune the mod to your taste
• Mod compatible — works with any mod that extends the base LeavesBlock
• Server-side — clients don't need the mod installed

---

Commands

Note: Commands require OP level 2. On multiplayer servers, use LuckPerms to restrict /leafdecay to staff.

/leafdecay reload
/leafdecay set <option> <value>

Examples:

/leafdecay set chainDecay true
/leafdecay set chainDelay 3
/leafdecay set soundChance 0.5
/leafdecay set particleType composter
/leafdecay set extraSaplingChance 2.0
/leafdecay reload

---

Configuration

Config file is created on first launch at config/instant_leaf_decay.json.

Core

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| enabled | bool | true | Master toggle |
| decayTicks | int | 2 | Ticks to wait before leaves decay |

Particles

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| particles | bool | true | Enable particle effects |
| particleCount | int | 8 | Number of particles per decay |
| particleType | string | "block" | "block", "composter", or "happy" |

Sound

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| sound | bool | true | Enable sound effects |
| soundVolume | float | 0.8 | Volume (0.0 – 1.0) |
| soundPitchMin | float | 1.0 | Minimum pitch |
| soundPitchMax | float | 1.2 | Maximum pitch |
| soundChance | float | 0.3 | Chance per leaf to play sound |

Supported sound IDs:
minecraft:block.grass.break, minecraft:block.azalea_leaves.break, minecraft:block.moss.break, minecraft:block.azalea.break, minecraft:block.flowering_azalea.break, minecraft:block.cherry_leaves.break, minecraft:block.sweet_berry_bush.break

Chain Decay

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| chainDecay | bool | false | Enable cascading wave decay |
| chainDelay | int | 2 | Spread factor (higher = slower wave) |

Extra Drops

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| extraSaplingChance | float | 0.0 | Bonus sapling roll multiplier |
| extraStickChance | float | 0.0 | Bonus stick roll multiplier |
| extraAppleChance | float | 0.0 | Bonus apple roll (oak/dark oak only) |

Filters

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| blacklistedLeaves | list | [] | Block IDs to exclude |
| disabledDimensions | list | [] | Dimension IDs to disable in |

Performance

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| requirePlayerNearby | bool | false | Only decay near players |
| playerRadius | float | 64.0 | Player detection radius |

---

License

MIT — free to use, modify, and include in modpacks. No permission needed.