VoidChest

Void Chest

A Valheim mod: a magic container that travels with your character.

Equip it and press the hotkey to open your personal container. Contents are bound to the character save — dropping it, trading it, dying, or upgrading it never moves or loses the contents. Comes with a four-tier upgrade chain, nearby quick storage, and a guard-stone remote deposit.

> Localization: English / Simplified Chinese / Traditional Chinese

---

Features

• Four-tier chest chain: Black Metal → Eitr → Flametal → Crystal, capacities 2x6 / 3x6 / 3x8 / 4x8 (configurable).
• Character-level data: contents live in the character file (Player.m_customData) and follow you across worlds and servers; the chest item is just a "key".
• Equip to open: uses a Utility slot (compatible with ExtraSlots extra slots), default hotkey B (configurable).
• Weight limit: defaults 100 / 150 / 300 / 800 (0 = unlimited, configurable).
• Drag / Shift-move over the limit auto-splits (stores only what fits).
• When full, items bounce back (no silent loss).
• Container weight is shown as current/max.
• Nearby / remote storage is not limited by weight.
• Nearby storage: one click stores backpack items into all containers within 30 m (configurable).
• Automatically ignores: the first hotbar row, equipped items, ExtraSlots dedicated slots (quick/ammo/food/misc/extra equipment), and containers in use by other players.
• Guard-stone remote deposit: while away from home, deposit materials remotely into all containers inside the territory of a guard stone you have access to.
• Configurable: capacities, weights, ranges, filters, remote unlock, hotkey, timeouts, caching (ConfigurationManager supported).

Recipe

| Tier | Item | Capacity (default) | Materials | Station | |---|---|---|---|---| | 1 | Black Metal Void Chest | 2x6 | Dragon Tear x5 + Fine Wood x10 + Black Metal x20 | Forge | | 2 | Eitr Void Chest | 3x6 | Black Metal Void Chest x1 + Refined Eitr x10 + Yagluth Thing x2 | Forge | | 3 | Flametal Void Chest | 3x8 | Eitr Void Chest x1 + Flametal x10 + Fader Relic x2 | Black Forge | | 4 | Crystal Void Chest | 4x8 | Flametal Void Chest x1 + Blood Gold x10 + Liquid Frost x10 | Black Forge |

Usage

1. Equip the Void Chest (Utility slot).
2. Press B to open the interface.
3. Interface buttons (single button, toggles):

• Nearby Storage: store into surrounding containers;
• Remote Deposit: store into home containers inside a guard stone's territory (requires Eitr/L2 or higher chest; can be set to always available in config).

1. Vanilla "Stack All / Take All" buttons still work.

Remote Deposit Notes

• You must be the guard stone's creator or be on its permitted list.
• Range is the guard stone's own territory radius (XZ circle).
• Works for multiplayer clients: both the server (dedicated or host) and the client must have this mod installed.
• The client sends a filtered backpack snapshot to the server; the server scans and stores, then returns the result;
• The client removes exactly the items the server reports — safe even if the inventory changed while waiting;
• If the server does not have the mod, a "no response" message appears after ~30 s;
• Server can disable it with RemoteStore.Enabled = false.
• Scan results are cached (default 300 s, per player); repeated deposits complete in seconds. Removed containers are skipped automatically.

Configuration

File: BepInEx/config/trigger.valheim.voidchest.cfg (ConfigurationManager supported).

| Section | Key | Default | Description | |---|---|---|---| | General | OpenHotkey | B | Open/close hotkey | | General | DebugLog | true | Debug logging | | Capacity | BlackMetal / Magic / Flame / Crystal Rows/Cols | 2x6 / 3x6 / 3x8 / 4x8 | Capacity per tier (1-8) | | Weight | BlackMetal / Magic / Flame / Crystal Max | 100 / 150 / 300 / 800 | Weight limit (0-9999, 0 = unlimited) | | NearbyStore | Enabled | true | Enable nearby storage | | NearbyStore | Range | 30 | Search radius (1-100 m) | | NearbyStore | CheckWard | true | Skip containers in territories you lack access to | | NearbyStore | IgnoreHotbar | true | Do not store hotbar items | | NearbyStore | IgnoreFood / IgnoreAmmo / IgnoreMead | false | Do not store food / ammo / mead | | NearbyStore | TimeoutSeconds | 2 | Per-container response timeout | | RemoteStore | Enabled | true | Enable remote deposit | | RemoteStore | AlwaysAvailable | false | Remote always available (false = unlocked by Eitr/L2) | | RemoteStore | CacheSeconds | 300 | Scan cache time (0 = rescan every time) |

Installation

1. Install BepInExPack for Valheim.
2. Install Jotunn.
3. Drop VoidChest.dll into BepInEx/plugins/VoidChest/.

Dependencies

• BepInExPack Valheim 5.4.2350+
• Jotunn 2.29.2+
• Optional: Valheim Plus (compatible; AutoStack spread is suppressed while nearby storage runs)
• Optional: ExtraSlots (extra Utility slot support)

Repository

https://github.com/1264600905/valheim-voidchest

Build

cd VoidChest
dotnet build .\VoidChest.csproj -c Release

Output: BepInEx/plugins/VoidChest/VoidChest.dll (output path is preconfigured).

Known Limitations

• Remote deposit requires the same mod version on server and client (otherwise you get the "no response" message).
• After changing capacities, items beyond the visible range keep their data but are hidden (visible again with a larger capacity).
• Uninstalling the mod makes the chest item inert; character data is preserved (reinstall to recover).

Changelog