HerePunchy

A premium Paper Minecraft plugin for auto-attack and auto-defense combat patrols — automatically traverse a player-defined rectangular area, scan and navigate around hazards (lava, water, fire, walls), prioritize attacks using a configurable weapon list (Bow, Crossbow, Trident, Sword, Axe, Mace), auto-defend from incoming projectiles with shields, eat food to sustain health, restock gear, and deposit mob loot!

---

Features

• Area selection — Shift-right-click with any Sword to set two corners (Point A and Point B) of your combat patrol zone.
• Area scanning — After setting Point B, the perimeter is scanned and classified as passable, hazards (lava, fire, magma, water), or obstructed. Hazards are safely bypassed.
• Reverse Traversal & Rescan — Walks from Point A to Point B. Once B is reached, walks backwards to A in reverse waypoint order, re-scanning the zone at each end to adapt to changes.
• Smart weapon selection — Dynamically equips the highest priority available weapon from your custom sequence.
• Ranged Combat aiming — Fires arrows or throws tridents at distant mobs (up to 20 blocks away), including drawing bow simulations.
• Active Shielding — Holds a shield raised in your offhand to protect you from surprise attacks whenever you are not swinging/shooting.
• Frontal block listener — Custom listener ensures that frontal damage from arrows or melee hits is cancelled, durability is damaged, and shield block effects are triggered.
• Weapon Durability Safety — Automatically switches to alternative weapons when a weapon's durability falls below 5 to prevent it from breaking.
• Low Hunger/Health Eating — Scans inventory for food and eats it when hunger or health drops, restoring saturation and pausing other tasks for 1.6s.
• Wizard Setup Chests — Set backup weapon restocking chests and loot drop-off chests.
• Starting Gear Protection — Records your initial inventory at startup; these items are marked as protected and will never be dumped into the loot box.
• Auto-Defense Mode Chat Alerts — If all preferred weapons and backup ammo are completely depleted, sends an alert message in chat and activates bare fist/tool fighting.
• Offline cleanup — Automatically clears player states and stops tasks when they disconnect.

---