ChestHelper

Client-side mod for Valheim that adds a live 3D chest locator, an item search bar, and one-click container sorting.

Features

Item Search Bar

• Adds a search input field directly above the player inventory window.
• Typing any item or material name (supports English and Russian) highlights all matching chests around your base and dims non-matching items in your inventory.
• Character movement (WASD, sprinting, jumping) and hotbar slots are paused while typing to prevent accidental inputs. Pressing Enter restores full movement while keeping the found chests highlighted.
• Clear the search at any time by pressing Escape or clicking the clear button.

Chest Locator (Hover Highlight)

• Hovering your cursor over any item in your inventory highlights all nearby chests containing that item.
• Found chests are marked with a rotating golden beacon and a subtle glow.
• Includes a soft line-of-sight check (MaxWallObstacles = 1) so chests behind a door, beam, or partition are still visible, while chests buried deep behind multiple solid walls are filtered out.
• Default search radius is 25 meters (configurable).

Container Sorting

• Adds a "Sort" button directly below the vanilla "Take All" and "Stack All" buttons in the chest UI.
• Merges incomplete stacks automatically.
• Groups items by category: Weapons & Tools -> Armor & Ammo -> Food & Potions -> Crafting Materials -> Trophies -> Misc.
• Secondary sorting orders items alphabetically by localized name, quality tier, and durability.
• Safe to use: does nothing while an item is actively being dragged.

Configuration

A config file is generated on first launch at:
Valheim/BepInEx/config/com.awuushy.chesthelper.cfg

Section	Key	Default	Description
Highlight	HighlightRadius	25.0	Search radius in meters (5 to 60)
Highlight	CheckLineOfSight	true	Filter out chests blocked by multiple walls
Highlight	MaxWallObstacles	1	Number of wall/beam obstacles tolerated
Highlight	HighlightColor	#FFE600	Color of the beacon and chest glow
Highlight	EnableChestBeacon	true	Show 3D beacon above matching containers
Highlight	EnableChestLight	true	Spawn point light above matching containers
Highlight	ChestSurfaceGlow	0.55	Surface glow intensity on the chest model
Features	EnableSearchBar	true	Show search bar above player inventory
Sorting	SortButtonText	Auto	Button text ('Auto' follows game language)

Compatibility

• Multiplayer: 100% client-side. Works on dedicated servers and vanilla multiplayer without needing the server or other players to install the mod.
• Quick Stack Mods: Compatible with mods like TidyChests or QuickStackStore.
• Save Safe: Does not add custom items, prefabs, or world data. Safe to install or remove on existing worlds at any time.

Installation

Via Mod Manager (Recommended)

Install through r2modman or Thunderstore Mod Manager.

Manual Installation

1. Install BepInExPack Valheim.
2. Download this package and extract ChestHelper.dll into your Valheim/BepInEx/plugins/ directory.
3. Launch the game.