Перейти к содержимому
Mineforgian

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.

Загрузки
19K
Подписчики
14
Обновлён
14 августа 2026 г.
Лицензия
MIT

Опубликован 18 января 2026 г.

Исходный кодСообщить об ошибке

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

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

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

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

Ченджлог

1.0.2+mc26.2-fabricРелиз26.2 · 14 августа 2026 г.

Version 1.0.2

  • Initial release for Minecraft 26.2.
  • Feature-equivalent to Performance Overlay 1.0.2 for Minecraft 1.21.9–1.21.11.
1.0.2+mc26.1.x-fabricРелиз26.1, 26.1.1, 26.1.2 · 14 августа 2026 г.

Version 1.0.2

  • Initial release for Minecraft 26.1, 26.1.1, and 26.1.2.
  • Feature-equivalent to Performance Overlay 1.0.2 for Minecraft 1.21.9–1.21.11.
1.0.2+mc1.21.9-1.21.11-fabricРелиз1.21.9, 1.21.10, 1.21.11 · 13 августа 2026 г.

Version 1.0.2

  • Improved benchmark accuracy and made exported metrics independent of overlay visibility.
  • Moved CSV writing off the render path to reduce benchmark overhead.
  • Fixed benchmark stopping, shutdown, world-leaving, filename collision, and write-error handling.
  • Fixed GC reporting, reset behavior, and CSV values.
  • Fixed configuration presets, validation, color thresholds, tooltips, and saved settings.
  • Fixed benchmark progress, F9/F10 behavior, and three-line overlay formatting.
  • Improved low-FPS, stutter, and overlay-rendering performance.
  • Added extensive automated tests for metrics, configuration, CSV export, and benchmark lifecycle.
1.0.1+mc1.21.9-1.21.11-fabricБета1.21.9, 1.21.10, 1.21.11 · 12 августа 2026 г.

Version 1.0.1

  • Corrected supported Minecraft versions to 1.21.9–1.21.11.
  • Confirmed compatibility with Minecraft 1.21.9, 1.21.10, and 1.21.11.
  • Minecraft 1.21.8 is no longer listed as supported.
1.0.0+mc1.21.x-fabricАльфа1.21.9, 1.21.10, 1.21.11 · 18 января 2026 г.

Version 1.0.0

  • Real-time FPS and frametime overlay.
  • Average FPS, 1% and 0.1% low metrics.
  • GC pause detection and memory usage tracking.
  • Stutter detection and worst frame spike tracking.
  • Built-in benchmark mode with TSV exports.
  • Configurable overlay layout and keybindings.

Комментарии

Загружаем…