Storage Filter

Thunderstore install: install the BepInEx-BepInExPack dependency, then copy the included DLL to BepInEx/plugins/GraveyardKeeper2.StorageFilter/.

Too many chests and storage rooms to search through? Storage Filter adds unified search and locator tools to chests, storage rooms, and conveyor storage.

Features

• Shared search: one query is reused across all supported storage windows.
• Pinyin search: full pinyin, initials, and spaced pinyin are supported. For example, a Chinese item named "火焰" can be matched with huoyan, hy, or huo yan.
• Dim or highlight: dim non-matching slots, or highlight matching slots with a subtle gold border.
• R = find storage: locate containers holding the hovered item, recipe result, or current search target.
• U = find crafting station: locate stations that know the recipe. Alchemy, distillation, and sermon-style recipe families use the game's corresponding craft element type.
• Task-style magnifier: matching buildings are highlighted and marked with a vanilla-style magnifying-glass bubble. Off-screen targets pin to the screen edge with a direction pointer.
• Cross-area guidance: R/U searches every currently loaded area. When the target is elsewhere, guidance first points to the connecting door or cellar entrance and refreshes after crossing.
• Non-destructive: scanning happens only when R or U is pressed. The mod does not move items, craft automatically, or write save data.
• No idle cost: the plugin no longer scans the loaded assemblies every frame to detect Storage Console, so it stays cheap even when Storage Console is not installed.

Key behavior

• R priority: hovered item > current recipe window > global search text.
• U priority: current recipe window > hovered item > global search text.
• While the search box is focused, R and U are treated as normal text input.
• The locator does not run while build or deconstruct mode is active.
• Highlights and markers last 6 seconds by default. At most the nearest 64 targets get markers; every matching building is still tinted.
• All currently loaded scenes/areas are searched; the locator never forces a new area to load.

Subscription is not auto-install

Workshop only downloads the files. The game does not automatically load Workshop DLLs. Copy the plugin once after subscribing.

Installation

• Close the game.
• Install BepInEx 5.4.x if needed.
• Open CopyToGameFolder in this item and merge its BepInEx folder into the game folder.
• Start the game and load a save.

GameFolder\BepInEx\plugins\GraveyardKeeper2.StorageFilter\GraveyardKeeper2.StorageFilter.dll

Configuration

GameFolder\BepInEx\config\gk2.storagefilter.cfg

`[Filter] SearchText = VisualMode = Dim PinyinSearch = true

[Locator] Enabled = true FindStorageKey = R FindCraftKey = U HighlightSeconds = 6`

Compatibility

• Standalone; it does not require or patch Shared Storage.
• When Shared Storage is installed, U naturally sees its cross-zone material pool because the locator calls the game's own crafting checks.
• With Storage Console 1.1.0+, this mod injects its search bar into the console's right-side aggregate panel. With Console 1.2.0+, the bar also exposes a two-state "Name / Quantity" sort button. It only changes display order and never modifies inventory.
• Only the consumer side performs optional integration. The mods remain independent and update separately.

Changelog

• 1.6.4: fixed a severe performance bug. Without Storage Console installed, the plugin probed for the console API on every frame, and every miss enumerated all loaded assemblies twice; the game dropped to single-digit FPS even at the main menu. The probe is now a cheap plugin-presence lookup plus a one-time type resolution.
• 1.6.2: cross-zone route markers are recalculated after the player changes area or crosses a door, so guidance continues to the next route segment or the real station instead of stopping at the old door.
• 1.6.1: when the target is in another area, the marker first points to the door or cellar entrance leading there and explains that the target is outside the current area.
• 1.6.0: locator coverage now includes every currently loaded area and inactive object; R marks all matching containers and U marks the nearest crafting station.
• 1.5.3: U now uses the same crafted-at station index as the native tooltip. Alchemy and other special stations are preferred; study stations remain a last-resort fallback.
• 1.5.2: fixed pooled cell visuals leaking into the character page or backpack after searching a storage window.
• 1.5.1: fixed missing Chinese glyphs in the injected search bar. The mod now scores the fonts available to the window, prefers one that can render the required characters, and falls back to English labels (Dim / Highlight / Name / Qty) when no CJK-capable font exists.
• 1.5.0: optional quantity-sort bridge for Storage Console 1.2.0+.
• 1.4.1: fixed false "cannot craft" results for alchemy, distillation, and sermon recipe families.
• 1.4.0: moved the console search bar to the external filter host.
• 1.3.1: added a reusable pinyin matching API.
• 1.3.0: added full-pinyin and initial-letter search.
• 1.2.0: added vanilla-style magnifier markers and off-screen direction pointers.

Troubleshooting

• Search bar or R/U does not work: verify the DLL path and check BepInEx\LogOutput.log for Storage Filter 1.6.4 loaded.
• Search-bar buttons are blank or the placeholder only shows "ID": update to 1.6.4 and verify Storage Filter 1.6.4 loaded in LogOutput.log.
• Game stutters or drops to single-digit FPS: fixed in 1.6.4; update and confirm Storage Filter 1.6.4 loaded in LogOutput.log.
• Pinyin does not match: verify PinyinSearch = true, then test huoyan or hy.
• U still reports unavailable: include LogOutput.log, the item name, and a screenshot of the intended crafting station. 1.6.4 prioritizes the native tooltip crafted-at index and keeps the study-station fallback.

About

Source code is included in SourceCode. Report issues with BepInEx\LogOutput.log and your mod list.