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. ---