Advanced TreeCapitator

# Advanced TreeCapitator **Version:** 1.5.3 | **API:** Paper 1.21+ | **Author:** Duong2012G **License:** Apache-2.0 | **Link:** (https://modrinth.com/user/Duong2012G) Fell an entire tree with a single axe swing — Fortune, Silk Touch, and realistic tool durability fully supported. --- ## Features | Feature | Description | |---|---| | **BFS tree felling** | Finds and breaks all connected logs using a 26-direction breadth-first search. Handles Big Oak, Acacia, and Dark Oak diagonal logs correctly. | | **Configurable horizontal cap** | Limits horizontal BFS spread — keeps nearby trees from being merged into one fell. Default: 8 blocks. Configurable via `max-horizontal-distance` (added v1.5.0). | | **Configurable 3-D distance cap** | `max-distance` limits total BFS depth in all three axes. Default: 50 — accommodates Jungle trees up to 30+ blocks tall. Configurable via `max-distance` (added v1.5.1; was hardcoded 30). | | **`require-leaves` guard** | Checks for adjacent leaves before felling — prevents accidental activation on player-built log walls and cabins. Now correctly covers stripped-log variants (fixed v1.5.1). | | **Protection plugin support** | Fires `BlockBreakEvent` for each extra block — WorldGuard, GriefPrevention, Lands, and Residence can cancel individual blocks. | | **Anti-recursion guard** | `breakingTrees` set prevents the plugin from re-triggering itself when it fires protection events. Mutable-set exposure removed (fixed v1.5.1). | | **Fortune & Silk Touch** | Work automatically on every block via `breakNaturally(tool)`, no extra configuration needed. | | **Durability pre-check** | Calculates max breakable logs *before* breaking any — the axe can never fell more than its remaining durability allows. | | **Vanilla Unbreaking rolls** | Durability loss uses per-hit random rolls matching Minecraft's actual Unbreaking formula (fixed v1.5.0). | | **Config validation** | All numeric values are clamped to a valid range — a malformed config cannot crash or break the plugin. | | **Configurable leaf cost** | `leaf-durability-ratio` controls how many leaves equal one durability hit (default: 10). Partial hits resolved probabilistically (fixed v1.5.1). | | **Partial chop** | Trees larger than `max-blocks` are chopped up to the limit; remaining logs can be harvested with additional swings. | | **Per-player toggle** | Each player can enable/disable tree felling with `/atc toggle` without affecting others. Toggle state resets on disconnect. | | **Plugin API** | `TreeCapitatorEvent` lets other plugins cancel felling or grant custom rewards. All API methods annotated `@NotNull` (added v1.5.1). | | **World whitelist/blacklist** | Restrict which worlds allow tree felling. | | **Nether & Bamboo support** | Crimson Stem, Warped Stem, and Bamboo Block are supported. `require-leaves` is automatically bypassed for these types. | | **Particle & sound effects** | Visual feedback on each fell. Sound plays at the tree base so nearby players hear it correctly (fixed v1.5.0). | | **Hot reload** | Apply config changes with `/atc reload`, no restart needed. | | **Realistic break time** | Optional `realistic-break-time` spreads the fell out over real mining time instead of breaking every log instantly — closes the "instant wood farm" exploit. Default: off (added v1.5.3). | --- ## Installation 1. Download `AdvancedTreeCapitator-1.5.3.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 **Requirements:** Paper (or any Paper fork) 1.21+, **Java 17+** --- ## 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 | Permission | |---|---|---| | `/atc toggle` | Enable or disable tree felling for yourself | `advancedtreecapitator.use` | | `/atc reload` | Reload the configuration file | `advancedtreecapitator.admin` | --- ## 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 Reference ```yaml # ── Activation ────────────────────────────────────────────────── enabled: true require-axe: true # must hold an axe from tool-whitelist require-sneak: true # must be sneaking (Shift) require-leaves: true # at least 1 adjacent leaf required — prevents structure damage # covers stripped-log variants since v1.5.1 # ── Tree detection ─────────────────────────────────────────────── max-blocks: 100 # max logs per