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.
Versions
Gallery
About
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
Conversation