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:

File	Format	Contents
`report.md`	Markdown	Human-readable benchmark table, FPS graphs and frame-time histograms
`report.json`	JSON	Full machine-readable benchmark data
`fps.csv` / `session.csv`	CSV	Data for Excel, LibreOffice, Pandas or other tools
`system.json`	JSON	Minecraft version, OS, CPU, Java version, GPU vendor and renderer

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.

Category	Scenarios
Showcase	3-minute cinematic flyby across 8 biomes
Baseline	Empty flat world for clean render measurement
Particles	7 particle types, all-particles run and particle quarry
Entities	Cows, sheep, zombies, pigs, villagers, chickens, items, XP orbs, zombie maze and item merge storm
Physics	TNT fields, falling sand runs and projectile storm
Redstone	Observer clocks, dust grid and piston-slime array
Fluids	Fluid spread benchmark
Lighting	Lighting update churn
Block Entities	Hopper grid and comparator storage
Entity AI	80-villager village with active AI
Static Render	Dense forest render benchmark
Chunk Flyby	Flyby through 12 different biomes

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.