Inventory Log

Inventory Log is a client-side Fabric mod that records player inventory changes: item additions, removals, stack count changes, and custom server items.

It is designed for multiplayer servers with custom items, resource packs, plugin-based item metadata, loot mechanics, fishing, sieving, farming, and other systems where you want to know exactly what changed in your inventory.

Features

Client-side only: no server installation required
Logs added and removed items from the player inventory
Tracks stack count changes
Supports custom item display names from resource packs
Supports custom item IDs such as executableitems:ei-id
Ignores durability and repair cost changes, so tools are not logged as removed/added when damaged
Short in-game HUD log
Moveable short HUD position
Configurable short HUD line count
Full daily JSON logs
Daily short logs
Daily loot-only logs
Daily CSV export
Ignore list for unwanted items
Commands for checking, adding, and removing ignored items
Session loot statistics
Drop Tracker for calculating item drop chances
Drop Tracker HUD
Drop Tracker session CSV files
Drop Tracker summary files
Drop Tracker ignore list
Drop chance confidence range using Wilson 95% interval
Ability to remove accidental loot from Drop Tracker statistics
Mod Menu configuration screen
Optional Mod Menu support

Requirements

Minecraft 1.21.11
Fabric Loader
Fabric API
Java 21

Optional:

Mod Menu, for the in-game configuration screen

Keybinds

Key	Action
`F7`	Clear short HUD log
`F8`	Toggle inventory logging
`F9`	Show short inventory log
`F10`	Move short log

While short log move mode is enabled:

Key	Action
Arrow keys	Move the HUD
`PageUp` / `PageDown`	Change visible line count

Commands

General Commands

`/invlog help`

Shows the command list.

`/invlog status`

Shows current mod state:

logging enabled/disabled
short log mode
HUD visibility
visible line count
ignored item count
enabled outputs
Drop Tracker status

`/invlog files`

Shows the current log file paths.

`/invlog clear`

Clears the short in-game HUD log.

`/invlog lines <1-100>`

Sets how many short log lines are visible on screen.

Example:

/invlog lines 20

Log Mode

`/invlog mode all`

Shows all confirmed changes in the short log.

`/invlog mode added`

Shows only added items in the short log.

`/invlog mode removed`

Shows only removed items in the short log.

Note: log mode affects only the HUD short log and short-YYYY-MM-DD.log. Full JSON and CSV logs always record all confirmed inventory changes.

Output Files

`/invlog output csv on`

Enables CSV output.

`/invlog output csv off`

Disables CSV output.

`/invlog output loot on`

Enables loot-only output.

`/invlog output loot off`

Disables loot-only output.

Ignore List

`/invlog ignore hand`

Adds the item in your main hand to the ignore list.

It uses the custom item ID if available, otherwise the displayed item name.

`/invlog ignore hand custom`

Adds the item in your main hand by custom item ID.

Example custom ID:

executableitems:ei-id=sito_gold

`/invlog ignore hand name`

Adds the item in your main hand by displayed item name.

`/invlog ignore hand minecraft`

Adds the item in your main hand by Minecraft item ID.

Example:

minecraft:golden_carrot

`/invlog ignore remove`

Removes the item in your main hand from the ignore list.

It checks:

custom item ID
displayed name
Minecraft item ID

`/invlog ignore check`

Checks whether the item in your main hand is ignored.

If it is ignored for multiple reasons, all reasons are shown in chat.

`/invlog reload ignore`

Reloads ignored-items.txt.

This is only needed after manually editing the file. Adding or removing ignored items through commands updates the active ignore list immediately.

Session Stats

`/invlog stats`

Shows added item totals for the current session.

`/invlog stats reset`

Resets session stats.

Drop Tracker

Drop Tracker is used to calculate drop chances from repeated actions.

It can track two types of mechanics:

Durability Mode

Use this when the item in your hand loses durability after each attempt.

Example use cases:

sieves
custom tools
server tools that take damage after every use

Each time the tracked item loses durability, one attempt is counted. Items added shortly after that are counted as drops for that attempt.

Loot Mode

Use this when the item in your hand does not lose durability.

Example use cases:

fishing rods
custom server mechanics
loot systems where the server gives items without changing item durability

In this mode, a new attempt is counted when loot is added to your inventory while holding the tracked item.

Drop Tracker counts only added items. Removed items are ignored for drop chance statistics.

Drop Tracker Commands

`/invlog tracker start durability hand`

Starts a new durability-based tracking session using the item in your main hand.

`/invlog tracker start durability hand file <name>`

Starts a new durability-based tracking session and writes it to a custom file.

Example:

