All Mods Resource Packs Data Packs Shaders Modpacks Plugins
FPS Overlay

FPS Overlay

by Hicham • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

FPS Overlay

Simple & Lightweight Performance Monitor

Modrinth Downloads CurseForge Downloads Version GitHub Source License Hichamdev | Fps Overlay Mod



As seen in AsianHalfSquat's Videos! v3.6 OLD

Featured in the "Voxy vs Distant Horizons" showcase. Get that same professional aesthetic with the built-in preset!

AsianHalfSquat Feature


Features

  • Real-Time Stats: Track FPS, Avg FPS, Ping, and RAM usage instantly.
  • Fully Customizable: Easily change the size, position, and colors via the config menu.
  • Quick Toggle: Hide or show the overlay with a single keypress. (Default: o)
  • Ultra Lightweight: Written for performance. It won't impact your frames.
  • Cross-Platform: Full support for Fabric and NeoForge and Forge.

Installation & Setup

How to Install

  1. Download and install your preferred loader (Fabric or NeoForge).
  2. Download the FPS Overlay jar for your Minecraft version.
  3. Drop it into your .minecraft/mods folder.
  4. Launch and enjoy!

How to Change Modes

  1. Open the configuration menu (use Mod Menu on Fabric).
  2. Look for the Layout Type setting.
  3. Switch between Default, Navbar.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.1.2
Neoforge
1d ago 1
26.1.2
Fabric
1d ago 1
26.2
Fabric
1d ago 1
1.21.1
Neoforge
1d ago 1
1.21.11
Neoforge
1d ago 1
26.2
Neoforge
1d ago 1
1.21.11
Fabric
1d ago 1
26.2
Fabric
1d ago 1
1.21.1
Neoforge
1d ago 1
1.21.11
Fabric
1d ago 1
26.2
Fabric
1d ago 1
1.21.1
Neoforge
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Fabric
1d ago 1
26.2
Fabric
1d ago 1
1.21.1
Neoforge
1d ago 1
26.1.2
Neoforge
1d ago 1
26.1.2
Fabric
1d ago 1
1.20.1
Forge
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Fabric
1d ago 1
1.21.11
Fabric
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Fabric
1d ago 1
26.1
Fabric
1d ago 1
26.1
Fabric
1d ago 1
1.21.11
Fabric
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.1
Neoforge
1d ago 1
1.20.1
Forge
1d ago 1
1.21.1
Fabric
1d ago 1
1.21.11
Fabric
1d ago 1
1.21.1
Fabric
1d ago 1
1.21.11
Fabric
1d ago 1
1.20.1
Fabric
1d ago 1
1.21.1
Fabric
1d ago 1
1.21.11
Fabric
1d ago 1
1.20.1
Fabric Quilt
1d ago 1
1.21.11
Neoforge
1d ago 1
1.21.11
Fabric Quilt
1d ago 1
1.21.10
Fabric Quilt
1d ago 1
1.21.11
Fabric Quilt
1d ago 1
1.21.11
Fabric Quilt
1d ago 1
1.21.11
Fabric
1d ago 1
1.21.8
Fabric
1d ago 1
1.21.8
Fabric
1d ago 1
1.21.5
Fabric
1d ago 1
1.21.4
Fabric
1d ago 1
Support for 26.1.2 NeoForge
## v5.6
  • Fixed ping showing 1ms on Hypixel SkyBlock and BedWars, caused by
PlayerInfo#getLatency() staying permanently stuck at 1 on Hypixel's
custom tab-list handling. The mod now detects this after 5 seconds
and switches to an active RTT measurement path: it sends a
ServerboundPingRequestPacket every 2 seconds and reads the round-trip
time from Minecraft's own debug overlay ping logger. Normal servers
are unaffected. The fallback resets immediately on disconnect or
server switch.
## v5.6
  • Fixed ping showing 1ms on Hypixel SkyBlock and BedWars, caused by
