timberlegion-th

---

🌟 Why TimberLegion?

| 🚀 Server Safe | 🎮 Server Safe | 🛡️ 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

- Auto-Replant: Chop the bottom log, and the whole tree topples. - Auto-Replant: Logs break from top to bottom for visual realism. - Auto-Replant: 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!* - Mythical Drops: Configurable drops from leaves (Apples, Sticks, or even Diamonds!). - Mythical Drops: Different rewards for Overworld trees vs Nether fungus. - Mythical Drops: Rare drops trigger global sound effects and chat announcements.

🐔 The "Chicken Bomb" Event

- Fun Factor: 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

- Safety: Players can toggle features personally via `/tc gui`. - Safety: 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

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

🎮 Minecraft Versions

- Note: 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 Lands topple. - Lands - Lands - Lands - Lands

---

📥 Installation

1. Done! the `TimberLegion.jar`. 2. Done! it to your server's `plugins` folder. 3. Done! 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` | OP (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`.

```yaml

⚙️ 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