ChestSee - Chestlogger

ChestSee is a lightweight Fabric chest logger for Minecraft servers. It logs chests, barrels, shulker boxes and other containers to simple .txt files. Drop it in, no setup needed. Look up logs in-game with /chestsee, or open the files in your world folder.

Server-side only. Vanilla clients can join.

How it works

The mod runs on the server and tracks every time a player opens a container and changes its contents. It also logs when someone breaks a container or places a hopper underneath one.

Logs are saved as .txt files under ChestLog/ in your world folder, sorted by dimension. Each container gets its own file, named after the block type and coordinates. Moving containers (minecarts, chest boats) use their entity UUID instead.

Logged containers

Chests, barrels, shulker boxes, hoppers, dispensers, droppers, crafters, furnaces, blast furnaces, smokers, brewing stands, chest/hopper minecarts and chest boats. Furnaces and brewing stands only log what players put in or take out - not the smelting or brewing itself.

---

Commands

/chestsee inspect Toggle inspect mode. Right-click or punch a container to see its log. The container does not open and does not break while inspect mode is on.

/chestsee lookup <x y z> [page] [dimension] Show the log of one container.

/chestsee player <name> [page] Show everything a player did in all containers, newest first. Click an entry to jump to that container's log. The search runs in the background, so big log folders do not lag the server.

/chestsee reload Reload config/chestsee.json without a restart.

All commands work from the console and RCON. Without a permission mod they need OP level 2.

---

Folder structure

world/
└── ChestLog/
 ├── Overworld/
 │ ├── Chest 120 64 -340.txt
 │ └── Barrel 80 70 200.txt
 ├── The Nether/
 └── The End/

Example log entry (Chest 120 64 -340.txt)

[06.05.26 19:31:37] Steve
Items Added: [3 diamond]
Items Removed: [1 iron_ingot]

[06.05.26 19:45:02] Alex
Items Added: []
Items Removed: [3 diamond]

[06.05.26 20:10:14] Steve
Broke Chest

---

Config

On first start ChestSee creates config/chestsee.json:

{
 "pageSize": 8,
 "retentionDays": 0,
 "maxFileSizeKb": 0,
 "excludedDimensions": [],
 "containers": {
 "chest": true,
 "barrel": true,
 "shulker_box": true,
 "hopper": true,
 "dispenser": true,
 "dropper": true,
 "crafter": true,
 "furnace": true,
 "brewing_stand": true,
 "minecart": true,
 "chest_boat": true,
 "other": true
 }
}

Option	Description
pageSize	Entries per page in commands.
retentionDays	Remove entries older than X days on server start. 0 keeps everything.
maxFileSizeKb	Drop the oldest entries when a log file gets too big. 0 disables the limit.
excludedDimensions	Dimension IDs that should not be logged, e.g. "minecraft:the_nether".
containers	Turn logging on or off per container type.

Existing log files keep working. Nothing needs to be converted after an update.

---

Permissions (optional - LuckPerms)

ChestSee uses fabric-permissions-api. Without LuckPerms, commands need OP level 2.

Node	Access
chestsee.inspect	/chestsee inspect
chestsee.lookup	/chestsee lookup
chestsee.player	/chestsee player
chestsee.reload	/chestsee reload

Example:

/lp group moderator permission set chestsee.inspect true
/lp group moderator permission set chestsee.lookup true
/lp group moderator permission set chestsee.player true

---

Companion mod

ChestSee pairs with StaffSee - container logs in ChestLog/, player moderation in StaffLog/. With both installed, /history <player> chests in StaffSee opens ChestSee activity.

---

Install

1. Install Fabric Loader and Fabric API for your Minecraft version
2. Place ChestSee.jar in your server's mods/ folder
3. Restart the server

Done. No extra setup required.

Inspired by Aguga2201's Chest Logs.