WorldBoundInventory

WorldBoundInventory gives every character a separate standard inventory for each Valheim world or server.

The mod also supports mandatory server enforcement. When enabled on the host or dedicated server, players without the correct mod build are rejected before their character enters the world.

Features

Separate inventory for every unique Valheim World UID.
Works with local worlds, hosted games and dedicated servers.
The first world entered after installation imports the character's current inventory.
A newly visited world starts with an empty inventory by default.
Restores item positions, hotbar layout and equipped state.
Preserves normal death and tombstone behavior inside each world.
Automatic saving after inventory changes.
Atomic slot writes, SHA-256 integrity checking and .bak recovery.
Mandatory client handshake before the server accepts PeerInfo.
Exact mod version and DLL SHA-256 validation.
Continuous heartbeat; clients that stop running the mod are disconnected.

Installation

Install the same WorldBoundInventory.dll on:

the host or dedicated server;
every player connecting to the protected server.

Manual installation path:

Valheim/BepInEx/plugins/WorldBoundInventory/WorldBoundInventory.dll

For automatic installation, use a compatible Thunderstore mod manager.

Configuration

The configuration file is created after the first launch:

BepInEx/config/fandray.valheim.worldboundinventory.cfg

Enabled = true — enables inventory separation and networking.
ImportInventoryIntoFirstWorld = true — assigns the existing inventory to the first world.
EmptyInventoryInNewWorlds = true — newly visited worlds start empty.
AutosaveSeconds = 15 — inventory autosave delay.
KeepBackup = true — retains the previous slot as .bak.
EnforceModOnServer = true — rejects clients without the required mod.
RequireExactAssembly = true — requires the exact same DLL by SHA-256.
HandshakeTimeoutSeconds = 8 — initial handshake timeout.

Inventory slots are stored under:

BepInEx/config/WorldBoundInventory/Inventories/

Important

Back up your character before the first use.
Distribute one compiled DLL to the server and every player. Separately rebuilt DLL files may have different SHA-256 hashes.
This mod separates the standard Player.GetInventory() inventory. Extra equipment or quick-slot inventories added by other mods require separate compatibility.
The network gate prevents normal clients without the mod from joining, but it is not a replacement for a full server-authoritative anti-cheat system.

Русское описание

Мод создаёт отдельный стандартный инвентарь персонажа для каждого мира или сервера Valheim. Первый открытый мир получает текущие вещи персонажа, а новые миры по умолчанию начинаются с пустым инвентарём.

Если мод установлен у хоста или на выделенном сервере, клиент без такой же версии и идентичного DLL не допускается в мир. После подключения сервер продолжает проверять работу мода через heartbeat.

Поддержка и вопросы: Discord