
Modrinth · Minecraft mod
Performance Overlay
Lightweight performance overlay and benchmark tool. Real-time FPS & frametime metrics: average FPS, 1% / 0.1% lows, stutters, worst spikes, plus GC and memory stats.
Quick answer
Which Performance Overlay release should I use?
Performance Overlay 1.0.2+mc26.2-fabric targets 26.2 with Fabric. It must be installed on the client. Do not install it on the dedicated server. All 2 required mods have matching files.
Where it goes
Is Performance Overlay required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This file is marked client-only.
What else does Performance Overlay 1.0.2+mc26.2-fabric need?
1.0.2+mc26.2-fabric. Change the file and its required mods may change too.
Install Fabric API, Cloth Config API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Performance Overlay without breaking your instance.
Built for Performance Overlay 1.0.2+mc26.2-fabric. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.2+mc26.2-fabric. It targets 26.2 with Fabric; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Fabric API, Cloth Config API first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.2+mc26.2-fabric. It opens that exact file at the source.
About this project
What does Performance Overlay add?
FPS, Frametime & Benchmarking
Performance Overlay is a lightweight, client-side mod that shows what actually matters for smooth gameplay — not just average FPS.
It focuses on 1% / 0.1% lows, frametime stability, stutters, and frame spikes, helping you understand why Minecraft feels smooth or laggy.
📊 Performance Metrics

The overlay updates in real time and displays:
- FPS (average)
- 1% low FPS
- 0.1% low FPS
- Frametime
- Stutter count
- Worst frame spike
- GC pauses
- Memory usage
All metrics are designed for real performance analysis, not vanity numbers.
⌨️ Key Bindings
All features are accessible instantly via key binds:
- F7 — Toggle performance overlay
- F8 — Cycle overlay layout
- F9 — Reset performance statistics
- F10 — Start / stop benchmark
Key bindings can be changed in Minecraft → Controls.
🧩 Customisation

- Multiple overlay layouts
- Different screen positions
- Minimal and non-intrusive design
- Instant toggling without menus
🧪 Benchmark Mode

Run objective benchmarks and get detailed CSV results, including:
- Per-frame FPS and frametime data
- Average FPS, 1% / 0.1% lows
- Worst stutters and frame spikes
- Run metadata for comparison
📁 Files are saved to:
.minecraft/config/performanceoverlay/benchmarks/
CSV files can be opened in Excel, Google Sheets, or any analysis tool as well as AI chats.
🎯 Use Cases
- Diagnosing stutters and micro-freezes
- Comparing shaders, mods, modpacks, or settings
- Measuring real smoothness instead of “feels smoother”
- Benchmarking performance changes reliably
ℹ️ Notes
- Client-side only
- Lightweight and low overhead
- No gameplay or logic changes
🔁 Redistribution
You are free to:
- Use this mod in modpacks (public or private)
- Include it in custom client setups
- Fork or modify the code for your own needs
If you re-upload this mod (modified or unmodified), please:
- Credit Performance Overlay as the original project
- Link back to this Modrinth page
- Use a different name and icon for modified versions
License
MIT License
Project description from Modrinth.
Pick your setup
Performance Overlay by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
1 loader build26.1.2
1 loader build26.1.1
1 loader build26.1
1 loader build1.21.11
1 loader build1.21.10
1 loader build1.21.9
1 loader build1.21.8
1 loader build1.21.7
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader buildShowing the newest 12 of 16 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Performance Overlay versions and loaders
1.0.2+mc26.2-fabric
performanceoverlay-1.0.2+mc26.2-fabric.jar
14 Aug 2026
1.0.2+mc26.1.x-fabric
performanceoverlay-1.0.2+mc26.1.x-fabric.jar
14 Aug 2026
1.0.2+mc1.21.9-1.21.11-fabric
performanceoverlay-1.0.2+mc1.21.9-1.21.11-fabric.jar
13 Aug 2026
1.0.1+mc1.21.9-1.21.11-fabric
performanceoverlay-1.0.1+mc1.21.9-1.21.11-fabric.jar
12 Aug 2026
1.0.0+mc1.21.x-fabric
performanceoverlay-1.0.0+mc1.21.x-fabric.jar
18 Jan 2026
Looking for an older file? The official Modrinth project page is in Resources.