[1.2.3] — 2026-03-27

Added

• require-leaves option (default: true) — Before felling, the plugin now checks that the log cluster has at least one adjacent leaf block. If none are found, the capitator does nothing. This prevents accidental activation on player-built log structures such as house walls, cabin roofs, or log-block decorations. Set to false to restore the old behaviour.

Fixed

• Durability did not limit felling — Tool durability was calculated and applied after all blocks were already broken. A nearly-broken axe (1 durability remaining) could silently fell a 100-log tree and would simply be destroyed at the end. The task now calculates the maximum number of extra logs the remaining durability permits before breaking any blocks, and trims the set accordingly. Unbreaking level is respected in this pre-check as well.

[1.2.2] — 2026-03-16

Fixed

• Critical Item Swap Bug — Fixed a bug where switching items during a tree felling task (0.05s delay) could overwrite a new item in the player's hand with the old axe, potentially causing item loss. The task now tracks the specific inventory slot and verifies the tool's identity before applying durability changes.
• Leaf Durability — Added durability loss for leaf felling. Every 10 leaves broken now counts as 1 tool hit to ensure balancing when break-leaves is enabled.

fixed bug

Changelog — Advanced TreeCapitator

All notable changes to this project are documented here. Format follows Keep a Changelog.

[1.2.1] — 2025-03-10

Fixed

• Plugin was completely non-functional. The BFS task read block.getType() one tick after the block-break event fired — at that point the block is already AIR, so the search found nothing and no extra logs were cut. The block Material is now captured inside the event handler (while the block still exists) and passed to the task.
• Tool durability changes were silently discarded because the modified ItemStack was never written back to the player's hand. Added setItemInMainHand(tool) after updating the item meta.
• Enchantment.UNBREAKING resolved via Enchantment.getByKey(NamespacedKey) with a try-catch fallback, fixing compatibility across all Paper 1.21.x patch builds.
• Leaf blocks adjacent to a log in a cardinal direction were skipped during the 26-dir leaf scan because the log-BFS visited set had already claimed them. Leaf collection now deduplicates with its own LinkedHashSet, independent of the log BFS.
• Event priority reverted to NORMAL (was incorrectly HIGH) so protection-plugin cancellations at NORMAL priority are still respected.

Changelog — Advanced TreeCapitator

All notable changes to this project will be documented in this file.

[1.2.0] — 2025-03-10

Added

• Per-player toggle (/atc toggle) — each player can enable or disable tree felling independently without affecting others
• Tab completion for the /atc command
• README.md with full installation guide, permissions table, and usage notes
• CHANGELOG.md (this file)

Fixed

• @EventHandler was missing ignoreCancelled = true and priority = EventPriority.HIGH — now correctly respects cancellation from other plugins
• Leaf detection upgraded to 26-direction (3×3×3) scan when break-leaves: true — diagonal leaves on Dark Oak and Jungle trees are now always caught
• When a tree exceeded max-blocks, breakCount was reset to 1 but damage was still calculated — now the task returns early with no extra block breaks or damage when the limit is hit
• Tool durability now uses extraBreaks + 1 (including the origin block) for an accurate damage total

Changed

• In-game messages translated to English for Modrinth release
• Logger startup message now includes the plugin version
• onDisable() clears both cooldowns and disabledPlayers
• Config comments rewritten in English with explicit Fortune/Silk Touch notes
• maven-compiler-plugin bumped to 3.13.0
• Version: 1.1.0 → 1.2.0

[1.1.0]

Fixed (internal, per [FIX #x] comments)

• [FIX #1] enabled flag is now checked at the top of the event handler
• [FIX #2] /atc reload command handler registered correctly
• [FIX #3] Permission check advancedtreecapitator.use applied
• [FIX #4] break-leaves now actually breaks leaves
• [FIX #5] Particle effect now renders correctly
• [FIX #6] Periodic cooldown map cleanup to prevent memory leak
• [FIX #8] Cooldown is configurable via cooldown-ms instead of being hardcoded
• [FIX #9] Unbreaking enchantment respected; Pale Oak, Nether stems, and Bamboo added to default config

[1.0.0]

• Initial release