bettershulkers/README.md

Better Shulkers

A Fabric mod for Minecraft 1.21.11 that enhances shulker boxes with a top-down flat view, tooltip previews, item hints, labels and a fill bar.

Better Shulkers focuses specifically on shulker boxes and aims to stay lightweight and simple. If you're looking for a more feature-rich mod that covers other containers as well, check out Peek by henkelmax, which served as the original inspiration for this project.

Features

• Flat top-down view — shulker boxes are displayed from above in GUIs instead of the default angled 3D view, making their lid fully visible
• Tooltip grid preview — hover over a shulker box to see its contents laid out in a grid
• Item hints on the lid — displays the most relevant item directly on the lid, both in GUIs and in the world
• Custom labels — shows the shulker box's custom name on the lid
• Fill bar — a durability-style bar indicating how full the shulker box is

Installation

1. Install Fabric Loader for Minecraft 1.21.11
2. Drop bettershulkers-x.x.x+1.21.11.jar into your mods/ folder
3. (Optional) Install Cloth Config and Mod Menu to access the in-game settings screen

Configuration

All options are accessible through Mod Menu (requires Cloth Config). Available settings:

Option	Default	Description
Show Tooltip Preview	When Filled	When to show the grid preview (Always / When Filled / Never)
Show Item Hints in GUI	On	Item and label hints on the lid in inventory and other GUIs
Show Item Hints in World	On	Item and label hints on the lid of placed shulker boxes
Item Display Type	Single Type	Which item to display on the lid (None / Single Type / Bulk / First Item)
Show Labels	On	Show the custom name on the lid
Hide Hint Background in GUI	Off	Hide the shulker-like background of item hints
Item Hints Scale	100%	Scale of the item hint icon (50–200%)
Show Fill Bar	On	Show a fill bar on shulker boxes

License

LGPL-3.0