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.

9,81k

Quick challenge

How far can you run before the mobs catch you?

Performance Overlay

FPS, Frametime & Benchmarking

what actually matters for smooth gameplay 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

Minecraft performance overlay showing FPS, 1% and 0.1% lows, frametime, stutters, and frame spikes

The overlay updates in real time and displays:

- Memory usage - Memory usage - Memory usage - Memory usage - Memory usage - Memory usage - Memory usage - Memory usage

All metrics are designed for real performance analysis, not vanity numbers.

---

⌨️ Key Bindings

All features are accessible instantly via key binds:

- F10 — Toggle performance overlay - F10 — Cycle overlay layout - F10 — Reset performance statistics - F10 — Start / stop benchmark

Key bindings can be changed in *Minecraft → Controls*.

---

🧩 Customisation

Different overlay layouts and positions for Minecraft performance metrics

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

---

🧪 Benchmark Mode

CSV benchmark file with per-frame FPS and frametime data

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

Gallery

ADS