🌲 TreeChopper — Tree Felling Plugin with Falling Animation | Paper · Spigot · Folia 1.21-26.1.2

Break one log. Watch the whole tree fall.

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 haven't kept up. TreeChopper is built from the ground up for modern Minecraft 1.21-26.1.2 servers, with first-class Folia support — making it the only tree chopper plugin that combines a real falling animation with full regional thread compatibility.

The only tree chopper plugin with Folia support + falling animation.

🪓 Core Features

Falling animation Logs don't just disappear — they break top-to-bottom and fly outward as FallingBlock entities with real Minecraft physics. Satisfying to watch, every single time.

Smart tree separation Two trees growing side by side are treated completely independently. Chop one tree and the other stays 100% intact — leaves and all. A 3D ownership check prevents any cross-tree damage.

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, not four separate trees.

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 and similar canopy/trunk vegetation are detected and removed along with the tree.

⚖️ Balance & Gameplay Feel

Durability & Unbreaking The axe loses one durability per log broken. The Unbreaking enchantment reduces this probabilistically — exactly as vanilla does — applied across the entire tree, not just the first log.

Fortune & Silk Touch Enchantments on your axe apply to every log that falls, not just the one you hit. Fortune on a 20-log tree means bonus drops from all 20 logs.

Player-placed log protection Logs placed by players are tracked and never trigger mass felling. No accidental destruction of log cabins, storage rooms, or any other wood builds.

Structure detection Heuristic analysis prevents 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 (recommended)
• 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

All integrations are soft dependencies. TreeChopper works perfectly on servers 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 spawn it for free
• Respects WorldGuard and GriefPrevention — won't plant in protected zones
• Can be limited to natural trees only
• Per-world enable/disable list

⚙️ Configuration

language:
  default: en          # en · ru · uk
  fallback: en

limits:
  max-logs: 512
  leaf-search-radius: 6
  foreign-log-scan-radius: 8

performance:
  max-blocks-per-task: 16

activation:
  mode: SNEAK_DISABLE  # ALWAYS_ON · SNEAK_DISABLE · SNEAK_ENABLE

player-toggle:
  enabled: true
  default-enabled: true
  save-on-change: true

detection:
  min-leaf-contacts: 4
  min-mega-leaf-contacts: 8
  max-structure-contacts: 4

protection:
  enabled: true
  use-worldguard: true
  use-griefprevention: true
  mode: FAIL_WHOLE_TREE

integrations:
  coreprotect:
    enabled: true

auto-replant:
  enabled: true
  require-sapling: false
  consume-sapling: false
  delay-ticks-after-fell: 20
  replant-mega-trees: true
  mega-mode: four-saplings   # single · four-saplings
  respect-protection: true
  only-natural-trees: true
  disabled-worlds: []

💬 Commands & Permissions

🌍 Localization

Built-in translations: English, Russian, Ukrainian

Language files are in plugins/TreeChopper/lang/ and can be freely edited. Switch language in config.yml under language.default.

🚀 Perfect For

• SMP servers — satisfying QoL without breaking survival balance
• Vanilla+ servers — feels like a natural part of the game
• Economy servers — Fortune applies to all logs; balanced durability cost
• Folia servers — the only falling-animation tree chopper with Folia support
• Any server with WorldGuard / GriefPrevention / CoreProtect — full native integration

📋 Requirements

• Server: Paper, Spigot, or Folia
• Java: 21+
• Minecraft: 1.21-26.1.2

Built for modern servers. Tested with 38 passing unit tests. MIT licensed.