HudPulse — 1% Low FPS, Server TPS & Ping Jitter Telemetry HUD
HudPulse is an ultra-lightweight, pure client-side performance and network telemetry overlay built specifically for Minecraft 1.21 and 1.21.1 (Fabric). Designed for competitive multiplayer players, technical redstone builders, and modpack authors, HudPulse surfaces the real frame-pacing, server tick health, network stability, and JVM memory metrics that vanilla's crowded F3 debug screen hides behind walls of text.
Key Telemetry Features
- Sub-Microsecond Frame Pacing & 1% Low FPS: Hooks the start of every client render pass using a lock-free 1,024-sample nanosecond ring buffer (
System.nanoTime()), reporting real-time average FPS, 1% Low FPS, average frametime in milliseconds, and>33.3 msmicro-stutter spike counts. - Passive Multiplayer Server TPS Estimator: Tracks
WorldTimeUpdateS2CPacketarrival intervals using an exponentially weighted moving average (EWMA) to estimate live server TPS (0.0 – 20.0 TPS) on any vanilla, Paper, Spigot, Purpur, or Fabric multiplayer server without requiring server-side mods or operator permissions. - RFC-3550 Network Ping & Jitter Tracking: Samples tab-list latency alongside RFC-3550 inter-arrival jitter (
±ms) so you can immediately tell whether lag originates from Wi-Fi/routing instability or server tick overload. - World Entity, Chunk & JVM GC Allocation Profiler: Displays loaded client chunks, active world entity counts, heap utilization (
used / max MB), live allocation rate (MB/s), and automatic[GC!]stop-the-world collection warnings when memory pressure spikes. - Dynamic Status Border & F3 Auto-Hide: Uses crisp procedural
DrawContextrendering with color-coded health borders (emerald normal, amber warning, crimson alert) and automatically hides itself wheneverF3orF1(hudHidden) is active.
Default Keybindings
All shortcuts can be rebound anytime under Options -> Controls -> Key Binds -> HudPulse Telemetry:
H— Toggle HudPulse Overlay: Instantly show or hide the HUD overlay in-game.J— Cycle Compact / Detailed Profiler Mode: Switch between a minimal two-line FPS + TPS/Ping badge and the full four-line entity, chunk, and JVM allocation profiler.
Multiplayer & Modpack Compatibility
- 100% Client-Side Only: Safe on vanilla realms and public multiplayer networks; sends zero custom packets to servers.
- Zero Texture Overhead: Renders procedurally via Minecraft 1.21's native
DrawContextbatching pipeline with negligible CPU/GPU cost, making it fully compatible with Sodium, Iris, Lithium, and ImmediatelyFast.
Installation & Requirements
- Install Minecraft 1.21 or 1.21.1 with Fabric Loader
>= 0.16.0and Java 21. - Install Fabric API in your
.minecraft/modsdirectory. - Drop
hudpulse-fps-telemetry-1.1.0+mc1.21.1.jarinto.minecraft/modsand launch the game.
License
Released under the permissive MIT License.