[1.18–26.x] TreeFlow | Safe Tree Felling, Animation & Replanting

Fast tree felling without blind log destruction

Most timber plugins simply follow connected logs. That is fast, but a connected roof, support beam or wooden build can become part of the tree.

TreeFlow takes a safer approach. Before changing anything, it checks whether the structure actually looks like a natural tree. Accepted trees are felled smoothly from the canopy downward while suspicious structures continue to break normally, one block at a time.

TreeFlow is designed for survival servers that want convenience without sacrificing control.

What makes TreeFlow different?

SMART DETECTION	SURVIVAL BALANCE	SERVER CONTROL
Validates the root, trunk, canopy, tree family, size and nearby construction blocks.	Uses natural drops, damages the axe per log and respects Unbreaking.	Configure activation, limits, animation, cooldown, replanting, feedback and language.

Features

• 
  []One-action tree felling — sneak and break the lowest log with an axe
  []Conservative natural-tree detection — does not blindly destroy every connected log
  []Player-build protection — rejects structures touching common building, storage or redstone blocks
  []Animated or instant mode — fell logs smoothly from top to bottom or remove them immediately
  []Natural drops — blocks drop using the player's original tool and enchantments
  []Balanced durability — applies durability per broken log with Unbreaking support
  []Automatic replanting — restores matching saplings, propagules or fungi after a configurable delay
  []Optional sapling consumption — choose free replanting or require items from the player
  []Player toggle — every player can enable or disable TreeFlow for themselves
  []Cooldown protection — configurable delay with an administrator bypass permission
  []Protection preflight — compatible protection plugins can cancel checked blocks before felling starts
  []Safe size limits — configurable maximum log count, height and horizontal radius
  []Quiet by default — automatic success and rejection messages are disabled unless the server enables them
  []English and German — both languages are included and every message is customizable
• Privacy friendly — no telemetry, update checker or external network connections

How safe detection works

Before a tree is accepted, TreeFlow checks that:

• 
  []the broken block belongs to a supported natural tree family;
  []the player started at the base of the trunk;
  []the trunk is rooted in appropriate natural soil;
  []the structure has enough logs and vertical trunk height;
  []matching leaves or Nether canopy blocks are present;
  []the tree stays inside the configured size and distance limits;
  []no different wood family is connected nearby;
  []no common construction or storage block touches the detected trunk.

Detection is intentionally conservative. No plugin can know with absolute certainty whether every log was placed by a player. If TreeFlow is unsure, it leaves the remaining structure untouched and allows normal block breaking.

Supported trees

• 
  []Oak and azalea trees
  []Spruce
  []Birch
  []Jungle
  []Acacia
  []Dark oak
  []Mangrove
  []Cherry
  []Pale oak
  []Crimson huge fungus
• Warped huge fungus

Default gameplay

1. 
   []Enter Survival mode.
   []Hold an axe and sneak.
   []Break the lowest log of a natural tree.
   []TreeFlow validates the entire structure before starting.
   []Accepted logs fall from top to bottom with natural drops and tool damage.
   []A matching sapling or fungus is replanted after the configured delay.

The activation gesture, game modes, animation speed, block count, cooldown, drops, durability and replant behavior can all be changed in config.yml.

Commands

Aliases: /tf and /timber

Permissions

treeflow.use and treeflow.toggle default to everyone. Reload and cooldown bypass default to server operators.

Installation

1. 
   []Stop your server.
   []Place TreeFlow-1.0.0.jar inside the plugins folder.
   []Start the server.
   []Sneak and break the lowest log of a natural tree with an axe.

Do not run multiple tree-felling plugins at the same time.

Compatibility

Platform	Spigot and Paper
API baseline	Spigot 1.18.2
Runtime verified	Spigot 26.2 on Java 25
Required Java	Java 17 or newer
Dependencies	None
Built-in languages	English and German
Telemetry	None
External connections	None

Support

When reporting a problem, include your server software and version, Java version, TreeFlow version, tree type and relevant console error.

Never publish passwords, tokens, private coordinates or database credentials.