Leaves Us In Peace

---

Leaf decay ignores different types of leaves and logs. Fast leaf decay. Configurable. Data driven.

Works server-side and in single player.

This mod aims to make leaf decay less frustrating.

It started out as a fork of Tfarcenim's LeafMeAlone, but then I overhauled it to the point of it being an almost entirely different mod.

It does 3 (+1) things to change how leaves decay, all configurable:

1. Leaves will ignore leaves of a different type when determining whether to decay or not. By default, this will only
   match identical leaves (like in LeafMeAlone), but if a tag for leaves is found, all leaves in that tag will match.
   This is how the mod handles azaleas' two types of leaves. Mods (or mod users) can add compat for trees with multiple
   types of leaves by just adding a tag. Details on
   the wiki.
2. Leaves will ignore logs from different tree types when determining whether to decay or not. This will look for a tag
   by the name of the log and check if it contains the leaves doing the check. If no tag is found, any log will match
   instead (like in vanilla). Details on
   the wiki.
3. Leaves will decay much faster. This is basically like the fast leaf decay mods you've likely seen before. It's
   highly configurable, and uses an algorithm that can check for diagonal leaves, in addition to the usual check for
   adjacent leaves, so it's less likely to leave a stray leaf or two floating.

• 3 + 1. This isn't convenient or less frustrating, but leaves can optionally make block breaking sounds and create
  particles when they decay.

---

Configuration

Supports Cloth Config and
Mod Menu for configuration, but neither is required.

Options will use their default values if Cloth Config is absent.

If Cloth Config is present, options can be configured either through
Mod Menu or by editing config/leaves_us_in_peace.json in your
instance folder (.minecraft/ by default for the vanilla launcher).

• Match leaves types; default: true

  Leaves ignore leaves of other types when determining whether to decay or not

• Unknown leaves only match self; default: true

  If "Yes", leaves without tags defining which leaves they should match will only match leaves of exactly the same type.
  If "No", leaves without tags will match all leaves.
  Set to "No" if you're having trouble with some modded leaves decaying as soon their tree grows (with multiple leaves types).

• Match logs to leaves; default: true

  Leaves ignore logs of other tree types when determining whether to decay or not

• Ignore persistent leaves; default: true

  Leaves ignore persistent leaves (placed by player) when determining whether to decay or not

• Accelerate leaves decay; default: true

  Make leaves decay much faster

• Decay delay

  Random delay between leaves decaying and updating nearby leaves.
  Has no effect if 'Accelerate leaves decay' is 'No'.

  • Minimum; default: 10

    Minimum random delay. Set minimum equal to maximum to eliminate randomness.

  • Maximum; default: 60

    Maximum random delay

• Update diagonal leaves; default: true

  When leaves decay, update leaves diagonal to them in addition to those adjacent to them

• Do decaying leaves effects; default: false

  Create particles and sounds when leaves decay

---

Compatibility

Tags for trees added by several mods are included:

• Biomes O' Plenty
• Oh The Biomes We've Gone
• Oh The Biomes You'll Go
• Promenade
• Traverse
• Twilight Forest
• William Wythers' Overhauled Overworld
• Yung's better Mineshafts

The built-in data pack wood_prevents_decay (default disabled) can also make vanilla wood blocks (logs with
bark on all 6 sides) count as logs for their respective trees, since some mods generate trees with wood blocks.

Further modded tree support can be added via data packs, find out how on
the wiki.

Leaves Us In Peace does its best to handle unknown trees (modded trees without tags) gracefully:

• Unknown leaves will only consider leaves of exactly the same type to be part of their tree
  (this can be changed by disabling "Unknown leaves only match self")
• Unknown logs will prevent any adjacent unknown leaves from decaying

However it's not perfect: modded trees that aren't implemented similarly to vanilla trees or that don't follow vanilla
tag conventions can sometimes decay unexpectedly. If you encounter this, please report it on the
issue tracker
(please don't report it to the mod that adds the unexpectedly decaying tress).

---

Translations

Install SSS Translate to automatically download new translations.
You can help translate Leaves Us In Peace on Crowdin.

---

Credits

• Tfarcenim's for making LeafMeAlone.

• gliscowo for making Isometric Renders,
  which I used to create the mod icon.

---

This mod is only for Fabric (works on Quilt, too!) and I won't be porting it to Forge. The license is CC0, however,
so anyone else is free to port it.

I'd appreciate links back to this page if you port or otherwise modify this project, but links aren't required.