SwiftPickupMagnetFix

版本 v2.0.0·更新於 2026-09-20

Stops SwiftPickup's magnet from dragging items you cannot carry. Checks free slots, partial stacks and carry weight.

模組介紹 作者原文

SwiftPickup Magnet Fix

SwiftPickup aimante les objets au sol sans jamais vérifier qu'ils peuvent entrer dans

l'inventaire. Quand celui-ci est plein, les objets sont tirés vers le joueur, le

ramassage échoue, puis ils sont réinjectés au scan suivant — ils finissent par suivre

le joueur en permanence.

Ce plugin retire de la liste magnet tout objet que l'inventaire ne peut pas accepter.

Il ne touche ni au ramassage, ni au merge des drops, ni au multiplicateur de loot.

Détail du test

Un objet est écarté si l'une des deux conditions échoue:

  • Inventory.CanAddItem(item) — cases libres ou pile partielle compatible
  • `GetTotalWeight() + item.GetWeight()

Fonctionnement

Prefix Harmony sur SwiftPickup.SwiftPickupPlugin.MoveMagnets, appelée à chaque frame

depuis le postfix de Player.Update. La liste statique MagnetItems est purgée avant

tout déplacement. HandleScan réinjecte les objets au scan suivant (0,15 s par défaut),

le prefix les retire à nouveau avant la frame suivante: déplacement net nul.

Les internes de SwiftPickup sont résolus par reflection. Si une mise à jour renomme

MoveMagnets ou MagnetItems, le plugin logge un avertissement et ne patche rien

plutôt que de casser le jeu.

Configuration

BepInEx/config/saru.swiftpickup.tweaks.cfg

| Clé | Défaut | Effet |

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

| Enabled | true | Active le filtrage de la liste magnet |

Compilation

dotnet build -c Release -p:Deploy=true

Les chemins ValheimDir et BepInExDir sont définis dans le.csproj et peuvent être

surchargés en ligne de commande. Cibler net472 demande soit le package NuGet

Microsoft.NETFramework.ReferenceAssemblies, soit le.NET Framework 4.7.2 Developer Pack.

Testé avec SwiftPickup 1.3.3 et BepInEx 5.

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

denikson-BepInExPack_ValheimSoulEmper0r-SwiftPickup

檔案與校驗

檔案名稱
SwiftPickupMagnetFix-2.0.0.zip
檔案大小
13.3 KiB