Tools / Project Zomboid / Fixes
Fix Project Zomboid Missing Mod Errors
The server is trying to load a Mod ID that is not available on disk. Usually the WorkshopItems line, Mods line, or Steam Workshop download is out of sync.
When this is the problem
- The log says a mod could not be loaded, not found, or missing.
- The server stops during startup after loading Workshop items.
- Players can join vanilla servers, but this modded server fails before the world is ready.
Repair steps
- Open the Steam Workshop collection and confirm the item still exists and is public.
- Regenerate WorkshopItems and Mods from the current collection instead of editing one line by hand.
- Stop the server, delete the affected item folder under steamapps/workshop/content/108600, then restart so Steam downloads it again.
- Confirm the Mod ID from the mod's mod.info appears in Mods, not just the numeric Workshop ID.
Prevent it next time
- Keep WorkshopItems and Mods generated from the same collection snapshot.
- Avoid mixing private/deleted Workshop items into public server collections.
- After changing mods, restart once and check the first new startup log before inviting players.
Check the fresh log
After changing the server, restart once and analyze the newest log tail. Do not keep debugging the old failed startup log after the config changes.