UltraEpicFail-WorldNamePathFix icon

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.

Last updated 3 weeks ago
Total downloads 42
Total rating 0 
Categories Misc Client-side Utility
Dependency string UltraEpicFail-WorldNamePathFix-1.0.0
Dependants 0 other packages depend on this package

This mod requires the following mods to function

denikson-BepInExPack_Valheim-5.4.2350 icon
denikson-BepInExPack_Valheim

BepInEx pack for Valheim. Preconfigured with the correct entry point for mods and preferred defaults for the community.

Preferred version: 5.4.2350

README

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).