A client-side-only Fabric mod for Minecraft 26.2 that visualizes
Minecraft's attribute-swapping behavior — the "swap hit" case where a
follow-up attack lands using a stale/swapped attribute snapshot. It's purely
cosmetic/diagnostic: it surfaces swap hits with an on-screen glyph and a world
particle, and changes no gameplay.
This mod runs only on the client. fabric.mod.json declares
"environment": "client", so Fabric Loader skips it entirely on a dedicated
server — it is never registered there and none of its code runs. There is no
main/server entrypoint, only a client one.
Early scaffold. The client-only setup and the glyph/particle build pipeline are in place; swap-hit detection and rendering are not implemented yet. See AGENTS.md for architecture and the roadmap.
./gradlew build
Built jar lands in build/libs/. The build bakes the glyph art from
src/main/resources/assets/visual-swap/swap_hit_masks.json into particle
sprites (see AGENTS.md → "Build pipeline").
Minecraft 26.2 · Fabric (Loader 0.19.3, API 0.153.0+26.2, Loom
1.17-SNAPSHOT) · Java 25 · Mojang mappings.
Start with AGENTS.md (architecture & flows) and CLAUDE.md (working instructions).