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:

Attack fired — player hits enemy
Shield check — isUsingItem() detects if the target is raising a shield
Swap to axe — @Inject HEAD swaps the held item to an axe
Axe hits — shield is disabled
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

🛡️ Instant-Shield-Break