Skip to content
Project ZomboidViewpoint survival notes

Servers

Project Zomboid file does not match the server: read the paths first

Historical Indie Stone support cases · current Viewpoint server/runtime boundary

The short answer

Save the full error, including the client and server paths. Compare the named Workshop IDs and Mod IDs before reinstalling: different packages can supply the same module. Check the administrator’s intended list and exact game versions. A Lua file mismatch is separate from a Simple Mod Check Java fingerprint warning.

On this page

Record the complete failure

  1. Copy the exact message and both paths before closing it. Keep any item number and relative file name visible.
  2. Ask the administrator for the intended Workshop and Mod IDs; compare them using the two-list reference.
  3. Record the client and server game versions and whether every player fails or only one does.
  4. Keep the failed client log and the corresponding server log time; redact personal paths or addresses before posting publicly.

“Doesn’t match” and “doesn’t exist” are different observations. The first compares different files; the second says a file is missing on a named side. Do not silently substitute one message for the other or assume a RAM setting explains either.

Different packages, same Mod ID

In a November 2023 support case, clarified in July 2024, administrator Beard identified two conflicting subscribed items with the same Mod ID. The recommendation was to unsubscribe from the identified conflicting item. This case explains why comparing the named packages matters; its old item number is not a fix to copy for today’s server.

With the administrator, identify which original package is intended. If your error names an additional conflicting item, remove only that unwanted subscription, allow Steam to apply the change, relaunch and try the same connection. Retain the error and result. Do not replace server files with a stranger’s attachment.

An old manual copy can survive a Workshop change

A November 2024 support reply identifies manually installed mods conflicting with Workshop copies. That is a separate installation location, so unsubscribing from Workshop alone need not remove the old copy.

If your actual client path identifies a manual mod, exit the game, copy that specific mod to a backup outside active mod folders, then remove only the unwanted active copy and retest. This reversible isolation is our diagnostic suggestion; the historical reply used a broader deletion instruction. Do not delete the whole user Zomboid directory, saves or server world.

Compare updates without bypassing checks

If the intended package IDs agree, compare the actual installed versions and completed downloads with the administrator. Arrange a server update/restart when their installation is behind, then repeat the same join. A stale copy is a hypothesis until the files or version evidence support it.

If the message identifies a base-game file rather than a Workshop item, preserve the log and verify the affected game installation through Steam. A launch verification can affect the manually installed loader: check ZombieBuddy after verification afterward.

Do not disable checksums or overwrite arbitrary Lua/scripts to conceal the warning. For Simple Mod Check’s own Java mismatch use its administrator baseline workflow; for an unresolved named file, send both paths, intended IDs, versions and the comparison results to the original support channel. We have not reproduced every historical file error on Build 42.21.

Sources & version

Based on author documentation and community instructions, not our own gameplay test. Later updates may change defaults.