Advanced TreeCapitator

Version: 1.2.0 | API: Paper 1.21+ | Author: Duong2012G

Fell an entire tree with a single axe swing — Fortune and Silk Touch fully supported.

---

Features

• BFS tree felling — finds and breaks all connected logs using a breadth-first search (6 cardinal directions)
• 26-direction leaf detection — when break-leaves: true, diagonal leaves on Dark Oak and Jungle trees are always caught
• Fortune & Silk Touch — work automatically on every block, no extra configuration needed
• Realistic tool durability — durability decreases proportional to blocks broken, respects Unbreaking
• Per-player toggle — each player can enable/disable tree felling with /atc toggle without affecting others
• Configurable cooldown — prevents spam, adjustable per millisecond
• World whitelist / blacklist — restrict which worlds allow tree felling
• Particle & sound effects
• Hot reload — apply config changes with /atc reload, no server restart needed

---

Installation

1. Download AdvancedTreeCapitator-1.2.0.jar
2. Place it in your server's plugins/ folder
3. Restart or reload the server
4. Edit plugins/AdvancedTreeCapitator/config.yml as needed
5. Run /atc reload to apply changes without restarting

---

Permissions

Permission	Description	Default
advancedtreecapitator.use	Use tree felling + /atc toggle	true (all players)
advancedtreecapitator.admin	Reload config with /atc reload	op

---

Commands

Command	Description
/atc toggle	Enable or disable tree felling for yourself
/atc reload	Reload the config file (requires admin permission)

---

How to Use

1. Hold an axe listed in tool-whitelist
2. Sneak (Shift) if require-sneak: true
3. Break the base log of a tree — the entire connected tree drops at once

Fortune: All logs and leaves receive Fortune bonus drops automatically.
Silk Touch: Logs and leaves drop as their block form instead of items.

---

Configuration

enabled: true
require-axe: true
require-sneak: true
damage-axe: true
damage-multiplier: 1.0
max-blocks: 100
cooldown-ms: 200
break-leaves: false
particle-effect: true
sound-effect: true

World Restrictions

# Allow only specific worlds:
whitelist-worlds:
  - world
  - world_the_end

# Or block specific worlds:
blacklist-worlds:
  - creative_world

---

Changelog

See CHANGELOG.md

---

License

Apache-2.0 © Duong2012G