Loot Journal

Track what you get from every block you break. Loot Journal silently monitors your inventory and attributes item pickups to the blocks that caused them — then exports the results as clean JSON when your session ends.

Built for block randomizer speedruns, but useful for anyone who wants to know what they're actually getting from mining.

Features

Drop Attribution

Every block break opens a short attribution window. Items gained from your inventory within that window are linked to the block just broken. Mine quickly and multiple pending breaks are tracked concurrently.

Session Tracking

A session starts automatically when you join a world or server, and ends when you disconnect. On disconnect you get a chat summary:

All items gained and lost
XP earned
Session timer — elapsed time shown in every report
Mob kills — total mobs killed per session, broken down by type
Number of block types broken

Session History Screen (New in 1.1.0)

Browse your past sessions without leaving the game. Open the history screen with a keybind (unbound by default) to see:

Date, world name, and session duration
Items gained, mob kills, XP, and blocks broken
Click any session row to expand its details

Mob Kill Tracking (New in 1.1.0)

Every mob death is recorded per session. The summary shows a breakdown by mob type — useful for tracking combat-heavy sessions or drop rates from mobs.

JSON Export

Session data is saved to loot-journal/sessions/session-YYYY-MM-DD-HH-mm-ss.json. A running statistics.json file accumulates drop counts and computed drop frequencies per block type across all sessions.

Block Randomizer Mode

A dedicated mode for block randomizer challenge runs:

Restricts to one pending break at a time so drops are never mixed up
Shows a live chat line per break — [Randomizer] grass block → dirt x1, seeds x2
Enforces a wider attribution window to handle server loot table delay

In-Game Config Screen

All settings adjustable in-game without restarting. Open with a configurable keybind.

Keybinds

Action Default Show mid-session report (unbound) Open settings (unbound) Open session history (unbound)

Output Files

Located under .minecraft/loot-journal/:

File Contents sessions/session-*.json Per-session item gains/losses, mob kills, block aggregates, XP, duration statistics.json Cumulative drop counts and drop frequencies per block type

Configuration

Setting Default Description enabled true Master on/off switch attributionWindowTicks 60 Ticks after a break to collect drops (~3 seconds) blockRandomizerMode false Enable block randomizer mode brFeedbackInChat true Per-break chat lines in BR mode writeSessionJson true Save per-session JSON file writeStatisticsJson true Update cumulative statistics file writeBreakEvents false Include per-break event data in session JSON showSummaryOnDisconnect true Print summary to chat on disconnect