/invlog tracker start durability hand file gravel_sieve

This creates:

tracker/tracker-gravel_sieve.csv
tracker/tracker-gravel_sieve-summary.txt

`/invlog tracker start loot hand`

Starts a new loot-based tracking session using the item in your main hand.

`/invlog tracker start loot hand file <name>`

Starts a new loot-based tracking session and writes it to a custom file.

Example:

/invlog tracker start loot hand file fishing_test

`/invlog tracker continue durability hand file <name>`

Continues an existing durability-based tracker file.

Use this when you want to keep collecting statistics in the same file after restarting the game or stopping a session.

`/invlog tracker continue loot hand file <name>`

Continues an existing loot-based tracker file.

`/invlog tracker stop`

Stops the current tracker session.

`/invlog tracker reset`

Shows reset confirmation hint.

`/invlog tracker reset confirm`

Resets current tracker statistics.

This clears the current tracker session statistics and rewrites the tracker files.

`/invlog tracker stats`

Shows current Drop Tracker statistics in chat.

`/invlog tracker window <ticks>`

Sets how long added items are grouped into the same attempt.

Example:

/invlog tracker window 10

If several items are added within this window, they are counted as drops from the same attempt.

Drop Tracker HUD

`/invlog tracker hud show`

Shows the Drop Tracker HUD.

`/invlog tracker hud hide`

Hides the Drop Tracker HUD.

`/invlog tracker hud move`

Toggles Drop Tracker HUD move mode.

While tracker HUD move mode is enabled:

Key	Action
Arrow keys	Move the tracker HUD
`PageUp` / `PageDown`	Change tracker visible line count

`/invlog tracker hud lines <1-100>`

Sets how many Drop Tracker lines are visible on screen.

Example:

/invlog tracker hud lines 25

Drop Tracker Ignore List

`/invlog tracker ignore hand`

Adds the item in your main hand to the tracker-only ignore list.

It uses the custom item ID if available, otherwise the displayed item name.

`/invlog tracker ignore hand custom`

Adds the item in your main hand to the tracker ignore list by custom item ID.

`/invlog tracker ignore hand name`

Adds the item in your main hand to the tracker ignore list by displayed name.

`/invlog tracker ignore hand minecraft`

Adds the item in your main hand to the tracker ignore list by Minecraft item ID.

`/invlog tracker ignore remove`

Removes the item in your main hand from the tracker ignore list.

`/invlog tracker ignore check`

Checks whether the item in your main hand is ignored by the tracker.

If the item is ignored for multiple reasons, all reasons are shown in chat.

`/invlog tracker ignore list`

Shows tracker-only ignored items.

`/invlog tracker ignore clear`

Clears the tracker-only ignore list.

Note: items from ignored-items.txt are also ignored by Drop Tracker. Items from tracker-ignored-items.txt are ignored only by Drop Tracker and can still appear in normal inventory logs.

Drop Tracker Corrections

`/invlog tracker remove hand`

Removes all Drop Tracker statistics for the item in your main hand.

Use this if an item was accidentally counted and you want to remove it completely from the tracker results.

`/invlog tracker remove hand amount <count>`

Removes one recorded drop entry with the selected amount for the item in your main hand.

Example:

/invlog tracker remove hand amount 4

If the item in your hand was recorded as a x4 drop, this removes one x4 hit from the statistics.

This does not reduce the total number of attempts. It only removes the selected drop result.

Drop Chance Display

Drop Tracker shows the total chance for each item.

If an item can drop in different amounts, each amount is shown separately.

Example:

Diamond: 2.34% +/-2.7%
Scrap: 18.00% +/-7.5% | x4 10.00% +/-5.9% | x6 8.00% +/-5.3%

If an item has only one drop amount, x1 is not shown.

The +/- value is based on Wilson 95% confidence interval. More attempts make the value more reliable.

Log Files

All files are stored in:

.minecraft/config/inventory-log/

The mod creates daily log files. The date in the file name uses the format YYYY-MM-DD.

`inventory-YYYY-MM-DD.log`

Full JSON log.

This file records all confirmed inventory changes, both additions and removals.

Each line is one JSON object.

Example:

{"time":"2026-05-11T10:58:59Z","player":"Steve","action":"added","item":"minecraft:diamond","customId":"","displayName":"Diamond","amount":3,"before":2,"after":5,"dimension":"minecraft:overworld","x":100,"y":64,"z":-50,"components":"..."}

Fields:

