ChestHeim

Chest upgrades for Valheim: labels on every chest, and the Echo Chest, whose contents follow you.

• Chest labels. Press Shift+E on any chest and give it a name and an icon, like a sign on its front. Pick the icon from a searchable list of the game's items, change the colour of the text and of the icon, and use colour markup in the text.
• Echo Chests. Every one you build, anywhere in the world, holds the same things. Link them with a clan and your whole clan shares one.
• Clan Keys, Restock and more, below.

Chest labels

Look at a chest and press Shift+E. In the window, type the label text. It's written like a sign, so <color=red>Arrows</color>, <b>, <i> and <size=...> all work, and you can pick the text colour from the swatches or type a hex colour. Choose icon... opens a searchable list of every item with an icon; pick one and colour it the same way. The label then appears on the front of the chest, an icon beside the text on a dark plate, and everyone who looks at the chest sees it (and the chest's hover name changes to the text). Anyone who can open a chest can label it; an Echo Chest only its builder or clan. If the label ends up on the wrong side of a chest, change Labels / Side.

A chest whose contents follow you. Every Echo Chest you build, anywhere in the world, holds the same things.

Put your tools in the Echo Chest at your main base, walk to your mining outpost, open the Echo Chest there, and they're all in it. Take something out at the outpost and it's gone from the base chest too. It's one stash with many doors.

Contents

• Getting started
• How it works
• Other players
• Examples
• Good to know
• Multiplayer
• Configuration
• Troubleshooting
• Coming next

Getting started

1. Open the Hammer and go to Furniture. Build a Echo Chest: 10 Fine Wood, 10 Iron and 5 Surtling Cores.
2. Use it like any chest and put things in. It holds 50 slots, as many as the biggest chest in the game.
3. Build another Echo Chest somewhere else (another base, an outpost, a boat house). Open it: it already holds the same things.

An Echo Chest looks like a black-metal chest with a purple tint, and gives off a faint purple glow, so you can tell it apart.

Clan chests

Share one set of echo chests with your whole clan. Craft a Clan Key at a workbench (2 Bronze, 2 Fine Wood). Carry it, look at an Echo Chest you built, and press Shift+E. Type your clan name and press Link this chest with my clan. From then on that chest shows the same things as every other Echo Chest set to that clan, wherever those were built: build one at an outpost, link it to the clan, and it's connected back to the home chest. Everyone whose own clan name matches (they set it the same way, with a key of their own, using Just save my clan name) can open those chests and take things out; nobody else can open them. The chest's own previous contents are replaced by the clan's when it joins, so link an empty chest. Back to my own echo chests returns it to your personal set.

The key also works on an ordinary chest you built: Share this chest with my clan makes it open only to you and your clan (normally anyone can open an ordinary chest unless a ward covers it). Names aren't case-sensitive. The rules are checked in each player's game, so use it among people you trust.

Restock

Open your echo chest and a Restock panel appears beside it. Add the items you like to carry and how many (search by name, use + and -, hold Shift for bigger steps), or click Remember what I carry to copy what's in your inventory now. Click Restock and the stash tops your inventory up to those amounts, taking only what you're short of. Anything the stash doesn't have is reported. The list belongs to your character, so every echo chest shows the same one. The panel can be dragged (double-click it to reset) and has an X to close the chest. Only the chest's builder sees it.

How it works

All of your Echo Chests are one stash. Whenever you change what's in one (put something in or take something out), the server copies the new contents to your other Echo Chests, usually within a couple of seconds. It doesn't matter how far apart they are, or whether you're anywhere near the others.

• Your stash is yours: it belongs to whoever built the chests. Two players each building Echo Chests have two separate stashes.
• Only one of your Echo Chests can be open at a time. If you try to open a second one while the first is still open, it tells you the stash is open elsewhere.
• Taking an Echo Chest down is safe. If you have other Echo Chests, the one you remove just goes away, and nothing spills on the ground (that would duplicate your things). When you remove your last Echo Chest, its contents drop on the ground like any chest.

Other players

Anyone can open your Echo Chest, look inside, and put things in, so a friend can drop you supplies. Only you, the builder, can take things out. For anyone else, taking, "Take all" and swapping an item with one in the chest are all refused with a message.

Prefer a stash nobody else can touch? Set Echo / OthersCanDeposit to false and only you can open them.

