BlackTimber 1.4.0

Two fixes and a new feature for how trees come down: vanilla-accurate leaf clearing,
durability-bounded felling, and opt-in sapling replanting.

New in 1.4.0

• Leaf clearing now follows vanilla decay. With leaf breaking on, BlackTimber used to
  scan a fixed cube around each log. That left the outer one or two layers of a wide canopy
  behind and, in a forest, ate the leaves of a neighbouring tree that fell inside the cube.
  Clearing now reproduces vanilla decay exactly: it removes only the leaves the felled tree
  was supporting and that no surviving log still keeps within range. The whole canopy comes
  down, outer layers included, on a tree of any size or shape, while an adjacent tree whose
  trunk still stands keeps every one of its own leaves, even where two canopies overlap.
  Player placed (persistent) leaves are still never touched.
• Felling is bounded by the axe's durability. An axe could get stuck at 1 durability and
  fell trees forever without breaking. Felling is now limited to the logs the axe can pay
  for, Unbreaking honoured per log, so it can never outrun the tool. A worn axe fells the
  part it can afford and leaves the rest standing.
• break-tool now defaults to true. The axe wears down and breaks like vanilla once
  it runs out mid-fell. Set it to false to protect the axe instead: it then stops at 1
  durability and leaves the rest of the tree standing rather than breaking.
• New: sapling replanting. A fourth per player toggle, off by default, replants a
  matching sapling where the tree stood. The species is read from the felled trunk: oak,
  birch, spruce, jungle, acacia and cherry plant one sapling; dark oak and pale oak plant
  their full 2x2 only when all four cells are clear; mangrove plants a propagule. It plants
  only on valid ground (dirt, grass, podzol, moss and the like, plus farmland; clay and mud
  for mangrove) and never over water, lava or an occupied block. Toggle it in the player
  menu, with /blacktimber replant, or set the server default default-replant.

Config

• New default-replant (default false): per player starting state for the replant toggle.
  Replaces the old global replant-sapling.
• New leaf-clear-budget (default 8192): safety ceiling on how many leaves a single fell
  may examine before deferring cleanup to vanilla decay.
• leaf-search-radius is now detection only and no longer limits clearing.
• break-tool default changed from false to true.

Still true

• Whole tree felling that protects houses, tree houses and hand built trees.
• Three way detection: natural leaves, remembered placed logs, attached structures.
• Per player menu, live admin panel and a drag and drop leaf loot editor.
• Built for Folia. No external dependencies and no database.

Requirements

• Folia or Paper 26.1.2 (api-version: 26.1).
• Java 25.

Install

Drop BlackTimber-1.4.0.jar into your server plugins folder and start the server. An
existing config.yml keeps working; the new leaf-clear-budget falls back to its default,
and break-tool keeps whatever value you already set.

BlackTimber 1.3.0

Adds a live network chart, powered by anonymous, opt-out usage stats.

New in 1.3.0

• Live usage chart. A premium chart in the README shows active servers and players
  online, refreshed every few minutes.
• Anonymous telemetry. Each server reports only a random id, its player count and its
  software and version, once every fifteen minutes, on the async scheduler. No IP, no
  player names, nothing personal. Opt out with telemetry: false in config.yml. Full
  disclosure in TELEMETRY.md.

Still true

• Whole tree felling that protects houses, tree houses and hand built trees.
• Three way detection: natural leaves, remembered placed logs, attached structures.
• Per player menu, live admin panel and a drag and drop leaf loot editor.
• Built for Folia. No external dependencies and no database.

Requirements

• Folia or Paper 26.1.2 (api-version: 26.1).
• Java 25.

Install

Drop BlackTimber-1.3.0.jar into your server plugins folder and start the server. A
config.yml is written on the first run.

BlackTimber 1.2.0

Smart tree felling for Folia and Paper. Break one log and the whole tree falls, while
houses, tree houses and player builds stay standing.

Highlights

• Whole tree felling that protects houses, tree houses and hand built trees.
• Three way detection: natural leaves, remembered placed logs, and attached structures.
• A per player menu and a live admin panel, both saved across restarts.
• A drag and drop leaf loot editor with biome themed bonus drops.
• Built for Folia: regionized work, tick spreading, and no legacy scheduler.
• No external dependencies and no database.

Requirements

• Folia or Paper 26.1.2 (api-version: 26.1).
• Java 25.

Install

Drop BlackTimber-1.2.0.jar into your server plugins folder and start the server. A
config.yml is written on the first run. Full documentation is in the
README.