🛡️ Instant-Shield-Break

<details> <summary>Text Description (Accessibility Transcription)</summary> ## 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* </details>