Overview#
The Inventory Spam Mod is a lightweight, client-side utility designed to enhance the player's awareness of their inventory state. In standard Minecraft, picking up or losing items provides no immediate visual feedback unless the player manually opens their inventory screen. This mod solves that issue by displaying a dynamic list of inventory changes directly on the game's Heads-Up Display (HUD).
Whether you are mining, farming, or engaging in combat, the mod tracks every item that enters or leaves your possession, providing a clear and concise log of your activities. Because it is a client-side mod, it does not need to be installed on servers to function, making it compatible with any multiplayer environment.
Core Mechanics#
The mod functions by monitoring the player's inventory slots every tick. When a discrepancy is detected between the current state and the previous state, the mod generates a notification entry.
Item Tracking
- Additions: When an item is picked up from the ground, crafted, or moved from a container into the player's inventory, a notification appears with a green prefix (e.g.,
+64 Stone). - Removals: When an item is dropped, consumed, used in crafting, or destroyed, a notification appears with a red prefix (e.g.,
-1 Bread). - Stacking Logic: If multiple items of the same type are added or removed within a short window, the mod intelligently groups them into a single line rather than spamming multiple entries. For example, picking up a stack of 64 dirt will show one entry for
+64 Dirtrather than 64 individual lines.
HUD Behavior
Notifications appear at a designated anchor point on the screen. Each entry remains visible for a set duration (configurable) before fading out. If the list of changes exceeds the maximum allowed lines, the oldest entries are pushed off the screen to make room for new ones.
Visual Interface#
The visual interface is designed to be non-intrusive while remaining highly legible. It consists of three primary components per entry:
| Component | Description |
|---|---|
| Item Icon | A high-fidelity render of the item's sprite or 3D model. |
| Quantity | The numerical change, prefixed with '+' for gains and '-' for losses. |
| Item Name | The localized name of the item (supports translated names based on language settings). |
Color Coding
To allow for quick identification at a glance, the mod uses standard color conventions:
- Green Text: Indicates a positive change (item gain).
- Red Text: Indicates a negative change (item loss).
- White/Gray Text: Used for the item name to maintain contrast against the background.
Configuration#
The mod is highly customizable through the inventoryspam-client.toml configuration file or an in-game configuration menu (if a mod like Configured is installed). This allows players to tailor the HUD to their specific layout preferences.
Configuration Options
| Option | Type | Default | Description |
|---|---|---|---|
position |
Enum | TOP_RIGHT |
Sets the anchor point for the HUD (Top Left, Top Right, Bottom Left, Bottom Right). |
displayTime |
Integer | 60 |
The duration (in ticks) that an entry remains on screen before fading. |
maxLines |
Integer | 10 |
The maximum number of simultaneous notifications displayed. |
showIcons |
Boolean | true |
Toggles whether item icons are rendered next to the text. |
textScale |
Float | 1.0 |
Adjusts the size of the text and icons on the HUD. |
horizontalOffset |
Integer | 0 |
Fine-tunes the horizontal position relative to the anchor. |
verticalOffset |
Integer | 0 |
Fine-tunes the vertical position relative to the anchor. |
blacklist |
List | [] |
A list of item IDs (e.g., minecraft:cobblestone) that the mod should ignore. |
Blacklisting Items
If you find certain items (like Cobblestone or Netherrack) cluttering your HUD during large-scale excavations, you can add their IDs to the blacklist section of the config. Items on this list will never trigger a notification.
Mechanics and Technical Details#
As a utility-focused mod, Inventory Spam does not add new blocks, items, mobs, or biomes to the game. Instead, it interacts with the existing Minecraft inventory system.
- Compatibility: Works seamlessly with modded items. Any item added by other mods will automatically display its icon and name in the Inventory Spam HUD.
- Performance: The mod is optimized to have a negligible impact on frame rates. It only performs inventory checks when the player's inventory data is updated by the server.
