HudPulse FPS & Tick Telemetry

Lightweight client-side 1% low FPS, frame-time graph, estimated server MSPT/TPS, and ping jitter HUD overlay for Fabric 1.21 / 1.21.1.

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 ms micro-stutter spike counts.
  • Passive Multiplayer Server TPS Estimator: Tracks WorldTimeUpdateS2CPacket arrival 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 DrawContext rendering with color-coded health borders (emerald normal, amber warning, crimson alert) and automatically hides itself whenever F3 or F1 (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 DrawContext batching pipeline with negligible CPU/GPU cost, making it fully compatible with Sodium, Iris, Lithium, and ImmediatelyFast.

Installation & Requirements

  1. Install Minecraft 1.21 or 1.21.1 with Fabric Loader >= 0.16.0 and Java 21.
  2. Install Fabric API in your .minecraft/mods directory.
  3. Drop hudpulse-fps-telemetry-1.1.0+mc1.21.1.jar into .minecraft/mods and launch the game.

License

Released under the permissive MIT License.

HudPulse FPS & Tick Telemetry Team

profile avatar
  • 2
    Projects
  • 78
    Downloads

More from Khanhtnq