FPS Benchmark | Performance Suite
- By
- Mods
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.
The FPS Benchmark | Performance Suite Team
