---

🌟 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