You are viewing a potentially older version of this package. View all versions.
Skere-HoardFinder-1.4.1 icon

HoardFinder

Find any item in nearby chests, carts, ships, tombstones and BetrValheim drawers. Sort and filter by type, source or mod, then highlight every match, even through walls. Client-side, read-only, 36 languages.

Date uploaded 3 weeks ago
Version 1.4.1
Download link Skere-HoardFinder-1.4.1.zip
Downloads 272
Dependency string Skere-HoardFinder-1.4.1

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2351 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2351

README

HoardFinder

Press Ctrl + F, type part of an item name, and HoardFinder lists every stack of it stored around you: chests, carts, ships, tombstones and BetrValheim drawers. Pick a result and every place that holds it lights up with a beam and an on-screen marker you can see through walls.

It only runs on your client and never touches your items. Formerly published as BetrDrawerFinder.

Screenshots

The search window

Sorted by mod and filtered to the items added by Monstrum

Two drawers holding Fox Pelt, marked with the amount and distance

A chest and a drawer with Barley Flour, each with its own beam and marker

Features

  • Searches built chests (vanilla and modded), carts, ships and tombstones. Dungeon loot chests are optional.
  • Searches BetrValheim drawers when that mod is installed. Without it, everything else still works.
  • Matches localized names and ignores case, spaces and accents, so black metal, blackmetal and BLACK METAL all find Black metal, and pina finds Piña.
  • Each result shows the item icon, how many places hold it, the total amount and the distance to the nearest one.
  • Sort by relevance, name, amount, distance, item type or source mod. Filter by item type, by kind of storage and by mod.
  • Highlight one item, or every listed item at once with Shift + Enter. Each item gets its own color.
  • The window is drawn with Valheim's own wood panel, text field and buttons, and uses the game's font.
  • Follows the game's language setting. Translated into 36 languages, every one the game offers except Abenaki, which falls back to English.
  • Only lists storage you could open yourself: wards and private chests are respected, like in vanilla.

Controls

Key Action
Ctrl + F Open or close the window
type Search
Up / Down, PageUp / PageDown, mouse wheel Move through the results
Enter or click Highlight every place that holds the selected item
Shift + Enter or Shift + click Highlight every item in the list
Tab / Shift + Tab Change the sort order
Esc Close

While the window is open your character stands still and the camera does not move. Chat, the inventory and the Escape menu stay closed until you close the window.

Changing the shortcut

Click the Shortcut: Ctrl + F [change] line at the bottom of the window and press the new combination. It is saved right away. Esc cancels, Backspace goes back to Ctrl + F. You can also edit OpenSearchHotkey in the config file.

Sorting and filtering

The four buttons under the search field cycle through their options: left click moves forward, right click moves back. A button that is not on its default value is drawn highlighted.

Button Options
Sort Relevance, Name, Amount, Distance, Type, Mod
Type All, Materials, Food, Potions, Ammo, Equipment, Trophies, Other
Source All, Drawers, Chests, Carts & ships, Tombstones, World loot
Mod All, then each mod that has items nearby, vanilla first

Relevance puts exact matches first, then names that start with what you typed, then names that contain it. Sort, type and source are remembered between sessions. The Mod button needs Jotunn, which most modpacks already include; items from mods also show the mod name in small text next to the item.

Highlight

For 10 seconds (configurable) every matching place gets a pulsing glow, a light beam and a screen marker with the item, the amount stored there and the distance. Markers stay visible through walls and stick to the screen edge when the storage is behind you. In a big base only the 8 nearest markers show text, so the screen stays readable.

Installation

Install with r2modman or the Thunderstore app. To install by hand, put HoardFinder.dll in BepInEx/plugins/HoardFinder/.

Updating from BetrDrawerFinder: remove the old BetrDrawerFinder folder from BepInEx/plugins. Your settings are copied over automatically the first time HoardFinder starts. If both are installed, HoardFinder does not load and the BepInEx log says why.

Requirements and compatibility

  • BepInExPack for Valheim.
  • Optional: BetrValheim (tested with 5.1.5) for drawer support.
  • Optional: Jotunn for the mod sort and filter.

HoardFinder is client-side. The server does not need it, other players do not need it, and it does not take part in Jotunn's version check. Valheim already sends chest contents to every nearby player, which is how the mod reads them without opening anything. It never moves items, opens containers or writes world data.

Configuration

The config file is BepInEx/config/heido.valheim.hoardfinder.cfg.

Setting Default What it does
SearchRadius 50 Meters around you that are searched
HighlightDuration 10 Seconds a highlight lasts
MaxSearchResults 50 Rows in the result list
OpenSearchHotkey F + LeftControl Opens the window
ClearHighlightHotkey empty Removes a highlight early
IncludeDrawers true Search BetrValheim drawers
IncludeChests true Search built chests
IncludeVehicles true Search carts and ships
IncludeTombstones true Search tombstones
IncludeWorldContainers false Search dungeon and location loot
RespectStorageAccess true Hide storage you could not open
DetectItemMods true Detect which mod added each item (needs a restart)
EnableDebugLogging false Extra lines in the BepInEx log

