🌲 TreeCutter

One-line: Instantly fell whole trees by sneaking and breaking a log — lightweight, safe, and toggleable per player.

---

✨ What it does

TreeCutter makes harvesting trees quick and natural: when a player sneaks (shift) and breaks a log, the plugin finds the connected tree (vanilla logs/stems/stripped variants) and drops the tree’s blocks as if harvested normally. Designed for minimal server impact: async scanning, caching, size limits, and configurable behaviors.

---

⚡ Features

• Sneak + break any log to fell the full tree.
• Supports all vanilla logs, nether stems and stripped variants.
• Per-player toggles (/tc) — opt-in by default.
• Async scanning + cached results for high performance.
• Configurable: max tree size, cooldown, drop behavior, particles, messages.
• Permission nodes for granular control.
• Safe: affects natural logs only and enforces size/cell limits to avoid grief.

---

🛠 Commands

Player

• /tc — Toggle TreeCutter for yourself.
• /tc on / /tc off — Explicit enable/disable.
• /tc status — Show current status.
• /tc help — Show help.

Admin (requires treecutter.admin)

• /tcadmin reload — Reload config.
• /tcadmin config — Print current effective config.
• /tcadmin info — Plugin stats & cache info.
• /tcadmin player <name> enable|disable — Manage a player's setting.
• /tcadmin cache clear — Clear tree cache.
• /tcadmin debug on|off — Toggle debug logging.
• /tcadmin cleanup — Cleanup stale player data.

---

🔑 Permissions

Permission	Default	Description
treecutter.use	true	Allows a player to use TreeCutter.
treecutter.admin	op	Access admin commands.
treecutter.reload	op	Reload configuration.

---

📥 Installation

1. Download the JAR (Modrinth / GitHub releases).
2. Place TreeCutter-<version>.jar into the plugins/ folder.
3. Start or restart your server — config files will be generated at first run.
4. Configure config.yml to taste and reload with /tcadmin reload.

---

⚙ Example config.yml

# TreeCutter — example config
enabled: true
use-permission: true

behavior:
  sneak-required: true
  natural-logs-only: true
  max-tree-size: 500          # prevents huge accidental fells
  cooldown-seconds: 2         # per-player cooldown

drops:
  drop-items: true
  preserve-tools-durability: true
  allow-vanilla-drops: false  # if true, do not modify drop logic

feedback:
  action-bar: true
  chat-messages: true
  particles: true

performance:
  async-scan: true
  cache-enabled: true
  cache-ttl-seconds: 300