Перейти к содержимому
Mineforgian

Handy Shulker

Shulker boxes should work like bundles. Click to insert items, hover to preview contents, and scroll to extract — all without placing the box down.

Загрузки
3K
Подписчики
13
Обновлён
24 июня 2026 г.
Лицензия
MIT

Опубликован 21 февраля 2026 г.

Исходный кодСообщить об ошибке

Logo

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 and 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
  • ✅ 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
  • ⚙️ Optional: Mod Menu + YACL for in-game config screen (not required)

Installation

Single Player

  1. Install Fabric Loader
  2. Install 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 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 Shulker is open source under the MIT license.

Ченджлог

2.3.0-beta.1Бета26.3-snapshot-1 · 24 июня 2026 г.

Preview build for the Minecraft 26.3 snapshot cycle (tested against 26.3-snapshot-1).

  • Rebuilt against Fabric API 0.153.1+26.3 and YACL 3.9.5+26.3-fabric.
  • Updated for 26.3's reworked shulker-contents storage, so click-to-insert and scroll-to-extract keep slot positions intact.
  • ModMenu has no 26.3 build yet, so it won't list the mod on 26.3 until it updates — the config screen is still reachable through YACL.
2.2.0Релиз26.2 · 16 июня 2026 г.

Updated for the Minecraft 26.2 full release.

  • Rebuilt against Fabric API 0.152.1+26.2 and Fabric Loader 0.19.3.
  • YACL updated to 3.9.4+26.2-fabric and ModMenu to 20.0.0-beta.2; with YACL's stable 26.2 build out, the in-game config screen is back in dev and live play.
  • Now declares compatibility with 26.2 and future 26.2.x point releases.
2.1.0-beta.4Бета26.2-pre-1 · 27 мая 2026 г.
  • Tracks Minecraft 26.2-pre-1 (first prerelease of the 26.2 cycle); skips snapshots 6, 7, and 8 since none broke this mod's surface.
  • Rebuilt against Fabric API 0.149.2+26.2.
  • YACL bumped to 3.9.3+26.2-fabric and ModMenu to 19.0.0-alpha.1 on the compile classpath. Neither has a build that explicitly lists 26.2-pre-1 in its game_versions yet, so they remain compileOnly — the in-game config screen returns to dev runtime once either ships a matching build.
2.1.0-beta.3Бета26.2-snapshot-5 · 30 апреля 2026 г.

Breaking

  • Mod ID renamed from handyshulkers to handyshulker to match the rest of the Handy series convention (singular). Existing config at config/handyshulkers.json is migrated automatically on first launch — no settings lost.
  • Internal package moved from dev.handyshulkers to dev.handy.mods.handyshulker. No user-facing impact unless another mod was depending on internal classes.

Bug fixes

  • Fixed rare ClassCastException on shulker scroll-extract when another mod constructed an AbstractContainerMenu subclass that loaded before our mixin applied. The cast is now guarded by an instanceof check with a sane fallback.
  • Ender chests can now hold ender chest items. The "no nested containers" rule was a copy-paste of the shulker-box rule and didn't actually apply — ender chest items don't carry their own contents, so dropping ender chests into your ender chest is just storing items.

Changes

  • Config persistence rebuilt on YACL ConfigClassHandler (matches the rest of the Handy suite). On-disk JSON shape is unchanged; users without YACL installed still run on defaults, and dedicated servers no longer touch any YACL classes at all.
  • CI release workflow fixed for prerelease tags — the grep that detects -beta/-alpha/-rc was failing silently because the regex started with -, which both GNU and BSD grep parse as a flag list. The CurseForge upload step is also now gated to stable releases (snapshot betas only ship to Modrinth + GitHub Releases until Overwolf catalogs the MC version).

Internal

  • Cleanup wave aligned this mod with the rest of the suite — JAVA_25 mixin compatibility level, full @At descriptors on every inject, FastUtil Int2IntMap on the per-slot selection hot path, deduplicated insert/remove algorithms via a new SlotAccessor interface, mixin renames to reflect their Item.class target, encapsulated mutable globals, narrowed exception handlers, named magic numbers, and a Math.clamp swap for the ender-glow color sweep.
2.1.0-beta.1Бета26.2-snapshot-3 · 19 апреля 2026 г.
  • Preview build for Minecraft 26.2 snapshots (tested against 26.2-snapshot-3)
  • Rebuilt against Fabric API 0.146.1+26.2
  • Adapted MouseHandlerMixin to the 26.2 screen refactor: Minecraft.screen moved onto Gui, so the scroll hook now reads minecraft.gui.screen() when checking for an open container screen
2.1.0Релиз26.1.2 · 19 апреля 2026 г.

Bug fixes

  • Item loss on insert fixed — inserting items into a shulker while its last slot was occupied could silently drop the new stack once the box was placed. The helper now operates on a fixed 27-slot list and fills empty positions by index instead of appending, so slot positions are preserved across insert/extract and items can no longer overflow. (fixes #4)
  • Extract no longer "walks" to the next item — the scroll selection is now cleared after each extract, so rapid right-clicks don't drift through the shulker/ender chest in ways that were hard to predict.

Features

  • Ender chest support — click-to-insert, scroll-to-extract and tooltip previews now also work on ender chests. Contents are synced from the server on login and on every ender chest close so the preview is always accurate. Disabled in creative mode (server-authoritative state isn't reachable from creative slot packets); toggleable for survival via Ender Chest Support in the Features tab. (fixes #2)
  • Animated ender-glow tooltip border — ender chest tooltips get a subtle cycling glow so they're visually distinct from dyed shulkers.
  • Configurable compact-mode modifier — the compact-tooltip hotkey is no longer hard-coded to Shift. Choose Shift, Ctrl, Alt, or None (disables toggling entirely) under the Tooltip tab. (fixes #3)
  • Show all slots option — new toggle to always render the full 3×9 tooltip grid including empty slots, for users who prefer a stable layout over the auto-collapsing default. (fixes #1)
2.0.2Релиз26.1.2 · 18 апреля 2026 г.
  • Update to Minecraft 26.1.2 compatibility
  • Update Fabric Loader to 0.19.2, Fabric API to 0.146.1
2.0.1Релиз26.1.1 · 3 апреля 2026 г.
  • Update to Minecraft 26.1.1 compatibility
  • Update Fabric Loader to 0.18.6, Fabric API to 0.145.3, YACL to 3.9.2

Комментарии

Загружаем…