[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

Changelog

All notable changes to Advanced TreeCapitator will be documented in this file.

[1.1.0] - 2026-03-10

Fixed

• enabled flag was never checked — the plugin would still function even when enabled: false was set in config.yml. A guard check is now placed at the top of onBlockBreak().
• /atc reload command had no handler — the command was declared in plugin.yml but the plugin never implemented CommandExecutor, causing the server to return "Unknown command". The plugin now properly implements onCommand() and handles /atc reload.
• advancedtreecapitator.use permission was never enforced — any player could use the feature regardless of their permissions. A permission check is now performed before processing each block break.
• Leaf breaking did nothing — break-leaves: true in config had no effect because the BFS loop collected leaf blocks into a dead branch with no code. Leaves are now properly collected and broken.
• Particle effect was commented out — the particle block in TreeCapitatorTask was entirely commented out, so particle-effect: true never produced any visual feedback. Particles now spawn correctly using the Particle.BLOCK API.
• breakCount did not include the initial block — durability loss was calculated one block short because the starting block (broken by the event itself) was excluded from breakCount. The counter now starts at 1 to account for it.

Added

• Configurable cooldown — a new cooldown-ms option in config.yml (default: 200) replaces the previously hardcoded 100 ms cooldown, giving server admins full control.
• Unbreaking enchantment support — axe durability loss now respects the Unbreaking enchantment level using Minecraft's standard probability formula (1 / (level + 1) chance per hit).
• Automatic cooldown map cleanup — a repeating task runs every 10 minutes to purge stale entries from the cooldowns ConcurrentHashMap, preventing a memory leak on long-running servers.
• Additional log types in default config:
  • PALE_OAK_LOG (Minecraft 1.21.4+)
  • CRIMSON_STEM and WARPED_STEM (Nether wood)
  • BAMBOO_BLOCK (Minecraft 1.20+)

[1.0.0] - Initial Release

• BFS-based tree felling on log break.
• Configurable axe requirement, sneak requirement, world whitelist/blacklist.
• Durability loss on axes with a configurable multiplier.
• Sound and particle effect toggles.
• Per-player cooldown to prevent spam.