SmartStash

**SmartStash** is a powerful, intuitive inventory management plugin for Minecraft 1.21+ that eliminates the tedious "cherry-picking" of items. It introduces a seamless, UI-free way to sort, deposit, and loot containers using intelligent logic and simple mouse interactions. ### Key Features * **Void-Click Interaction:** Trigger massive item transfers by clicking the dark space outside the chest GUI—no buttons taking up inventory slots. * **Smart Categorical Sorting:** Automatically organizes chests by logical groups (Combat, Tools, Food, Blocks, etc.) rather than just a messy alphabetical list. * **"Quick Stack" (Smart Deposit):** Instantly move matching items from your inventory to a chest with one click—perfect for massive storage rooms. * **Hotbar Protection:** All bulk actions strictly ignore your first 9 slots, keeping your sword, pickaxe, and food exactly where they belong. * **Container Support:** Works seamlessly with Chests, Barrels, Shulker Boxes, and Ender Chests. * **Fully Configurable:** Change sorting strategies and rebind every action to your preferred mouse clicks via a simple config file. ### Functionality Managing a large base in Minecraft usually involves hundreds of repetitive shift-clicks. **SmartStash** solves this by turning the empty space around the chest interface into a functional control panel. Instead of manually dragging stacks, you can use **Push/Pull** mechanics to empty or fill a chest instantly. The **Quick Stack** (or "Dupe" deposit) feature is a game-changer for organization: if a chest already contains Cobblestone, clicking the trigger will suck every piece of Cobblestone out of your inventory and into that chest, ignoring everything else. The **Smart Sorting** system goes beyond basic organization. It merges partial stacks first to save space, then groups items by gameplay utility. Your swords and bows will always sit at the top, followed by your armor, tools, and food, creating a professional and clean storage layout every time. ### Configuration & Binds SmartStash is designed to be "plug-and-play," but offers deep customization for power users. * **Sort Strategy:** Choose between `SMART_CATEGORICAL`, `CREATIVE_MENU`, `ALPHABETICAL`, or `QUANTITY_FIRST`. * **Binds:** Map actions to `LEFT`, `RIGHT`, `MIDDLE`, or `SHIFT` combinations. * **Default Controls:** * **Left-Click Outside:** Pull all items to inventory. * **Right-Click Outside:** Push all items to chest. * **Shift + Left-Click (Empty Slot):** Sort the container. * **Shift + Right-Click (Empty Slot):** Quick Stack matching items. ### Commands & Permissions * `/smartstash reload` — Reloads the configuration file (smartstash.reload) ### Installation SmartStash is a lightweight, server-side plugin for Paper 1.21+. No client-side mods or resource packs are required. Simply drop the JAR into your `plugins` folder and restart your server. A `plugins/SmartStash/config.yml` file will be created automatically. <div align="center"> <div style=" max-width: 420px; padding: 20px; border-radius: 16px; background: rgba(88,101,242,0.08); border: 1px solid rgba(88,101,242,0.3); "> <h2>🛠 Support & Bug Reports</h2> <p style="opacity:0.85;"> Found a bug or need help setting up the plugin?<br> Report issues directly on Discord. </p> <br> <a href="https://discord.com/users/530425932947783692"> <img src="https://img.shields.io/badge/Report%20Bugs%20on%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white"> </a> </div> </div>