HereLoggy

# HereLoggy A premium (https://papermc.io) Minecraft plugin for **fully automated lumberjacking and tree felling** — systematically discover trees, execute recursive whole-tree clearing, dynamically manage inventory storage, swap and restock axes, auto-feed, defend against hostiles, replant saplings, and boost leveling with **AuraSkills** integration! --- ## Features - **Double-Axe Selection & Path Mapping**: - Selection is quick and simple: hold any Axe, **Sneak + Right-Click** to set **Point A** and **Point B** bounding coordinates. - The plugin automatically triggers an **asynchronous scan** of the area to map walkable blocks and discover tree locations, avoiding server lag. - **Dynamic Auto-Chopping Methods**: - **Whole Tree Mode (BFS)**: Uses a smart recursive Breadth-First Search (BFS) with a radial adjacency of 2 to traverse and break the entire tree structure (up to a 512-block safety limit) from a single base chop. - **Reachable Mode**: Only chops wood blocks within standard player reach height (up to eye-height + 3 blocks), respecting traditional survival mechanics. - **Automatic Foliage & Obstacle Clearing**: - Periodically scans a local radius around the player to **break leaves, vines, and nether foliage** automatically. - Keeps walking paths fully clear to prevent the player from getting stuck or trapped. - **Emergency Trapped & Suffocation Rescue**: Actively monitors if the player is suffocating or trapped inside solid blocks (e.g., logs/leaves due to tree growth, or pushed underground). Instantly fells any logs and foliage in a 5x5x5 cubic area and teleports the player to the nearest safe path node or adjacent safe ground coordinate. - **Smart Tool Preservation & Restocking**: - Monitors axe durability in real-time. Automatically swaps active quickslots to another axe in the inventory to prevent tool breakage. - **Tool Supply Restocking**: Link a **Tool Supply Chest** with spare axes. If durability drops below a user-defined threshold and no spares exist on hand, the player teleports to the chest, deposits the worn axe, withdraws a fresh one, and teleports back to resume lumberjacking instantly! - **Advanced Storage Routing & Keep/Trash Chests**: - Link a **Keep Chest** (for valuable logs) and a **Trash Chest** (for saplings, leaves, extra drops) using the setup wizard. - When the player's inventory becomes full, the plugin automatically routes items to deposit chests. If chests are full or unconfigured, the session pauses safely rather than dropping items. - Allows configuring routing destinations (Keep, Trash, or Keep on Person) per wood type. - **Integrated Hostile Mob Defense & Auto-Feeding**: - Monitors surrounding entities and **actively defends the player** from hostile mobs, pausing wood-cutting for weapon cooldown ticks. - **Smart Whole-Inventory Feeding**: Automatically consumes food from **any inventory slot** (not just the hotbar) when hunger drops below saturation limits. - **Smart Food Preservation**: During automated inventory dumps to Keep/Trash chests, the bot automatically identifies and preserves the **largest food stack** (cooked or raw) in the inventory to ensure continuous operations. - **Vacuum Drop Attraction & Shared Mending Repair**: - Automatically vacuum-attracts all dropped items and experience orbs within a **6-block radius** around broken blocks. - Directs collected block-break experience straight to repairing hotbar tools enchanted with **Mending** (prioritizing the most damaged axe), allocating leftover XP to the player. - **Automatic Sapling Replanting**: - If enabled, automatically places matching saplings on soil, dirt, nylium, or soul blocks immediately after a tree is felled, as long as saplings are available in the player's inventory or off-hand. - **AuraSkills Integration**: - Fully supports AuraSkills (formerly Aurelium Skills). - Award-winning **Foraging XP** is granted for broken log blocks and attracted experience orbs. - Player movement velocity multiplier scales dynamically based on their current Foraging Level (`1.0 + Foraging Level * 0.01`). - **HereRolePlay Integration**: - Automatically awards Collect experience points directly to the player for each log and wood block broken, helping level up Miner and Admin classes. - **Interactive Configuration GUI**: - A beautiful, full-featured GUI to toggle active states, replanting preferences, and inventory routing destinations for 10 tree types: **Oak, Spruce, Birch, Jungle, Acacia, Dark Oak, Mangrove, Cherry, Crimson, and Warped**. --- ## Commands All commands can be run with `/hl` instead of `/hereloggy`. | Command | Description | Permission | |---------|-------------|------------| | `/hereloggy start` (or `/hl start`) | Start auto-chopping (triggers area scan first if selection exists but has not been scanned) | `hereloggy.use` | | `/hereloggy stop` (or `/hl stop`) | Stop active chopping session and display statistics | `herelo