Описание
# 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 `
- **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
```
**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.