Unpacker » Auto sort inventory into chests!

You get back from mining with a full inventory. You stand in your storage room and type /unload. Every stack that one of your chests already has some of goes into that chest. Everything else stays with you.

There is nothing to set up. No signs, no filters, no naming chests. If a barrel already has cobblestone in it, that is where your cobblestone goes. Your chests are the settings.

Still holding junk you have no chest for? /dump does the same pass, then pushes whatever is left into the nearest chests until you are empty or they are full.

Your hotbar is left alone unless you say otherwise, so your pickaxe, food and torches stay exactly where you put them.


✨ What it does

• /unload only puts things where they belong. A chest has to already hold that kind of item before anything goes in.
• /dump clears out the rest. It unloads first, then fills the nearest chests with whatever is left over, closest first.
• Your hotbar stays yours. Only the main part of your inventory gets emptied. Armour and your off-hand are never touched. Each command remembers whether you wanted your hotbar included.
• Keep-out list. Name the things you never want moved: your totem, your torches, your food. Remove them again with a click from the list in chat.
• /searchitem finds things again. Ask which chests nearby have an item and how many. Chests you are not allowed to open never show up.
• You can see what happened. A tidy summary in chat of what went where, a puff of particles over every chest that got something, and beams pointing at them. Only you see any of it, and /unloadinfo replays it whenever you like.
• It respects your protection plugin. If WorldGuard, GriefPrevention, Towny, Lockette or anything similar would stop you opening a chest by hand, Unpacker will not put anything in it either. It only asks about chests it is genuinely about to use, so a big storage room does not slow anything down.
• Bigger reach for donors or staff. Set different distances per rank.
• Double chests count once. One chest, one puff of particles, and both halves get checked even if only one half is in range.
• You pick what counts as storage. Chests, trapped chests, barrels, shulker boxes and copper chests to begin with. Things like furnaces and brewing stands can be searched but never filled, since dropping any old item into a fuel slot is not something the game would let you do either.
• Item names are forgiving. minecraftak_log, oak_log and OAK_LOG all work, in commands and in the config.
• Reword anything. Every message the plugin sends lives in one file, with full colour, gradients, hover text and clickable text.

Version 1.0.0 does not hook into any other plugins. The groundwork is there for sorting, logging and custom-item plugins to be added later, but nothing is wired up today.


⌨️ Commands and permissions

Every command also works under /unpacker, so if you would rather hand out one command than six, hand out that one.

• /unload Put matching items into nearby chests. Add a number for a different distance. unpacker.unload, on by default
• /dump Unload first, then push the leftovers into the nearest chests. unpacker.dump, on by default
• /searchitem Find which chests have an item, and how many. Takes an item and a distance, either order. unpacker.search, on by default
• /unloadinfo Replay the last summary and point the beams again. Takes a number of seconds. unpacker.info, on by default
• /ublacklist Add, remove, list or clear your keep-out list. unpacker.blacklist, on by default
• /unpacker reload Re-read the three settings files. unpacker.reload, op only

Shorter names: /ul and /unloadinv for unload, /invdump and /dumpinv for dump, /uli and /dumpinfo for unloadinfo, /chestsearch and /usearch for searchitem.

A fresh install works for everybody straight away. If you would rather it were a perk, take unpacker.use and unpacker.search away from your default rank and give them out where you want them. unpacker.admin covers everything including reload, and unpacker.group.<name> is what gives a rank its own distance settings.

Type hotbar as the first word after /unload or /dump to include or exclude your hotbar.

/blacklist is deliberately left alone. That name belongs to ban plugins, and a storage plugin quietly stealing it is a support ticket waiting to happen. Use /ublacklist instead.


✅ What you need

• Paper 1.20.6 or newer, right up to 26.2. One jar covers the lot.
• Java 21 or newer.
• Spigot will not work. Unpacker needs Paper.
• Folia is not supported.

Nothing is bundled inside the jar but Unpacker itself.


⚙️ Settings

Three files in the plugins/Unpacker folder, and /unpacker reload re-reads all three.

• config.yml How far it reaches, how fussy item matching is, which blocks count as storage, the cooldown, the protection check, and the chat, particle, beam and sound feedback.
• messages.yml Every line of text the plugin says. Anything you have not changed is topped up automatically when you upgrade.
• groups.yml Longer reach per rank. Ships with the examples commented out, and never gets overwritten.

By default it reaches 10 blocks and nobody may ask for more than 20. Raise it per rank like this:

Item matching is relaxed to begin with, so a chest of oak logs will take your oak logs whatever they are called. Tighten it if custom items on your server share a base item and you need them kept apart.

If you mistype a particle or a sound, Unpacker tells you once when it loads, says what it used instead, and carries on. One wrong line switches off one effect. It never takes the plugin down.

The fully commented version of all three files is in the README.


⚡ Installing it

1. Drop the jar in your plugins folder.
2. Start the server.
3. Stand in your storage room and type /unload.