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/<sessionId>/:
| 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.
