Chest Tracker Mod — Guide

User Interface (GUI)

The main GUI is the central hub for managing your stored resources. It features a clean, grid-based layout that displays every unique item the mod has recorded.

Features of the GUI:

• Search Bar: Supports advanced filtering, including searching by item name, mod ID, or tags (e.g., #logs).
• Item Grid: Displays icons of all tracked items. Hovering over an item shows the total count across all known containers.
• Container List: Selecting an item reveals a list of every container holding it, sorted by distance from the player.
• Dimension Filtering: Toggle between viewing items in your current dimension or across all dimensions.
• Sorting Options: Sort items by name, quantity, or most recently seen.

Chest Labels and Customization

To help organize large storage rooms, Chest Tracker allows you to assign custom names to containers. These names appear as floating labels above the blocks, visible only to you.

• Client-Side Naming: You can rename a chest within the mod's GUI. This name is stored locally and does not affect the actual block data on a server.
• Automatic Naming: If a container has a custom name (e.g., renamed in an anvil), Chest Tracker will automatically use that name for its label.
• Visual Customization: Labels can be toggled on or off, and their rendering distance can be adjusted in the settings to prevent screen clutter.

Technical Limitations

While highly accurate, users should be aware of the following limitations inherent to a client-side mod:

1. Direct Observation Required: The mod cannot track items in a chest you have never opened. If another player moves items while you are offline, the mod will show outdated information until you open the chest again.
2. Chunk Loading: Chests in unloaded chunks cannot be 'verified' by integrity checks. They will remain in the database until you return to that area.
3. Server-Side Changes: On some servers, containers might be moved by plugins or scripts. Chest Tracker attempts to follow these changes but may occasionally require a manual 'Reset' of a specific container's data if it becomes desynced.

Core Mechanics

The mod operates on a 'see-to-remember' logic. It does not scan the world for chests; instead, it updates its internal database every time a container's inventory is loaded on your screen.

Memory Bank

The Memory Bank is the core data structure where item locations are stored. It tracks: * Item Type: The specific block or item. * Quantity: The total count of that item in a specific container. * Location: The exact X, Y, Z coordinates and the dimension (Overworld, Nether, End). * Container Type: Whether it is a chest, barrel, shulker box, or modded container.

Integrity Checks

Since the mod is client-side, it cannot know if a chest was broken or emptied while you were away. To mitigate this, Chest Tracker includes integrity checks. When you are near a remembered container, the mod can verify if the block still exists. If a container is found to be missing or changed, the mod updates its records accordingly.