Shulker Pocket

A Fabric mod that turns an off-hand shulker box into a live, scrollable tool belt. Sneak + scroll cycles items between the shulker and your main hand: no inventory screen, no hotbar juggling.

Why

Carrying a stack of tools means a cluttered hotbar or constant trips to your inventory. Shulker Pocket lets a single off-hand shulker box be your tool belt: spin the wheel to bring the next item to hand, instantly, without ever opening a screen. Your hotbar stays free for what matters.

How it works

1. Put any shulker box (or other minecraft:container item) in your off-hand.
2. Hold sneak (or a key you bind under Options → Controls → Inventory) and scroll the mouse wheel.
3. The held item rotates through the shulker's contents; scroll past the end to reach bare hands.

There's no custom overlay. Vanilla already shows the held item's name above the hotbar as it changes, and you know what's in your box.

Install

Requires Fabric Loader and Fabric API on Minecraft 1.20.5 through 26.1.x. Must be installed on both the client and the server.

Download on Modrinth or grab a jar from GitHub Releases.

Config

Install Mod Menu (optional) to edit everything in-game: its Config button on the Shulker Pocket row opens a settings screen. Otherwise, edit config/shulker_pocket.json (written on first launch) by hand.

Key Default Meaning invertScroll false Flip scroll direction. cooldownMs 250 Min ms between scroll fires (debounce). allowEmptyPosition true Let the cursor land on "bare hands". playSounds true Play subtle swap / deny sounds. useActivationKey false Activate with a bindable key instead of sneak. showTooltipHint true Show a usage hint on shulker-box tooltips.

Building from source

Requires JDK 25 (the Gradle toolchain pulls JDK 21 for the older Minecraft targets). The mod is built from a single source tree across every supported Minecraft version with Stonecutter: the current version's dialect is the source of truth, and older versions are generated from it.

./gradlew chiseledBuild # build + test every supported Minecraft version ./gradlew build # build + test just the active version (26.1.x) ./gradlew runClient # launch a dev client for the active version

Per-version jars land in versions/<mc>/build/libs/. The design and swap algorithm are documented in SPEC.md.

License

Released under the MIT License.