Handy Shulker

 # Handy Shulker **Shulker boxes should work like bundles.** That's it. Vanilla Minecraft gave bundles a slick click-to-insert and hover-to-preview interface - but shulker boxes, the OG portable storage, still require you to place them down every single time. Handy Shulker fixes that with two simple interactions: ## Features ### 🖱️ Click to Insert Hold a shulker box in your inventory and click items onto it to store them — exactly like bundles. No more placing, opening, inserting, closing, and breaking. Just click. ### 🔍 Hover + Scroll to Browse Hover over a shulker box to preview its contents in a 9×3 grid. Scroll to cycle through items and click to extract — all without ever placing the box. ### 📊 Fullness Bar Shulker boxes display a colored bar showing how full they are — just like bundles. Spot your empties at a glance. ### 🎨 Color-Tinted Tooltips The tooltip border matches your shulker box's dye color. Pink shulker? Pink border. ### 🔢 Item Count Badges When you select an item, the tooltip shows the total count across all slots — no more mental math. "Cobblestone ×204" tells you exactly what you've got. ### 📦 Compact Mode Hold **Shift** to view a condensed grid of unique items with aggregated counts and no empty slots. Large counts are abbreviated (1000+ → "1.0k", 10000+ → "10k"). Perfect for quickly checking "do I have enough iron?" ### ⚙️ Fully Configurable Every feature can be toggled individually. No game restart needed. Install [Mod Menu](https://modrinth.com/mod/modmenu) and [YACL](https://modrinth.com/mod/yacl) for an in-game config screen, or just edit `config/handyshulkers.json` by hand. Both are optional - the mod works out of the box with sensible defaults. ## Why This Mod? The average Minecraft builder interacts with shulker boxes about 30 times per session. Each time, you go through the same ritual: find a surface, place the box, wait for the opening animation, open the GUI, move your items, close it, mine it back, pick it up. That's roughly **5.6 seconds per interaction** — and over the course of a year, it adds up to about **6.9 hours** of just placing and breaking shulker boxes. We did the math so you don't have to. You're welcome. Shulker boxes are 27-slot portable chests, yet they have none of the quality-of-life that bundles got in 1.21. Handy Shulker brings that same vanilla-feeling UX to your shulkers. - **Vanilla-esque** — no new items, no new blocks, no config screens. Just better shulker UX. - **Lightweight** — does one thing well. No library dependencies beyond Fabric API. - **Respects vanilla balance** — shulker-in-shulker nesting is still blocked, stack sizes are unchanged. ## Compatibility - Requires [Fabric API](https://modrinth.com/mod/fabric-api) - ✅ **Mouse Tweaks compatible** — works cleanly alongside Mouse Tweaks and other inventory mods - ✅ **ItemScroller / MaLiLib compatible** — scroll events are intercepted at the GLFW input level, so inventory mods won't interfere - Should work alongside most inventory mods — if you run into conflicts, [open an issue](https://github.com/dfox288/HandyShulker/issues) - ⚙️ **Optional:** [Mod Menu](https://modrinth.com/mod/modmenu) + [YACL](https://modrinth.com/mod/yacl) for in-game config screen (not required) ## Installation ### Single Player 1. Install [Fabric Loader](https://fabricmc.net/use/installer/) 2. Install [Fabric API](https://modrinth.com/mod/fabric-api) 3. Drop `handyshulkers-x.x.x.jar` into your `mods/` folder 4. Launch the game! ### Server The mod is required on **both the server and all connecting clients**. Players without the mod installed will not be able to use shulker box interactions correctly. 1. Install Fabric Loader on your server 2. Place Fabric API and Handy Shulker in the server's `mods/` folder 3. Each connecting player needs Fabric Loader, Fabric API, and Handy Shulker installed ## Inspiration This mod exists because of [Xisuma](https://www.youtube.com/@xisumavoid) and his Bundle Boutique in Hermitcraft Season 11. Watching that episode was the moment bundles finally *clicked* - and immediately made me wonder why shulker boxes, the original portable storage, couldn't do the same thing. ## Part of the Handy series Small Fabric mods that smooth over vanilla friction points: - **[Handy Bookshelf](https://modrinth.com/mod/handy-bookshelf)** — enchantment glint and name tags for chiseled bookshelves - **[Handy Trader](https://modrinth.com/mod/handy-trader)** — bookmark your favorite villager trades - **[Handy Indicator](https://modrinth.com/mod/handy-indicator)** — visual indicators on container blocks --- *Handy Shulker is open source under the MIT license.*