You are viewing a potentially older version of this package. View all versions.
EK_Solutions-ChestButler-1.0.0 icon

ChestButler

Dump-and-sort chests: flag any chest as a Sorter and your loot flies to the right chests. Pin filters, sign labels (sort: cooking), priorities, and a Pull button to restock. Multiplayer-safe via MultiUserChest.

Date uploaded 14 hours ago
Version 1.0.0
Download link EK_Solutions-ChestButler-1.0.0.zip
Downloads 1
Dependency string EK_Solutions-ChestButler-1.0.0

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2333 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2333
ValheimModding-Jotunn-2.29.1 icon
ValheimModding-Jotunn

Jötunn (/ˈjɔːtʊn/, 'giant'), the Valheim Library was created with the goal of making the lives of mod developers easier. It enables you to create mods for Valheim using an abstracted API so you can focus on the actual content creation.

Preferred version: 2.29.1
MSchmoecker-MultiUserChest-0.6.1 icon
MSchmoecker-MultiUserChest

Allows multiple players to interact with the same chest at the same time

Preferred version: 0.6.1

README

ChestButler

Sorts your storage for you. Mark a chest as a Sorter, dump everything into it, and when you close it the items get moved to the right chests around your base. Stone goes where your stone already is, carrots end up in the kitchen, and anything the mod can't place stays put so nothing is lost.

What it does

  • Toggle any chest into a sorter with one button. Contents distribute when you close it.
  • Chests attract items they already hold, fullest chest first, so it works with zero setup.
  • Pin filters: put sample items in a chest, hit Pin, and the chest claims those item types even when empty. An Auto/Manual toggle decides whether the sorter fills it on its own or only when you ask.
  • Pull: chests with filters get a button that fetches one stack of each wanted item from nearby storage. Good for a cooking chest that restocks itself.
  • Sign labels as an alternative: a sign reading sort: cooking on a chest makes it the cooking chest. Also takes item names, * wildcards, pN for priority and off to exclude a chest.
  • Item groups (stone, wood, ores, metals, cooking, meat, seeds, trophies, valuables, meads, ammo, hides) are editable in the config and sync from the server.

Every transfer runs through MultiUserChest's networking, so only the actual owner of a chest modifies it. No dupes and no lost items, including with several people online.

Buttons

Button On Does
Sorter: ON/OFF any chest dump chest toggle
Pin / Auto (n) / Manual (n) target chests save contents as filters, toggle auto-fill
Clear filtered chests remove saved filters
Pull filtered chests fetch a stack of each saved item from nearby

Setup notes

Config: BepInEx/config/light.chestbutler.cfg (radius, speed, fallback behavior, item groups). Server values sync to all clients.

Multiplayer needs the mod on the server and every client at the same version. Mismatches get a clear message at connect. Crossplay must be off.

Credits

Item transfer networking is built on MultiUserChest by MSchmoecker.

CHANGELOG

Changelog

1.0.1

  • Mod ID changed to eksolutions.chestbutler (config file is now BepInEx/config/eksolutions.chestbutler.cfg; settings reset to defaults once)
  • Server and all players must update together, older versions are refused at connect

1.0.0

  • First public release
  • Sorter chest toggle with tiered routing: pinned filters, then groups, then chests that already hold the item
  • Consolidation (fullest chest wins ties) and partial fills
  • Pin / Auto / Manual / Clear / Pull buttons in the chest UI
  • Sign labels (sort: ...) with groups, wildcards, priority and off
  • Server-synced config including editable item groups
  • Same-version check for server and clients at connect