PlayerInfo#getLatency() staying permanently stuck at 1 on Hypixel's
custom tab-list handling. The mod now detects this after 5 seconds
and switches to an active RTT measurement path: it sends a
ServerboundPingRequestPacket every 2 seconds and reads the round-trip
time from Minecraft's own debug overlay ping logger. Normal servers
are unaffected. The fallback resets immediately on disconnect or
server switch.
  • NeoForge support**
  • NeoForge support**
  • NeoForge support**
  • Backport** for **1.21.11** fabric
## FPS Overlay TPS/MSPT Freeze Handling Fix

Fixed an issue where TPS and MSPT would display stale values or drop straight to N/A during a server freeze or severe lag spike, instead of reflecting what was actually happening.

  • TPS now decays smoothly toward 0 the longer the server goes without responding, instead of holding the last known value or cutting to N/A
  • If the server stays unresponsive for over 30 seconds, the display reverts to N/A (handles disconnects/timeouts correctly)
  • Applies to both the OP debug-packet reading and the non-OP fallback
  • MSPT still shows N/A during a freeze on both paths, unchanged

Thanks to **Sk1ght** on CurseForge for the bug report that led to this fix.
## 5.4
  • Fixed** AVG FPS and 1% Low being capped by HUD framerate-limiting mods (e.g. Gnetum). Frame timing is now sampled from the core render loop instead of the HUD render callback, so it reflects true framerate regardless of HUD throttling settings from other mods.
  • Added **a new Keybinds screen** (accessible from the config hub) for changing, unbinding, and resetting all mod keybindings in one place, with conflict detection against other bound keys.
For 1.21.11 Fabric
## 5.3.1
  • Fixed AVG FPS and 1% Low being capped by HUD framerate-limiting mods
(e.g. Gnetum). Frame timing is now sampled from the core render loop
instead of the HUD render callback, so it reflects true framerate
regardless of HUD throttling settings from other mods.
# FPS Overlay **v5.3**
  • Fixed TPS and MSPT showing "N/A" on dedicated servers
  • OP players receive exact tick data via the vanilla debug sample stream
  • Non-OP players receive an estimated TPS based on server time packets
  • support for 1.21.1**
# FPS Overlay **v5.3**
  • Fixed TPS and MSPT showing "N/A" on dedicated servers
  • OP players receive exact tick data via the vanilla debug sample stream
  • Non-OP players receive an estimated TPS based on server time packets
  • support for 1.21.11**
# FPS Overlay **v5.3**
  • Fixed TPS and MSPT showing "N/A" on dedicated servers
  • OP players receive exact tick data via the vanilla debug sample stream
  • Non-OP players receive an estimated TPS based on server time packets
  • support for 1.21.11**
# FPS Overlay **v5.3**
  • Fixed TPS and MSPT showing "N/A" on dedicated servers
  • OP players receive exact tick data via the vanilla debug sample stream
  • Non-OP players receive an estimated TPS based on server time packets
  • support for 26.2**
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.2

### New
  • Hide metric labels** New toggle in General HUD settings: "Show Metric Labels." Turn it off and your HUD shows only the numbers and units (like 100fps | 10ms), with no text clutter. Great for a minimal look.

### Performance fixes
  • Fixed the FPS drop caused by the graph** This was the main bug from last version. The graph was drawing each bar one pixel at a time, which hammered the GPU. It now draws each bar in a single operation, cutting GPU work by up to 50x.
  • Graph overhead when hidden is now zero** Previously the game was still calculating graph data even when the graph wasn't visible. That's fixed — it skips all graph processing when you have it turned off.
  • Internal Cleanups** A couple of smaller internal cleanups to reduce unnecessary memory usage during startup.
## FPS Overlay v5.1

This release focuses on stability, compliance, and accuracy.
No new features — just making sure everything that's there works perfectly.

### Changes
  • Fixed a thread safety issue in the performance tracking engine that could
cause corrupted FPS readings under heavy load
  • Fixed a crash that could occur when reordering metrics while the overlay
was actively rendering
  • Multiplayer MSPT and TPS now correctly show N/A instead of fake static values
  • Removed CPU and GPU metrics — the only reliable way to read these required
spawning external system processes

### What's in the mod (carried over from v5.0)
Thirteen trackable metrics: FPS, Average FPS, Frame Time, 1% Low, Ping,
TPS, MSPT, Memory, Coordinates, Biome, Chunks, FPS Graph, Min/Max Stats.

