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