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

1. Key Features
2. Controls & Interaction Guide
3. Configuration & Visual Themes
4. Installation
5. License

---

🚀 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)
• 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 Preview
• F (or key config): Filter Item Type
• R (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.

Config Options

• tooltipEnabled (default: true): Toggles the interactive tooltip.
• precisionModeEnabled (default: true): Allows using the Ctrl key 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 holding Alt to 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.

---

🛠️ 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.