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?

• 📝 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions
• 📖 Documentation: Full README

---

❤️ 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!