ChestSee - Chestlogger

ChestSee - Chestlogger

Fabric chest logger for servers. Logs chests and containers to .txt files, with in-game inspect, player search and optional LuckPerms.

1 210 downloads 3 followers

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.

Version Minecraft Loader Download

ChestSee - Chestlogger 1.2.0 for 1.21.7

1.2.0+1.21.7

1.21.7
fabric
Download

ChestSee - Chestlogger 1.2.0 for 1.21.8

1.2.0+1.21.8

1.21.8
fabric
Download

ChestSee - Chestlogger 1.2.0 for 1.21.9

1.2.0+1.21.9

1.21.9
fabric
Download

ChestSee - Chestlogger 1.2.0 for 1.21.10

1.2.0+1.21.10

1.21.10
fabric
Download

ChestSee - Chestlogger 1.2.0 for 1.21.11

1.2.0+1.21.11

1.21.11
fabric
Download

ChestSee - Chestlogger 1.2.0 for 26.1

1.2.0+26.1

26.1
fabric
Download

ChestSee - Chestlogger 1.2.0 for 26.1.1

1.2.0+26.1.1

26.1.1
fabric
Download

ChestSee - Chestlogger 1.2.0 for 26.1.2

1.2.0+26.1.2

26.1.2
fabric
Download

ChestSee - Chestlogger 1.2.0 for 26.2

1.2.0+26.2

26.2
fabric
Download

ChestSee - Chestlogger 1.2.0 for 26.3

1.2.0+26.3

26.3
fabric
Download

ChestSee - Chestlogger 1.1.0 for 1.21.7

1.1.0+1.21.7

1.21.7
fabric
Download

ChestSee - Chestlogger 1.1.0 for 1.21.8

1.1.0+1.21.8

1.21.8
fabric
Download

ChestSee - Chestlogger 1.1.0 for 1.21.9

1.1.0+1.21.9

1.21.9
fabric
Download

ChestSee - Chestlogger 1.1.0 for 1.21.10

1.1.0+1.21.10

1.21.10
fabric
Download

ChestSee - Chestlogger 1.1.0 for 1.21.11

1.1.0+1.21.11

1.21.11
fabric
Download

ChestSee - Chestlogger 1.1.0 for 26.1

1.1.0+26.1

26.1
fabric
Download

ChestSee - Chestlogger 1.1.0 for 26.1.1

1.1.0+26.1.1

26.1.1
fabric
Download

ChestSee - Chestlogger 1.1.0 for 26.1.2

1.1.0+26.1.2

26.1.2
fabric
Download

ChestSee - Chestlogger 1.1.0 for 26.2

1.1.0+26.2

26.2
fabric
Download

ChestSee - Chestlogger 1.1.0 for 26.3

1.1.0+26.3

26.3
fabric
Download

ChestSee - Chestlogger 26.1.2

26.1.2

26.1.2
fabric
Download

ChestSee - Chestlogger 26.1.1

26.1.1

26.1.1
fabric
Download

ChestSee - Chestlogger 26.1

26.1

26.1
fabric
Download

ChestSee - Chestlogger 1.21.11

1.21.11

1.21.11
fabric
Download

ChestSee - Chestlogger 1.21.10

1.21.10

1.21.10
fabric
Download

ChestSee - Chestlogger 1.21.9

1.21.9

1.21.9
fabric
Download

ChestSee - Chestlogger 1.21.8

1.21.8

1.21.8
fabric
Download

ChestSee - Chestlogger 1.21.7

1.21.7

1.21.7
fabric
Download