Performance Overlay

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