ChestLink

By TeamVibes • Version 1.0.0

Open a chest and manage your linked storage from one scrollable view. Items stay in real chests, with their normal slots and stack sizes.

Features

• Discover chests in the same building, with a configurable radius fallback.
• Search item names and filter by category. Multiple search words must all match.
• Drag and drop, split stacks, quick-move items and swap full stacks.
• Keep item and slot favorites; see individual chest boundaries and labels.
• STORE items, RESTOCK supplies, TAKE ALL matching items and physically SORT storage.
• Right-click food and potions to use them directly from storage. Equipment needs room in your inventory before use.
• Standalone multiplayer support, with optional MultiUserChest integration.

Installation

Requires BepInExPack Valheim 5.4.2351 and Jötunn 2.30.2 or compatible newer versions.

Mod manager: install ChestLink and its required dependencies through your manager.

Manual: install BepInEx and Jötunn first. Copy ChestLink.dll into BepInEx/plugins/ChestLink/. The Nexus archive contains this directory structure; extract it into the Valheim game directory.

In multiplayer, install the same ChestLink version and dependencies on the host/server and every player’s client.

Using ChestLink

Open an eligible chest to display the linked view. Use search and category filters to find items. Ctrl-click a linked stack to withdraw it; drag and drop to choose a destination.

STORE, RESTOCK and SORT operate on the whole linked group, ignoring the current filter. TAKE ALL follows the current filter. SORT rearranges the contents of physical chests. Normal successful transfers are silent; sorting shows Storage sorted. Brief messages explain blocked or failed actions.

Chests retain individual inventories. Ships, carts, tombstones and dungeon containers are excluded. Ward/private access and chest exclusions are respected. Discovery does not chain outward from each discovered chest.

Configuration

Launch once to generate BepInEx/config/com.chestlinkmod.valheim.chestlink.cfg. Existing settings are preserved when upgrading.

Setting	Default	Range / meaning
Discovery / Radius	30 m	1–100 m; fallback around the opened chest
Discovery / MaxContainers	64	0–512; 0 disables this limit
Discovery / MaxCombinedSlots	1000	0–10000; 0 disables this limit
Discovery / PreferSameBuilding	true	Prefer the same connected structure
Discovery / RequireSameBuildingRoof	true	Require a roof from the same structure
Debug / Logging	false	Detailed diagnostics; existing true values stay enabled

Other settings control structural detection, chest borders, labels, scrolling and category order. Their descriptions are included in the generated configuration.

Multiplayer and compatibility

ChestLink includes its own chest-owner request handling. MultiUserChest is optional, not a required download. When supported MultiUserChest 0.6.2 is installed, ChestLink uses it for ordinary transfers instead of enabling a second backend. Bulk storage actions use ChestLink’s batch coordinator.

The standalone host/client multiplayer build was tested successfully by TeamVibes, including simultaneous chest interaction. External MultiUserChest integration and dedicated-server play still need live verification. Compatibility with mods that directly change chest inventories is not guaranteed.

For troubleshooting, enable Debug / Logging and include the affected peers’ BepInEx logs and the output of chestlink_tx_status.

Credits

ChestLink by TeamVibes. The embedded owner-request implementation is adapted from MultiUserChest, copyright © 2022 Maximilian Schmöcker, under the MIT License. The full attribution and licence are included in LICENSE-MultiUserChest.txt.

See CHANGELOG.md for release notes.