Mods / AutoSort

Tags:
Utility Storage QoL Automation
Author:
roquess
Side:
Both
Created:
Jun 7th at 3:59 AM
Last modified:
Jun 24th at 4:26 PM
Downloads:
978
Recommended download (for Vintage Story 1.19.0-pre.0 - 1.22.3):
autosort_0.1.4.zip  1-click install

Automatic chest sorting for Vintage Story. Drop everything into one chest, close it, and AutoSort tidies each container and routes every item to the right chest across your whole storage room.

Features

  • Sort on close — closing a chest you changed re-sorts the network. It's idempotent: an already-sorted chest never reshuffles.
  • Semantic grouping — items are classified into 17 categories (weapons, tools, armor, food, materials, mechanical parts, etc.) and laid out top-to-bottom, left-to-right.
  • Variant clustering — every variant of an item stays together (all gears, all planks, all fruit…).
  • Cross-chest consolidation — one item type ends up in one chest, overflowing to the next only when it's full.
  • One virtual storage — connected nearby containers are treated as a single inventory. With room detection (on by default), a closed door keeps two storage rooms separate.
  • Chests and jars stay separate — never mixed.
  • /sort overlay — an optional read-only HUD showing the contents of the container you're looking at, mirroring the real GUI and updating in real time.

Commands

  • /autosort (alias /sort) — toggle the overlay
  • /autosort show / /autosort hide (also on / off)

Installation — important

  • Server: required. Install the mod on the server — this enables the sorting for everyone, including players who don't have the mod.
  • Clients: optional but needed for the overlay. The /sort HUD is client-side, so each player who wants it must also install the mod on their own client. Players without it still benefit from the server-side sorting; they just won't see the overlay.

Fully configurable via ModConfig/autosort.json (radius, room restriction, specialisation threshold, supported container types…).

Open source (MIT) — https://github.com/Los-Albatros/autoSortVintageStoryMod

Mod Version Mod IdentifierFor Game version Downloads Released Changelog Download 1-click mod install*
0.1.4 autosort
1.19.0-pre.0 - 1.22.3
280 Jun 24th at 4:26 PM autosort_0.1.4.zip 1-click install

## 0.1.4

**New**
- **Wooden trunks** are now recognised as sortable containers.
- **Container-group editor** added to the in-game config screen (ConfigLib): edit which
container kinds are grouped together, right from the settings UI.
- **Crates** are treated as single-type sticky containers, so a crate keeps its one item
kind instead of being mixed.
- Backpack sorting is re-hooked for every online player when the option is enabled, not
just on next join.

**Fixes**
- Trunks opened via their other multiblock half now sort correctly; collapsed/ruined
trunks are left alone.
- Corrected multiblock filler → principal block resolution, so the right inventory is
targeted.
- Restored the container-kind guard at hook time and tightened multiblock candidate
checks (no more sorting the wrong block).
- Config UI no longer resets settings to defaults when saving.

**Internal**
- Extracted `ContainerGroupCodec` for container-group wire encoding, with added unit
tests for container recognition and grouping.

Thanks to @AJIADb9 (Kirill) for the contributions.

0.1.3 autosort
1.19.0-pre.0 - 1.22.3
256 Jun 14th at 4:50 AM autosort_0.1.3.zip 1-click install
## 0.1.3
 
**Fixes**
- **Trait-aware merging.** Stacks that share an item code but differ in hidden traits —
different-genetics cuttings & runners, filled crocks, partially-used tools — are no
longer merged into one stack. Prevents items being silently lost or duplicated when
containers are consolidated.
- **Runners** are now classified as propagation/seed items, so they sort together with
cuttings.
 
**Improvements**
- **Family-based spread layout.** The "valence" layout now groups items by family
(base name), so related variants (e.g. all currant cuttings) stay together instead of
peeling off into separate vessels.
- **Sticky container ownership.** A chest or vessel that already held a family keeps it
across re-sorts, so established specialist containers no longer swap their contents
during a full-room relayout.
 
**Internal**
- Unit test suite migrated to the new stack model and moved into the repo; added
GitHub Actions CI that builds and runs the tests on every push and pull request.
 
Thanks to @AJIADb9 (Kirill) for the contributions.
0.1.2 autosort
1.19.0-pre.0 - 1.22.3
167 Jun 10th at 3:00 AM autosort_0.1.2.zip 1-click install

