Safe Pouch

Keep a few essentials with you, even after death. Safe Pouch adds configurable slots beneath your inventory using Valheim's own UI elements.

Features

• Configurable protected slots: contents remain with your character after death and follow that character between worlds.
• Large stacks: ordinary, portal-friendly stackable items can stack to 99,999 per slot. Equipment that normally does not stack stays separate.
• Limited portal transport: portal-restricted items are limited to one individual item per slot and can travel through portals while in the pouch. Restricted items in your normal inventory still follow world rules.
• Adjustable weight: choose 0–100% of normal pouch contents' weight.
• Adaptive position: the pouch follows the inventory background and footer buttons. A manual offset is also available.
• Native background material: follows the inventory's live material and tint instead of using a fixed brightness adjustment.
• Client-side design: no custom wearable, item prefab, or networked container. No server installation is intended or required by the plugin; compatibility with an unmodified dedicated server has not yet been verified.

Installation

Install through Thunderstore Mod Manager with the required BepInExPack_Valheim, then launch Modded.

For manual installation, place SafePouch.dll in your profile's BepInEx/plugins/SafePouch folder. Close the game before installing or updating. If you previously installed a development copy manually, remove that old DLL before installing the Thunderstore package so only one copy loads.

Controls

• Click an item in your normal inventory, then a pouch cell to deposit it. Split the normal stack first if you want to deposit only part of it.
• Depositing a restricted stack distributes one item into each available pouch cell, beginning at the clicked cell. The remainder stays in your inventory.
• Click a pouch item, then a normal inventory cell to withdraw it there.
• Right-click a pouch item to withdraw as much as fits. Large stacks split into normal inventory-sized stacks; overflow stays in the pouch.
• Occupied cells accept matching stacks only; items are not swapped.

Close an open chest to reveal the pouch. Withdraw items before equipping, consuming, crafting with, dropping, or putting them in a chest. Mouse input is supported; dedicated controller and touch navigation are not implemented.

Configuration

After the first launch, edit BepInEx/config/local.valheim.safepouch.cfg with the game closed, then restart. An in-game BepInEx configuration editor can also change these settings.

[Pouch]
SlotCount = 4
WeightPercent = 100

[Interface]
Gap = 8
VerticalOffset = 0

Layouts outside the inventory hierarchy may need a manual offset. Compatibility with every UI overhaul is not guaranteed.

Saving and uninstalling

Contents are stored in the character's custom data and saved with the character. They are not stored in a separate world container or editable config file. Unsaved changes can roll back with the character after a crash.

Before uninstalling, empty the pouch and log out normally. Contents are inaccessible without this plugin.

Slot count

Set SlotCount under [Pouch] to 1–28 (default 4), then restart Valheim. Slots wrap after seven per row: 8 gives rows of 7 and 1, and 14 gives two full rows. When reducing capacity, occupied extra slots remain visible and withdrawal-only until emptied. Existing saves migrate automatically; do not downgrade after saving with 0.3.0. Large layouts may need a smaller UI scale or a VerticalOffset adjustment to fit the screen.

Changelog

0.7.1

• Click an item in the pouch, then another occupied pouch slot to swap complete stacks directly. Compatible stacks still merge when there is room.
• Swaps and whole-stack moves preserve equipped gear and selected ammunition, including across rows and after saving/reloading.
• Swaps respect stack limits and cannot move an item back into a withdrawal-only overflow slot after shrinking the pouch. Partial-stack drops do not swap.
• Configuration synchronization remains compatible with 0.7.0 servers.

0.7.0

• Added server-synced BlockPortalWithRestrictedItems (default false). When enabled, pouch contents follow native portal restrictions, including allow-all portals and world rules.
• Pouch resources now count toward building and crafting requirements, and can fuel or load world objects. Normal inventory resources are consumed first, then the pouch supplies the remainder.
• Bows and other ammo weapons can use pouch ammunition. Shift + right-click selects ammo; selection persists through save/reload.
• Shift + right-click food or potions to use them directly. Native consumption restrictions still apply.
• Update servers and clients to 0.7.0+ together for configuration synchronization. Character save format is unchanged.

0.6.1

• Simplified pouch tooltips by removing server settings and numeric stack limits. Item details, equipment controls, and useful pouch hints remain.

0.6.0

• Added RegularStackLimit (default 99999) and PortalRestrictedStackLimit (default 1), both accepting 1-99999.
• Both limits sync from servers along with slot count and weight; update both server and clients to 0.6.0+.
• Restricted stack deposits fill slots up to their configured limit. Non-stackable equipment remains one per slot.
• Lowering limits preserves larger existing stacks for withdrawal, including after save/reload. Normal inventory stack limits remain unchanged.
• Tooltips and sync logs show the active limits. Older versions cannot load portal-restricted stacks larger than one.

0.5.1

• Keep early server config packets until login completes, fixing sync when Jotunn or ServerSync buffers the PeerInfo handshake.
• Deferred settings remain tied to the known server connection and are discarded on disconnect or session changes.
• Added startup config path/value logs, server offer logs, and client acknowledgment logs.

0.5.0

• Optional server install automatically syncs SlotCount and WeightPercent to clients with 0.5.0+.
• Server settings override local values for the session; disconnecting restores personal settings without rewriting the client config.
• Live setting edits broadcast to modded peers; interface placement stays local.
• Live capacity changes preserve occupied extra slots as withdrawal-only, including equipped gear.
• Servers without the mod continue to use local client settings. Pouch tooltips show active server rules.

0.4.1

• Restore saved pouch equipment on the character-selection preview, so protected armor appears before entering a world.

0.4.0

• Non-stackable equipped gear stays equipped when moved into, within, or out of the pouch.
• Shift + right-click toggles equipment in the pouch. Ordinary right-click still withdraws.
• Equipped state restores on login; native equipment-slot conflicts and durability rules still apply.
• Added equipped markers and durability bars. Ammo remains storage-only; withdraw gear for repairs.

0.3.1

• Panel now shrinks to fit one, two, or three slots.
• One-slot layout uses a two-line title; labels wrap and resize to fit.

0.3.0

• Added SlotCount configuration (1–28, default 4).
• Pouch expands into rows of seven slots.
• Reducing capacity preserves occupied extra slots as withdrawal-only until emptied.
• Variable-size save format with migration from existing pouch saves. Do not downgrade after saving with 0.3.0.

0.2.3

• Pouch background now shares the inventory's live material and color, allowing native lighting effects to apply.
• Removed the fixed background darkening tint.

0.2.2

• Added configurable pouch weight percentage, from 0% to 100%.
• First Thunderstore package.

0.2.1

• Adaptive positioning below expanded inventory backgrounds and footer buttons.
• Configurable UI gap and vertical offset.

0.2.0

• Ordinary stackable items can stack to 99,999 per pouch slot.
• Updated save format to preserve large counts, with migration from earlier saves.
• Withdrawals split into normal inventory stacks.

0.1.x

• Four character-bound slots with death protection.
• One-per-slot limit for portal-restricted items.
• Native inventory styling and background refinements.