ValheimDepositAll

版本 v1.0.1·更新於 2026-09-15

在製作臺界面添加「分發」按鈕:一鍵把身上的物品分發到範圍內的所有箱子中,箱子滿了就留在身上。Adds a Deposit button to the crafting panel that distributes your inventory into nearby chests.

模組介紹 作者原文

ValheimDepositAll

在製作臺界面裏添加一個「分發」按鈕:點一下就把身上的物品自動分發到範圍內的所有箱子中。箱子滿了就留在身上,不會丟東西。

適合「工作臺旁邊擺了一排分類箱子」的基地佈局——做完東西不用再一個個開箱手動歸類,一鍵把背包清空進箱子。

功能

  • 一鍵分發:打開工作臺 / 熔爐 / 切石機 / 工匠臺 / 黑鍛爐 / 鐵鍋等任意製作類建築的界面,點擊「分發」按鈕即可。按鈕就位於原版製作按鈕的正下方。
  • 自動找箱子:以玩家爲中心(打開製作臺時還額外以製作臺爲中心,按臺子自身的建造半徑)搜索範圍內的所有容器,把物品分發進去。
  • 只進同類箱子:只把物品放進「已經收着同類物品」的箱子。不會把全新種類的東西隨口塞進恰好有空位的箱子,從而保持你自己給箱子分的類。如果附近沒有對應分類的箱子,物品就留在身上。
  • 保留裝備與快捷欄:默認不碰身上已穿戴的武器、護甲、腰帶、工具,也不碰快捷欄(按鍵 1-8 切換的背包第一行)裏的物品——方便保留常用的食物、藥水、工具。兩者均可在配置裏改成參與分發。
  • 滿了就留在身上:所有同類箱子都放不下的物品留在背包裏,絕不丟棄。完成後在屏幕中央提示結果,並區分原因:已分發 20 件到 2 個箱子,5 件沒有對應分類的箱子,3 件因箱子已滿,留在身上。
  • 可拆分堆疊:一個箱子能塞多少塞多少,剩下的繼續嘗試下一個箱子,不浪費任何剩餘空間。
  • 就近優先:優先填充離玩家最近的箱子。
  • 精確計算容量:按物品名稱 + 品質 + 世界等級判斷箱子的剩餘空間,不會出現"算着能放、實際放不進"的情況。
  • 多人安全:默認只分發到你有權訪問的容器,私人箱子(僅建造者可用)不會被他人誤塞;寫入前會先取得容器所有權,保證改動正確同步。

兼容範圍

  • 覆蓋所有 CraftingStation:工作臺、鍛造臺(熔爐)、切石機、工匠臺、黑鍛爐、鐵鍋,以及各類擴展(StationExtension)提升等級後的範圍。
  • 目標容器是遊戲裏所有 Container:普通箱子、木箱、鐵箱、推車等。
  • 與 ValheimCraftFromContainers 互補:那個 mod 是"從箱子裏取材料做東西",本 mod 是"把身上的東西放回箱子",範圍判定邏輯一致,可同時使用。
  • 不涉及冶煉爐 / 炭窯的放礦放燃料操作。

操作

打開任意製作臺界面,點擊「分發」按鈕即可。無需快捷鍵,也無需逐個打開箱子。

配置

配置文件:BepInEx/config/SuperVikingDepartment.ValheimDepositAll.cfg

| 配置項 | 默認值 | 說明 |

| --- | --- | --- |

| General.Enabled | true | 總開關,關閉後按鈕不再出現。 |

| General.Range | 10 | 以玩家爲中心搜索容器的半徑(米)。 |

| General.UseStationBuildRange | true | 額外以當前製作臺爲中心、按臺子建造半徑搜索。 |

| General.RequireAccess | true | 只分發到你有權訪問的容器(私人箱子僅建造者可用)。 |

| General.KeepEquipped | true | 保留已裝備的物品,不放進箱子。 |

| General.SkipHotbar | true | 保留快捷欄(按鍵 1-8 對應的背包第一行)裏的物品,不放進箱子。 |

| General.AddButton | true | 是否添加「分發」按鈕(關閉後本 mod 不改動界面)。 |

| General.ButtonLabel | 空 | 按鈕文字。留空 = 中文界面顯示「分發」,其他語言顯示「Deposit」。 |

| General.ShowMessage | true | 完成後是否在屏幕中央提示結果。 |

| Diagnostics.DebugLogging | false | 輸出分發細節日誌,排查問題用。 |

安裝

方式一:r2modman Mod Manager(推薦)

  • 在 r2modman 中安裝 ValheimDepositAll。
  • 確保已安裝依賴 BepInExPack_Valheim。
  • 啓動遊戲。

方式二:手動安裝

  • 安裝 BepInExPack for Valheim。
  • 把 ValheimDepositAll.dll 放到 Valheim/BepInEx/plugins/。
  • 啓動遊戲。

啓動後在 BepInEx/LogOutput.log 裏可見:

Loading [ValheimDepositAll 1.0.1]

[DepositAll] 已掛載補丁 InventoryGui.UpdateRecipe

[DepositAll] ValheimDepositAll loaded (v1.0.1)

從源碼構建

需要.NET SDK。倉庫放在 Valheim 安裝目錄下的子文件夾裏,直接構建即可:

dotnet build -c Release

若在其他位置構建:

dotnet build -c Release -p:ValheimDir="C:\...\steamapps\common\Valheim\"

打包發佈 zip:./build-package.sh

常見問題

按鈕沒出現?

確認 General.AddButton 與 General.Enabled 都是 true,並檢查日誌裏是否有 InventoryGui.UpdateRecipe 的掛載記錄。遊戲大版本更新可能改變該方法簽名,屆時日誌會明確報出。

箱子就在旁邊,但沒被分發到?

分兩步看:一是 General.Range(默認 10 米)與箱子隱私設置——私人箱子只有建造者本人能分發進去,General.RequireAccess 關閉後會嘗試所有箱子,但原版對 Group 權限的箱子本身也不可訪問;二是該箱子裏是否已經有同類物品——本 mod 只往同類箱子裏放,新種類不會開新分類。提示信息會告訴你是哪一類原因。

有些東西沒進箱子?

屏幕提示會區分「沒有對應分類的箱子」和「同類箱子已滿」兩種情況。無論哪種,物品都安全地留在你身上,不會丟失。

許可

MIT

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

denikson-BepInExPack_Valheim

檔案與校驗

檔案名稱
ValheimDepositAll-1.0.1.zip
檔案大小
24.5 KiB