SpyHITW (Hybrid Plugin-Mod System)

SpyHITW is a highly optimized, hybrid "Hole In The Wall" minigame system built for Minecraft 1.21.11. It is split into a server-side Referee/Director (Paper Plugin) and a client-side Visuals/Physics engine (Fabric Mod) to achieve zero-lag visual interpolation and client-authoritative solid collisions.

It is a client-side dependency for SpyHITW-paper plugin.

spyhitw-fabric (Client Mod)

The Fabric mod intercepts instructions from the server to local visual renderers and physics loops:

• Network Packet Listener: Deserializes serialized byte streams and updates the local wall registry.
• Visual Renderer: Draws virtual walls using client-side BlockRenderDispatcher and WorldRenderEvents.AFTER_ENTITIES (rendering high-fidelity blocks with full refresh rate interpolation).
• Zero-Lag Physics Injection: Uses Mixin to inject solid VoxelShape collision boxes into Entity#findCollisions(). Forces the client to collide locally against moving walls, preventing phasing and rubber-banding.
• Dynamic Audio Engine: Automatically plays client-side music loops during active games, syncing with operator preference settings.