Valheim INCOMPATIBLE_VERSION Fix: Build ID, Branch & Mod Stack

Valheim "INCOMPATIBLE_VERSION" Fix: Build ID, Branch & Mod Stack

Your Valheim server shows up in the browser. You hit join. The client throws "INCOMPATIBLE_VERSION" and disconnects. Almost every time, the world is fine and the server is fine. The two are simply on different Steam builds, different branches, or one side has a stale BepInEx stack that targets an older game version.

This page walks you through the actual diagnosis instead of guessing. The first step is always: find out what build the client thinks it is.

What the error really means

Valheim refuses to connect when the client's protocol/build does not match the server's. Steam exposes a numeric build ID per game; that number is the only authoritative way to compare what's on each side. The error itself does not show this number, so you have to look it up.

The three real causes, ranked by how often they bite:

1. Branch mismatch: server is on the public-test branch, client is on default (or vice versa).
2. Steam updated the client first: common for a few hours after a patch ships, while the dedicated server build is still propagating.
3. Stale BepInEx plugin: a mod compiled against the previous Valheim version blocks the protocol handshake.

Step 1: Look up the client's build ID

The customer can read this from Steam without joining the server:

1. Open Steam → Library → right-click Valheim → Properties.
2. Open Updates. Steam shows the installed build ID near the top of the panel.
3. Open Betas. The currently selected branch is shown there. If it is anything other than None, write down the branch name.

You now have two facts: what build the client is on and what branch the client is on. Without these, every fix is a guess.

Step 2: Look up the server's build ID and branch

On Supercraft the branch is shown in the panel for the deployment. The current build can be confirmed by reading the version file on disk:

cat vlh/version
# example output
vlh/public-test/latest

If the customer is using the public-test branch and the server is on vlh/stable/latest, that is the bug. Branch names that have shipped at various points include public-test, default_old, and seasonal beta tags. The client's Betas dropdown must match the server's branch by name.

Step 3: Decide which side moves

Step 4: When it's actually the mod stack

If both sides are confirmed identical and join still fails, the BepInEx plugin loader is the next suspect. After a Valheim patch the plugin DLLs are still on disk but the patches they apply target methods that no longer exist. The server log line to look for is in BepInEx/LogOutput.log:

[Error  : Unity Log] NullReferenceException: Object reference not set to an instance of an object
Stack trace:
<ModName>.<ModName>.TryRegisterRecipes ()
<ModName>.ObjectDB_CopyOtherDB_Patch.Postfix ()

The first non-engine stack frame names the broken mod. Either remove that DLL from BepInEx/plugins/ or update it from Thunderstore to the version that targets the current Valheim build.

Things that are not the cause

• The world file. A version mismatch never corrupts the .db / .fwl pair. Do not restore a backup as your first step.
• The server password. Wrong passwords give a different error.
• Crossplay / public-1 flags. Those affect listing and matchmaking, not protocol compatibility.
• Verbose Steam handshake noise. Lines like SteamNetworkingUtils004 before SteamAPI_Init succeeded appear during normal boot and are not the problem on their own.

If you are running modded with friends

Coordinate the branch before the next patch lands. Once Steam ships an update on the default branch, modded groups commonly stay one version behind on the public-test opt-out branch (when one is offered) until every plugin updates. The decision of "who switches branch" is the only thing you have to agree on.

Skip the manual update dance

On Supercraft Valheim hosting the branch picker and the dedicated-server app sit behind one button, so you can swap branches per restart and never SteamCMD a server by hand again. Pair it with the BepInEx setup guide if you run mods.