Links
Tags
Creators
Details
1.0.0
Compatibility
Changes
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.
Optional dependencies
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle. To learn more about the Modrinth Maven API, click here.
Note: When available, you should use the creator's maven repo instead as it will have transitive dependency information that the Modrinth Maven API does not. You may also end up with duplicate dependencies if you use a mix of Modrinth and non-Modrinth Maven repositories for your dependencies, because the group identifier will be different when served through the Modrinth Maven API.
Maven coordinates:
Version ID:
build.gradle:
repositories {
exclusiveContent {
forRepository {
maven {
name = "Modrinth"
url = "https://api.modrinth.com/maven"
}
}
// forRepositories(fg.repository) // Uncomment when using ForgeGradle
filter {
includeGroup "maven.modrinth"
}
}
}
// Standard Gradle dependency
dependencies {
implementation "maven.modrinth:y1EVuZTX:Z66zV7GF"
}
// Legacy Loom dependency
dependencies {
modImplementation "maven.modrinth:y1EVuZTX:Z66zV7GF"
}

