WorldNamePathFix
Client fix for Valheim 1.0: black screen when joining a server whose world name contains quotes or other characters invalid in Windows file names.
模組介紹 作者原文
WorldNamePathFix
Client-side workaround for a Valheim 1.0 bug.
Problem
If a dedicated server's world name contains characters that are invalid in Windows file names
(for example quotes: "Welt1"), Windows clients get stuck on a black screen when joining.
The log shows:
System.ArgumentException: Illegal characters in path.
at AltBiomeWorldData.GetFilePath (System.String worldName)
at AltBiomeWorldData.VerifyBiomeData (World world)
What this mod does
It replaces invalid characters with _ only when the game builds the local biome-data
cache file name on your PC. The world, the world name and your character are not changed.
- Install on every Windows client (Steam Deck / Proton users should install it too).
- Not required on the server.
- Remove it once Iron Gate fixes the bug.
Source code is included (WorldNamePathFix.cs).
安裝與使用 安裝：BepInEx 外掛
- 本站下載的壓縮包就是模組本體，通常是 BepInEx 外掛（解壓後得到 .dll 或外掛資料夾）。
- 建議流程：用社群模組管理器（如 r2modman）選中本遊戲後匯入該模組，管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程：先在遊戲目錄裝好 BepInEx 載入器，再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲，BepInEx 控制台會列印載入日誌；確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝，否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時，主機與所有用戶端需要安裝一致的模組。
下面這些內容需要先安裝，否則該模組不會生效：