# Advanced TreeCapitator<\/p>\n
**Version:** 1.4.0 | **API:** Paper 1.20.4+ | **Author:** Duong2012G
\n**License:** Apache-2.0 | **Link:** Modrinth<\/p>\n
Fell an entire tree with a single axe swing \u2014 Fortune, Silk Touch, and realistic
\ntool durability fully supported.<\/p>\n
—<\/p>\n
## Features<\/p>\n
| Feature | Description |
\n|—|—|
\n| **BFS tree felling** | Finds and breaks all connected logs using a 26-direction breadth-first search (handles Big Oak, Acacia, Dark Oak diagonal logs) |
\n| **Horizontal BFS cap** | Limits horizontal spread to 8 blocks from the origin \u2014 two nearby trees are never merged into one fell (added v1.4.0) |
\n| **`require-leaves` guard** | Checks for adjacent leaves before felling \u2014 prevents accidental activation on player-built log walls and cabins |
\n| **Protection plugin support** | Fires `BlockBreakEvent` for each extra block \u2014 WorldGuard, GriefPrevention, Lands, Residence can cancel individual blocks (fix v1.4.0) |
\n| **Anti-recursion guard** | `breakingTrees` set prevents the plugin from re-triggering itself when it fires protection events (fix v1.4.0) |
\n| **Fortune & Silk Touch** | Work automatically on every block via `breakNaturally(tool)`, no extra configuration needed |
\n| **Durability pre-check** | Calculates max breakable logs *before* breaking any \u2014 axe can never fell more than its remaining durability allows |
\n| **Config validation** | All numeric values are clamped to a valid range \u2014 a malformed config can no longer crash or break the plugin (added v1.4.0) |
\n| **Configurable leaf cost** | `leaf-durability-ratio` controls how many leaves equal one durability hit (default: 10) |
\n| **Partial chop** | Trees larger than `max-blocks` are chopped up to the limit; remaining logs can be harvested with additional swings |
\n| **Per-player toggle** | Each player can enable\/disable tree felling with `\/atc toggle` without affecting others |
\n| **Plugin API** | `TreeCapitatorEvent` lets other plugins cancel felling or grant custom rewards based on tree size |
\n| **World whitelist\/blacklist** | Restrict which worlds allow tree felling |
\n| **Nether & Bamboo support** | Crimson Stem, Warped Stem, and Bamboo Block all supported; `require-leaves` is automatically bypassed for these |
\n| **Particle & sound effects** | Configurable visual feedback on each fell |
\n| **Hot reload** | Apply config changes with `\/atc reload`, no restart needed |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download `AdvancedTreeCapitator-1.4.0.jar`
\n2. Place it in your server’s `plugins\/` folder
\n3. Restart or reload the server
\n4. Edit `plugins\/AdvancedTreeCapitator\/config.yml` as needed
\n5. Run `\/atc reload` to apply changes without restarting<\/p>\n
**Requirements:** Paper (or any Paper fork) 1.20.4+, **Java 17+** (was Java 21 in v1.3.0)<\/p>\n
—<\/p>\n
## Permissions<\/p>\n
| Permission | Description | Default |
\n|—|—|—|
\n| `advancedtreecapitator.use` | Use tree felling + `\/atc toggle` | `true` (all players) |
\n| `advancedtreecapitator.admin` | Reload config with `\/atc reload` | `op` |<\/p>\n
—<\/p>\n
## Commands<\/p>\n
| Command | Description | Permission |
\n|—|—|—|
\n| `\/atc toggle` | Enable or disable tree felling for yourself | `advancedtreecapitator.use` |
\n| `\/atc reload` | Reload the configuration file | `advancedtreecapitator.admin` |<\/p>\n
—<\/p>\n
## How to Use<\/p>\n
1. Hold an axe listed in `tool-whitelist`
\n2. Sneak (Shift) if `require-sneak: true`
\n3. Break the base log of a tree \u2014 the entire connected tree drops at once<\/p>\n
> **Fortune:** All logs and leaves receive Fortune bonus drops automatically.
\n> **Silk Touch:** Logs and leaves drop as their block form instead of items.<\/p>\n
—<\/p>\n
## Configuration Reference<\/p>\n
“`yaml
\n# \u2500\u2500 Activation \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nenabled: true
\nrequire-axe: true # must hold an axe from tool-whitelist
\nrequire-sneak: true # must be sneaking (Shift)
\nrequire-leaves: true # at least 1 adjacent leaf required \u2014 prevents structure damage<\/p>\n
# \u2500\u2500 Mining \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nmax-blocks: 100 # max logs per fell (partial chop above limit)
\ncooldown-ms: 200 # per-player cooldown in milliseconds
\nbreak-leaves: false # also break adjacent leaves<\/p>\n
# \u2500\u2500 Durability \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\ndamage-axe: true # apply durability loss proportional to blocks broken
\ndamage-multiplier: 1.0 # durability cost per log block (Unbreaking respected)
\nleaf-durability-ratio: 10 # how many leaves = 1 durability hit (when break-leaves: true)<\/p>\n
# \u2500\u2500 Effects \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nparticle-effect: true
\nsound-effect: true<\/p>\n
# \u2500\u2500 World Restrictions \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
\nwhitelist-worlds: [] # only these worlds (empty = all)
\nblacklist-worlds: [] # block these worlds (empty = none)
\n“`<\/p>\n
### World Restrictions<\/p>\n
“`yaml
\n# Allow only specific worlds:
\nwhitelist-worlds:
\n – world
\n – world_nether<\/p>\n
# Or block specific worlds:
\nblacklist-worlds:
\n – creative_world
\n“`<\/p>\n
### Adding Custom Log Types<\/p>\n
Add any `Material` enum name (case-insensitive) to `log-types`:<\/p>\n
“`yaml
\nlog-types:
\n – OAK_LOG
\n – MUSHROOM_STEM # enables huge mushroom felling
\n # add more as needed…
\n“`<\/p>\n
—<\/p>\n
## Plugin API \u2014 `TreeCapitatorEvent`<\/p>\n
Other plugins can hook into tree felling via the `TreeCapitatorEvent`:<\/p>\n
“`java
\nimport dev.duong2012g.atc.TreeCapitatorEvent;
\nimport org.bukkit.event.EventHandler;
\nimport org.bukkit.event.Listener;<\/p>\n
public class MyListener implements Listener {<\/p>\n
@EventHandler
\n public void onTreeFell(TreeCapitatorEvent event) {
\n Player player = event.getPlayer();
\n int logCount = event.getLogs().size();<\/p>\n
\/\/ Example: cancel felling in a specific region
\n if (isProtectedRegion(player.getLocation())) {
\n event.setCancelled(true);
\n return;
\n }<\/p>\n
\/\/ Example: reward economy based on tree size
\n economy.depositPlayer(player, logCount * 0.5);
\n }
\n}
\n“`<\/p>\n
**Event fields:**<\/p>\n
| Method | Returns | Description | —<\/p>\n ## Changelog<\/p>\n See [CHANGELOG.md](CHANGELOG.md)<\/p>\n —<\/p>\n ## Bug Fixes in v1.4.0<\/p>\n | # | Bug | Status | —<\/p>\n ## License<\/p>\n Apache-2.0 \u00a9 Duong2012G<\/p>\n","protected":false},"excerpt":{"rendered":" Advanced TreeCapitator enables fast tree felling on Paper 1.21. Sneak with an axe to chop entire trees, with configurable durability loss, world restrictions, and a reload command.<\/p>\n","protected":false},"featured_media":7002,"template":"","meta":{"_minecraft_slug":"advanced-treecapitator","_minecraft_project_id":"8li9wnIm","_minecraft_author":"Duong2012G","_minecraft_license":"Apache-2.0","_minecraft_downloads":479,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"advanced-treecapitator.zip","_minecraft_size_bytes":165113,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T10:43:14.051635Z","_minecraft_date_created":"2026-03-10T00:03:55.134849Z","_minecraft_date_modified":"2026-05-14T04:50:52.707492Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/advanced-treecapitator","_minecraft_icon_attachment_id":7002,"_minecraft_imported_at":"2026-05-31T14:32:29+00:00","_minecraft_import_hash":"039a0d200a1f9d310ba970d35ada36d0","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,89,127,128,129,869,92],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-7001","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|—|—|—|
\n| `getPlayer()` | `Player` | The player who triggered the fell |
\n| `getLogs()` | `Set
\n| `getLeaves()` | `Set
\n| `setCancelled(true)` | \u2014 | Cancels the entire tree felling |<\/p>\n
\n|—|—|—|
\n| 1 | Forced Java 21 \u2192 `UnsupportedClassVersionError` on Java 17 servers | \u2705 Fixed \u2014 compile target lowered to Java 17 |
\n| 2 | Double durability damage | \u2705 Clarified \u2014 **not a bug**: `breakNaturally(tool)` does not touch inventory durability; it only uses the tool for drop calculation |
\n| 3 | Accidentally felling player-built log structures | \u2705 Already covered by `require-leaves` guard since v1.2.3; v1.4.0 adds horizontal BFS cap as a second layer |
\n| 4 | 26-direction BFS merging two nearby trees | \u2705 Fixed \u2014 added `MAX_HORIZONTAL_DISTANCE = 8` |
\n| 5 | Bypassing protection plugins (WorldGuard, Lands\u2026) | \u2705 Fixed \u2014 `BlockBreakEvent` fired for every extra block |
\n| 6 | No anti-recursion guard | \u2705 Fixed \u2014 `breakingTrees` set prevents the listener from looping when it fires protection events |
\n| 7 | Config accepts invalid values (`max-blocks: -1`) | \u2705 Fixed \u2014 all numeric values are clamped on load |
\n| 8 | Folia incompatibility | \u26a0\ufe0f Not yet fixed \u2014 requires migration to `RegionScheduler` (planned v1.5.0) |<\/p>\n