🛡️ Instant-Shield-Break

Instant-Shield-Break v1.0

NETHPOT PVP · FABRIC MOD · CLIENT-SIDE

Auto-breaks enemy shields in nethpot PvP by swapping to an axe at the exact moment of attack,
then reverting instantly — all within a single tick. No GUI, no keybinds, always on.

Tags: Fabric API · Java · MC 1.19–1.21 · 1-tick swap · Always active · Zero flicker

⚙️ How the Swap Works

A five-step process that occurs within a single tick:

1. Attack fired — player hits enemy
2. Shield check — isUsingItem() detects if the target is raising a shield
3. Swap to axe — @Inject HEAD swaps the held item to an axe
4. Axe hits — shield is disabled
5. Revert slot — @Inject RETURN swaps back to the original item instantly

📦 Module Breakdown

ShieldDetector (util/ShieldDetector.java)
Checks if the target player is actively raising a shield via isUsingItem() + item identity
check. Catches the intent before the 5-tick raise delay, ensuring no missed hits.

InventoryScanner (util/InventoryScanner.java)
Scans hotbar slots 0–8 first, then main inventory slots 9–35. Maintains a cached
last-used axe slot for instant lookup on repeated attacks. Supports any modded axe
extending AxeItem.

SwapHandler (handler/SwapHandler.java)
Orchestrates the full swap sequence. Guards against spam with a 150ms cooldown. Sends a
vanilla UpdateSelectedSlotC2SPacket for server sync. Reverts in the same call-stack frame
— zero extra ticks.

Attack Mixin (mixin/ClientPlayerInteractionManagerMixin.java)
Hooks into attackEntity() at HEAD (pre-packet) and RETURN (post-packet). Only
intercepts PlayerEntity targets — mob attacks pass through unmodified.

Config (config/ShieldBreakConfig.java)
GSON-backed JSON config at config/instant-shield-break.json. Supports enabled toggle,
cooldownMs tuning, and debugLogging for verbose output. Auto-creates defaults on first
launch.

📊 At a Glance

| Stat | Value |
|——|——-|
| Tick swap window | 1 |
| Spam cooldown | 150ms |
| Visible flicker frames | 0 |
| Inventory slots scanned | 35 |
| Mixin inject points | 2 |
| Source modules | 5 |

by Shubham96 · MIT License · Fabric 1.19–1.21 · instant-shield-break v1.0