BlackTimber

BlackTimber is a smart tree felling plugin for Minecraft Java Edition, written from the ground up for Folia. Break a single log and the whole tree comes down in one motion, gathered with the axe in your hand. Wooden houses, tree houses and hand built trees are never touched. There is nothing to install alongside it: no library plugin, no database, no setup.

What it does

Classic timber plugins fell anything made of logs, which makes them a liability near a base. BlackTimber fells only what nature grew, and it proves a tree is wild before a single extra log is removed.

A cluster of logs comes down only when all three checks agree it is wild:

1. Natural leaves. Wild leaves are persistent = false. A cluster with none is treated as a build and left alone.
2. Placed logs. Every log a player places is remembered. One placed log protects the whole tree.
3. Attached structures. Planks, stairs, slabs, fences, walls or glass touching the logs mark the cluster as a build.

Why you want it

• It protects builds. A stray swing near your base will not delete a wall, a floor or a tree house.
• It is fast and Folia native. Felling runs on the region thread that owns the log, large fells are spread across ticks, and the legacy scheduler is never used.
• It is self contained. No external dependencies and no database, so there is nothing to install or maintain alongside it.

In game menus

Every player flips three switches for themselves, saved per player.

Admins tune eighteen settings live, written straight to config with no reload.

Bonus leaf loot is built by hand in a drag and drop editor.

Requirements

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

Commands and permissions

Command	Permission
/blacktimber open your menu	blacktimber.use
/blacktimber on / off / toggle / leaves / pickup / status	blacktimber.use
/blacktimber admin open the admin panel	blacktimber.admin
/blacktimber reload	blacktimber.admin

blacktimber.use defaults to everyone, blacktimber.admin defaults to operators.

Telemetry and privacy

BlackTimber reports anonymous usage stats every fifteen minutes: a random server id, the online player count, and the software and version strings. No IP address is stored, no player names or UUIDs are ever sent, and nothing is linked to any person. The data is anonymous and aggregate, in the same spirit as bStats. Opt out completely with telemetry: false in config.yml. Full disclosure is in TELEMETRY.md.

Links

A full write up lives at docs.cebi.tr; the configuration reference, the source code and the issue tracker are on GitHub.