SonicPickupFilters
Per-item auto-pickup rules: Allow, Block, or Cap. In-game panel with search and category filter. Manual pickup still works.
About this mod Author’s original text
Sonic Pickup Filters
Valheim BepInEx mod for per-item auto-pickup rules: Allow, Block, or Cap.
Identity
| | |
| --- | --- |
| Author | SonicDM |
| Plugin name | Sonic Pickup Filters |
| Plugin GUID | com.sonicdm.valheim.sonicpickupfilters |
| Assembly | SonicPickupFilters.dll |
| Version | 0.1.0 |
| Config file | BepInEx/config/com.sonicdm.valheim.sonicpickupfilters.cfg |
| Source | |
Features
- Allow — vanilla auto-pickup (default). Block unchecked.
- Block — check Block with Cap empty: never auto-pick that prefab; manual Use still works.
- Cap — check Block and set Cap to N: auto-pick only while inventory count is below N. Cap alone (Block unchecked) does nothing.
- Pickup Filter panel — hotkey L (configurable) or inventory bar button. Table of known items with Block + Cap columns, search, and category filter.
- Tabs — All / Blocked / Capped (with counts).
- Clear — resets search and category filter.
- Inventory — hold modifier (default LeftAlt) and right-click an item to toggle Block.
- Client-only; other players do not need the mod.
Configuration
- [General] Enabled, DebugLogging
- [Rules] ItemRules (Prefab:0 = Block, Prefab:N = Cap), DefaultCapUsesMaxStack
- [UI] ToggleKey, InventoryBlockModifier
Example ItemRules:
BlackMetalScrap:0,Wood:50,Stone:100
Installation
- Install BepInExPack and Jötunn.
- Place SonicPickupFilters.dll under BepInEx/plugins.
Build.\build.ps1
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: