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

- 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