Mod problems solution

From PZwiki
ModdingMod problems solution
UI Tick.png
This page has been revised for the current stable version (41.78.16).
Help by adding any missing content. [edit]

This is the guide with solutions with mod problems.

Solving the most common problems with mods

In this article, we will tell you what to do if the mod is not installed, does not start, gives errors, breaks the game, etc.

Mod not installed

If you installed the mod via Steam, try this:

  1. Close the game
  2. Unsubscribe from the mod
  3. Subscribe him again
  4. Wait for the mod to install (A loading bar should go through at the bottom of the Steam window. Sometimes the Steam servers are loaded and you need to wait a bit)
  5. Start the game

If you installed the mod manually:

  1. Check that the mod is in the path ...\Zomboid\mods\ (How to find the Zomboid folder).
  2. Check that the mod is not in the archive
  3. Check that the mod folder contains the mod.info file and the media folder (If not, find the folder with these contents. This will be the true mod folder. This is what you need to put in the ...\Zomboid\mods\ folder

Mod installed but won't run

  1. To check if the mod is running in the current game world - press the pause menu and in the lower right corner click on the "Mods" button. You will be shown a list of all running mods in the current game world.
  2. If the mod is red in mods menu (or when save is running - in mod list in lower right corner in pause menu), then the mod is missing a third-party mod that it depends on. It is usually listed on the right side of the mod's Steam page ("Required Items").
  3. If you enabled the mod in the mods menu in the main menu, but the mod did not enable in your old world - Read how to enable mods in the old game world

Mod not working

Have you checked that the mod is enabled in your current game world, but the functionality is not working? Read again in detail the description of the mod on the mod page on Steam. If you did not find the answer to your question - write a comment or ask in #mod_support in the PZ discord

Mod throws errors

A fairly common situation is when a mod provokes errors. Most often, they do not interfere with the game much, but if some errors critically affect your gameplay, then write on the mod page on Steam in the discussion about errors (or in the comments) in detail about the error (in what situations it appears and how it manifests itself). And wait for the mod developer to fix it.

Mod breaks the game

If after installing and running the mod you have:

  1. The game stopped launch - unsubscribe from this mod and try to start the game again.
  2. Broke the save - try removing the mod from the save mods list and load the save again. If that doesn't help, then your save is permanently broken.

Before adding mods to an old save, it is highly recommended to make a backup save!

Mod does not work with other mods

Mods can sometimes conflict with each other. If the errors are not critical for you, you can continue to play. If critical, you will have to remove one of the mods. You can check the mod pages on Steam ahead of time to see if there is a list of incompatible mods.

Can't connect to server due to mod

Try to close the game, unsubscribe from the mod, then subscribe again and try connecting to the server again.

Find the problematic mod 1: Look for logs

Look for logs (especially if errors - bottom right red boxes - show up) they are likely to tell where the problem is.

For solo games and clients/hosts in Multiplayer games, the default log file on Windows is %USERNAME%/Zomboid/console.txt

For server, the default log file on Windows is %USERNAME%/Zomboid/server-console.txt

Find the problematic mod 2: Mod search by dichotomy

You have too many mods (e.g., 100) and meet an unexpected behavior, then you need to:

  1. Get a systematic procedure to reproduce that behavior on a new save (use debug mode to facilitate the reproduction).
  2. Ensure the behavior does not occur without mods on a new save.
  3. Then create a new game with half the mods (e.g., 50 first mods) and apply your procedure.
  4. If the problem occurs, then create a new game with half the mods (e.g., 25 first) and apply your procedure...
  5. If the problem does not occur, then create a new game with the other half (e.g., 50 last mods) and apply your procedure...
  6. Repeat until you circumvent the potential problematic mods to 1: you got it!

Now share what you've found (problem and reproduction procedure) on the mod owner's workshop.

Thank you! You've improved the modding world of Project Zomboid!

See also