SmartStash — Anti-Cheat Container Sort, Quick-Stack & Shulker Search
SmartStash is a modern, pure client-side inventory management, chest sorting, and live slot search assistant for Minecraft 1.21 and 1.21.1 (Fabric). Built from the ground up around Minecraft 1.21's DataComponentTypes item architecture and strict multiplayer packet-rate budgets, SmartStash organizes cluttered storage rooms in seconds without triggering multiplayer anti-cheat false positives.
Core Inventory & Storage Features
- Deterministic Two-Pass Container Sorting: Compacts partial item stacks with matching components (
ItemStack.areItemsAndComponentsEqual) before ordering items cleanly by registry identifier, custom display name, and descending stack size. Works seamlessly on single chests, double chests, barrels, Shulker boxes, hoppers, dispensers, and your survival backpack (slots 9–35) while keeping your hotbar and armor untouched. - Anti-Cheat-Safe Slot Click Pacing: Queues standard vanilla
PICKUPandQUICK_MOVEwindow clicks through a tick-paced scheduler capped at<= 2slot clicks per client tick (40 clicks/sec), ensuring smooth operation on strict Grim, Vulcan, Paper, and Spigot multiplayer servers without packet bursts or desyncs. - One-Key Quick-Stack to Open Chests: Scans the open container and automatically transfers matching items from your main survival inventory (
slots 9–35) while preserving your active hotbar tools, weapons, and offhand gear. - Live
Ctrl+FSlot Search & Deep Shulker Inspection: PressCtrl+Finside any container screen to open an instant search bar that outlines matching slots in bright emerald and dims non-matching clutter. Searches across display names, Minecraft registry IDs, applied enchantments (DataComponentTypes.ENCHANTMENTS), and nested Shulker Box / Bundle contents (DataComponentTypes.CONTAINER)! - Rich Durability & Shulker Tooltip Previews: Enhances item hover tooltips with exact remaining durability (
remaining / max+ color-coded percentage and[LOW DURABILITY!]warnings) plus aggregated item counts inside Shulker Boxes and Bundles without placing them down.
Controls & Shortcuts
Keybindings are configurable in Options -> Controls -> Key Binds -> SmartStash Inventory Helper:
R(inside any open container): Merge partial stacks and sort the active container (or main backpack if viewing player inventory).K(inside any open container): Quick-stack matching items from your main backpack into the open container.Ctrl + F(inside any open container): Focus the live item/enchantment/Shulker search filter (Escclears and closes search).
Multiplayer Safety & Requirements
- Pure Client-Side Mod: Requires no server installation and sends zero custom networking channels.
- Requirements: Minecraft 1.21 or 1.21.1, Fabric Loader
>= 0.16.0, Java 21, and Fabric API.
License
Released under the MIT License.