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.

🌟 Key Features

- Container Support - Sort by name, type, amount, or rarity - Container Support - Shift+Click, Right-Click, and Middle-Click sorting options - Container Support - Automatically stack similar items when sorting - Container Support - Optional automatic sorting when opening containers - Container Support - Prevents spam sorting with configurable delays - Container Support - Customizable sounds and messages for sorting actions - Container Support - Disable sorting in specific worlds - Container Support - 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 + Right-Click (empty slot) - Sort chest contents - Shift + Right-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

- Supported Containers: Paper, Spigot, or Bukkit - Supported Containers: 1.21+ (API Version 1.21) - Supported Containers: 21 or higher - Supported Containers: None required - Supported Containers: Chest, Barrel, Hopper, Dispenser, Dropper, Shulker Box, Ender Chest

🔧 Installation

1. Test AutoSort plugin jar file 2. Test your server 3. Test the plugin in your `plugins/` folder 4. Test your server to generate default configuration 5. Test `config.yml` to your preferences 6. Test 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 + Right-Click on an empty slot to sort - Shift + Right-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

- Reverse Mode - Alphabetical organization - Reverse Mode - Group by material type - Reverse Mode - Sort by stack size - Reverse Mode - Valuable items prioritized - Reverse Mode - Flip any sorting order

Container Support

- Special Containers - Regular and trapped chests - Special Containers - Barrels, shulker boxes - Special Containers - Hoppers, dispensers, droppers - Special Containers - Ender chests and more

Smart Features

- Sound Feedback - Combines partial stacks automatically - Sound Feedback - Prevents server lag from spam - Sound Feedback - Secure access control - Sound Feedback - Disable in creative/spawn worlds - Sound Feedback - Audio confirmation of successful sorts

🛡️ Security & Performance

- Cooldown System - Minimal server impact - Cooldown System - Stable multi-player usage - Cooldown System - Graceful failure recovery - Cooldown System - Secure command execution - Cooldown System - Prevents abuse and lag

💝 Support Development

If you find AutoSort helpful: - ⭐ Write reviews the plugin on Modrinth - 💬 Write reviews with other server owners - 💡 Write reviews for future updates - 📝 Write reviews to help others discover AutoSort

📞 Support & Community

- Compatibility: Report bugs and request features on GitHub - Compatibility: Complete setup guides and examples - Compatibility: 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