Sorted

Client-side inventory sorting with chest memory and quick stack.

Fabric · NeoForge via Sinytra Connector · Client-only · 1.21–1.21.3 · 1.21.10–1.21.11 · 26.x

---

Your inventory gets messy. You open chests looking for things you put somewhere. You manually move stacks around you already have in a nearby barrel.

Sorted handles all of that. It sorts your inventory with a real layout in mind, remembers what's in every chest you've opened, and lets you push/pull items across nearby containers in one button press.

• Auto-sort on pickup — items land in the right place the moment you pick them up
• Zone layout — gear and tools first, then food, then building blocks, then everything else — same order every time
• Hotbar stays put — sorting only rearranges your main inventory; your hotbar gear is never touched
• Sort buttons — sort your inventory or any open chest with one click
• Quick Stack — deposit matching items into nearby containers in one keybind (Terraria players, this one's for you)
• Quick Empty / Fill / Pull — dump your bags, top up partial stacks, or pull a whole chest to your inventory
• Keep what you need — Alt+Click an item so it's never sent to a chest, or Alt+Scroll to keep a set number of stacks of it
• Chest knowledge — remembers what's in every chest you've opened, persists across restarts
• Container search — find any item across every container you've opened: name, total, and the nearest one with its distance, all in the row — or switch to a grid of cards if you'd rather scan than read
• Find it in the world — open a result to see every chest holding it, click one to light it up through walls
• Container labels — nearby chests, barrels, and shulker boxes show their contents (and custom name) floating right on top — see inside without opening
• Vanilla button frames — buttons sit in vanilla widget frames, so any resource pack that restyles buttons restyles these too
• Server-friendly — a built-in block list that disables the mod entirely on servers that ban automation, plus an adaptive throttle that lowers its action rate per server if a kick lands mid-sort
• Client-only — no server mod needed; works on vanilla servers, Realms, and most modpacks

---

Chest knowledge

Open a chest once and Sorted records its contents — persistently, in a local database per world/server. That data survives restarts. Type an item name into the search and every result says the total and the nearest container holding it, with the distance; open one to see every container with its own count.

The cache invalidates itself. Broken container? Entry dropped. Chunk loads? It re-checks. Data reflects the last time you opened each container — it updates the moment you open one again.

Click a container in a result and Sorted highlights it in the world — even through walls — so you walk straight to it.

See inside without opening

Glance at a shulker box, barrel, or chest and its contents sit right on the lid — a small grid of the items inside, plus the container's custom name if you've renamed one. No opening, no hovering, no menus.

The label lies flat on the face the lid opens from, so it reads right whether a shulker sits on the floor, hangs from the ceiling, or is stuck to a wall — and on top/bottom lids it turns to face you. You choose what shows — just the items, just the name, both, or the name only when a container is empty — plus how many items, how far away labels appear, and which container types get them (shulker boxes on by default; chests and barrels opt-in).

In singleplayer the contents are read live. On servers they come from what Sorted has already recorded, so a container fills in the first time you open it (or let auto-scan read it for you).

Sorting with a real layout

Not alphabetical. Not random. There's a consistent layout, applied top-to-bottom across your main inventory:

• Weapons, tools, and armor sort to the top
• Food and consumables come next
• Building blocks fill the middle, grouped by material and dimension
• Everything else lands at the bottom

Your hotbar is left alone — sorting only rearranges the main inventory, so your active gear and quick-slots stay exactly where you put them. Pick something up — it sorts itself in. Open a chest — sort button's right there. Same rules everywhere.

Shulker boxes get sorted too — each one slots in next to its primary item, so a box of redstone lands with your redstone.

Quick Stack

One keybind. Every item in your inventory that already has a matching stack in a nearby container gets deposited there. If you've played Terraria you know exactly what this button does. Quick Empty, Quick Fill, and Pull All round out the set — dump your bags, top up partial stacks, or pull a chest into your inventory.

Keep what you need

Quick Empty is enthusiastic. Sometimes too enthusiastic — press it and your rockets, your food and your torches all end up in a chest.

Alt+Click an item and it stops being sent to containers. Alt+Scroll instead and you get a number: keep 2 stacks of rockets, and only what's above 2 ever leaves. Rules follow the item, not the slot, so sorting can't shake them loose.

Hold Alt — or hover Quick Stack — and a marker shows which stacks are being held back. Let go and it's gone; nothing sits on your slots permanently.

/sorted keep opens the editor: every rule as a row, with what it's holding back right now and buttons to change it. Type to filter, or to add something you aren't carrying. Share turns the list into one code you can paste into Discord — it carries check digits, so a truncated copy is refused rather than importing half a list.

Controls

Keybinds — all rebindable in Options → Controls

`	Open the container search
R	Sort your inventory
unbound	Open the keep list

In an inventory screen — clicks and modifiers

Click a sort button	Compact layout
Shift+Click	Category columns
Ctrl+Click	Category rows
Alt+Click an item	Keep it — never sent to a container
Alt+Scroll an item	Keep a number of stacks of it
Hold Alt	Show which stacks are being held back

Commands

/sorted config	Settings — works with or without Mod Menu
/sorted keep	The keep list editor
/sorted menuguard [on|off|status]	Per-server guard against sorting plugin GUIs

UI that belongs in the game

Every button — sort, quick stack, quick empty, quick fill, search — appears directly inside inventory and container screens, in vanilla button frames, so a resource pack that restyles buttons restyles these too. The icons on them, and the keep marker on your slots, are sprites in the mod's own atlas, so packs can override those as well.

Safe on servers

Sorts and transfers run as a queue of slot-clicks rather than all in one burst — by default ~80 actions/sec.

If a server kicks you while a sort or transfer is running, Sorted takes the hint: it steps that server's action rate down a notch (80 → 40 → 20 → 10 → 5 per second) and remembers it, so next time it starts slower and keeps adjusting until the kicks stop. Only server-initiated disconnects that land mid-sort count — a normal "Disconnect", an AFK kick, or a ban won't drag your rate down. Learned rates are per-server, persist across sessions, shown on rejoin, and resettable in the config. You can also pin a manual rate yourself if you'd rather not rely on the learning.

Some servers prohibit inventory automation outright. Sorted ships with a built-in block list covering servers where it fully disables itself on connect — no buttons, no keybinds, no cache updates, nothing. Same as not having the mod installed, just on those specific servers.

---

Installation

• Fabric
• Fabric API
• YACL (required — the settings screen is built on it)
• ModMenu (optional — adds a config button to the mods list)

On NeoForge, the same jar runs under Sinytra Connector with Forgified Fabric API in place of Fabric API.

Client-side only. No server component. Works on vanilla servers, Realms, and modpacks.

Version support

Actively tested: 1.21.11 and 26.2, on Fabric. Those are the two that get played before a release goes out.

Everything else is built from the same source and expected to work, but is not actively tested — 1.21–1.21.3, 1.21.10, 26.1–26.1.2, and NeoForge under Connector on any of them. Bugs there are still bugs and still get fixed; they just aren't caught before you find them, so a report is genuinely useful.