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.

/invlog tracker refresh

Refreshes the active Drop Tracker session from its current CSV file.

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%