(This take-out rule is enforced in each player's game, like most chest mods. It's meant for friends sharing a server, not for stopping someone determined who modifies their game.)

Examples

A travelling toolbox. Keep your pickaxes, hammer, cultivator and spare armour in your Echo Chest. Whichever base you reach, open the Echo Chest there and everything's in reach.

Ore without the hauling. Dump your ore into the Echo Chest at the mine. Open the one at your forge: it's there.

A drop box for friends. Tell a friend to put supplies in your Echo Chest. You find them in every one of your chests.

A safety net. Every chest holds a full copy, so if one is lost (a raid, a mistake), your things are still in the others.

Good to know

• The stash is one set of 50 slots, however many chests you build. More chests don't add more space.
• Each chest is a normal chest underneath, with a full copy of the stash. It saves with the world like any other.
• The server copies the newest contents to the rest, so a chest that hasn't been loaded for a while catches up as soon as the server does its check.
• A newly built chest first catches up with your stash. It never replaces what's already in it with its own empty contents.

Multiplayer

Install ChestHeim on the server as well as every player. The Echo Chest is a new buildable, so a server without the mod removes it, and the server is also what keeps your chests in step. Versions must match. It works the same in single player, where your game is its own server.

Configuration

BepInEx/config/mbaya.ChestHeim.cfg, or Gale's config editor:

Troubleshooting

• The Echo Chest isn't in the Hammer menu. It's under Furniture. Check the mod is in the profile you launch from.
• My second chest is empty. The server needs a moment, usually a couple of seconds, to copy the contents. Close it and open it again. Check that the mod is on the server too: without it, chests aren't kept in step.
• "This stash is open in another chest." One of your Echo Chests is open (possibly by you on another screen, or someone else's game). Close it first.
• "Only its builder can take things out." The chest belongs to another player. You can put things in, but only they can take things out.
• Something else. Open an issue at github.com/mattbaya/ChestHeim and attach BepInEx/LogOutput.log.

Coming next

A team chest shared by several players, linked the same way, is planned.

Works with

• Bag O' Heim: packs that refill themselves from chests in your base.
• GearHeim: loadouts that restock from chests in your base.
• SortHeim: sort an Echo Chest with its buttons.

Changelog

0.5.3

• The pointer stays steady in the chest window (the game could take the mouse back every frame, making it flicker).

0.5.2

• Each patch is now applied on its own, so one the game has changed can't stop the others (the log names the one that failed).

0.5.1

• Fix for the Restock panel's buttons not responding (the panel no longer has a canvas of its own, which could stop clicks reaching it).

0.5.0

• Now called ChestHeim (it was Echo Chests): Echo Chests are one feature of it.
• Chest labels. Shift+E on any chest opens a window to write a label: text with colour markup, a text colour, an icon from a searchable list of the game's items and an icon colour. It shows on the front of the chest like a sign, and the chest's hover name uses the text. Labels / ShowLabels, Labels / Side.
• Shift+E now opens one window for both labelling and (with a Clan Key) clan sharing.

0.4.0

• Renamed to Echo Chests (the chest is now the Echo Chest). Chests built with the earlier test versions are not carried over: the old piece no longer exists.
• Clan-linked echo chests. Use the Clan Key on an Echo Chest (Shift+E) and link it to your clan: it then shares its contents with every Echo Chest set to the same clan, wherever they are, and clan members can take things out of it. Echo Chests that aren't linked behave as before.

0.3.0

• Clan chests. A new craftable item, the Clan Key (2 Bronze, 2 Fine Wood, at a workbench). Carry it and press Shift+E on any chest you built: set your clan name (saved on your character) and share the chest with it. Everyone whose clan is set to the same name can open the chest; nobody else can (you always can). Press Shift+E again to stop sharing. Shared chests say so when you look at them. Anyone who wants in needs their own Clan Key once, to set their clan name; they don't need to keep it.

0.2.0

• Restock. Open your echo chest and a panel appears beside it. Set how many of some items you like to carry (add them by name, or click Remember what I carry), then click Restock: the vault tops your inventory up to those amounts. The list is kept on your character, so every echo chest uses it. Drag the panel anywhere (double-click to reset); there's an X on it to close the chest.

0.1.0

• First version: the personal Echo Chest.