Full customization: drag to reposition, reorder metrics, rename labels,
theme presets (Classic Dark, Light, Glass), custom color palette, adaptive
colors, HUD scale, 10 keybinds, auto-hide on F3.
## FPS Overlay v5.1

This release focuses on stability, compliance, and accuracy.
No new features — just making sure everything that's there works perfectly.

### Changes
  • Fixed a thread safety issue in the performance tracking engine that could
cause corrupted FPS readings under heavy load
  • Fixed a crash that could occur when reordering metrics while the overlay
was actively rendering
  • Multiplayer MSPT and TPS now correctly show N/A instead of fake static values
  • Removed CPU and GPU metrics — the only reliable way to read these required
spawning external system processes

### What's in the mod (carried over from v5.0)
Thirteen trackable metrics: FPS, Average FPS, Frame Time, 1% Low, Ping,
TPS, MSPT, Memory, Coordinates, Biome, Chunks, FPS Graph, Min/Max Stats.

Full customization: drag to reposition, reorder metrics, rename labels,
theme presets (Classic Dark, Light, Glass), custom color palette, adaptive
colors, HUD scale, 10 keybinds, auto-hide on F3.
### Version 5.1 (Beta)
I completely rewrote the mod so it now runs natively on both Fabric and NeoForge for Minecraft 1.21.11.

  • New Metrics and Tracking
You can now track thirteen different stats on your screen. This includes performance details like your FPS, a live frame graph, average frames, 1 percent lows, Ping, TPS, and MSPT. You can also monitor your hardware with live CPU, GPU, and memory usage, or keep track of the world with your coordinates, current biome, and loaded chunks.

  • Customization
I added a lot of ways to make the display your own.

You can click and drag the overlay anywhere on your screen, and easily rearrange the order of your stats.

You can rename any label. For example, you can change FPS to say Frames instead.

You can pick from themes like Classic Dark, Light, or Glass, or build your own color palette from scratch.

The text colors will automatically shift from green to yellow to red when your performance drops or you hit a lag spike.

You can scale the size of the overlay up or down, and it will stay perfectly crisp without any blur.

  • Quality of Life Changes

The settings menu is now super easy to reach right from ModMenu on Fabric or the mods list on NeoForge.

The overlay will automatically hide itself whenever you open the F3 debug screen so things do not get too crowded.

I added ten customizable keybinds so you can toggle the overlay, the graph, or individual stats on the fly.
### Version 5.1 (Beta)
I completely rewrote the mod so it now runs natively on both Fabric and NeoForge for Minecraft 1.21.11.

  • New Metrics and Tracking
You can now track thirteen different stats on your screen. This includes performance details like your FPS, a live frame graph, average frames, 1 percent lows, Ping, TPS, and MSPT. You can also monitor your hardware with live CPU, GPU, and memory usage, or keep track of the world with your coordinates, current biome, and loaded chunks.

  • Customization
I added a lot of ways to make the display your own.

You can click and drag the overlay anywhere on your screen, and easily rearrange the order of your stats.

You can rename any label. For example, you can change FPS to say Frames instead.

You can pick from themes like Classic Dark, Light, or Glass, or build your own color palette from scratch.

The text colors will automatically shift from green to yellow to red when your performance drops or you hit a lag spike.

You can scale the size of the overlay up or down, and it will stay perfectly crisp without any blur.

  • Quality of Life Changes

The settings menu is now super easy to reach right from ModMenu on Fabric or the mods list on NeoForge.

The overlay will automatically hide itself whenever you open the F3 debug screen so things do not get too crowded.

I added ten customizable keybinds so you can toggle the overlay, the graph, or individual stats on the fly.
## v5.0 (Release)

### Performance & Metrics
  • Multiplayer TPS Support**: The mod now displays server performance (TPS and MSPT) when playing in multiplayer, leveraging the updated Minecraft TickRateManager to sync data directly from the server.
  • Efficient Corner Rendering**: I optimized the background rendering logic. It now uses a row-by-row calculation for rounded corners, which is much lighter on your GPU while keeping the exact same classic look.

