## ChestSorter – Simple Chest Sorting for 1.21.x
Tired of messy chests where everything is all over the place
ChestSorter cleans them up for you
With **sneak + right-click** on a chest, all items are automatically
- merged and fully stacked
- sorted by importance
- arranged in a logical order instead of random chaos
## Features
- ✅ Sort via **sneak + right-click** on any chest
- ✅ Automatically merges identical items into full stacks
- ✅ Sorting order by categories
1. Valuable items like diamonds, netherite, ores and ingots
2. Tools and armor
3. Blocks
4. Other / misc items
- ✅ Within each category items are sorted by material name and stack size
- ✅ No commands required
- ✅ No additional dependencies
- ✅ Very lightweight, perfect even for small servers
## How it works
1. Walk up to a chest
2. Hold **Shift** to sneak
3. **Right-click** the chest
4. ChestSorter will
- read all items from the chest
- merge identical items into max stacks
- sort them by category, name, and amount
- write the result back into the chest
You’ll see a short chat message:
> Chest sorted
## Compatibility
- Minecraft server software
- ✅ Spigot 1.21.x
- ✅ Paper 1.21.x
- Tested on
- 1.21.1
- 1.21.10
Since it only uses the Spigot API, the plugin should also work on future 1.21 patches as long as there are no breaking API changes.
## Installation
1. Download the **.jar** file from the Files tab
2. Drop it into the `plugins` folder of your Spigot or Paper server
3. Restart the server
4. Done
No configuration required
You should see `ChestSorter` in `/plugins` ingame.
## Usage
- Go to any chest
- Hold **Shift** to sneak
- Right-click the chest
- The contents are automatically stacked and sorted
## Commands
This plugin currently uses **no commands**.
Everything is handled through chest interaction.
## Permissions
ChestSorter currently doesn’t use permissions.
Any player who can open a chest can also sort it.
If needed in the future, permissions like these can be added:
- `chestsorter.use`
- `chestsorter.bypass`
## Performance
- Sorting only happens when a player sneak right-clicks a chest
- Only the items of that single chest are loaded, processed and written back
- No background tasks
- Very small CPU impact
Even on busy servers the performance impact is minimal, unless players spam sorting on many chests at once.
## Roadmap
Planned / possible future features
- Optional permissions support
- Configurable sorting categories
- Support for shulker boxes
- Optional item frame mode or hotkey style interaction
## Support
Found a bug or want to request a feature
- Open an issue in the tracker
- Attach log files or error messages if possible
- Include your exact server version and any important plugins you’re running
Enjoy your clean chests 🙂
