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
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.
No setup, no commands, no manual testing. Just press one button and compare the result.
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.
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 |
FPS Benchmark records practical performance data, including:
It also tracks additional server-side counters using mixin instrumentation:
During benchmark runs, the mod can show a configurable live overlay with:
The overlay supports 4 anchor positions, compact mode and customizable visibility options.
The mod includes 8 built-in locales:
Other Minecraft versions are planned.
This is a client-side mod. No server installation is required.
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.
