AccurateFPS+

# AccurateFPS+ 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! --- ## Highlights - **Extended FPS Slider** - Replaces the vanilla Max Framerate slider with a precise 1–1000 range (step of 1 instead of vanilla's step of 10). Your chosen value saves and persists between sessions. - **Live FPS, AVG, MAX & MIN** - Four independent metrics, each with its own update interval, decimal precision, label, display slot, and configurable history window. - **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. - **Per-Metric Colors** - Set a custom hex color for each metric independently, or enable auto-color per metric: green (≥60), yellow (≥30), red (<30). - **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). - **Built-in Presets** - Minimal (FPS only), Competitive (FPS + AVG), Detailed (all four), or Custom. - **CSV Export** - Run `/accuratefps+ exportcsv` to dump your FPS history (with frametime) in a clean, readable table format. !(https://cdn.modrinth.com/data/cached_images/14a662614a47160304e1bd56a96e22dd3d15b1ec.gif) > "**All Metrics/Detailed**" Preset + **Automatic Coloring** on **FPS** --- ## Supported Versions | Minecraft | Loaders | |-----------|---------| | 1.21.1 | Fabric, Quilt, Forge | | 1.21.11 | Fabric, Quilt, Forge | --- ## Installation 1. Download the jar that matches your **loader** and **MC version** 2. Drop it into your `mods/` folder 3. Launch Minecraft 4. Open **Mod Menu → AccurateFPS+** to configure (requires (https://modrinth.com/mod/cloth-config) on Fabric/Quilt), or edit `config/accuratefpsplus.json` directly --- ## Configuration All settings are available through the in-game config screen and apply immediately - no restart needed. ### HUD Settings - **Toggle HUD** on/off - **Anchor corner** or custom X/Y position - **Text shadow** for readability - **Background overlay** with configurable color and transparency ### Per-Metric Settings (FPS, AVG, MAX, MIN) + Low Metrics Line - Show/hide each metric independently - Set **display slot order** (main line has four slots; the low-metrics line has two slots stacked vertically under the main HUD) - Set **decimal precision** (0–4 places) - Add custom **prefix** and **suffix** text - Set **update interval** per metric - Set **custom color** (hex) per metric - **1% Low** - FPS exceeded 99% of the time (competitive stability metric) - **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. ### Engine Settings - **Calculation Mode**: - **Real-Time** - instant per-frame FPS (default) - **Averaged** - mean over poll window (stable) - **EMA** - exponential moving average for smooth yet responsive output - **History Window** - Time range for AVG/MAX/MIN/percentile calculations (1s–60s) - **Sampling Interval** - How often to poll frame times (balance fidelity vs. overhead) - **Per-Metric Refresh Intervals** - Configure FPS/AVG/MAX/MIN/1% Low/0.1% Low update cadence independently ### Presets - **Minimal** - Just the current FPS - **Competitive** - FPS + Average - **Detailed** - All four metrics - **Custom** - Your own layout --- ## Performance - **Zero-allocation hot path** - primitive ring buffer for frame timings, no autoboxing or GC pressure per frame - **Cached HUD text** - string composition is skipped when telemetry values haven't changed; fast decimal formatting without `String.format()` overhead - **Cached overlay color** - no per-frame float math, recalculated only when settings change - **Cached screen dimensions** - window size queries only when display actually resizes - **Throttled history pruning** - CSV export data pruned every ~10 seconds instead of every poll tick - **Async CSV export** - history snapshots on the render thread, disk I/O runs off-thread to avoid hitches - **Configurable polling intervals** - balance accuracy vs. overhead to suit your hardware - **Very low performance overhead** - only a single `nanoTime()` call + ring buffer write per frame; all other work runs at ~10 Hz - **Automatic config migration** - old configs are seamlessly upgraded to the latest schema, so updates never break your settings > **Tip:** Polling intervals below 100 ms give faster updates but may slightly impact performance on lower-end hardware. --- ## Troubleshooting - **HUD not visible?** Make sure it's enabled in the config and that no GUI screen is open. - **Config won't save?** Check write permiss