TreeChopperUltra

# 🌲 TreeChopper — Tree Felling Plugin with Falling Animation | Paper · Spigot · Folia 1. 16-26. 2

Break one log. Watch the whole tree fall.

[!(https://img.shields.io/badge/Support%20TreeChopper-Ko--fi-29C7FF?style=for-the-badge&logo=kofi&logoColor=white&labelColor=101826)](https://ko-fi.com/erotoro)

TreeChopper is a lightweight, performance-focused tree felling plugin for Paper, Spigot, and Folia servers. Hit any log with an axe and the entire tree collapses — logs tumble down layer by layer with real physics, leaves decay automatically, and a sapling replants itself at the base.

No client mods. No heavy dependencies. Just drop the jar and it works.

## ✨ Why TreeChopper?

Most tree felling plugins were built years ago and never adapted to modern threaded servers. TreeChopper is built for modern Minecraft 1. 16-26. 2, with real Folia support and a full falling log animation.

> A tree chopper plugin with both falling animation and real Folia compatibility.

## 🪓 Core Features

Falling animation Logs do not just vanish. They break top-to-bottom and fly outward as `FallingBlock` entities with real Minecraft physics.

Smart tree separation Two trees growing side by side are treated independently. Chop one tree and the other stays intact. Ownership checks prevent cross-tree damage to leaves, roots, and attached vegetation.

2×2 mega tree support Large Jungle, Spruce, and Dark Oak trees with a 2×2 trunk are detected and felled as a single unit.

Improved vanilla tree handling Complex natural trees such as Cherry, Pale Oak, and Mangrove are handled more accurately, including irregular trunk shapes, hanging vegetation, propagules, cocoa, and mangrove roots.

All vanilla wood types Oak · Birch · Spruce · Jungle · Dark Oak · Acacia · Cherry · Mangrove · Crimson Stem · Warped Stem · Mushroom Stem

Automatic leaf decay After the logs fall, leaves from the chopped tree break automatically. Leaves shared with a neighboring tree are left untouched.

Attached vegetation cleanup Vines, cocoa, pale hanging moss, mangrove propagules, and similar vegetation are detected and removed along with the correct tree.

## ⚖️ Balance & Gameplay Feel

Durability & Unbreaking The axe loses one durability per log broken. Unbreaking is applied probabilistically across the whole tree, matching vanilla behavior.

Fortune & Silk Touch Enchantments on your axe apply to every log that falls, not just the first one.

Player-placed log protection Logs placed by players are tracked and never trigger mass felling.

Structure detection Heuristic analysis helps prevent the plugin from treating village houses, outposts, and other generated structures as natural trees.

Sneak activation modes Choose how the plugin activates: - `ALWAYS_ON` — always active with an axe - `SNEAK_DISABLE` — active by default, hold sneak to disable - `SNEAK_ENABLE` — disabled by default, hold sneak to activate

Per-player toggle Each player can enable or disable tree chopping for themselves using `/treechopper toggle`. State persists across sessions.

## 🔗 Plugin Integrations

| Plugin | Behavior | |---|---| | WorldGuard | Felling is blocked inside protected regions | | GriefPrevention | Felling is blocked inside claimed land | | CoreProtect | Every broken log and replanted sapling is logged under the player's name |

All integrations are soft dependencies. TreeChopper works perfectly without any of them.

## 🌱 Auto-Replant

After a tree is felled, a sapling is automatically placed at the base:

• Supports regular and mega (2×2) trees
• Configurable: take sapling from player inventory, or place it for free
• Respects WorldGuard and GriefPrevention
• Fixed protection flow so saplings are not consumed if placement is denied
• Can be limited to natural trees only
• Per-world enable/disable list

## ⚙️ Configuration