# AccurateFPS+<\/p>\n
A lightweight, client-side **FPS HUD** mod with an **extended framerate slider** and deep customization. See your performance clearly and in more detail at a glance, exactly the way you want it!<\/p>\n
**!!!** – I know this is an overused concept for a mod, but i just wanted to test myself and get better at coding, i have much more creative projects that i hope i finish so that yall can enojoy them! I hope you can find this mod useful and good<\/p>\n
—<\/p>\n
## Highlights<\/p>\n
– **Extended FPS Slider** – Replaces the vanilla Max Framerate slider with a precise 1\u20131000 range (step of 1 instead of vanilla’s step of 10). Your chosen value saves and persists between sessions.
\n– **Live FPS, AVG, MAX & MIN** – Four independent metrics, each with its own update interval, decimal precision, label, display slot, and configurable history window.
\n– **Fully Customizable HUD** – Pick any screen corner or set exact X\/Y coordinates. Enable text shadows, and add a semi-transparent background overlay with adjustable color and transparency.
\n– **Per-Metric Colors** – Set a custom hex color for each metric independently, or enable auto-color per metric: green (\u226560), yellow (\u226530), red (<30).\n- **Flexible FPS Calculation** - Switch between Real-Time (instant), Averaged (smooth), or EMA (exponential moving average) for responsive yet stable tracking. AVG\/MAX\/MIN\/percentile lows respect the configurable history window (1s \/ 3s \/ 5s \/ 10s \/ 30s \/ 60s).\n- **Built-in Presets** - Minimal (FPS only), Competitive (FPS + AVG), Detailed (all four), or Custom.\n- **CSV Export** - Run `\/accuratefps+ exportcsv` to dump your FPS history (with frametime) in a clean, readable table format.\n\n\n> “**All Metrics\/Detailed**” Preset + **Automatic Coloring** on **FPS**<\/p>\n
—<\/p>\n
## Supported Versions<\/p>\n
| Minecraft | Loaders |
\n|———–|———|
\n| 1.21.1 | Fabric, Quilt, Forge |
\n| 1.21.11 | Fabric, Quilt, Forge |<\/p>\n
—<\/p>\n
## Installation<\/p>\n
1. Download the jar that matches your **loader** and **MC version**
\n2. Drop it into your `mods\/` folder
\n3. Launch Minecraft
\n4. Open **Mod Menu \u2192 AccurateFPS+** to configure (requires Cloth Config on Fabric\/Quilt), or edit `config\/accuratefpsplus.json` directly<\/p>\n
—<\/p>\n
## Configuration<\/p>\n
All settings are available through the in-game config screen and apply immediately – no restart needed.<\/p>\n
### HUD Settings
\n– **Toggle HUD** on\/off
\n– **Anchor corner** or custom X\/Y position
\n– **Text shadow** for readability
\n– **Background overlay** with configurable color and transparency<\/p>\n
### Per-Metric Settings (FPS, AVG, MAX, MIN) + Low Metrics Line
\n– Show\/hide each metric independently
\n– Set **display slot order** (main line has four slots; the low-metrics line has two slots stacked vertically under the main HUD)
\n– Set **decimal precision** (0\u20134 places)
\n– Add custom **prefix** and **suffix** text
\n– Set **update interval** per metric
\n– Set **custom color** (hex) per metric
\n– **1% Low** – FPS exceeded 99% of the time (competitive stability metric)
\n– **0.1% Low** – FPS exceeded 99.9% of the time (worst-case analysis); These are displayed on a separate line to prevent the main HUD from overflowing.<\/p>\n
### Engine Settings
\n– **Calculation Mode**:
\n – **Real-Time** – instant per-frame FPS (default)
\n – **Averaged** – mean over poll window (stable)
\n – **EMA** – exponential moving average for smooth yet responsive output
\n– **History Window** – Time range for AVG\/MAX\/MIN\/percentile calculations (1s\u201360s)
\n– **Sampling Interval** – How often to poll frame times (balance fidelity vs. overhead)
\n– **Per-Metric Refresh Intervals** – Configure FPS\/AVG\/MAX\/MIN\/1% Low\/0.1% Low update cadence independently<\/p>\n
### Presets
\n– **Minimal** – Just the current FPS
\n– **Competitive** – FPS + Average
\n– **Detailed** – All four metrics
\n– **Custom** – Your own layout<\/p>\n
—<\/p>\n
## Performance<\/p>\n
– **Zero-allocation hot path** – primitive ring buffer for frame timings, no autoboxing or GC pressure per frame
\n– **Cached HUD text** – string composition is skipped when telemetry values haven’t changed; fast decimal formatting without `String.format()` overhead
\n– **Cached overlay color** – no per-frame float math, recalculated only when settings change
\n– **Cached screen dimensions** – window size queries only when display actually resizes
\n– **Throttled history pruning** – CSV export data pruned every ~10 seconds instead of every poll tick
\n– **Async CSV export** – history snapshots on the render thread, disk I\/O runs off-thread to avoid hitches
\n– **Configurable polling intervals** – balance accuracy vs. overhead to suit your hardware
\n– **Very low performance overhead** – only a single `nanoTime()` call + ring buffer write per frame; all other work runs at ~10 Hz
\n– **Automatic config migration** – old configs are seamlessly upgraded to the latest schema, so updates never break your settings<\/p>\n
> **Tip:** Polling intervals below 100 ms give faster updates but may slightly impact performance on lower-end hardware.<\/p>\n
—<\/p>\n
## Troubleshooting<\/p>\n
– **HUD not visible?** Make sure it’s enabled in the config and that no GUI screen is open.
\n– **Config won’t save?** Check write permissions on the `config\/` folder.<\/p>\n
—<\/p>\n
## Dependencies & Compatibility<\/p>\n
| Mod | Loaders | Requirement |
\n| ——————————————————– | ————- | —————– |
\n| Fabric API | Fabric, Quilt | \ud83d\udce6 **REQUIRED** |
\n| Cloth Config | Fabric, Quilt | \ud83d\udce6 **REQUIRED** |
\n| Mod Menu | Fabric, Quilt | \u2705 **COMPATIBLE** |
\n| Sodium | Fabric, Quilt | \u2705 **COMPATIBLE** |<\/p>\n
### \u274c Known Incompatibilities
\nNone at the moment. If you run into a conflict with another mod, please report it so that I can mark it as INCOMPATIBLE, or make it compatible!<\/p>\n
> **Note:** Forge builds bundle their own dependencies and do not require Fabric API, Cloth Config, or Mod Menu.<\/p>\n
—<\/p>\n
## Links<\/p>\n
– **Modrinth**
\n– Contact: Discord (username: matteo.sb)<\/p>\n
—<\/p>\n
**All Rights Reserved** – This mod is closed-source.
\nYou may **not** re-upload, redistribute, modify, decompile, or reuse the code or assets.<\/p>\n
You are welcome to include this mod in any modpack (private or public).
\nPlease give credit and link back to this Modrinth page.<\/p>\n
—<\/p>\n
*Built with love by gingermat<\/p>\n","protected":false},"excerpt":{"rendered":"
Lightweight and highly accurate FPS metrics with a fully customizable HUD<\/p>\n","protected":false},"featured_media":5023,"template":"","meta":{"_minecraft_slug":"accuratefps+","_minecraft_project_id":"AQGahqU5","_minecraft_author":"gingermat","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":293,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"accuratefps+.zip","_minecraft_size_bytes":515388,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T18:29:17.662766Z","_minecraft_date_created":"2026-05-05T02:07:03.153537Z","_minecraft_date_modified":"2026-05-02T09:41:34.555704Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/accuratefps+","_minecraft_icon_attachment_id":5023,"_minecraft_imported_at":"2026-05-31T13:39:03+00:00","_minecraft_import_hash":"949cb8e9c4e4ec8d7792a73e39e4748b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,104,89,98,123,92],"mod_loader":[99],"minecraft_version":[37,41],"class_list":["post-5022","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-quilt","mod_category-technology","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-1","minecraft_version-1-21-11"],"yoast_head":"\n