InventoryWizard

# 🧙‍♂️ InventoryWizard **The magical sorting assistant for your Minecraft world!** ✨ InventoryWizard is a powerful PaperMC plugin that brings intelligent, one-click inventory organization to your server. With intuitive controls and smart categorization, managing your items has never been easier! !(https://img.shields.io/badge/license-MIT-blue.svg) !(https://img.shields.io/badge/minecraft-26.1.x-green.svg) !(https://img.shields.io/badge/server-PaperMC-orange.svg) ## 🌟 Features ### ✨ **Intelligent Sorting** - **Smart categorization** - Items are grouped logically (weapons, tools, food, blocks, etc.) - **Hotbar optimization** - Weapons and tools prioritized for PvP/survival gameplay - **Stack consolidation** - Automatically combines partial stacks - **Configurable partial stack sorting** - Choose whether to sort only full stacks or include partial stacks (see config) - **Metadata preservation** - Maintains enchantments, names, and item data ### 🖱️ **Multiple Control Methods** - **Shift+Right Click** - Sort inventories, chests, and hotbar - **Double Click** - Alternative hotbar sorting - **Commands** - `/iwiz` for programmatic sorting - **Shift+Right Click in Hotbar Slot 4** - Cycle through sorting modes ### 🎒 **Comprehensive Coverage** - **Player Inventory** - Organize your main storage - **Hotbar** - Optimized for quick access to combat/survival items - **Chests** - Keep your storage containers tidy - **All-in-one** - Sort everything simultaneously ## 📥 Installation 1. **Download** the latest `InventoryWizard-x.x.x.jar` from the (https://github.com/VanishingTacos/inventorywizard/releases) 2. **Place** the JAR file in your server's `plugins` folder 3. **Restart** your server 4. **Configure** the plugin using `plugins/InventoryWizard/config.yml` (optional) ### Requirements - **Minecraft**: 26.1. - **Server**: PaperMC, Spigot, or compatible fork - **Java**: 26 or higher ### Database - **H2 Database**: Embedded, no external setup required - **Storage**: `plugins/InventoryWizard/player_preferences.mv.db` - **Performance**: Optimized for servers with 1-10,000+ players ## 🎮 Usage Guide ### **Control Scheme Overview** | Action | Location | Permission Required | Result | |--------|----------|-------------------|---------| | **Shift+Right Click** | Hotbar (slots 0-8) | `inventorywizard.all` | Sort inventory + hotbar | | **Shift+Right Click** | Hotbar (slots 0-8) | `inventorywizard.hotbar` | Sort hotbar only | | **Shift+Right Click** | Hotbar Slot 4 | `inventorywizard.use` | Cycle sorting modes | | **Shift+Right Click** | Main Inventory (slots 9-35) | `inventorywizard.inventory` | Sort main inventory | | **Shift+Right Click** | Chest | `inventorywizard.chest` | Sort chest contents | | **Double Click** | Hotbar (slots 0-8) | `inventorywizard.hotbar` | Sort hotbar only | ### **Sorting Your Inventory** - Open your inventory (`E`) - **Shift+Right Click** any slot in your main inventory area (slots 9-35) - Watch the magic happen! ✨ ### **Sorting Your Hotbar** - **Method 1**: **Shift+Right Click** any hotbar slot (0-8) with `inventorywizard.hotbar` permission - **Method 2**: **Double Click** any hotbar slot - **Method 3**: Use command `/iwiz hotbar` ### **Sorting Chests** - Open any chest - **Shift+Right Click** any slot in the chest - The entire chest will be organized! ### **Sorting Everything** - **Shift+Right Click** in your hotbar (slots 0-8) with `inventorywizard.all` permission - Both your inventory and hotbar will be sorted! ### **Cycling Sorting Modes** - **Shift+Right Click** in hotbar slot 4 (middle slot) to cycle through sorting modes - **Default Mode**: Smart categorization by item type - **Alphabetical Mode**: Sort items alphabetically by name - **Stack-based Mode**: Group by item type, then sort by stack size (full stacks first) - Your preferred mode is saved and remembered for future sorting! ## 🧙‍♂️ Commands | Command | Aliases | Description | Permission | |---------|---------|-------------|------------| | `/iwiz` | `/inventorywizard`, `/sort` | Base command | `inventorywizard.use` | | `/iwiz hotbar` | `/iwiz hb` | Sort hotbar only | `inventorywizard.hotbar` | | `/iwiz inventory` | `/iwiz inv` | Sort inventory only | `inventorywizard.inventory` | | `/iwiz all` | `/iwiz both` | Sort everything | `inventorywizard.all` | ## 🔐 Permissions | Permission | Description | Default | |------------|-------------|---------| | `inventorywizard.use` | Basic plugin access | `true` | | `inventorywizard.chest` | Sort chests | `true` | | `inventorywizard.inventory` | Sort player inventory | `true` | | `inventorywizard.hotbar` | Sort hotbar | `true` | | `inventorywizard.all` | Sort everything at once | `true` | ### Permission Groups ```yaml # Example permissions setup groups: default: permissions: - inventorywizard.use - inventorywizard.inventory - inventorywizard.hotbar vip: permissions: - inventorywizard.* # All