SimpleAutoSort

# 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. !(https://img.shields.io/badge/Version-1.0.0-blue) !(https://img.shields.io/badge/Minecraft-1.21+-green) !(https://img.shields.io/badge/License-MIT-yellow) ## 🌟 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 pre