Перейти к содержимому
Mineforgian

Chest Sort

A client-side mod to automate the sorting of items to containers using customizable filter lists with the click of a button.

Загрузки
7K
Подписчики
8
Обновлён
9 июля 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 17 февраля 2026 г.

Исходный кодСообщить об ошибке

ChestSort

ChestSort Filtering ChestSort Sorting ChestSort is a Fabric mod for Minecraft 1.21.x & 26.2 that helps you track where items are stored (chests + barrels) and quickly sort items from your inventory into containers using per-container rules.

TL;DR

ChestSort is a lightweight alternative to advanced sorting contraptions that gives you some of the benefits of sorting without even needing to touch redstone, sorting at the click of a button.

Ever had a bunch of chests and barrels and forgot where you put that one item? ChestSort lets you search for an item and see which containers have it, with highlights in the world and UI.

In the early game of Minecraft, you will probably always have a "chest monster" - a big group of chests that you dump items into. Players then start building automatic sorting systems, but these can be complex and require a lot of resources. ChestSort is a lightweight alternative that gives you some of the benefits of sorting without needing to build redstone contraptions, at the click of a button.

You can set up filter rules on each container to specify what items belong there, and then quickly sort matching items from your inventory into the open container with one click.

You can also find pre-made presets for any world on our github.

