Shulker Box Tooltip Mod Wiki

Shulker Box Tooltip (also known as "What's in My Shulker Box?") is an essential quality-of-life mod designed to streamline inventory management. In vanilla Minecraft, players must place a Shulker Box on the ground and open it to see its contents. This mod removes that hurdle by rendering a graphical overlay when hovering over a container item in any inventory screen.

The mod is highly intelligent, automatically detecting the color of the Shulker Box and tinting the preview window to match. It supports not only standard Shulker Boxes but also Ender Chests (with server-side installation), barrels, chests, furnaces, and various modded storage solutions.

The mod offers several distinct viewing modes and utility features to help players track their resources:

• Dynamic Previews: Instantly see icons and stack counts for every item inside a container.
• Color Matching: The preview window's border and background adapt to the color of the Shulker Box (e.g., a Lime Shulker Box will have a lime-themed tooltip).
• Inventory Fullness: Displays a summary of how many slots are occupied versus the total capacity.
• Loot Table Detection: For technical players, the mod can display the internal loot table name of a container (disabled by default).
• Creative Mode Support: Works seamlessly with containers obtained via the 'Pick Block' (Ctrl + Middle Click) command, showing their saved NBT contents.

Interaction with the tooltips is handled through configurable hotkeys. By default, the mod uses the following keybindings:

Note: These keys can be remapped in the standard Minecraft Controls menu or via the mod's configuration screen.

Preview Styles

The mod utilizes two primary rendering methods for tooltips:

1. Compact Mode: This mode groups identical items together. If you have three stacks of Cobblestone, it will show a single Cobblestone icon with the number '192'. This is ideal for bulk storage boxes.
2. Full Mode: This mode mimics the actual container GUI. It shows the exact slot placement of every item, which is useful for organized kits or shulker boxes containing varied equipment.

While the mod is primarily client-side, installing it on a server enables the Ender Chest Preview. Because Ender Chest contents are stored per-player on the server, the client cannot normally see them. With the mod on the server, it securely syncs your Ender Chest data to your client for the preview to function.

The mod is fully customizable through the shulkerboxtooltip.json5 file or an in-game configuration menu.

Major Config Options

• Tooltip Style: Choose between COMPACT or FULL as the default view.
• Always On: If enabled, the tooltip shows immediately upon hovering without needing to press Shift.
• Show Fullness: Toggles the 'Fullness' bar or text at the bottom of the tooltip.
• Use Colors: Toggles whether the tooltip background should match the container's color.
• Loot Table Info: Enables the display of loot table paths for map makers and developers.
• Hide Item List: Allows hiding the vanilla 'item list' text that usually appears on Shulker Box tooltips to reduce clutter.

Shulker Box Tooltip is designed to be compatible with almost any container item. Supported vanilla items include:

• All 17 colors of Shulker Boxes
• Chests and Trapped Chests
• Barrels
• Furnaces, Blast Furnaces, and Smokers
• Dispensers and Droppers
• Hoppers
• Ender Chests (Requires server-side mod)

Mod Compatibility

The mod features an API that allows other mod developers to add support for their own backpacks, crates, and storage bags. It is widely compatible with popular storage mods, ensuring that modded backpacks display previews in the same style as vanilla Shulker Boxes.

To ensure the mod functions correctly on version 1.20.1, follow these steps:

1. Loader: Ensure you have the correct version of the Fabric Loader installed.
2. Dependencies: Download the Fabric API and place it into your mods folder.
3. Mod File: Place the shulkerboxtooltip-5.x.x+1.20.1.jar file into the mods folder.
4. Optional: Install Cloth Config API and Mod Menu to access the configuration screen in-game.
5. Launch: Start the game. You can verify the installation by hovering over a Shulker Box in the Creative inventory; a tooltip should appear when holding Shift.