## 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 🙂

Chest Sorter