ThreeChopper Changelog

1.0.0 - Initial Release

The first complete public release of ThreeChopper. This version introduces an intelligent, highly configurable tree-chopping system for modern PaperMC servers.

Intelligent Tree Chopping

• Chop down an entire natural tree by breaking a single log.
• Trunk, branch, and canopy scanning.
• Tree species-specific log and leaf detection.
• Structure scoring to distinguish natural trees from player-built structures.
• Protection against long horizontal beams, oversized log networks, and leafless structures.
• Supported overworld tree types: Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, and Pale Oak.
• Support for Crimson and Warped Nether fungi.
• Optional full harvesting of Giant Red and Brown Mushrooms.

Tree Chopping Animation

• Trees do not disappear instantly in a single tick.
• Gradual, configurable block-breaking animation.
• Configurable number of blocks broken per animation step.
• Configurable delay between animation steps.
• Wood block particles and break sounds for every chopped log.
• ActionBar progress indicator showing chopping progress.

Intelligent Replanting

• Automatically replants the correct sapling based on the tree species.
• Detects 2×2 Dark Oak, Spruce, Jungle, and Pale Oak trees.
• Optionally consumes saplings from the player's inventory.
• Natural soil validation before replanting.
• Configurable replant delay.
• Can be enabled or disabled individually by each player in the settings menu.

Leaf Decay Enhancer

• Accelerated removal of natural leaves belonging to the chopped tree.
• Protects player-placed persistent leaves.
• Configurable search radius and maximum leaf count.
• Tick-limited processing to reduce server load.
• Optional leaf particle effects.

Durability System

• Axes do not automatically lose durability for every individual log.
• Configurable number of logs between durability checks.
• Vanilla-style Unbreaking calculations.
• Unbreaking III has a 75% chance to prevent durability loss on every durability check.
• Tree chopping can stop automatically if the axe breaks.
• Tools do not lose durability in Creative mode.

ActionBar+

• Static active status indicator while holding an axe.
• Active text: ⚠ ThreeChopper Active! displayed entirely in green.
• Disabled text: ThreeChopper Disabled displayed entirely in red.
• The disabled indicator automatically disappears after a few seconds.
• The indicator disappears when the player switches away from the axe.
• Tree chopping progress and completion ActionBars have higher priority.
• The "Tree Felled" message remains visible for a configurable duration.
• Can be enabled or disabled individually by each player.

Hologram Feedback

• Displays a temporary TextDisplay hologram after a tree is chopped.
• Shows the number of logs harvested and the tree species.
• Server-side master toggle in the configuration.
• Client-side per-player toggle in the settings menu.
• Configurable duration and vertical offset.
• Complete Hungarian and English localization.

Player Settings GUI

• Clean four-row settings interface.
• Toggle ThreeChopper on or off.
• Toggle hologram feedback.
• Toggle ActionBar+.
• Toggle giant mushroom harvesting.
• Toggle automatic replanting.
• Switch between Hungarian and English.
• Display personal tree chopping statistics.
• Player preferences are saved in players.yml.

Admin GUI & Inspect Mode

• Dedicated administrator menu accessible via /tc admin.
• Toggle Inspect Mode directly from the admin menu.
• Right-click logs to analyze detected trees.
• Detailed report including tree species, log count, leaf count, validation result, and structure score.
• Particle debug overlay for detected log networks.
• Green markers for accepted trees and red markers for rejected structures.
• Quick reload of configuration and language files.
• Runtime and metrics status display.

Language System

• English is the default language.
• Separate lang_en.yml and lang_hu.yml files.
• Complete English localization.
• Complete Hungarian localization with proper accented characters.
• GUI, holograms, ActionBars, ActionBar+, commands, and admin menu are fully translatable.
• Automatic language migration adds new translation keys to existing language files during updates.
• Custom server owner translations are never overwritten.

Anti-Exploit System

• Per-player trees-per-minute limit.
• Per-player logs-per-minute limit.
• Per-chunk trees-per-minute limit.
• Prevents rapid repeated chopping attempts from the same starting block.
• Default limits are balanced for large Dark Oak and Jungle trees.
• threechopper.antiexploit.bypass permission bypasses all anti-exploit checks.
• OP players automatically receive the bypass permission.

Per-World Configuration

• Enable or disable the plugin independently for each world.
• Override the maximum log count per world.
• Override the number of processed blocks per tick per world.
• Create separate profiles for spawn, resource, and Nether worlds.

Compatibility & Protection

• A separate BlockBreakEvent is fired for every additional log.
• Protection and logging plugins can cancel individual block breaks.
• Sneaking temporarily bypasses full tree chopping.
• Can optionally require an axe to activate.
• Separate handling for Creative mode.
• Scan, tree size, and blocks-per-tick limits protect server performance.

Statistics & bStats

• Per-player statistics for chopped trees and harvested logs.
• Official bstats-bukkit 3.2.1 integration.
• bStats Plugin ID: 32489.
• Relocated bStats package to prevent plugin conflicts.
• Custom chart for the default language.
• Custom chart for the server-side hologram feedback setting.

Commands

• /treechopper or /tc - Detailed multi-line command help.
• /tc menu - Open the player settings menu.
• /tc toggle - Toggle ThreeChopper.
• /tc on - Enable ThreeChopper.
• /tc off - Disable ThreeChopper.
• /tc status - Display the current status.
• /tc stats - View personal statistics.
• /tc admin - Open the administrator menu.
• /tc reload - Reload the configuration, language files, and player data.

Permissions

• treechopper.use - Use the tree chopping system.
• treechopper.toggle - Toggle your own state.
• treechopper.stats - View your personal statistics.
• treechopper.menu - Access the player settings menu.
• treechopper.debug - Access inspect and debug features.
• treechopper.admin - Access the admin GUI.
• treechopper.reload - Reload the configuration.
• threechopper.antiexploit.bypass - Bypass all anti-exploit limits.