ServersideQoL DuplicateSummonFix
Unofficial server-only fix preventing duplicate summon animation keys, such as Wizardry's staff_summon, from aborting ServersideQoL initialization.
模組介紹 作者原文
ServersideQoL Duplicate Summon Fix
Author: laredson
Unofficial, server-only compatibility patch for ServersideQoL 1.8.0.
It prevents PlayerSpawnedProcessor.Initialize from aborting when multiple modded summon staves use the same attack-animation key, for example:
System.ArgumentException: An item with the same key has already been added.
Key: staff_summon
This is known to occur with content packs that add multiple summon staves, including Wizardry.
What the patch changes
ServersideQoL inserts each summon animation into a dictionary with Dictionary.Add. A repeated animation key throws an exception. This patch changes only that insertion path:
- Unique key: behavior remains unchanged.
- Duplicate key: the configured duplicate policy is applied.
- Default Merge: merges tracked summon-prefab lists and uses the highest MaxSpawned value.
- KeepFirst and KeepLast: diagnostic fallback policies.
Because ServersideQoL indexes this data by animation rather than by individual staff, duplicate staves using the same animation share a combined summon cap under the default merge policy.
Installation
Install only on the dedicated server:
Valheim dedicated server/BepInEx/plugins/ServersideQoL.DuplicateSummonFix.dll
Clients do not need this patch.
Remove any earlier test build before installing this release.
Requires:
- BepInExPack Valheim 5.4.2333 or compatible
- ServersideQoL 1.8.0
Verification
At startup, the server log should contain:
[Info: ServersideQoL Duplicate Summon Fix] Patched PlayerSpawnedProcessor summon animation dictionary insertion.
When a duplicate is encountered, it logs the key once instead of throwing.
Configuration
Generated at:
BepInEx/config/laredson.serversideqol.duplicatesummonfix.cfg
Options:
- DuplicatePolicy = Merge — recommended.
- LogDuplicateKeys = true — logs each duplicate key once.
Tested with
- Valheim 0.221.12
- ServersideQoL 1.8.0
- Wizardry 1.1.8
Compatibility scope
Built specifically for ServersideQoL 1.8.0. If a future ServersideQoL version fixes the issue, remove this patch. If the target method changes, this patch logs an error and does not alter unrelated code.
This is an unofficial patch and is not affiliated with the ServersideQoL or Wizardry authors.
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：