ChestButler

ChestButler

Sorts your storage for you. Mark a chest as a Sorter, dump everything into it, close the lid, and the items get moved to the right chests around your base. Press Organize and the whole base tidies itself. Press Gather at a crafting station and the missing ingredients come to you. Open a Puller Chest and pick anything from storage.

Features

Sorter chests Toggle any chest into a dump chest with one button, or build the craftable Sorter Chest, which is one out of the box. Anything inside gets distributed to nearby chests the moment you close it. An item no chest holds yet goes to the nearest empty chest, or the chest with the most free slots if none is empty. It only stays in the sorter when everything is full, so nothing is ever lost or dropped.

Puller Chest (new in 2.1.2) Build a Puller Chest and open it to see everything stored in the chests around it, with a search box. Click an item to pull a stack of it into the Puller, Shift-click to pull all of it. The sorter, Organize, Gather and Pull never touch what's in a Puller Chest, so press Send back when you're done and anything left goes back to storage. It also empties itself 5 minutes after you last touch it ([Puller] ReturnAfterSeconds).

Organize your whole base Sorter chests get an Organize button. One press scans every chest in range and previews what would move. Press again and every item type consolidates into its best home, in place, while you carry nothing. Homes persist: chests keep their assigned role between runs, so a tidy base stays tidy and a second press right after the first has little or nothing left to do. Weapons, armor and tools get homes of their own, and small odds and ends share a misc chest instead of each claiming their own.

Gather at the crafting station (new in 2.0) A Gather button under Craft pulls the selected recipe's missing ingredients from chests in range, scaled to your craft multiplier. Green (N) counts show what storage holds. Craft, then dump what's left into a Sorter chest and it flows back to where it belongs. Greyed out means there is nothing to fetch: you already carry what the recipe needs, or storage has none of what is missing. Since 2.1.1 it works for building too: place a piece you can't afford and the missing materials get pulled from chests in range.

Sign control, now with areas (area-off new in 2.0) A sign next to a chest labels it: sort: wood claims a group, sort: off opts the chest out entirely. New in 2.0: add a number on its own line and the off covers every chest within that radius. One sign protects a whole room.

Processor-aware routing (changed in 2.0) During Organize, a chest next to a smelter or blast furnace attracts ores and fuel, and one next to a fermenter attracts meads. Crafting stations (forge, workbench, cauldron and so on) no longer attract chests by default. With Gather you fetch what a recipe needs instead of storing materials beside the bench. Any station can be re-added in config.

Pin filters & Pull to restock Put sample items in a chest and press Pin. That chest now claims those item types even when empty. Pull fetches one stack of each saved item from surrounding storage.

Safe in multiplayer Every transfer (sorting, Pull, Gather and Organize) runs through MultiUserChest's networking, so only the actual owner of a chest modifies it, and the completion message counts only transfers the network confirmed. No duped stacks, no vanishing items.

Before your first Organize: protect curated chests

Organize thinks in item types. A hand-curated chest that mixes types, like a "meals for the trip" chest or an adventure kit, is a player concept it cannot see, and it will be reorganized like everything else. Before your first press, protect what you've curated:

| You want | Do this | Effect | | -------- | ------- | ------ | | "Never touch this chest / room" | Sign: sort: off (add a number line for a radius) | Fully ignored: never read, never filled. Pull still works on click. | | "This is THE chest for these types" | Pin the contents (Auto) | Protected, and it attracts all of those types in range. | | "Don't auto-fill it" | Manual toggle | Not filled automatically, but Organize may still take from it. Manual does not protect contents. |

Quick Start

1. Open a chest near your storage and click Sorter: OFF so it reads Sorter: ON, or build a Sorter Chest (Furniture tab, near the end).
2. Dump your inventory into it and close the chest. Items fly to whichever chests already hold those types.
3. Protect any curated chests (see above), then press Organize in the sorter chest. It previews ("move 340 items across 12 chests"), the button turns into Confirm?, and a second press runs it.
4. At a crafting station, select a recipe and press Gather to pull the missing ingredients from storage.
5. Build a Puller Chest (Furniture tab), open it, search for an item and click it to pull a stack into the chest.
6. For a dedicated chest (carrots and onions near the cauldron): put samples in, press Pin. Press Pull any time to restock it from storage.

Installing

With a mod manager (recommended)

Install ChestButler with the Install button on this page or through r2modman / Thunderstore App. The dependencies (BepInEx, Jötunn, MultiUserChest) install automatically. Launch the game with Start modded.

With a profile code (server groups)

Playing on a server that runs ChestButler? In r2modman or the Thunderstore App go to Import / Update, pick Import new profile, choose From code and paste the code your server admin gave you.

The code for the EK_Solutions server is:

019f56be-5a3d-1f95-1b1e-9c8aa52a8a6b

Manual