Description (paste this)
ChestAutoSort automatically deposits items from your inventory into nearby containers.
It only puts items into containers that already contain the same item type (so it won’t mess up empty chests by default).
Designed for private servers & friends: owner/party aware, BossBar progress, cooldown, and blacklist support.
Key Features
- Inventory → Nearby Containers auto deposit (NOT “sort chest contents”)
- Match-only rule: puts items only into containers that already have the same item
- Owner / Party aware access
- Uses container ownership tags
- Party members can use each other’s containers
- BossBar progress while scanning/sorting
- Cooldown + single-run lock (prevents spam / overlapping tasks)
- Blacklist support
- Global blacklist (config)
- Per-user blacklist (users.yml)
- Optional hotbar exclusion (can skip hotbar items)
How to Use
- Stand near your storage area
- Press Shift + F
- The plugin scans nearby containers and deposits items automatically
- You’ll see a BossBar progress indicator
Commands
- /cs bl add <MATERIAL|hand> — add item to your blacklist
- /cs bl remove <MATERIAL> — remove item from your blacklist
- /cs bl list — show your blacklist
- /cs bl clear — clear your blacklist
- /cs claimnear <radius> — claim nearby unowned containers as yours (does not overwrite existing owners)
Party Commands
- /sortparty create
- /sortparty invite <player>
- /sortparty accept
- /sortparty leave
- /sortparty disband
- /sortparty info
Admin Commands
- /cs setlevel <level>
Sets the scan level used for auto-deposit (higher level = wider/faster scan depending on your config).
Example: /cs setlevel 3
- /cs setmax <amount>
Sets the maximum number of containers processed per run to control performance.
Example: /cs setmax 80
Permissions
- chestautosort.use — use Shift+F auto deposit
- chestautosort.blacklist — use /cs bl ...
- chestautosort.claimnear — use /cs claimnear ...
- chestautosort.party — use party commands
(If you don’t use a permissions plugin, OP/admin can use everything.)
Compatibility
- Paper / Spigot (recommended: Paper)
- Tested on 1.21.x
- Works with common containers (chest, barrel, etc.)
Notes / Default Behavior
- By default, it does not deposit into empty containers.
- Only deposits into containers you own (or your party owns).
- Blacklisted items will be skipped and reported in the result summary.
Support
If you find a bug, please include:
- server version (Paper/Spigot + MC version)
- plugin version
- console log / error message
- steps to reproduce
