HomeJavaModsLoot Journal
Loot Journal
ModsJava

Loot Journal

by ar_tyyuu · on Modrinth

Tracks block breaks, item pickups, mob kills, and session stats. Attributes drops to blocks that caused them. Browse session history in-game or export…

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 26.1–26.1.2 · NeoForge⬇ Download for 1.21.11 · NeoForge⬇ Download for 1.21.5 · NeoForge⬇ Download for 1.21.2–1.21.4 · NeoForge⬇ Download for 1.21.1 · NeoForge⬇ Download for 26.1–26.1.2 · Fabric⬇ Download for 1.21.11 · Fabric⬇ Download for 1.21.2–1.21.4 · Fabric⬇ Download for 1.21.1 · Fabric⬇ Download for 26.1–26.1.2 · Quilt⬇ Download for 1.21.11 · Quilt⬇ Download for 1.21.2–1.21.4 · Quilt⬇ Download for 1.21.1 · Quilt
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

What's new in v1.3.0

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


What's new in 1.1.1

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


What's new in 1.1.0


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:

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):

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:

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:

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)

NeoForge (1.21.1, 1.21.11 & 26.1)

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more