?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
ChestSorter

ChestSorter

ChestSort is a Minecraft plugin that allows players to easily sort both container and player inventories by type, amount, category, or randomly with simple commands.

1,201
6

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
1.12.x
1.11.x
1.10.x
1.9.x

Platforms

Links

Report issues View source Visit wiki
Buy Me a CoffeeDonate on PayPalSponsor on GitHub

Creators

Shweit
ShweitMember

Details

Published last year
Updated 2 weeks ago

ChestSorter - The Ultimate Inventory Management Solution

Stop wasting time organizing chests! ChestSorter is a powerful and intuitive plugin that brings automatic chest sorting to your Minecraft Paper server.

✨ Why Choose ChestSorter?

  • 🖱️ Multiple Sorting Methods - Sort chests your way: middle-click, sneak + left-click, or commands
  • ⚙️ Per-Player Customization - Every player can set their own sorting preferences
  • 🎯 Smart & Non-Intrusive - Blacklist specific containers and works alongside client-side mods
  • 🚀 Modern & Fast - Built with Paper 1.21+ APIs for optimal performance
  • 🔧 Highly Configurable - Customize everything from sounds to default behaviors

🎮 Features

🔄 Flexible Sorting Options

Sort your containers in 4 different ways:

  • 📝 By Name - Alphabetical sorting (A-Z or Z-A)
  • 📦 By Quantity - Stack size sorting (largest to smallest or vice versa)
  • 🧱 By Material Type - Group similar items together
  • ⚒️ By Durability - Sort tools and armor by remaining durability

Each sorting method supports both ascending and descending order!

🎯 Multiple Sorting Methods

1. Middle-Click Sorting (In-Container)

  • Open any chest, barrel, or container
  • Middle-click anywhere inside
  • Instant sorting based on your preferences!

2. Sneak + Left-Click (External)

  • Look at a container
  • Sneak + Left-Click
  • Sort without opening the container!

3. Command-Based Sorting

  • Sort specific containers by coordinates
  • Sort player inventories (including others as admin)
  • Override sorting preferences on-the-fly

👤 Per-Player Preferences

Every player can customize their experience:

/sortprefs                    # View your current settings
/sortprefs type QUANTITY      # Sort by stack size
/sortprefs order DESC         # Largest stacks first
/sortprefs toggle             # Disable/enable sorting

Perfect for servers where some players use client-side sorting mods!

🚫 Smart Blacklist System

Prevent specific containers from being sorted:

  • Location-based blacklist - Protect important chests at specific coordinates
  • Container-type blacklist - Automatically exclude hoppers, furnaces, etc.

📋 Commands

Command Description Permission
/sortcontainer (or /sc) Sort the container you're looking at chestsorter.sort.container
/sortcontainer <x> <y> <z> Sort a container at coordinates chestsorter.sort.container
/sortcontainer <x> <y> <z> <type> <order> Sort with specific settings chestsorter.sort.container
/sortplayer (or /sp) Sort your own inventory chestsorter.sort.player.self
/sortplayer <player> Sort another player's inventory (admin) chestsorter.sort.player.others
/sortprefs View your sort preferences (none)
/sortprefs toggle Enable/disable sorting (none)
/sortprefs type <type> Set default sort type (none)
/sortprefs order <order> Set default sort order (none)

🔐 Permissions

Permission Description Default
chestsorter.sort.container Use container sorting ✅ true
chestsorter.sort.player.self Sort own inventory ✅ true
chestsorter.sort.player.others Sort other players' inventories ⚠️ op
chestsorter.sneak.sort Use sneak + left-click sorting ✅ true
chestsorter.middleclick.sort Use middle-click sorting ✅ true
chestsorter.* All permissions ⚠️ op

⚙️ Configuration

Highly customizable via config.yml:

# Default sorting settings
default-sort-type: NAME  # NAME, QUANTITY, MATERIAL_TYPE, DURABILITY
default-sort-order: ASC  # ASC, DESC

# Sound settings
sound:
  enabled: true
  success: ITEM_BOOK_PAGE_TURN
  volume: 0.5
  pitch: 1.0

# Feature toggles
sneak-sort:
  enabled: true
middle-click:
  enabled: true

# Blacklist
blacklist:
  locations: []
  # Example: - "world:100:64:200"
  container-types:
    - "minecraft:hopper"

💡 Use Cases

For Survival Players

  • Quickly organize storage rooms with hundreds of items
  • Sort shulker boxes before long trips
  • Keep your base tidy without the tedious manual work

For Creative Builders

  • Organize massive material collections instantly
  • Sort themed build palettes
  • Manage large-scale project inventories

For Server Admins

  • Give players quality-of-life improvements
  • Reduce server lag from players manually organizing items
  • Fully compatible with existing plugins

🔧 Installation

  1. Download the latest version from this page
  2. Place the JAR file in your server's plugins/ folder
  3. Restart or reload your server
  4. (Optional) Configure settings in plugins/ChestSorter/config.yml
  5. Done! Players can start sorting immediately

📦 Requirements

  • Server: Paper 1.21+ (or Folia 1.21+)
  • Java: Java 21 or higher
  • Dependencies: None (PaperLib is shaded)

🤝 Compatibility

✅ Works With

  • All container types (chests, barrels, shulker boxes, etc.)
  • Hopper systems (with blacklist)
  • Most other plugins
  • Client-side sorting mods (can be disabled per-player)

🐛 Support & Issues

Need help or found a bug?

❤️ Credits

Created by: Dennis van den Brock (@shweit)

🌟 Show Your Support

If you enjoy ChestSorter, please:

  • ⭐ Star the project on GitHub
  • 📝 Leave a review
  • 🐛 Report bugs and suggest features
  • 💝 Consider supporting development

Download now and never manually sort a chest again!