Chest/Item Finder

English

Chest/Item Finder searches nearby loaded containers for an item name and highlights every matching chest in the world.

Features

• Adds a Search button next to the inventory.
• Search by a complete name or any part of an item name.
• Searches English names and the language currently selected in Valheim.
• Shows nearby search suggestions while typing.
• Lists matching nearby item types before the search is executed.
• Matching containers blink visibly for 10 seconds.
• Optional item and quantity labels appear above matching containers.
• Supports normal chests and other loaded objects using Valheim Container inventories.
• Works alongside storage mods such as AzuAutoStore and AzuCraftyBoxes when the containers are loaded on the client.
• The editable translation and alias CSV files are generated in BepInEx/config.

Usage

1. Open the player inventory.
2. Select Search.
3. Enter an item name or part of a name, such as Stone.
4. Press Enter or select the search button.
5. Follow the blinking container and its item label.

Press Escape to cancel the search window. Tab also closes it without starting a search.

Configuration

The configuration is created automatically when the mod starts for the first time:

BepInEx/config/LEGIOmods.ChestFinder.cfg

Important settings:

• [Search] Radius = 50 — search radius around the player, in metres.
• [Marker] BlinkDurationSeconds = 10 — how long matching containers blink, in seconds.
• [Marker] ShowScreenLabels = true — shows the yellow item/count label above a matching container.
• [Performance] ScanCooldownSeconds = 3 — minimum delay between nearby-container scans.

Restart Valheim after changing the configuration file.

Translation and alias CSV files

The mod creates two editable files in BepInEx/config:

• ChestFinder.ItemTranslations.csv — overview of item tokens, prefabs, English names and available translations.
• ChestFinder.ItemAliases.csv — additional search words. Use semicolons to separate aliases, for example:

"PrefabName","EnglishAliases","GermanAliases"
"RoundLog","core wood;corewood","Kernholz;Kern"

The CSV files are optional. The mod still works if they are missing or contain an invalid row.

Installation

Install with r2modman or Thunderstore Mod Manager. For manual installation, place ChestFinder.dll in BepInEx/plugins/ChestFinder.

Chest/Item Finder is client-side. The server and other players do not need the mod.

Troubleshooting

• Only loaded containers within the configured radius can be searched. Unloaded areas cannot be scanned.
• The search works with regular chests, carts, the obliterator and other objects that use a Valheim Container inventory.
• If an item is not found, check the search radius and whether the storage object is currently loaded near the player.
• For diagnostics, see BepInEx/LogOutput.log.

Highlighted chest

The matching chest blinks white and displays the item quantity.

AI disclosure

OpenAI Codex was used to assist with code, localization, documentation, and Thunderstore package preparation.

Deutsch

Chest/Item Finder durchsucht geladene Behälter in der Nähe nach einem Gegenstand und hebt jede passende Kiste in der Spielwelt hervor.

Funktionen

• Fügt neben dem Inventar eine Schaltfläche Suchen hinzu.
• Suche nach einem vollständigen Namen oder einem beliebigen Teil des Gegenstandsnamens.
• Durchsucht englische Namen und die aktuell in Valheim ausgewählte Sprache.
• Zeigt während der Eingabe Suchvorschläge aus der Umgebung.
• Zeigt passende Gegenstandsarten in der Nähe bereits vor dem Start der Suche.
• Passende Behälter blinken 10 Sekunden lang deutlich sichtbar.
• Optionale Beschriftungen zeigen Gegenstand und Menge über passenden Behältern.
• Unterstützt normale Kisten und andere geladene Objekte mit einem Valheim-Container-Inventar.
• Funktioniert zusammen mit Lagermods wie AzuAutoStore und AzuCraftyBoxes, solange die Behälter auf dem Client geladen sind.
• Bearbeitbare Übersetzungs- und Alias-CSV-Dateien werden unter BepInEx/config erzeugt.

Verwendung

1. Öffne das Spielerinventar.
2. Wähle Suchen.
3. Gib einen Gegenstandsnamen oder einen Teil davon ein, zum Beispiel Stein.
4. Drücke Enter oder wähle die Suchschaltfläche.
5. Folge der blinkenden Kiste und ihrer Gegenstandsbeschriftung.

Mit Escape wird das Suchfenster geschlossen. Tab schließt es ebenfalls, ohne eine Suche zu starten.

Konfiguration

Die Konfiguration wird beim ersten Start der Mod automatisch erstellt:

BepInEx/config/LEGIOmods.ChestFinder.cfg

Wichtige Einstellungen:

• [Search] Radius = 50 — Suchradius um den Spieler in Metern.
• [Marker] BlinkDurationSeconds = 10 — Dauer des Blinkens passender Behälter in Sekunden.
• [Marker] ShowScreenLabels = true — zeigt die gelbe Gegenstands-/Mengenanzeige über passenden Behältern.
• [Performance] ScanCooldownSeconds = 3 — Mindestzeit zwischen Umgebungsscans.

Nach Änderungen an der Datei Valheim einmal neu starten.

Übersetzungs- und Alias-CSV-Dateien

Die Mod erstellt unter BepInEx/config zwei bearbeitbare Dateien:

• ChestFinder.ItemTranslations.csv — Übersicht der Gegenstands-Tokens, Prefabs, englischen Namen und Übersetzungen.
• ChestFinder.ItemAliases.csv — zusätzliche Suchbegriffe; mehrere Begriffe werden mit Semikolon getrennt.

Beispiel:

"PrefabName","EnglishAliases","GermanAliases"
"RoundLog","core wood;corewood","Kernholz;Kern"

Die CSV-Dateien sind optional. Die Mod funktioniert auch ohne sie oder bei einer ungültigen Zeile weiter.

Installation

Mit r2modman oder Thunderstore Mod Manager installieren. Bei manueller Installation ChestFinder.dll nach BepInEx/plugins/ChestFinder kopieren.

Chest/Item Finder ist eine Client-Mod. Server und andere Spieler benötigen sie nicht.

Hinweise bei Problemen

• Es können nur geladene Behälter innerhalb des eingestellten Radius durchsucht werden. Nicht geladene Gebiete lassen sich nicht scannen.
• Die Suche funktioniert mit normalen Kisten, Karren, dem Vernichter und anderen Objekten mit einem Valheim-Container-Inventar.
• Wird ein Gegenstand nicht gefunden, prüfe Suchradius und ob der Behälter aktuell in der Nähe geladen ist.
• Für Diagnosen siehe BepInEx/LogOutput.log.

Hervorgehobene Kiste

Die passende Kiste blinkt weiß und zeigt die gefundene Gegenstandsmenge an.

KI-Hinweis

OpenAI Codex wurde für Unterstützung bei Code, Lokalisierung, Dokumentation und der Thunderstore-Paketvorbereitung eingesetzt.

License

Licensed under the MIT License. See LICENSE.