FPS Benchmark

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.