Field	Description
`time`	UTC timestamp
`player`	Player name
`action`	`added` or `removed`
`item`	Minecraft item ID
`customId`	Detected custom item ID, if available
`displayName`	Client-side displayed item name
`amount`	How many items changed
`before`	Total amount before the change
`after`	Total amount after the change
`dimension`	Current dimension
`x`, `y`, `z`	Player block position
`components`	Normalized item component data used for item identity

`short-YYYY-MM-DD.log`

Short human-readable log.

This file uses the same format as the in-game HUD short log.

Example:

11.05.2026 14:23:44 | Diamond +3 | total: 5

This file is affected by:

/invlog mode all
/invlog mode added
/invlog mode removed

If the mode is added, only additions are written to this file. If the mode is removed, only removals are written.

`loot-YYYY-MM-DD.log`

Loot-only log.

This file records only added items.

Example:

11.05.2026 14:23:44 | Diamond +3 | total: 5

This is useful when you only care about what you gained from mining, farming, trading, or looting.

It can be enabled or disabled with:

/invlog output loot on
/invlog output loot off

`inventory-YYYY-MM-DD.csv`

CSV export.

This file records all confirmed inventory changes in table format.

It is useful for Excel, Google Sheets, scripts, or external analysis.

Columns:

Column
`date_time`
`action`
`item`
`custom_id`
`display_name`
`amount`
`total`
`dimension`
`x`
`y`
`z`

Example row:

"11.05.2026 14:23:44","added","minecraft:diamond","","Diamond",3,5,"minecraft:overworld",100,64,-50

It can be enabled or disabled with:

/invlog output csv on
/invlog output csv off

`ignored-items.txt`

Main ignore list.

Items listed here are not written to normal inventory logs and are also ignored by Drop Tracker.

One ignored item per line.

Supported ignore entries:

Minecraft item ID, for example minecraft:golden_carrot
Custom item ID, for example executableitems:ei-id=sito_gold
Displayed item name, for example Diamond

The recommended ignore method for custom server items is custom item ID.

You can add items from in-game with:

/invlog ignore hand
/invlog ignore hand custom
/invlog ignore hand name
/invlog ignore hand minecraft

You can remove the item in your hand from the ignore list with:

/invlog ignore remove

If you edit ignored-items.txt manually, reload it with:

/invlog reload ignore

`tracker-ignored-items.txt`

Drop Tracker ignore list.

Items listed here are ignored only by Drop Tracker.

They can still appear in normal inventory logs.

One ignored item per line.

Supported ignore entries:

Minecraft item ID, for example minecraft:stick
Custom item ID, for example executableitems:ei-id=custom_rod
Displayed item name, for example Old Boot

You can manage this file in-game with:

/invlog tracker ignore hand
/invlog tracker ignore hand custom
/invlog tracker ignore hand name
/invlog tracker ignore hand minecraft
/invlog tracker ignore remove
/invlog tracker ignore check
/invlog tracker ignore list
/invlog tracker ignore clear

`settings.properties`

General mod settings.

This file stores persistent settings such as:

current short log mode
CSV output enabled/disabled
loot output enabled/disabled
Drop Tracker window ticks

Example:

logMode=added
writeCsv=true
writeLootLog=true
trackerWindowTicks=10

Usually you do not need to edit this file manually. Use commands or Mod Menu instead.

`hud.properties`

HUD settings.

This file stores the short log HUD position, tracker HUD position, and visible line counts.

Example:

x=8
y=8
visibleLines=20
trackerX=8
trackerY=120
trackerVisibleLines=12
trackerHudVisible=true

Usually you do not need to edit this file manually. Use F10 move mode, tracker HUD move command, arrow keys, and PageUp / PageDown instead.

Tracker Folder

Drop Tracker files are stored in:

.minecraft/config/inventory-log/tracker/

Each tracker session creates two files:

tracker/<name>.csv
tracker/<name>-summary.txt

`tracker/<name>.csv`

This file stores raw Drop Tracker session data.

It is used for continuing the same statistics later with:

/invlog tracker continue durability hand file <name>
/invlog tracker continue loot hand file <name>

Columns:

Column
`type`
`attempt`
`item`
`custom_id`
`display_name`
`amount`

Example rows:

"attempt",1,"","","",0
"drop",1,"minecraft:diamond","","Diamond",1

`tracker/<name>-summary.txt`

Human-readable Drop Tracker summary.

This file mirrors the same kind of information shown in the tracker HUD.

Example:

Drop Tracker: durability, attempts: 100, file: tracker-gravel_sieve.csv
Tracked item: Iron Sieve
Diamond: 2.00% +/-2.6%
Scrap: 18.00% +/-7.5% | x4 10.00% +/-5.9% | x6 8.00% +/-5.3%