ChestItemFilter

Choose what each vanilla chest accepts, even when it is empty. Set aside a chest for wood, food or a few specific items, then manage its filter from the button beside the storage name.

Features

• Assign several items to each chest, including an empty one.
• Search discovered items by name and narrow the list with category checkboxes.
• Add items with the arrow buttons or a quick double click. Search and categories leave your selected filter unchanged.
• Hover over a chest to see its assigned items.
• Keep existing contents when changing a filter. The filter limits new items entering the chest.

Set up a filter

Open a chest and click the funnel button beside its name. Select an item in the left list, then click the right arrow or double-click the item to add it. Select an item on the right and use the left arrow to remove it.

Click Confirm to save. Close or Escape discards an unsaved selection. Clear filter removes the restriction and leaves the contents in place.

Combine category checkboxes to broaden the search. All resets the categories. Scroll either list with the mouse wheel, scrollbar or its end arrows. Items without icons stay hidden in the available list; previously assigned items remain in the filter if their icon or item mod becomes unavailable.

Compatibility

Supports wooden, reinforced, personal and black metal chests, plus the vanilla barrel. Ships, carts and gravestones are excluded.

Other inventory replacements or mods that move items outside the standard inventory methods may need separate compatibility support. If another inventory UI conflicts with manual transfers, disable BlockManualInvalidItems; automatic transfers still use the filter.

For multiplayer, install the same version on the server and all participating clients.

Installation

Install BepInExPack Valheim, then install ChestItemFilter through your mod manager or copy the archive's BepInEx folder into the game or profile folder.

Keep both files in BepInEx/plugins/ChestItemFilter/:

• ChestItemFilter.dll
• VanillaChestItemCategory.dll, the compatibility library for existing integrations.

When replacing the old test mod, remove its full plugin folder before installing this package. Keep your configuration file.

Localization

Available in 24 languages: English, Russian, Serbian (Latin), Ukrainian, German, French, Chinese (Simplified), Swedish, Spanish, Italian, Turkish, Japanese, Portuguese (Brazil), Polish, Chinese (Traditional), Korean, Dutch, Romanian, Bulgarian, Macedonian, Finnish, Danish, Norwegian and Czech.

The interface follows the game's language setting and falls back to English. Valheim supplies item names, including names from item mods.

Configuration

The configuration file is created after the first launch:

BepInEx/config/dellarion.valheim.vanillachestitemcategory.cfg

The filename stays the same for existing users. Updates preserve saved values. Restart the game after editing the file.

Boolean values below are shown as Enabled or Disabled.

Setting	Type	Default	Allowed values / range	Description
Enabled	Boolean	Enabled	Enabled / Disabled	Turn item filters on or off.
ShowFilterButton	Boolean	Enabled	Enabled / Disabled	Show the filter button on supported storage.
FilterRadiusIntegrationEnabled	Boolean	Enabled	Enabled / Disabled	Let supported nearby sorters prioritize assigned chests, including empty ones.
ShowUndiscoveredItems	Boolean	Disabled	Enabled / Disabled	Include undiscovered inventory items in the available list.
BlockManualInvalidItems	Boolean	Enabled	Enabled / Disabled	Reject incompatible manual transfers. Disable for a conflicting inventory UI; automatic filtering stays enabled.

Save compatibility

Each chest keeps its own filter. Changing or clearing it leaves existing items in place. Chests without a filter use their normal storage rules.

Removing the mod restores normal chest behavior. Stored assignments remain available if you reinstall it. ChestItemFilter keeps existing assignments and configuration values when you update it.

Credits and authorship

Created by Dellarion. Uses Valheim's interface resources, BepInEx and Harmony.

UI implementation and icon rendering by ChatGPT (OpenAI).