The TreeCapitation999 plugin is designed for Minecraft servers, enhancing the tree-cutting experience by allowing players to harvest entire trees with a single action. Key features include customizable configurations for axe requirements, automatic replanting with matching saplings, and a permission system for granular control over usage. Commands include /treecapitation reload for reloading configurations without a server restart. The plugin also optimizes performance with an efficient tree scanning algorithm and supports custom log types, making it versatile for various gameplay styles.
The TreeCapitation999 plugin is a powerful tool for Minecraft server administrators, designed to streamline the tree harvesting process and enhance gameplay. This plugin allows players to cut down entire trees in one swift action, significantly improving efficiency and reducing the time spent on resource gathering. Among its standout features is the customizable configuration that lets server owners dictate whether players need an axe to use the plugin, with options to enable or disable this requirement based on gameplay preferences. Additionally, the plugin introduces an innovative auto-replant feature, which automatically plants saplings that match the species of the tree cut down, promoting sustainability within the game.
The permission system integrated into TreeCapitation999 provides fine-grained control over who can use the plugin's features, allowing server operators to set permissions such as treecapitation.use for general access, treecapitation.bypass.cooldown for those who should not face cooldowns, and treecapitation.instant for immediate tree harvesting without delays. The command /treecapitation reload is also included, enabling administrators to refresh the plugin's configuration without needing to restart the server, thus ensuring a seamless experience for players.
Performance-wise, TreeCapitation999 is optimized with a sophisticated tree scanning algorithm that minimizes lag during large operations, making it suitable for servers with high player counts or extensive tree populations. The plugin also supports custom log types, allowing for greater flexibility and compatibility with various mods and gameplay styles. Overall, TreeCapitation999 is an essential addition for any Minecraft server looking to enhance the tree harvesting experience while maintaining control and performance.
All Versions
+ Add Version- Felling direction control with visual particle effects showing fall direction based on player look direction
- Tool enchantment integration supporting Fortune (increased drops), Silk Touch (logs only), Unbreaking (reduced durability loss), and Efficiency (faster cascading)
- Undo/rollback command (/treecapitation undo) to restore the last felled tree within 5 minutes
### Bug Fixes
- Fixed cooldown calculation displaying incorrect remaining time due to integer division truncation
- Fixed tool breaking not properly clearing the player's main hand slot
- Fixed WorldGuard integration using deprecated API method
- Fixed cascading break potential null pointer when block state changes between scheduling and execution
- Added particle effects and sounds for leaf breaking in cascading mode
- Fixed auto-replant using original log location instead of bottom-most trunk block
- Fixed particle data creation failing for non-block materials
- Fixed break sound playing at player location instead of block location
- Fixed custom drops using incorrect origin location in cascading mode
- Fixed fake vertical log detection incorrectly blocking standalone logs and small trees
- Fixed smart tree recognition grounded check using wrong X/Z coordinates for multi-trunk trees
- Fixed tool list parsing silently ignoring invalid materials without warnings
- Fixed protection hook memory leak on config reload
- Fixed player settings and cooldown bypasses not clearing on config reload
- Fixed fortune enchantment not being applied to tree drops
- Additional protection integrations (GriefPrevention, Lands, Towny, PlotSquared) with per-plugin toggles.
### Bug Fixes
- Prevented cascading break from being retriggered mid-animation and duplicating drops.
- Reduced false negatives in tree detection by expanding the leaf scan radius.
- Smart tree recognition now requires trunks to be grounded.
- Per-world player settings now apply correctly per world.
- Invalid per-world or tree override entries no longer cause errors and are skipped.
- A max leaves break value of 0 now breaks no leaves.
- Tool break handling now clears the tool safely.
- Tree breaking now respects existing protection cancellations.
- Cooldown Bypass Command** —
/treecapitation bypass <player>allows admins to toggle cooldown bypass for a specific player. Bypassed players are exempt from the tree felling cooldown entirely. Both the admin and the target player receive a confirmation message when bypass is toggled on or off. Requires thetreecapitation.bypasspermission (default: op).
- Cascading Break Animation** — When enabled, tree blocks break sequentially from top to bottom instead of all disappearing instantly. Each block breaks with a configurable tick delay between them. Leaves break after all logs have finished breaking. Particles play on each individual block as it breaks. Auto-replant triggers after the final log is removed. Configurable via
cascading-break.enabledandcascading-break.delayin config.yml. Supports per-world overrides.
- Smart Tree Recognition**: Added advanced algorithm to distinguish between actual trees and wooden structures/buildings to prevent accidental destruction
- Validates minimum trunk height requirements
- Checks for nearby leaves to confirm tree structure
- Analyzes proportions to identify man-made structures
- Verifies ground connection for natural tree growth
- Configurable settings for recognition sensitivity
### Configuration Updates
- Added
smart-tree-recognitionsection to config.yml enabled: Toggle the feature on/off (default: false)min-trunk-height: Minimum vertical logs required (default: 2)max-branch-length: Maximum distance for leaf detection (default: 3)
### Behavior Changes
- When smart tree recognition is enabled, players will receive a notification when attempting to break structures that are not recognized as trees
- Tree capitation will only occur when the connected logs form a valid tree structure according to the recognition algorithm
- Feature can be configured per-world using the existing per-world settings system
- Added configurable leaf detection radius to allow customization of how far from logs to search for leaves
- Commands:**
- Added
/tc toggleguicommand to open a GUI for players to toggle their personal settings forsneak-to-fellandauto-replant. - Added
/tc limitscommand to display the current configured limits of the plugin. - Configuration (
config.yml):** - Added
durability-multiplieroption to control how much durability is used per log broken. - Added
per-world-settingssection to override any of the main settings for specific worlds. - Added
custom-dropssection to define custom items that can drop when a tree is chopped down. - Added
tree-overridessection to override settings for specific tree types. - Added
modded-wood-materials&modded-leaf-materialslists to add support for modded blocks. - Added
sounds&effectssections to configure sounds and particle effects.
- Tool Whitelist/Blacklist:** You can now specify a list of tools that can or cannot be used to trigger tree capitator. This is configurable in the
config.ymlfile under thetoolssection. - "Sneak to Fell" Functionality:** Players can now be required to sneak to trigger tree capitator. This is configurable in the
config.ymlfile with thesneak-to-felloption. - WorldGuard Integration:** Tree capitator will now respect WorldGuard regions and will not work in regions where the player does not have build permissions.
- Cooldown:** A cooldown between uses of tree capitator can now be configured in the
config.ymlfile to prevent server strain. - Durability Calculation:** The durability taken from the tool will be equal to the number of logs broken.
## Changes
- The default value for
auto-replantis nowfalseto match theconfig.ymlfile.
- Fixed tool durability handling: tools now properly break and notify players when worn out.
- Improved log drops: supports mixed log types and drops correct amounts per type.
- Auto-replanting now only occurs on valid soil blocks with air above to prevent silent failures.
- Enforced safe limits on max tree blocks (capped at 500) and warned about high break distances to protect performance.
- Optimized leaf breaking with BFS and a maximum leaves limit to drastically reduce lag on large trees.
- Added permission checks (
treecapitation.use,treecapitation.reload,treecapitation.toggle) for better control. - Included stripped logs and stems in wood detection for full compatibility.
- Added toggle command to enable/disable the plugin per player.
- Prevented plugin from triggering on fake vertical log columns without leaves nearby to avoid accidental breaks.
Added /treecapitation reload command to reload config without restart
Implemented require-axe config option (default: true)
Added drop-as-one option to combine log drops into single stack
New auto-replant system with species-matching saplings
Configurable max-tree-blocks limit (default: 120 blocks)
Support for custom log types via config
Permission system with granular controls:
treecapitation.use (base permission)
treecapitation.bypass.cooldown
treecapitation.instant
🐛 Bug Fixes
Fixed XP dropping issues with manual block breaking
Improved leaf detection to avoid breaking decorative foliage
Resolved tool durability miscalculations
Fixed potential item duplication issues
Better handling of custom block types
⚡ Performance Improvements
Optimized tree scanning algorithm
Added fail-safe for oversize trees (configurable limit)
Reduced memory usage during large tree operations
Async processing for very large trees (>50 blocks)
⚙️ Configuration Changes
yaml
Run
Copy code
# New options added:
require-axe: true
drop-as-one: true
auto-replant: true
max-tree-blocks: 120
leaf-search-radius: 5
# Custom logs example:
custom-logs:
# - "MODDED_LOG_TYPE"
