Why TreeCapitator1653?
TreeCapitator1653 focuses on control + compatibility + performance.
You can keep the chopping experience fast for players while still enforcing permissions,
enchant requirements, cooldowns, XP costs, tool durability, and region protection rules.
Built for admins who want a clean treebreaker feel without losing gameplay balance.

Perfect for survival servers, economy servers, SMPs and networks that want quality-of-life
without losing balance.


Requirements

• Server: Paper / Spigot / Folia 1.21.x+
• Java: 21+
• Optional: PlaceholderAPI
• Optional: WorldGuard

Feature Overview

Category	What you get
Core Tree Cutting	Connected log scan, natural-tree checks, fallen-log support, configurable minimum logs, and a natural timber effect
Break Logic	Order modes: ALL_AT_ONCE, TOP_DOWN, BOTTOM_UP, RANDOM, FROM_TRIGGER_BIDIRECTIONAL
Access Control	Permission gates, tool mode gates, optional enchant requirement, sneak mode trigger
Balance Controls	Cooldowns, XP cost per log, durability cost, daily limits, bypass permissions
Drops & Inventory	Log drop percent, optional direct log-to-inventory with overflow drop to ground
Leaves & Replant	Optional instant leaves break, optional delayed replant, optional sapling requirement
Visuals	Log crack preview animation, optional leaves crack animation, optional falling-tree animation
Messaging	Configurable prefix, language switcher, MINI_MESSAGE/LEGACY/BOTH format modes
Platform Integration	Folia-aware scheduler facade, WorldGuard hook, PlaceholderAPI expansion

Detailed Features

• ✅ Multi-platform: One jar for Paper, Spigot and Folia.
• ✅ Natural Tree Validation: Optional checks to avoid breaking random player builds while preserving a familiar treebreaker workflow.
• ✅ Leaves Trigger Mode: Start chopping by breaking leaves (with dedicated permission).
• ✅ Flexible Tool Modes: AXE_ONLY, ANY_ITEM or MATERIAL_LIST.
• ✅ Enchant Gate: Require TreeCap enchant level, including separate 2x2 requirement.
• ✅ Cooldown Modes: Cooldown with NONE/CHAT/ACTION_BAR notifications.
• ✅ Break Speed Scaling: Increase startup duration via percentage for balancing.
• ✅ Advanced Drop Control: Reduce log drops by percent and route logs directly to inventory.
• ✅ Replant Workflow: Delay replanting and optionally require saplings from inventory.
• ✅ Crafting Support: Optional custom recipe with result metadata and levels.
• ✅ In-World Safety: World blacklist + WorldGuard protection check.
• ✅ Language System: Dedicated lang/ folder with 21 language files.
• ✅ Message Formats: Use MiniMessage, classic &-codes, or BOTH mode.

Installation

1. Download TreeCapitator1653.jar
2. Put it into plugins/
3. Start or restart your server
4. Edit plugins/TreeCapitator1653/config.yml
5. Select your language in messages.language
6. Run /treecap reload

Commands

Command	Description	Permission
/treecap reload	Reload config and language files	treecap.command
/treecap givebook <player> [main|replant] [level]	Give TreeCap/Replant enchant book	treecap.command
/treecap giveaxe <player> [material] [level]	Give tagged TreeCap axe	treecap.command

Permissions (Core)

Permission	Description	Default
treecap.command	Use /treecap command	op
treecap.use	Use TreeCap breaking	true
treecap.startfromleaves	Allow leaves trigger mode	op
treecap.instantleaves	Allow instant leaves breaking	op
treecap.bypassenchant	Bypass enchant requirement	op
treecap.bypass.cooldown	Bypass cooldown	op
treecap.bypass.dailylimit	Bypass daily limit	op
treecap.bypass.xpcost	Bypass XP costs	op
treecap.bypass.protection	Bypass protection checks	op
treecap.bypass.toolbreak	Bypass tool break protection	op
treecap.animation.falling	Allow falling-tree visual animation	op
treecap.update.notify	Receive update checker notifications on join	op

Configuration Highlights


Use Cases

• SMP Vanilla+: Keep normal balance with XP cost + durability + cooldown.
• Fast-Paced Survival: Use ALL_AT_ONCE, disable costs, enable inventory drops.
• Hard Economy: Increase XP cost, enable fail-if-not-enough-xp and daily limits.
• Roleplay/Build Servers: Enable natural-tree checks + protection hooks to reduce grief potential.
• Network/Folia: Keep stable task behavior with scheduler abstraction and lightweight config gates.

Included Languages
English, German, Dutch, Spanish, French, Portuguese, Arabic, Czech, Turkish, Polish,
Russian, Italian, Korean, Hungarian, Japanese, Chinese, Vietnamese, Swedish, Slovak,
Hindi, Indonesian.

Custom language files are supported through the lang/ folder.


FAQ
Q: Can I disable tree cutting in specific worlds?
Yes, use general.blocked-worlds.

Q: Can players use TreeCap without axes?
Yes, set tool.mode to ANY_ITEM or configure MATERIAL_LIST.

Q: Can I require sneaking to activate TreeCap?
Yes, set trigger.sneak-mode to REQUIRE_SNEAK.

Q: Do logs have to drop on the ground?
No, enable drops.logs-to-inventory. Overflow still drops naturally.

Q: Can I use old & color codes and MiniMessage at the same time?
Yes, set messages.format: "BOTH".

Q: Is this a timber/treebreaker plugin style?
Yes. TreeCapitator1653 delivers the classic timber/treebreaker feel with full server-side control over balance and protection.


Support
Need help with setup or balancing?
Support is available via Discord.



Made with ❤ by Jan1653


Planned Features

• Strict Trigger-Block Sync Mode: optional exact sync for the first mined block crack stage.
• Advanced Animation Profiles: server presets for visual smoothness vs packet performance.
• Per-World Animation Overrides: different animation behavior depending on world type.