FPS Benchmark | Performance Suite

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.