DetectStorage

版本 v0.1.0·更新於 2026-02-19

Detect Storage adds Detect Hub + Detect Chest for server-authoritative loot sorting in Valheim.

模組介紹 作者原文

Detect Storage (Valheim Mod)

Detect Storage adds a clean sorting workflow with 2 build pieces in a new Hammer category called Detect:

  • Detect Hub
  • Detect Chest

The system is multiplayer-safe and server-authoritative:

  • client sends requests only
  • server validates object + distance
  • server performs all item moves/filter writes

What it does

Detect Hub

  • Recipe: 20 Wood + 20 Stone
  • Container where you drop items to sort
  • Default scan range: 20m (Hub.ScanRadiusMeters)
  • Sort trigger: open the hub and press G
  • Cooldown: Hub.SortButtonCooldownSeconds (default 0.5)

Sort behavior:

  • Reads each stack in the hub
  • Finds Detect Chests in range that match the item filter
  • Moves to the first matching chest with enough space
  • Leaves stack in hub if no matching/free chest is available

Detect Chest

  • Recipe: 5 Wood
  • Uses vanilla wood chest model
  • Inventory size matches largest vanilla chest size
  • Single-item filter mode (v0.1)

Filter usage:

  • Open a Detect Chest
  • Press F to enter filter mode
  • Click an item to set filter
  • Press F then click empty slot to clear filter

Persistence:

  • ZDO key: detect_filter_item
  • Value: item prefab name

If filter is not set, Detect Chest accepts nothing.

Build radius visuals

  • The hub radius is shown only while you are in build placement for:
  • Detect Hub
  • Detect Chest
  • Radius is hidden after placement.

Install with r2modman (local zip)

  • Open r2modman (Valheim profile)
  • Import local mod zip
  • Select DetectStorage-0.1.0.zip
  • Launch game

Manual install

Copy:

  • BepInEx/plugins/Detect/Detect.dll

into your profile/server plugin folder:

  • /BepInEx/plugins/Detect/Detect.dll

Required dependencies

  • denikson-BepInExPack_Valheim-5.4.2333
  • ValheimModding-Jotunn-2.27.1

Config keys

  • Hub.ScanRadiusMeters (default 20)
  • Hub.SortButtonCooldownSeconds (default 0.5)
  • Hub.ShowRadiusRing (default true)

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

denikson-BepInExPack_ValheimValheimModding-Jotunn

檔案與校驗

檔案名稱
DetectStorage-0.1.0.zip
檔案大小
95.3 KiB