### Control & Customization
  • Toggle Keybinding**: You can now hide or show the overlay instantly using a dedicated keybind. The default is set to 'C', but you can rebind it to anything you like in the standard Controls menu.
  • Toggle Feedback**: When you use the toggle key, a quick message will appear in your chat to confirm the HUD's status.

### Internal & Localization
  • Localization Improvements**: Added full translation support for the new keybindings and categories.
  • Fabric Integration**: Improved how the mod handles client ticks to ensure the overlay is perfectly synchronized with your frame rate.

  • Minecraft 26.1:** Fully up to date and ready for the newest version of Minecraft.
  • Mojang Mappings:** Switched over to official Mojang mappings behind the scenes, which will make maintaining and updating the mod much easier going forward.
# Changelog

## v5.0

### Evolution & Multi-loader
  • Migrated to Architectury**: I've completely rewritten the mod so it now runs natively on both Fabric and NeoForge from the exact same codebase.
  • Minecraft 1.21.11**: Fully up to date and ready for the latest version of Minecraft.
  • Mojang Mappings**: Switched over to official Mojang mappings behind the scenes, which will make maintaining and updating the mod much easier going forward.

### Rendering & UI Refinement
  • Matrix Scaling**: The HUD now scales perfectly without any pixel distortion or blurriness, thanks to the new rendering implementation.
  • Simplified HUD Scale**: I ditched the granular slider in favor of three carefully dialed-in presets: Small (0.65x), Normal (0.8x), and Big (0.95x).
  • New Default Layout**: Fresh installs will automatically use the Top Left position at the Small scale to give you a much cleaner, minimalist vibe right out of the box.
  • Adaptive Performance Colors**: Your FPS, MSPT, and Memory stats will now automatically shift colors in real-time if performance drops, helping you spot lag spikes instantly.
  • Visual Branding**: The mod finally has a polished icon that shows off exactly what the HUD looks like.

### Fixes & Integration
  • NeoForge Config**: You can finally click the "Config" button directly from the NeoForge mod list—no more digging through folders.
  • Cloth Config**: The settings menu now integrates deeply with Cloth Config, giving everything a cohesive and premium feel.
  • F3 Compatibility**: There's a handy new toggle to automatically hide the overlay whenever you open the F3 debug screen, keeping your display from getting cluttered with text.
# Changelog

## v5.0

### Evolution & Multi-loader
  • Migrated to Architectury**: I've completely rewritten the mod so it now runs natively on both Fabric and NeoForge from the exact same codebase.
  • Minecraft 1.21.11**: Fully up to date and ready for the latest version of Minecraft.
  • Mojang Mappings**: Switched over to official Mojang mappings behind the scenes, which will make maintaining and updating the mod much easier going forward.

### Rendering & UI Refinement
  • Matrix Scaling**: The HUD now scales perfectly without any pixel distortion or blurriness, thanks to the new rendering implementation.
  • Simplified HUD Scale**: I ditched the granular slider in favor of three carefully dialed-in presets: Small (0.65x), Normal (0.8x), and Big (0.95x).
  • New Default Layout**: Fresh installs will automatically use the Top Left position at the Small scale to give you a much cleaner, minimalist vibe right out of the box.
  • Adaptive Performance Colors**: Your FPS, MSPT, and Memory stats will now automatically shift colors in real-time if performance drops, helping you spot lag spikes instantly.
  • Visual Branding**: The mod finally has a polished icon that shows off exactly what the HUD looks like.

### Fixes & Integration
  • NeoForge Config**: You can finally click the "Config" button directly from the NeoForge mod list—no more digging through folders.
  • Cloth Config**: The settings menu now integrates deeply with Cloth Config, giving everything a cohesive and premium feel.
  • F3 Compatibility**: There's a handy new toggle to automatically hide the overlay whenever you open the F3 debug screen, keeping your display from getting cluttered with text.
[4.2] FPS Overlay v4.2 by Hicham on Oct 21, 2026
Download
v4.2 Support for 1.21.11 **NeoForge**
FPS Overlay Icon
Download FPS Overlay
Select game version
Select platform