FPS Benchmark
Cinematic auto-benchmark for Minecraft. One-click Base run is built for everyone - 3 minutes, then a clean FPS results table (Markdown + JSON). 40 deeper stress tests cover particles, entities, redstone, lighting, chunks, memory.
- Loaders
- Fabric
- Downloads on Modrinth
- 931
- Followers on Modrinth
- 7
- version
- 1
- Updated
- May 1, 2026May 1
- Published
- in 2026
At a glance
Install in the game only; not needed on the server
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//`:
| File | Format | What's inside |
|---|---|---|
report.md | Markdown | Human-readable table, ASCII FPS graphs, frame-time histograms |
report.json | JSON | Machine-readable: every test, every metric, every per-frame sample |
fps.csv / session.csv | CSV | Drop straight into Excel or Pandas |
system.json | JSON | MC version, OS, CPU, Java, GPU vendor / renderer |
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
| Category | Tests |
|---|---|
| Showcase | 3-min cinematic flyby across 8 biomes |
| Baseline | empty flat world (clean render measurement) |
| Particles | 7 particle types + ALL_TOGETHER + particle quarry |
| Entities | cows, sheep, AI zombies, pigs, villagers, chickens, items, XP orbs (200–500 each), zombie maze, items merge storm |
| Physics | TNT field × 2, falling sand × 4, projectile storm |
| Redstone | 6×6 observer clocks, dust grid, piston-slime array |
| Fluids | fluid spread |
| Lighting | lighting update churn |
| Block-Entities | hopper grid, comparator storage |
| Entity AI | 80-villager village with brain on |
| Static Render | dense forest |
| Chunk flyby | 12 different biomes |
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.
FAQ
How to install FPS Benchmark?
Install Fabric for your Minecraft version, download FPS Benchmark for the same version and loader, put the file into the mods folder and launch the game with the loader profile.
Which Minecraft versions does FPS Benchmark support?
FPS Benchmark has builds for Minecraft 1.21–1.21.1.
Is FPS Benchmark needed on the server?
Client only — no need to install it on the server
Similar mods
All utility mods →
Often needed together
Fabric API↓ 281M