FPS Benchmark

Mod

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.

Type

Mod

Modrinth Downloads

942

Modrinth ID

Cfyw5WXC

Last Updated

Sep 12, 2026

Description

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.