# AutoSort 📦 A powerful and intuitive chest sorting plugin that automatically organizes your inventory with customizable hotkeys, multiple sort types, and advanced filtering options for Minecraft servers.    ## 🌟 Key Features - **Multiple Sort Types** - Sort by name, type, amount, or rarity - **Flexible Hotkeys** - Shift+Click, Right-Click, and Middle-Click sorting options - **Smart Stacking** - Automatically stack similar items when sorting - **Auto-Sort on Open** - Optional automatic sorting when opening containers - **Cooldown System** - Prevents spam sorting with configurable delays - **Sound & Visual Feedback** - Customizable sounds and messages for sorting actions - **World Restrictions** - Disable sorting in specific worlds - **Permission-Based** - Fine-grained control over who can use features - **Container Support** - Works with chests, barrels, hoppers, dispensers, and more ## 📋 Commands ``` /autosort help - Show help message and available commands /autosort sort - Sort the currently open chest /autosort info - Display plugin information and settings /autosort reload - Reload plugin configuration /autosort toggle <setting> - Toggle specific plugin settings ``` **Available Toggle Settings:** - `enabled` - Enable/disable the entire plugin - `shift-click` - Toggle shift-click sorting - `right-click` - Toggle right-click sorting - `auto-sort-on-open` - Toggle automatic sorting when opening chests **Command Aliases:** `/asort`, `/sort` ## ⌨️ Hotkeys - **Shift + Left-Click** (empty slot) - Sort chest contents - **Middle-Click** (empty slot) - Sort chest contents - **Shift + Right-Click** (chest block) - Sort chest from outside ## ⚙️ Configuration ```yaml # AutoSort Plugin Configuration settings: # Enable/disable the entire plugin enabled: true # Sort Types: name, type, amount, rarity sort-type: "name" # Reverse the sorting order reverse-sort: false # Sorting Methods shift-click-sort: true # Shift + Left-Click on empty slot right-click-sort: true # Shift + Right-Click on chest block command-sort: true # /autosort sort command auto-sort-on-open: false # Auto-sort when opening chest # Item Management stack-similar-items: true # Stack similar items together move-to-top: false # Move sorted items to top # Cooldown in seconds (prevents spam) cooldown: 1.0 # Sound and Visual Feedback play-sound: true sort-sound: "BLOCK_CHEST_CLOSE" send-message: true # World Restrictions disabled-worlds: [] # Plugin Messages messages: sort-success: "&aChest sorted successfully!" no-permission: "&cYou don't have permission to use AutoSort!" reload-success: "&aAutoSort configuration reloaded!" cooldown: "&cPlease wait before sorting again!" # Rarity-based Sorting Priorities rarity-priorities: NETHERITE_BLOCK: 100 DIAMOND_BLOCK: 90 EMERALD_BLOCK: 85 GOLD_BLOCK: 80 # ... and many more items ``` ## 🔒 Permissions ```yaml permissions: autosort.*: description: "Full AutoSort permissions" default: op children: autosort.use: true autosort.command: true autosort.reload: true autosort.use: description: "Basic permission to use sorting functionality" default: true autosort.command: description: "Permission to use AutoSort commands" default: true autosort.reload: description: "Permission to reload AutoSort configuration" default: op ``` ## 💻 Requirements - **Server Type:** Paper, Spigot, or Bukkit - **Minecraft Version:** 1.21+ (API Version 1.21) - **Java Version:** 21 or higher - **Dependencies:** None required - **Supported Containers:** Chest, Barrel, Hopper, Dispenser, Dropper, Shulker Box, Ender Chest ## 🔧 Installation 1. **Download** AutoSort plugin jar file 2. **Stop** your server 3. **Place** the plugin in your `plugins/` folder 4. **Start** your server to generate default configuration 5. **Customize** `config.yml` to your preferences 6. **Reload** with `/autosort reload` or restart server 7. **Test** sorting functionality in-game ## 🎮 Usage Examples ### Basic Sorting ``` /autosort sort - Sort your currently open chest /autosort toggle enabled - Enable/disable the plugin /autosort info - View current plugin settings ``` ### Hotkey Usage - Open any supported container (chest, barrel, etc.) - **Shift + Left-Click** on an empty slot to sort - **Middle-Click** on an empty slot to sort - **Shift + Right-Click** on chest block from outside to sort ### Advanced Configuration - Set `sort-type` to "rarity" for valuable items first - Enable `auto-sort-on-open` for automatic sorting - Adjust `cooldown` to prevent sorting spam - Add world names to `disabled-worlds` to restrict usage ## 📊 Features Overview ### Sorting Options - **Name Sorting** - Alphabetical organization - **Type Sorting** - Group by material type - **Amount Sorting** - Sort by stack size - **Rarity Sorting** - Valuable items prioritized - **Reverse Mode** - Flip any sorting order ### Container Support - **Chests** - Regular and trapped chests - **Storage Blocks** - Barrels, shulker boxes - **Redstone Containers** - Hoppers, dispensers, droppers - **Special Containers** - Ender chests and more ### Smart Features - **Item Stacking** - Combines partial stacks automatically - **Cooldown Protection** - Prevents server lag from spam - **Permission Integration** - Secure access control - **World Restrictions** - Disable in creative/spawn worlds - **Sound Feedback** - Audio confirmation of successful sorts ## 🛡️ Security & Performance - **Lightweight Design** - Minimal server impact - **Thread-Safe Operations** - Stable multi-player usage - **Error Handling** - Graceful failure recovery - **Permission Checks** - Secure command execution - **Cooldown System** - Prevents abuse and lag ## 💝 Support Development If you find AutoSort helpful: - ⭐ **Rate** the plugin on Modrinth - 💬 **Share** with other server owners - 🐛 **Report issues** on our GitHub - 💡 **Suggest features** for future updates - 📝 **Write reviews** to help others discover AutoSort ## 📞 Support & Community - **Issues:** Report bugs and request features on GitHub - **Documentation:** Complete setup guides and examples - **Updates:** Regular releases with improvements and new features - **Compatibility:** Maintained for latest Minecraft versions --- Made with ❤️ for server administrators who value organization | Perfect for survival servers, creative builds, and storage management