Features

  • Persistent container database

    • Tracks chests and barrels only.
    • Stores per-container item counts and last-updated timestamps.
    • Database is persistent across restarts.

  • Fast item lookup

    • Search for an item and get a list of containers that contain it.

  • World highlights for find

    • Highlights matching containers in the world after /cs find (outline rendering).

  • In-GUI highlight

    • When you open a chest/barrel that contains your currently searched item, the container is highlighted in the UI.

  • Highlight modes

    • /cs highlights on|off|until_opened controls whether highlights show, and whether they auto-clear after you open a highlighted container.
    • /cs highlights dismiss clears current highlights.

  • Auto refresh on open

    • Whenever you open a chest/barrel, that container’s stored snapshot is automatically refreshed.

  • Per-container filter rules (whitelist + blacklist)

    • Each chest/barrel can have whitelist + blacklist rules based on:
      • explicit item ids (e.g. minecraft:cobblestone)
      • item tags (e.g. #minecraft:logs) with per-tag exceptions
      • applied presets (reusable saved rule sets)
    • If an item matches both whitelist and blacklist, you can choose which side wins via a per-container priority toggle.

  • One-click Sort

    • When a container has any rules, a Sort button appears.
    • Clicking Sort moves matching items from your inventory into the open container.
    • Items matching the blacklist are not moved (unless whitelist is set to win conflicts).

  • Sort feedback + Undo

    • After Sort/Autosort/Organize, a left-side notification shows what moved/changed.
    • Includes an Undo button to revert the most recent operation.

  • Autosort modes

    • Per-player autosort mode (never, selected, always) plus a per-container autosort toggle.

  • Organize

    • An Organize button rearranges the open container to pack stacks and group items.

  • Preset editor + import/export

    • Edit presets in a dedicated UI.
    • Presets support Whitelist/Blacklist tabs (same as containers).
    • Import/export presets as shareable cs2| strings (includes blacklist data).

  • Wand (region bulk edit)

    • Bind any item as a wand and select a region:
      • Left-click sets pos1
      • Right-click sets pos2
    • The selection is highlighted in-world and shows the region block count and container count.
    • Bulk-apply filters/autosort in the selected region.

Commands

All commands are under /cs.

  • /cs help

    • Shows an in-game help page describing the UI and command usage.

  • /cs scan

    • Scans loaded chunks for chests and barrels, recording their contents into the database.
    • Records the time the scan occurred.

  • /cs find <item>

    • Finds which scanned containers contain the specified item.
    • <item> supports autocomplete.
    • Remembers the item you’re “finding” so the GUI highlight can trigger when you open matching containers.

  • /cs autosort <never|selected|always>

    • Sets your per-player autosort mode.

  • /cs highlights <on|off|until_opened|dismiss>

    • Controls how highlights behave for you.

  • /cs tags <item>

    • Prints the tags for a given item (useful for building tag filters).

  • /cs blacklist ...

    • Prevents blacklisted items from being moved by Sort/Autosort.
    • add <item> / remove <item> / list / clear
    • addPreset <name> <blacklist|whitelist|everything> (adds items from a preset’s blacklist, whitelist, or both)

  • /cs presets ...

    • Manage presets:
      • add <name> / remove <name> / rename <old> <new> / edit <name> / list
      • import / export <name> / exportAll / exportSelect

  • /cs wand ...

    • Region selection + bulk operations (loaded chunks only):
      • bind (binds your current main-hand item)
      • unbind (removes the wand binding)
      • deselect (clears pos1/pos2 selection)
      • copy [pos] (copies the filter from a targeted container into a clipboard)
      • paste (applies clipboard filter to all containers in the region)
      • autosort <on|off> (bulk toggle per-container autosort)
      • clear (clears filters in the region)
      • merge (unions all filters in the region into the clipboard)

Container Filter UI

  1. Open a chest or barrel.
  2. Click Filter on the right side of the container screen.
  3. Use the left panel to view what’s applied:
  • Filter Items
  • Filter Tags (with exceptions)
  • Filter Presets
  1. Use the left header tabs to switch between Whitelist and Blacklist.
  2. If you use both tabs, set the conflict priority (which side wins when an item matches both).
  3. Use the right panel search:
  • type text to search for items
  • type #something to search tags
  • type &name to search presets
  1. Click the green + to add rules, red x to remove.
  2. If the filter rules are non-empty, click Sort to move matching items from your inventory into the container.

Organize:

  • Click Organize to pack and group the open container.

Undo:

  • After Sort/Autosort/Organize, use the Undo button to revert.

Autosort:

  • The filter UI includes an Autosort toggle for the current container.
  • Autosort behavior depends on your /cs autosort mode.
  • When autosort triggers, it automatically moves matching items from your inventory into the container whenever you open it.

Notes:

  • The filter is stored per container position + dimension.
  • The mod only targets chests and barrels.

Installation

  1. Install Fabric Loader for Minecraft 1.21.11.
  2. Install Fabric API.
  3. Put the built mod jar into your mods/ folder.

Development

  • Minecraft: 1.21.11
  • Yarn mappings: 1.21.11+build.4
  • Fabric Loader: 0.18.4
  • Fabric API: 0.141.3+1.21.11
  • Java: 21

Notes to Scanning

  • /cs scan scans loaded chunks only (it does not force-load chunks), meaning it doesn't necessarily see all containers in the world.
  • The mod relies on players to run /cs scan after placing containers or loading new chunks; the data may be inaccurate until a scan is performed. The mod, however, automatically detects new containers or changes to container contents when you open them.

Notes to Sorting

  • Sorting only moves items from your inventory into the open container; it does not move items between containers or from the container into your inventory.
  • Some servers may consider this an unfair advantage or game modification, and this may flag the anti-cheat as putting items into a container sends multiple packets in quick succession. Use with caution on multiplayer servers.

Ченджлог

2Релиз26.2 · 9 июля 2026 г.

ChestSort Changelog

v2-alpha to v2


FEATURES
  • Updated to Minecraft 26.2.
  • ChestSort is now fully client-only. The mod no longer needs to be installed on the server at all - singleplayer and multiplayer now behave identically, and everything (sorting, filters, presets, autosort, wand, find) works the same whether or not the server has ChestSort.
    • Sort and Organize run entirely via vanilla click packets (QUICK_MOVE / PICKUP), same as before, but no longer fall back to a server payload path.
    • Container filters, autosort, and the item blacklist are all stored and applied locally.
    • Presets and global settings (autosort mode, highlights mode, blacklist) are shared across every world/server you play on.
    • Per-container data (filters, autosort flags, the find index) is now scoped per world/server, so two unrelated worlds that happen to share block coordinates no longer collide.
  • Added /cs presets create, which opens a GUI with a name field and an items field to build a preset from a pasted item/tag list without hitting chat's text length limit.
  • Added @presetName as an alias for &presetName when searching - typing either now adds/references a preset.
  • Presets can now reference other presets. The preset editor's search field supports @/& preset search with autocomplete, same as the container filter UI already did.
  • Re-added the full /cs command set as client-only commands (never sent to the server): help, autosort, highlights, tags, blacklist, scan, find, presets, and wand.
    • /cs find and /cs scan now report containers you've personally opened (there's no server to run a world-wide scan for you).
    • /cs wand paste/clear/autosort/merge operate over currently loaded chunks, same as before.
    • /cs wand copy no longer accepts an explicit block position argument - only "look at the container" is supported.
CHANGES
  • Double chests are now correctly treated as a single container. Previously each half was tracked separately, so a double chest could end up with two different filters depending on which half you clicked.
  • Autosort is now purely a client preference: toggling it on a container no longer depends on any server-side support, and it re-triggers a normal (client-only) sort every time that container is opened.
  • The Sort/Organize result summary (left panel) is now generated locally when an action finishes, instead of waiting on a server response.
  • The client-only Sort action now re-checks each item right before moving it instead of trusting a snapshot taken before the batch started, fixing a bug where an earlier move's side effects (stack merging) could cause the wrong item to get swept into the container.
