🌲 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 never adapted to modern threaded servers. TreeChopper is built for modern Minecraft 1.21-26.1.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

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

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; durability still matters
• Folia servers — safe threaded scheduling with falling animation
• Servers using WorldGuard / GriefPrevention / CoreProtect — native integration

📋 Requirements

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

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