TreeCapitator1653 1.0.0

TreeCapitator1653
Fast, configurable timber-style tree chopping for modern servers

⚡ Fell complete trees in one action
🌍 21 language files included
🧩 Prefix + MiniMessage/Legacy/Both support
🎒 Optional direct log drops to inventory
🔒 Protection-aware with WorldGuard hook

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

1. Server: Paper / Spigot / Folia 1.21.x+
2. Java: 21+
3. Optional: PlaceholderAPI
4. Optional: WorldGuard

Feature Overview

Detailed Features

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

Installation
[LIST=1]Download TreeCapitator1653.jarPut it into plugins/Start or restart your serverEdit plugins/TreeCapitator1653/config.ymlSelect your language in messages.languageRun /treecap reload
[/LIST]

Commands

Permissions (Core)

Configuration Highlights
[SPOILER="config.yml essentials"]

messages:
  prefix: "&8[&aTreeCapitator1653&8] "
  language: "en"  # en, de, nl, es, fr, pt, ar, cs, tr, pl, ru, it, ko, hu, ja, zh, vi, sv, sk, hi, id
  format: "BOTH"  # MINI_MESSAGE | LEGACY | BOTH

trigger:
  allow-from-leaves: false
  sneak-mode: "IGNORE" # IGNORE | REQUIRE_SNEAK | REQUIRE_STAND

tool:
  mode: "AXE_ONLY" # AXE_ONLY | ANY_ITEM | MATERIAL_LIST

break-order:
  mode: "ALL_AT_ONCE"
  delay-per-log-ticks: 2

costs:
  xp-points-per-log: 0
  fail-if-not-enough-xp: true
  log-drop-percent: 100.0

drops:
  logs-to-inventory: false

cooldown:
  enabled: false
  ticks: 20
  notify-mode: "NONE" # NONE | CHAT | ACTION_BAR

[/SPOILER]

Use Cases

1. SMP Vanilla+: Keep normal balance with XP cost + durability + cooldown.
2. Fast-Paced Survival: Use ALL_AT_ONCE, disable costs, enable inventory drops.
3. Hard Economy: Increase XP cost, enable fail-if-not-enough-xp and daily limits.
4. Roleplay/Build Servers: Enable natural-tree checks + protection hooks to reduce grief potential.
5. 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 [ICODE]lang/[/ICODE] folder.

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

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

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

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

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

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.

Discord (Support)

Made with ❤ by Jan1653

Planned Features

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