![\"Buy](\"https:\/\/cdn.buymeacoffee.com\/buttons\/v2\/default-yellow.png\")
<\/p>\n# \ud83e\uddd9\u200d\u2642\ufe0f InventoryWizard<\/p>\n
**The magical sorting assistant for your Minecraft world!** \u2728<\/p>\n
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!<\/p>\n
\n
\n<\/p>\n
## \ud83c\udf1f Features<\/p>\n
### \u2728 **Intelligent Sorting**
\n– **Smart categorization** – Items are grouped logically (weapons, tools, food, blocks, etc.)
\n– **Hotbar optimization** – Weapons and tools prioritized for PvP\/survival gameplay
\n– **Stack consolidation** – Automatically combines partial stacks
\n– **Configurable partial stack sorting** – Choose whether to sort only full stacks or include partial stacks (see config)
\n– **Metadata preservation** – Maintains enchantments, names, and item data<\/p>\n
### \ud83d\uddb1\ufe0f **Multiple Control Methods**
\n– **Shift+Right Click** – Sort inventories, chests, and hotbar
\n– **Double Click** – Alternative hotbar sorting
\n– **Commands** – `\/iwiz` for programmatic sorting
\n– **Shift+Right Click in Hotbar Slot 4** – Cycle through sorting modes<\/p>\n
### \ud83c\udf92 **Comprehensive Coverage**
\n– **Player Inventory** – Organize your main storage
\n– **Hotbar** – Optimized for quick access to combat\/survival items
\n– **Chests** – Keep your storage containers tidy
\n– **All-in-one** – Sort everything simultaneously<\/p>\n
## \ud83d\udce5 Installation<\/p>\n
1. **Download** the latest `InventoryWizard-x.x.x.jar` from the releases page
\n2. **Place** the JAR file in your server’s `plugins` folder
\n3. **Restart** your server
\n4. **Configure** the plugin using `plugins\/InventoryWizard\/config.yml` (optional)<\/p>\n
### Requirements
\n– **Minecraft**: 1.21.x
\n– **Server**: PaperMC, Spigot, or compatible fork
\n– **Java**: 17 or higher<\/p>\n
### Database
\n– **H2 Database**: Embedded, no external setup required
\n– **Storage**: `plugins\/InventoryWizard\/player_preferences.mv.db`
\n– **Performance**: Optimized for servers with 1-10,000+ players<\/p>\n
## \ud83c\udfae Usage Guide<\/p>\n
### **Control Scheme Overview**
\n| Action | Location | Permission Required | Result |
\n|——–|———-|——————-|———|
\n| **Shift+Right Click** | Hotbar (slots 0-8) | `inventorywizard.all` | Sort inventory + hotbar |
\n| **Shift+Right Click** | Hotbar (slots 0-8) | `inventorywizard.hotbar` | Sort hotbar only |
\n| **Shift+Right Click** | Hotbar Slot 4 | `inventorywizard.use` | Cycle sorting modes |
\n| **Shift+Right Click** | Main Inventory (slots 9-35) | `inventorywizard.inventory` | Sort main inventory |
\n| **Shift+Right Click** | Chest | `inventorywizard.chest` | Sort chest contents |
\n| **Double Click** | Hotbar (slots 0-8) | `inventorywizard.hotbar` | Sort hotbar only |<\/p>\n
### **Sorting Your Inventory**
\n– Open your inventory (`E`)
\n– **Shift+Right Click** any slot in your main inventory area (slots 9-35)
\n– Watch the magic happen! \u2728<\/p>\n
### **Sorting Your Hotbar**
\n– **Method 1**: **Shift+Right Click** any hotbar slot (0-8) with `inventorywizard.hotbar` permission
\n– **Method 2**: **Double Click** any hotbar slot
\n– **Method 3**: Use command `\/iwiz hotbar`<\/p>\n
### **Sorting Chests**
\n– Open any chest
\n– **Shift+Right Click** any slot in the chest
\n– The entire chest will be organized!<\/p>\n
### **Sorting Everything**
\n– **Shift+Right Click** in your hotbar (slots 0-8) with `inventorywizard.all` permission
\n– Both your inventory and hotbar will be sorted!<\/p>\n
### **Cycling Sorting Modes**
\n– **Shift+Right Click** in hotbar slot 4 (middle slot) to cycle through sorting modes
\n– **Default Mode**: Smart categorization by item type
\n– **Alphabetical Mode**: Sort items alphabetically by name
\n– **Stack-based Mode**: Group by item type, then sort by stack size (full stacks first)
\n– Your preferred mode is saved and remembered for future sorting!<\/p>\n
## \ud83e\uddd9\u200d\u2642\ufe0f Commands<\/p>\n
| Command | Aliases | Description | Permission |
\n|———|———|————-|————|
\n| `\/iwiz` | `\/inventorywizard`, `\/sort` | Base command | `inventorywizard.use` |
\n| `\/iwiz hotbar` | `\/iwiz hb` | Sort hotbar only | `inventorywizard.hotbar` |
\n| `\/iwiz inventory` | `\/iwiz inv` | Sort inventory only | `inventorywizard.inventory` |
\n| `\/iwiz all` | `\/iwiz both` | Sort everything | `inventorywizard.all` |<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
| Permission | Description | Default |
\n|————|————-|———|
\n| `inventorywizard.use` | Basic plugin access | `true` |
\n| `inventorywizard.chest` | Sort chests | `true` |
\n| `inventorywizard.inventory` | Sort player inventory | `true` |
\n| `inventorywizard.hotbar` | Sort hotbar | `true` |
\n| `inventorywizard.all` | Sort everything at once | `true` |<\/p>\n
### Permission Groups
\n“`yaml
\n# Example permissions setup
\ngroups:
\n default:
\n permissions:
\n – inventorywizard.use
\n – inventorywizard.inventory
\n – inventorywizard.hotbar<\/p>\n
vip:
\n permissions:
\n – inventorywizard.* # All permissions
\n“`<\/p>\n
## \u2699\ufe0f Configuration<\/p>\n
The plugin generates a `config.yml` file with the following options:<\/p>\n
“`yaml
\n# InventoryWizard Configuration
\nsettings:
\n # Play magical sound effects when sorting
\n play-sound: true<\/p>\n
# Sound settings for the wizard’s magic
\n sound:
\n type: UI_BUTTON_CLICK
\n volume: 0.5
\n pitch: 1.2<\/p>\n
# Sorting method: “TYPE” for smart categorization or “ALPHABETICAL”
\n sort-method: “TYPE”<\/p>\n
# Enable\/disable magical features
\nfeatures:
\n chest-sorting: true
\n inventory-sorting: true
\n hotbar-sorting: true
\n show-messages: true<\/p>\n
# Allow sorting of partial stacks in chests (set false to only sort full stacks)
\n allow-partial-stacks-chest: true
\n # Allow sorting of partial stacks in player inventory (set false to only sort full stacks)
\n allow-partial-stacks-inventory: true<\/p>\n
# Hotbar sorting priorities (optimized for PvP\/survival)
\nhotbar-priorities:
\n weapons: 100 # Swords, bows, crossbows first
\n tools: 200 # Pickaxes, axes, shovels second
\n food: 300 # Sustenance third
\n building-blocks: 400 # Quick-build materials fourth
\n utility-items: 500 # Ender pearls, buckets, torches
\n other: 999 # Everything else
\n“`<\/p>\n
#### Partial Stack Sorting Behavior
\n– `allow-partial-stacks-chest` and `allow-partial-stacks-inventory` control whether partial stacks are included in sorting for chests and player inventory, respectively.
\n– **If set to `true`**: All items, including partial stacks, are sorted and consolidated as much as possible.
\n– **If set to `false`**: Only full stacks are sorted. Any leftover partial stacks are left unsorted at the end of the inventory or chest.<\/p>\n
## \ud83d\udccb Sorting Modes<\/p>\n
### **Default Mode** (Smart Categorization)
\nItems are sorted by logical categories:<\/p>\n
1. **Stone Types** – Stone, granite, cobblestone, deepslate, etc.
\n2. **Earth Types** – Dirt, sand, gravel, clay, concrete, etc.
\n3. **Wood Types** – Logs, planks, leaves, saplings
\n4. **Ores & Metals** – Iron blocks, diamond blocks, etc.
\n5. **Other Blocks** – Remaining building materials
\n6. **Tools** – Pickaxes, axes, shovels, shears, etc.
\n7. **Weapons** – Swords, bows, arrows, tridents
\n8. **Armor** – Helmets, chestplates, boots, shields
\n9. **Food** – All edible items
\n10. **Redstone** – Redstone components and mechanisms
\n11. **Transportation** – Boats, minecarts, saddles
\n12. **Decoration** – Flowers, carpets, banners, etc.
\n13. **Miscellaneous** – Everything else<\/p>\n
### **Alphabetical Mode**
\nItems are sorted alphabetically by their material name (A-Z).<\/p>\n
### **Stack-based Mode**
\nItems are grouped by type first, then sorted by stack size within each type. Full stacks appear before partial stacks of the same item.<\/p>\n
### **Hotbar Sorting Order** (Optimized for PvP\/Survival)
\n1. **Weapons** – Combat items for quick access
\n2. **Tools** – Essential survival tools
\n3. **Food** – Health restoration
\n4. **Building Blocks** – Cobblestone, dirt for quick building
\n5. **Utility Items** – Ender pearls, buckets, torches
\n6. **Other Items** – Miscellaneous<\/p>\n
## \ud83d\udd27 Building from Source<\/p>\n
“`bash
\n# Clone the repository
\ngit clone https:\/\/github.com\/VanishingTacos\/inventorywizard.git
\ncd inventorywizard<\/p>\n
# Build with Maven
\nmvn clean package<\/p>\n
# The JAR will be in target\/InventoryWizard-1.0.0.jar
\n“`<\/p>\n
### Development Requirements
\n– Java 17+
\n– Maven 3.6+
\n– PaperMC API 1.21.4+<\/p>\n
## \ud83e\udd1d Contributing<\/p>\n
Contributions are welcome! Please feel free to submit pull requests, report bugs, or suggest features.<\/p>\n
1. **Fork** the repository
\n2. **Create** a feature branch: `git checkout -b feature-name`
\n3. **Commit** your changes: `git commit -am ‘Add some feature’`
\n4. **Push** to the branch: `git push origin feature-name`
\n5. **Submit** a pull request<\/p>\n
## \ud83d\udcdc Changelog<\/p>\n
# Version 1.1.1
\n– \ud83d\udee1\ufe0f **Rate Limiting Added** – Prevents excessive sorting to avoid server lag and abuse (configurable per player)
\n– \ud83d\uddc3\ufe0f **H2 Database** – Improved performance and secuirty for inventory data storage
\n– \ud83d\udc1b **Bug Fixes** – Fixed rare issues with inventory sync and sorting edge cases
\n– \ud83d\udcda **Documentation Improvements** – Expanded README and in-game help for new features<\/p>\n
### Version 1.1.0
\n– \u2728 **New Stack-based Sorting Mode** – Group items by type, then sort by stack size (full stacks first)
\n – \ud83d\udd04 **Preserved Individual Stacks** – Partial stacks maintain their original sizes without combining
\n– \ud83d\udce6 **Alphabetical Material Grouping** – Items grouped alphabetically by material name within stack-based mode
\n– \ud83c\udfaf **Enhanced Sorting Logic** – Improved stack size sorting (largest to smallest within each material type)
\n– \ud83e\uddd9\u200d\u2642\ufe0f **Mode Cycling** – Easily switch between Default, Alphabetical, and Stack-based sorting modes<\/p>\n
### Version 1.0.1
\n– \ud83d\udd27 **Fixed control scheme** – Removed middle click, improved Shift+Right Click logic
\n– \ud83c\udfaf **Enhanced hotbar sorting** – Priority-based permission system for combined sorting
\n– \ud83d\udee0\ufe0f **Code optimization** – Eliminated duplicate event handlers and improved reliability
\n– \ud83d\udcdd **Updated documentation** – Clearer instructions and permission requirements<\/p>\n
### Version 1.0.0
\n– \u2728 Initial release
\n– \ud83e\uddd9\u200d\u2642\ufe0f Smart inventory sorting with type-based categorization
\n– \ud83c\udfaf Hotbar optimization for PvP\/survival gameplay
\n– \ud83d\udce6 Chest organization support
\n– \ud83d\uddb1\ufe0f Multiple control methods (click-based and commands)
\n– \ud83d\udd0a Audio feedback and magical messages
\n– \u2699\ufe0f Comprehensive configuration options<\/p>\n
## \ud83d\udcc4 License<\/p>\n
This project is licensed under the MIT License – see the [LICENSE](LICENSE) file for details.<\/p>\n
## \ud83d\ude4f Acknowledgments<\/p>\n
– **PaperMC Team** for the excellent server software
\n– **Minecraft Community** for inspiration and feedback
\n– **Plugin Developers** who paved the way for quality Bukkit plugins<\/p>\n
—<\/p>\n
## \u2615 Support InventoryWizard<\/p>\n
If you enjoy using InventoryWizard and want to support its development, you can buy me a coffee!<\/p>\n
<\/p>\n
**Made with** \u2764\ufe0f **and** \u2728 **for the Minecraft community**<\/p>\n
*Transform your chaotic inventory into organized perfection with InventoryWizard!* \ud83e\uddd9\u200d\u2642\ufe0f<\/p>\n","protected":false},"excerpt":{"rendered":"
Transform your chaotic inventory into organized perfection with InventoryWizard! \ud83e\uddd9\u200d\u2642\ufe0f<\/p>\n","protected":false},"featured_media":85890,"template":"","meta":{"_minecraft_slug":"inventorywizard","_minecraft_project_id":"cU0ynk3p","_minecraft_author":"VanishingTacos","_minecraft_license":"MIT","_minecraft_downloads":182,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"inventorywizard.zip","_minecraft_size_bytes":2589033,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T12:56:20.218011Z","_minecraft_date_created":"2025-07-23T21:41:45.317859Z","_minecraft_date_modified":"2025-07-27T20:22:25.333711Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/inventorywizard","_minecraft_icon_attachment_id":85890,"_minecraft_imported_at":"2026-06-04T21:43:22+00:00","_minecraft_import_hash":"fc0753e5df7383c1897013fb434670fa","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,91,92],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80],"class_list":["post-85889","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-paper","mod_category-storage","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7"],"yoast_head":"\n