Mining Session
A lightweight client-side HUD that tracks your mining session in real time.
No menus to open, no stats hidden away — your session time, blocks broken
and placed, tracked block counts, mob kills, deaths and distance walked are
always visible right on your screen, updating instantly as you play.
Works in singleplayer and on any multiplayer server — no server-side
installation required.
Features
- Live HUD panel — updates instantly, no menu needed to check your progress
- Track any block in the game — search and pick from every registered block,
not just a fixed ore list. Real item icons are shown next to each one.
- Fully customizable HUD — drag it anywhere with your mouse, pick a screen
corner, adjust scale and opacity, toggle the background, and reset the
position with one click. The panel can never be dragged off-screen.
- Per-line visibility — hide any stat you don't care about; the panel
automatically shrinks to fit
- JSON export — save a snapshot of your session to a neatly formatted
.json file with one keypress
- Localized in English and Russian
- Lightweight — event-driven, no per-frame world scanning
Default key bindings
- F8 — show / hide the HUD
- F9 — open settings
- F10 — reset session statistics (asks for confirmation)
- F7 — export current statistics to JSON
All key bindings are fully rebindable in Options -> Controls.
What gets tracked
- Session duration
- Blocks broken (total) and blocks placed (total)
- Break count for every block you choose to track
- Mob kills
- Deaths
- Distance walked
Settings (F9)
- Drag the HUD panel directly with your mouse to reposition it
- One-click Reset Position button
- Choose which screen corner the panel anchors to
- Scale and opacity sliders
- Toggle the background box on/off
- Show/hide toggle for every individual stat line
- Manage Tracked Blocks - search all blocks in the game and add/remove any
of them from tracking
Exporting statistics (F7)
Writes a pretty-printed JSON file to .minecraft/mining-session/, named
mining_session_YYYY-MM-DD_HH-MM-SS.json, containing session duration,
general counters, and a per-block breakdown of everything you're tracking.
Compatibility
- Client-side only — do NOT install on servers
- Works in singleplayer and on any vanilla or modded multiplayer server
- Requires Fabric API
- Minecraft 1.21.1, Fabric Loader, Java 21+
Notes on statistic accuracy
Fabric doesn't expose dedicated client-side events for "block placed" or
"mob killed", so those two counters use lightweight, purely client-side
heuristics (watching whether a targeted spot becomes solid after a
placement attempt, and whether an attacked mob disappears shortly after
being hit). This is accurate for the overwhelming majority of normal play,
but isn't a guaranteed 100% precise count in every edge case.
