⛏️ mc-stats-webui

Live competitive rankings for your Minecraft survival server.

A Fabric server mod that embeds a small web UI + API. Players open it in a browser — no client mod needed.

MORE SCREENSHOTS

✨ Features

• 🏆 Home podium with Champion, Most dedicated, and Most efficient crowns
• 📋 Player profiles with skins, grades, and full vanilla stats
• 🆚 Side-by-side player compare
• 📊 Leaderboards for the whole vanilla stats catalog (custom, mined, killed, …)
• 🧮 Transparent scoring (“How we rank”) — farms inflate some boards on purpose
• 🌐 UI in English / Español / Français · light / dark / system theme
• 🏷️ Branding via config/mc-stats-webui.json (title, slogan, tagline, window title, bind, port)
• ⚡ In-memory stats cache (see below)

🧠 Stats cache

On world start the mod loads every player stats file into RAM. The API serves that snapshot — it does not re-scan the disk on each request.

When a connected player gains stats, their UUID is marked dirty. Every ~15 s (and before each API snapshot) dirty players are flushed with vanilla save(), then that one entry is reloaded into the cache. Offline players drop out of the dirty set and reload from disk if needed.

More detail: endpoints · stats & champion

🛠️ Development

Needs: Java 25 · Node 24+ · Yarn via Corepack · Fabric 26.2

cd web
corepack yarn install
corepack yarn dev

UI: http://localhost:5173 (proxies /api → 25580)

./gradlew build

The SvelteKit UI is built static and shipped inside the JAR.