Loot Journal

What's new in v1.3.0

• Multi-goal support: set up to 3 simultaneous goals tracked independently on the HUD
• Each goal shows its own progress counter and completion checkmark in the top-right overlay
• Drop rate display in session history: see the best items/break rate from block aggregates
• Session history now shows block type count alongside gained items

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.

---

What's new in 1.2.0

• Chest & Container Tracking — items picked up while a container is open (chests, barrels, etc.) are now tracked separately and shown in the session summary as a "Containers" line, so loot from chests is never mixed in with block drops
• Goal / Target Tracking — set an item goal (e.g. "diamond x64") via the new Loot Goal screen; a small HUD overlay in the top-right corner shows live progress, and a chat message fires when you hit the target

---

What's new in 1.1.1

Bug fixes for the three features added in v1.1.0:

• Fixed crash when a mob entity ID had an empty name after the colon (e.g. malformed registry entries) in the Session History mob kill summary
• Fixed misleading "Click a session to see details" hint showing in the detail panel when there are no saved sessions to click
• Fixed potential crash from a malformed startTime string in the session history list — now falls back to the raw string gracefully

---

What's new in 1.1.0

• Session timer — elapsed time shown in every disconnect report
• Mob kill tracking — total mobs killed per session, broken down by type (singleplayer and LAN only)
• Session History Screen — browse past sessions in-game without leaving the world

---

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
• Container loot — items picked up from chests/containers shown separately
• Number of block types broken

Chest & Container Tracking (New in 1.2.0)

Items picked up while any container screen is open (chest, barrel, furnace, etc.) are attributed to a separate "Containers" bucket so they're never confused with block drops. The session summary prints a dedicated "Containers" line when container loot was collected.

Goal / Target Tracking (New in 1.2.0)

Set a loot goal from the new Loot Goal screen (bind a key in Controls > Loot Journal):

• Type any item name (e.g. diamond, iron_ingot) and set a target count
• A small overlay in the top-right of your HUD shows live session progress
• A chat message fires once when the goal is reached
• Goal persists across sessions; clear it any time from the Goal screen

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	J
Open settings	(unbound)
Open session history	(unbound)
Open loot goal	(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

---

Requirements

Fabric (1.21.1 & 1.21.11)

• Fabric Loader 0.19.2+
• Fabric API

NeoForge (1.21.1, 1.21.11 & 26.1)

• NeoForge 21.1.172+