v0.1.2

  • Proper per-room sorting. Each room is found by flooding its open space from the closed chest, stopping at walls, doors and stairs. A cellar/fridge behind its door no longer mixes with the outside, and a hall of any size is fully covered. Open or oversized areas only sort the chest you closed (a Carry-On or dungeon chest won't dump into nearby containers).
  • Consistent network. Closing any chest in a room now sorts the exact same set of containers (fixed a case where some chests pulled a smaller network than others).
  • "Valence" layout (default). Each distinct item gets its own chest, spreading across as many chests as the room offers; when there are more items than chests they fill up evenly (2, then 3 per chest), grouped by family. CompactRoom = true keeps the old dense packing.
  • One sort per session. Closing several chests in a row triggers a single room sort after a short debounce instead of a heavy sort per chest (no more server lag spikes).
  • Read-only containers protected. Collapsed/ruined trunks and any retrieve-only loot container are never touched.
  • Backpack sorting off by default, and the player inventory is never reshuffled unless you opt in.
  • Storeys are separated by solid floors/ceilings and stairs/ladders.
  • Cleanup: removed obsolete room options; sorting needs no tuning out of the box.
0.1.1 autosort
1.19.0-pre.0 - 1.22.3
72 Jun 9th at 6:12 AM autosort_0.1.1.zip 1-click install

v0.1.1

New features

  • In-game settings screen (ConfigLib). If ConfigLib is installed, AutoSort adds a settings panel: a per-player /sort overlay switch for everyone, plus an admin section to tune the sorting and edit the list of sorted container types. The list auto-discovers containers from every loaded mod. Available in English and French.
  • Room compaction (CompactRoom, on by default). The room's containers are packed from a stable reference — the room's door, or a fixed corner with several doors, or the lowest container in open areas. Chests fill up in order and the far ones are left empty. The reference no longer depends on which chest you closed.
  • Floor separation (SeparateFloors, on by default). A solid floor/ceiling layer now splits storeys, so a ladder or open stairwell no longer merges two floors into one sorting network. Works at any ceiling height.
  • Backpack sorting (SortPlayerBackpack, on by default). A player's backpack content is sorted when they close their inventory; bag slots and the hotbar are never touched.
  • Multiplayer-safe trigger. When several players or chests in a room are open, only the last one closed triggers the sort — items never shuffle while someone is still editing.

Fixes

  • Chests and storage vessels (jars) no longer mix: containers are grouped by block code instead of the shared chest inventory class.
  • Sorting is no longer blocked forever by a stale "open" state (e.g. a player who disconnected with a chest open).
  • The overlay now follows container contents in real time and mirrors the real chest GUI (localized title, correct columns, centered layout, depth inset).
  • A chest closed alone now sorts reliably.
  • ConfigLib container list no longer shows a duplicate entry.
0.1.0 autosort
1.19.0-pre.0 - 1.22.3
203 Jun 7th at 4:01 AM autosort_0.1.0.zip 1-click install

v0.1.0 — Initial release

First public release of AutoSort.

  • Sort on close: closing a chest you changed re-sorts the whole storage network (idempotent — an already-sorted chest never reshuffles).
  • Semantic sorting: items grouped into 17 categories and laid out top-to-bottom, left-to-right.
  • Variant clustering: every variant of an item stays together (all gears, all planks, all fruit…).
  • Cross-chest consolidation: one item type ends up in one chest, overflowing to the next only when full.
  • Connected nearby containers are treated as a single virtual inventory.
  • Room-aware: a closed door keeps two storage rooms separate (toggleable).
  • Chests and storage vessels (jars) are sorted separately, never mixed.
  • Optional /sort overlay (alias of /autosort): a read-only HUD showing a container's contents, mirroring the real GUI and updating in real time.
  • Fully configurable via ModConfig/autosort.json.

Requires Vintage Story 1.19+. Sorting runs server-side; the overlay needs the mod installed client-side.


7 Comments (oldest first | newest first) (threaded | flat)

Klovered, Jun 11th at 8:50 PM

Downloaded mod. Nothing is sorting. Is there a command orsomething i use to start the sorting?

roquess , Jun 9th at 1:17 PM

I agree with both of you. I’ll try to fix this in the next version. Thank you for the feedback.

JokoJose, Jun 9th at 11:53 AM

I agree with Fefa: auto-sort from any container will make it so that when you use carry-on as extra inventory, whenever you put items in it, they will be auto-transferred to any nearby containers that can hold them. But if you had a way to choose a single container to use as the sort mechanism, that problem would be resolved. Or instead of making it on a container close, make it a clickable option that you click to initiate the auto-sort. 

Fefa, Jun 9th at 9:06 AM

Noticed a problem, not sure if is intended, but if i have a trunk(Using Carry-on) and theres a collapsed trunk nearby, it forced any item to the collapsed trunk even when youre not allowed to place items inside a collapsed trunk. It can become anoying because if theres a collapsed trunk anywhere nearby in a dungeon and you open your trunk to fill with looted items, once it closes, it fills the collapsed trunk with your trunk's items. Maybe make that it cant move items to containers that dont allow the player place items and dont allow the transfer happens if youre not in an enclosed room. Another anoying thing is, it always sort my incentory when i open my player inventory, i havent seen transfers from my own inventory to chests, but just the player inventory sort alone is also anoying. I love to keep items in my inventory sorted in an specific way and the auto sort on player inventory every time i open it is frustrating.

Other solution could be to add to the mod a new container item that will transfer the items to containers of the same tipe or allow the player to set a container to be the one that transfer the items to containers of the same kind and a white-black list for containers, that way items wont end up on empty containers randomly while youre exploring in the world. Im not sure if the same happens with other kind of containers transfering to collapsed or aged containers from ruins, i havent tested it that far yet.

Fefa, Jun 7th at 12:48 PM

this works with any storage containers from other mods like extra chests? 

roquess , Jun 7th at 5:38 PM (modified Jun 9th at 6:13 AM)
@Fefa: this works with any storage containers from other mods like extra chests?

Good idea ! 0.1.1 is here