Console commands

Open the console with F5:

  • hoard_search iron prints the results for "iron".
  • hoard_dump lists every stored stack within range.
  • hoard_clear removes the current highlight.

Known limits

  • Only storage in loaded areas can be found. 50 m is well inside what the game keeps loaded around you.
  • When another player moves items, the list catches up within a second or two, the normal sync delay.
  • Ctrl is also crouch, so Ctrl + F makes you crouch for an instant. Change the shortcut if that bothers you.
  • The glow depends on the storage's material. Beams and markers always work.
  • The window has no gamepad support yet.
  • Cyrillic, Greek, Asian, Thai and Hindi text uses Unity's default font instead of Valheim's, because the game font only covers Western European letters.

Bugs and suggestions

Open an issue on the project page, and attach BepInEx/LogOutput.log if something went wrong.

CHANGELOG

Changelog

1.4.1

  • Darker window background and search field for easier reading.
  • Fixed: a printable shortcut (for example a bare comma) no longer types its character into the search field.
  • The compiled DLL no longer contains local build paths.
  • Screenshots and project link on the mod page.

1.4.0

  • Renamed from BetrDrawerFinder to HoardFinder, since it now searches all storage and not only BetrValheim drawers. New plugin GUID heido.valheim.hoardfinder; settings from the old config file are imported on first start. HoardFinder refuses to load next to the old BetrDrawerFinder so the two never run together.
  • Console commands renamed to hoard_search, hoard_dump and hoard_clear.
  • First Thunderstore release: manifest, icon, user README and packaging target.
  • Fixed: choosing a result with Enter or a click no longer opens chat or makes the character attack afterwards. The input lock now lasts until those keys are released and then clears Valheim's button states.
  • Fixed: text was hard to read on the light wood panel. The window now uses the dark panel and a dark backdrop behind the text.

1.3.0

  • Searches every container, not only BetrValheim drawers: chests (vanilla and modded), carts, ships, tombstones and, optionally, dungeon loot. BetrValheim is now optional. Containers are registered as they load (Container.Awake postfix), no scene scans.
  • Respects ward permission and container privacy by default (RespectStorageAccess).
  • Sort by relevance, name, amount, distance, type or mod; filter by item type, storage source and mod. Sort, type and source are remembered.
  • Mod detection through Jotunn ModQuery (optional), shown as a tag on modded items.
  • Valheim look: the window, search field and buttons use the game's own UI sprites (wood panel, text field, buttons), 9-sliced, with Valheim's orange and cream palette. Falls back to the flat style if a sprite is missing.
  • Highlights work on any storage; carts and ships get a marker at the container instead of a full-vehicle glow.
  • 29 new or updated strings in all 37 languages.

1.2.0

  • UI translated into every Valheim language (36 plus English); follows the game's language setting live. Averia typeface for Latin-1 languages, Unity's default font with OS fallback for the rest.
  • In-game rebinding of the open shortcut from the search window (Esc cancels, Backspace restores the default).
  • Animations: window open/close transition, staggered rows, gliding selection bar, chosen-row flash, confirmation banner, marker pop-in and growing beams.
  • Highlight collection no longer reuses the search snapshot, so the close animation never shows recycled rows.

1.1.0

  • New window look: Valheim typeface, item icons, column headers, selection accent, hover, thousands separators, scrollbar, placeholder and empty states.
  • Scrolling with mouse wheel and PageUp/PageDown; the selection always stays visible.
  • Shift + Enter / Shift + click highlights every listed item, one color per item.
  • Markers show the amount stored in each drawer; only the 8 nearest are labeled, the nearest is larger, and markers fade out at the end.
  • The hotkey also closes the window; reopening keeps the last query, pre-selected.
  • Accent-insensitive search.
  • ClearHighlightHotkey setting and bdf_clear command.
  • Camera zoom is blocked while the window is open.
  • Performance: drawer snapshot cached for 1 s (typing only re-ranks), pre-formatted row strings, single-pass drawing without GUILayout, marker sorting and pruning at 10 Hz.

1.0.0

  • Search window (Ctrl + F) listing items stored in BetrValheim drawers within SearchRadius, with total amount, drawer count and distance to the closest drawer.
  • Case-insensitive, space-insensitive partial matching on localized names, prefab name as fallback.
  • Highlight of matching drawers for HighlightDuration seconds: glow via MaterialMan, light beam, and screen-space markers visible through walls.
  • bdf_dump and bdf_search console commands.
  • Read-only, client-side integration through DrawerIndex.All and the public Drawer members, with logged fallbacks.