EssentialUtils

A Folia-optimized survival convenience plugin for Paper/Folia 1.21.8.
Adds smooth, lag-free mechanics like tree chopping, vein mining, and auto-farming.

---

✨ Features

• 🌲 Tree Assist (axe)

  • Incrementally chops connected logs with per-block delay (smooth, no spikes).
  • Leaf checks to avoid cutting adjacent trees.
  • Optional auto-replant (saplings/propagules), retries with cooldown until successful.
  • Durability decreases once per N blocks, not per block.

• ⛏ Vein Mine (pickaxe)

  • Incrementally mines connected ore veins.
  • Enforces Minecraft tool tier rules:
    • If tier too low → no break, alert shown (rate-limited).
  • Delay per block scales with vein size.
  • Durability decreases once per N blocks.

• 🌾 Auto Farm (hoe)

  • Harvests only mature crops in a radius.
  • No auto-replant (intentional).
  • Optimized for local chunk scans.

• ⚙ Activation

  • Hold Shift for 5 seconds → arms tool (progress bar shown).
  • Once armed, stays armed even after releasing Shift.
  • Deactivates only when item is changed or player quits.

• 🛡 Safety

  • Respects protections (future: WorldGuard/GriefDefender hooks).
  • Requires loaded chunks.
  • Folia region-safe scheduling only (no async hacks).

• 📊 Performance

  • Centralized per-player tick budget.
  • Strict per-feature caps.
  • Smooth staggered breaking.

---