WK UnlimitBackPack

版本 v1.0.0·更新於 2026-07-09

Removes the backpack encumbrance soft-limit so you can carry unlimited items with no movement/jump debuff. Disables leaderboard score upload for the run via WK_huoyan1231COMLib.

模組介紹 作者原文

WK_UnlimitBackPack

White Knuckle 無限背包 Mod — 移除背包負重軟限制,並藉由 WK_huoyan1231COMLib 關閉本局排行榜成績上傳。

它做了什麼

White Knuckle 的背包(Inventory.bagItems)本身沒有硬性數量上限,物品永遠都能存進去。

真正的“容量限制”是一個負重(encumbrance)軟限制:

  • Inventory.GetUnencumberanceAmount() 決定“無負擔容量”(默認 unencumberedItems = 5,按物品重量計算)。
  • 當 Inventory.GetInventoryWeight() 超過該值時,encumberance 會被壓低到 0.1 ~ 1,

進而在 ENT_Player 中降低移動速度(* GetEncumberance())與跳躍高度 —— 這就是“超出上限後的減益效果”。

本 Mod:

  • 無限背包容量:把 GetUnencumberanceAmount() 的返回值替換爲極大值(1E+9),

使物品總重量永遠不超標 → encumberance 恆爲 1 → 不再有任何移動/跳躍減益,

同時仍可繼續往背包裏存放任意數量的物品。

  • 關閉排行榜上傳:在 Mod 加載時(以及每局 M_Gamemode.StartFreshGamemode 開始時)

通過 WK_huoyan1231COMLib.LeaderboardManager.DisableForThisRun(...) 設置

CL_Leaderboard.WK_Leaderboard_Core.disableLeaderboards = true,

使 M_Gamemode.Finish 不再上傳成績(COMLib 會在每局結束時自動重置,故每局都會重新申請)。

與“pouch(挎包/小袋)”無關:pouch 是另一套獨立的硬性容量限制(Pouch.maxCapacity),

本 Mod 不修改 pouch 邏輯。

依賴

  • BepInEx 5.x(通過 Gale / R2MM 或手動安裝)
  • WK_huoyan1231COMLib —— 排行榜管理公共庫(硬依賴,Mod 通過它關閉排行榜)

構建

需要.NET SDK(>= 6.0):

dotnet build WK_UnlimitBackPack.csproj -c Release

產物:bin/Release/net471/WK_UnlimitBackPack.dll

安裝

  • 確保已安裝 BepInEx 5.x 與 WK_huoyan1231COMLib。
  • 將 WK_UnlimitBackPack.dll 複製到:

/BepInEx/plugins/

  • 啓動遊戲即可。

配置

首次運行後會在 BepInEx/config/ 生成配置文件 huoyan1231.whiteknuckle.unlimitbackpack.cfg:

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

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

| EnableUnlimitedBackpack | true | 設爲 false 則保留原版負重限制 |

| DisableLeaderboardOnLoad | true | 設爲 false 則不再關閉排行榜上傳 |

License

GPL-3.0

安裝與使用 安裝:按包內說明操作

  1. 解壓本站下載的壓縮包,先讀包內的 readme / 說明檔案。
  2. 多數模組依賴遊戲的模組載入器:常見做法是用社群模組管理器(如 r2modman)選中本遊戲安裝,由管理器自動處理載入器與依賴。
  3. 手動安裝時,把模組檔案放進遊戲目錄下對應的 Mod / plugins 資料夾。
  4. 啟動遊戲確認載入成功;帶「前置依賴」的模組需要把依賴一併安裝。

不同模組的安裝位置差異較大,包內說明是最可靠的依據。

前置依賴

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

BepInEx-BepInExPackhuoyan1231-WK_huoyan1231COMLib

檔案與校驗

檔案名稱
WK_UnlimitBackPack-1.0.0.zip
檔案大小
118.5 KiB