---

🌟 Why TimberLegion?

🚀 Performance First	🎮 Gameplay Focused	🛡️ Server Safe
Optimized algorithms ensure no lag, even on massive trees.	RPG rewards, sound effects, and particles make chopping addictive.	Respects WorldGuard, GriefPrevention, and tracks player-placed blocks.

🔥 Key Features

🪓 Realistic Mechanics

• Chain Reaction: Chop the bottom log, and the whole tree topples.
• Top-Down Breaking: Logs break from top to bottom for visual realism.
• Smart Leaf Decay: Leaves vanish smoothly around the tree.
• Auto-Replant: Automatically replants saplings so your forests never run dry.

🎁 RPG Reward System

Turn lumberjacking into a treasure hunt!

• Custom Loot: Configurable drops from leaves (Apples, Sticks, or even Diamonds!).
• Biome Specific: Different rewards for Overworld trees vs Nether fungus.
• Mythical Drops: Rare drops trigger global sound effects and chat announcements.

🐔 The "Chicken Bomb" Event

• Easter Egg: A configurable, rare chance (default 1%) for a tree to explode into a flock of glowing chickens!
• Fun Factor: Adds a surprise element to the grind.

⚙️ Player & Admin Friendly

• In-Game GUI: Players can toggle features personally via /tc gui.
• Admin Panel: Edit config settings directly in-game without restarting.
• Safety: Option to require sneaking (Shift) or double-break confirmation to prevent accidents.

---

✅ Compatibility & Support

🖥️ Server Software

• Supported: Spigot, Paper, Purpur, Pufferfish
• Recommended: Paper or Purpur (for best performance)

🎮 Minecraft Versions

• Range: 1.13 - 1.21+
• Note: Fully supports new blocks like Cherry, Mangrove, and Nether stems.

🛡️ Protection Integration

TimberLegion automatically respects region protections. If a player cannot break a block normally, the tree will not topple.

• WorldGuard
• GriefPrevention
• Towny
• Lands

---

📥 Installation

1. Download the TimberLegion.jar.
2. Upload it to your server's plugins folder.
3. Restart the server.
4. (Optional) Edit config.yml to customize drops and rates.
5. Done! No extra dependencies needed.

---

Commands

👤 Player Commands

Command	Permission	Description
/tc gui	treecutter.use	Open the personal settings menu
/tc help	None	View list of commands

👮 Admin Commands

Command	Permission	Description
/tc reload	treecutter.admin	Reload configuration from disk
/tc debug	treecutter.admin	Run system diagnostics & check conflicts
/tc toggle	treecutter.admin	Quick-toggle the plugin for yourself
/tc ap	treecutter.admin	Quick-toggle Auto-Plant for yourself
/tc fx	treecutter.admin	Quick-toggle Effects for yourself

🔐 Permissions

Permission	Default	Description
treecutter.use	True (Everyone)	Allows players to use the timber mechanic and open the settings menu (/tc gui).
treecutter.admin	OP	Grants access to admin commands (reload, debug) and the Admin Panel in the GUI.

---

🔧 Configuration

Customize every aspect in config.yml.

# ⚙️ Core Settings
max_blocks: 200           # Limit blocks to prevent lag
require_sneak: true       # Require Shift to chop

# 🎁 Rewards
reward_chance: 0.001      # 0.1% chance for custom drops
rewards:
  DIAMOND: 0.1            # Extremely rare drop!

# 🐔 Events
chicken_bomb_chance: 0.01 # 1% chance of chicken explosion