Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Tags
Creators
Details
Better Shulker Boxes
Welcome to Better Shulker Plus, a premium, high-performance Fabric mod for Minecraft 26.1 (compiled with Java 25) that completely redefines inventory management. This mod allows players to preview and manipulate the contents of Shulker Boxes and Ender Chests directly from their inventory tooltips without placing the containers down.
Designed for fluid gameplay, Better Shulker Plus features a fully interactive 9ร3 grid tooltip, a drag-and-paint control scheme, smart sorting, custom sound design, client-side prediction, and strict server-side anti-cheat validation.
๐ Table of Contents
๐ Key Features
- Interactive 9ร3 Tooltips: Hover over a Shulker Box or Ender Chest to view its contents in a complete grid.
- Easy Shulker Boxes (ESB)-Matched Controls: Click-and-drag to paint-insert or paint-extract items.
- Active Keyboard & Scroll Navigation: Use the scroll wheel or arrow keys while hovering a container to change the active slot.
- Wireless Ender Chest Access: Hover over a slot or hold the wireless hotkey to preview and interact with your Ender Chest remotely, provided you have an Ender Chest in your inventory.
- Smart Container Sorting: Sort your container's inventory instantly by Name, Count, or Category (using custom tags) with a single hotkey.
- Contextual Audio Feedback: Sounds are dynamically generated matching the material of the item being moved (e.g., metal clinks for iron, thuds for stone, cloth rustles for organic food items).
- Client-Side Prediction: Interactions are instantly simulated on the client for zero-latency feedback, with automatic rollback animation support if the server rejects the request.
- Security & Anti-Dupe Validation: The server evaluates all packet payloads against the player's true inventory state and nesting rules (e.g., preventing Shulker Boxes from being placed inside Shulker Boxes).
๐ฎ Controls & Interaction Guide
The mod uses a drag-to-act control scheme modeled after Easy Shulker Boxes (ItemStorageMouseActions). Tapping (clicking without dragging) has no action, preventing accidental moves.
Interaction Controls
| Action | Control Scheme | Condition | Code Handler |
|---|---|---|---|
| Insert Drag (Paint) | Left-click + Drag over occupied slot | Carried cursor item is not empty; slot has items | onMouseDragged |
| Extract Drag (Paint) | Right-click + Drag over empty slot | Carried cursor item is empty; slot is empty | onMouseDragged |
| Precision Extract Drag | Right-click + Drag + Hold Ctrl |
Extracts exactly one matching item per slot | shouldSlotBeClicked |
| Scroll Slot Selection | Scroll Wheel while hovering container | Cycles selection index backward/forward | scrollSelectedItem |
| Arrow Selection | Arrow Keys while hovering container | Moves selection cursor around the 9ร3 grid | onKeyPressed |
| Alt-Force Tooltip | Hold Left Alt | Shows carried container's tooltip even when cursor is not hovering inventory slots | HandledScreenMixin |
Keybindings
You can customize the following keybindings under Options -> Controls -> Key Binds -> Better Shulker Plus:
B: Open Settings/Config screen ([BetterShulkerSettingsScreen.java](file:///E:/main%20minecraft%20mod%20files/shulker%20box%20mod/src/main/java/com/bettershulker/client/BetterShulkerSettingsScreen.java))E: Bulk Extract Selected Slots (extracts all items from selected slots in tooltip)G: Sort Container Items (cycles: Name โ Count โ Category โ None)O: Wireless Ender Chest PreviewF(or key config): Filter Item TypeR(or key config): Restock / Deposit items into the container
โ๏ธ Configuration & Visual Themes
The config file is located at config/bettershulker-plus.properties and is managed by [BetterShulkerConfig.java](file:///E:/main%20minecraft%20mod%20files/shulker%20box%20mod/src/main/java/com/bettershulker/BetterShulkerConfig.java).
Config Options
tooltipEnabled(default:true): Toggles the interactive tooltip.precisionModeEnabled(default:true): Allows using theCtrlkey for extracting single items.fillIndicatorEnabled(default:true): Displays a fill gauge bar inside the container icon/slot.secondaryTooltipEnabled(default:true): Displays the selected slot indicator inside the tooltip.altForceTooltipEnabled(default:true): Enables holdingAltto force display tooltips for carried containers.selectionGlideEnabled(default:true): Toggles smooth linear interpolation (lerp) of the selection highlight.hoverAnimationsEnabled(default:true): Slots scale up 1.05x on hover.rareItemWobbleEnabled(default:true): Rare or enchanted items wobble/rotate in 3D within the tooltip.soundVolume(default:0.3): Configures volume level for contextual sounds.
Preset Color Themes
You can change themes directly in-game using the configuration GUI screen:
- Original: Dark gray background with purple border accents.
- Classic / Retro: Vintage GUI styling.
- Solarized Dark / Solarized Light: Thematic programmer color schemes.
- Pastel Soft / High Contrast / Light: Alternative color aesthetics.
- Glass: High-translucency glassmorphism effect.
- Custom: Allows players to customize backgrounds, borders, selection boxes, and name badges using [CustomColorPickerScreen.java](file:///E:/main%20minecraft%20mod%20files/shulker%20box%20mod/src/main/java/com/bettershulker/client/CustomColorPickerScreen.java).
๐ ๏ธ Installation
Requirements
- Minecraft Version: 26.1 (unobfuscated Mojang official mappings)
- Java Version: 25
- Mod Loader: Fabric Loader
- Dependency: Fabric API
๐ License
This project is licensed under the terms of the MIT License.


