SonicPickupFilters

版本 v0.1.0·更新於 2026-10-01

Per-item auto-pickup rules: Allow, Block, or Cap. In-game panel with search and category filter. Manual pickup still works.

模組介紹 作者原文

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

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

denikson-BepInExPack_ValheimValheimModding-Jotunn

檔案與校驗

檔案名稱
SonicPickupFilters-0.1.0.zip
檔案大小
225.5 KiB