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.