FPS Benchmark | Performance Suite

FPS Benchmark | Performance Suite is a one-click cinematic FPS benchmarking suite for Minecraft.

Press Run Base Benchmark, and the mod will automatically create a temporary benchmark world, move the camera through a scripted cinematic stress sequence, collect performance metrics, and generate clean reports. No setup, no manual flying, no watching the F3 screen.

Available for: Fabric
NeoForge: coming soon

One-Click Base Benchmark

Open the in-game benchmark menu, press Run Base Benchmark, and let the mod do the rest.

The base benchmark is designed for regular players who want a simple, repeatable and comparable performance result.

• Creates an isolated temporary world with a deterministic seed
• Keeps your existing saves untouched
• Runs a scripted cinematic benchmark for about 3 minutes
• Passes through multiple performance-heavy scenes
• Measures FPS, frame time, tick time, memory usage and GC activity
• Generates clean benchmark reports when finished
• Shows a 3DMark-style summary screen in-game

No setup, no commands, no manual testing. Just press one button and compare the result.

Clean Benchmark Reports

Every benchmark session creates a report folder:

fpstest-reports/<sessionId>/

Generated files include:

The main output is report.md: a clean table with average FPS, 1% low, 0.1% low, p99 frame time, tick time, heap usage and GC time.

You can paste the report directly into Discord, GitHub, mod reviews or performance comparisons.

The mod can also compare two saved benchmark sessions and generate:

compare-A-vs-B.md

with clear per-scenario performance deltas.

Advanced Benchmark Scenarios

Besides the base benchmark, the mod includes 41 deeper benchmark scenarios across 12 categories for users who want more detailed performance analysis.

Duration Presets

• Quick — about 36 seconds
• Full — about 80 seconds
• Long — about 225 seconds

Measured Metrics

FPS Benchmark records practical performance data, including:

• Average FPS
• Harmonic mean FPS
• 1% low FPS
• 0.1% low FPS
• p99 frame time
• Average and maximum client tick time
• Heap usage and peak heap usage
• GC events and GC time

It also tracks additional server-side counters using mixin instrumentation:

• Scheduled block ticks
• Scheduled fluid ticks
• Block-state changes
• Neighbour updates
• Section rebuilds
• Explosions
• Falling-block landings

Live HUD Overlay

During benchmark runs, the mod can show a configurable live overlay with:

• FPS
• Frame time
• Tick time
• Heap usage
• Entity count

The overlay supports 4 anchor positions, compact mode and customizable visibility options.

Controls

• ESC — abort the current benchmark scenario
• Shift + ESC — abort the entire queue

Languages

The mod includes 8 built-in locales:

• English
• Русский
• Українська
• Español
• Français
• Deutsch
• 中文
• 日本語

Requirements

• Minecraft: 1.21
• Loader: Fabric Loader 0.16.0+
• Required dependency: Fabric API
• Java: Java 21

Other Minecraft versions are planned.

This is a client-side mod. No server installation is required.

License

This project is licensed under the MIT License.

You may fork, modify and redistribute the source code, as long as attribution is preserved.

Please do not re-upload compiled .jar files to other hosting sites without permission. Link to the official project page instead.

FPS Benchmark is a one-click cinematic FPS benchmarking suite for Minecraft. Press Run Base Benchmark and the mod creates a temporary world, drives the camera through a scripted 3-minute stress sequence, and writes you a clean results table — no setup, no flying around with F3 open.

Fabric NeoForge(Soon)

For tinkerers, 40 deeper stress tests are available too: particles, entities, redstone, lighting, chunk loading and memory each get a dedicated run.

One-click Base Benchmark

Open the in-game menu, press Run Base Benchmark, walk away.

• The mod creates an isolated temporary world with a deterministic seed (your saves are not touched).
• Drives the camera along a scripted cinematic path for ~3 minutes through 8 different stress scenes.
• Collects FPS, frame-time, tick-time, heap and GC metrics.
• Writes a tidy results table (Markdown + JSON) the moment it's done.
• Shows you a 3DMark-style summary screen right away.

This run is designed for regular players — no setup, no math, just a clear number you can compare against friends or your own previous run.

A clean results table, not a wall of numbers

Every run produces a folder in fpstest-reports/<sessionId>/:

The Markdown report is the headline output: a table listing every test with avg FPS, 1% low, 0.1% low, p99 frame time, tick time, heap and GC time. Paste it straight into Discord or a mod review.

Compare two saved sessions with one click — the mod writes compare-A-vs-B.md showing per-test deltas.

Beyond Base — 41 tests across 12 categories

Three duration presets per test: Quick (~36 s), Full (~80 s), Long (~225 s).

What gets measured

• FPS — average, harmonic mean, 1% low, 0.1% low, p99 frame time
• Client tick time — avg / max
• Memory — heap, peak heap, GC events, GC time
• Server-side counters (mixin-instrumented) — scheduled block ticks, scheduled fluid ticks, block-state changes, neighbour updates, section rebuilds, explosions, falling-block landings

Live HUD overlay

A configurable overlay during runs — FPS / frame ms / tick ms / heap / entities. 4 anchor positions, compact mode, customisable visibility.

Controls

• ESC — abort the current test
• Shift + ESC — abort the entire queue

Languages

8 locales out of the box: English, Русский, Українська, Español, Français, Deutsch, 中文, 日本語.

Requirements

• Minecraft 1.21 other versions in plans
• Fabric Loader ≥ 0.16.0
• Fabric API
• Java 21

Client-side mod. No server install needed.

License

MIT License — fork, modify, redistribute, just keep the attribution.

Re-uploads of the compiled .jar to other hosting sites without permission are not allowed under Modrinth's content rules. Please link to this page instead.