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

# 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

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