BUGFIXES
  • Fixed tag search autocomplete not returning any results in the container filter UI and the preset editor.
  • Fixed the preset editor, preset import/export, and preset list screens showing text but no visible buttons or text fields.
  • Fixed /cs presets commands that open a GUI (create, edit, import, export, exportSelect, exportAll) not actually opening the screen.
  • Fixed importing a filter, or adding/removing a preset via the &/@ search shortcut, not saving.
  • Fixed a container filter occasionally reverting to a previously opened container's filter after some time, even without closing the chest.

2-alphaАльфа1.21.9, 1.21.10, 1.21.11 · 24 марта 2026 г.

ChestSort Changelog

v1.1.0 to v1.1.1

  • ATTN: This version is combined with v2.

FEATURES
  • Added /cs blacklist mode <preventSort|strictPreventSort|preventEntry|strictPreventEntry> to configure how the global blacklist interacts with sorting and container entry.
    • preventSort: prevents blacklisted items from being moved by Sort/Autosort unless the item is whitelisted and whitelist wins priority
    • strictPreventSort: like preventSort, but blacklist always wins (ignores whitelist priority)
    • preventEntry: prevents blacklisted items from being put into the container unless the item is whitelisted and whitelist wins priority
    • strictPreventEntry: like preventEntry, but blacklist always wins (ignores whitelist priority)

ChestSort Changelog

v1.1.1 to v2-alpha


FEATURES

  • Added client-only sorting fallback for servers without ChestSort installed.

    • Uses vanilla inventory click packets (shift-click / QUICK_MOVE) instead of custom payloads.
    • Sorting actions run over time (queued per tick) to reduce desync and packet spam.

  • Added client-only Organize fallback for servers without ChestSort installed.

    • Uses vanilla clickSlot packets (PICKUP) to merge stacks and compact the open container.
    • Also runs as a paced per-tick action queue.

  • Added per-container filter persistence on unmodded servers.

    • Container filters are saved client-side keyed by dimension + chest coordinates.
    • Filters now load automatically when you reopen the same chest/barrel.

  • Added client-local preset persistence for servers without ChestSort installed.

    • Importing a preset (or presetList) stores it locally even if the server cannot accept preset payloads.
    • Preset edits are saved locally as well.

  • Added safe networking: ChestSort custom payloads are only sent when the server advertises support.

    • Prevents disconnects/kicks caused by sending unknown custom payloads to unmodded servers.

  • Improved multiplayer usability: the ChestSort GUI now shows reliably for vanilla containers.

    • The UI no longer depends on receiving a server context packet to appear.
CHANGES
  • Client-side filtering now supports tag search suggestions again (tag autocomplete uses the proper registry tag stream).
  • Client-only mode uses separate action queues to prevent conflicting automation (e.g., Sort and Organize running at the same time).
NOTES
  • Autosort still requires server support (it needs the server to enforce and apply the rule while items are inserted).
  • Client-only Organize/Sort are best-effort on laggy servers and can be slower on large containers because actions are paced per tick.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 22 февраля 2026 г.

ChestSort Changelog

v1.0.0 to v1.1.0


FEATURES
  • Added slot locking, go into any container and toggle the "Lock Slots" button to lock down slots for your tools & items by clicking in your inventory that you don't want to accidentally move around.
  • Added export type "presetList" to export multiple presets in one string, which can be imported by other players. This change did not affect the existing "preset" export format.
  • Added /cs presets exportAll to export all presets in a presetList format.
  • Added /cs presets list to list all presets with their names and sizes.
  • Added /cs presets exportSelect with a GUI to select which presets to export.
  • Added per-container Whitelist/Blacklist filter tabs.
  • Added a per-container conflict priority toggle to choose whether whitelist or blacklist wins when both match.
  • Added Whitelist/Blacklist tabs to the preset editor (presets now carry their own blacklist rules too).
  • Added /cs blacklist addPreset <name> <blacklist|whitelist|everything> to populate your global blacklist from preset rules.

CHANGES
  • Export strings now use "|" instead of ":" to separate fields, to avoid issues with tokens that contain ":" (e.g. item IDs, tag IDs).
  • Preset export/import strings now support including a preset blacklist section (separated with ~), while remaining compatible with older whitelist-only strings.
  • Fixed a bug where imported presets would be named "Imported" instead of using the name specified in the export string.
  • Made the mod compatible with all versions of Minecraft 1.21.x. The mod should now work on any 1.21 version, but is only tested on 1.21.11.

REMOVED
  • Removed back compatibility support for an unused export format that was accidentally included in v1.0.0, which is the base64 JSON format.

Комментарии

Загружаем…