Valheim Incompatible Version Error: Difference between revisions

From Survival Servers
Jump to navigation Jump to search
[wiki:ss-claude-11372] Fixes: wrong or outdated steps, labels and facts corrected, current pictures, dead links fixed, search title and description
[wiki:wiki-operator] Fixes from the review of the rewording: claims, example addresses, names and wording (approved by Ryan, Nov 19)
 
(2 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{#seo:
{{#seo:
|title=Valheim Incompatible Version Error (and how to fix it)
|title=Valheim Incompatible Version Error: Causes and Fixes
|description=Valheim says Incompatible version when your game and the server run different builds or mods. Update the server or game, match branches, fix mods.
|description=Valheim says Incompatible version when your game and the server run different builds or mods. Update the server or game, match branches, fix mods.
}}
}}
The '''Valheim''' "Incompatible version" error usually means the game you are running and the server you are joining are on different builds. Mismatched required mods (Valheim Plus, BepInEx mods) cause the same error even when the base game versions match. Valheim only lets a client connect to a server that reports the same network version, so the fix is to bring the two sides to the same build, and the same mod versions if you run mods.
The '''Valheim''' "Incompatible version" error usually means the game you're running and the server you're joining are on different builds. Mismatched required mods (Valheim Plus, BepInEx mods) cause the same error even when the base game versions match. Valheim only lets a game connect to a server that reports the same network version. The fix is to bring both sides to the same build, and the same mod versions if you run mods.


== What the error means ==
== What the error means ==


Many Valheim updates change the network version the game reports to servers. When you pick a server in the Join Game list and the versions do not match, the join is refused with "Incompatible version". Nothing on the server is broken and nothing is lost; one side is simply behind.
Many Valheim updates change the network version the game reports to servers. When you pick a server in the Join Game list and the versions don't match, the join is refused with "Incompatible version". Nothing on the server is broken and nothing is lost. One side is behind.


The version number is shown in the bottom left corner of the Valheim main menu. A dedicated server prints its version in the console window when it starts, and a Survival Servers server shows it under '''SERVER DETAILS''' on its page in the Command Center.
The version number is shown in the bottom left corner of the Valheim main menu. A dedicated server prints its version in the console window when it starts, and a Survival Servers server shows it under '''SERVER DETAILS''' on the Game Server page in the Command Center.


Which side is behind decides the fix:
Which side is behind decides the fix:


* '''Steam updated your game and the server did not update.''' The most common case, especially in the hours after a patch. The server needs the update.
* '''Steam updated your game and the server didn't update.''' The most common case, especially in the hours after a patch. The server needs the update.
* '''The server updated and your game did not.''' Steam has not applied the patch to your copy yet, usually because the game was open when the patch went live. The game needs the update.
* '''The server updated and your game didn't.''' Steam hasn't applied the patch to your copy yet, usually because the game was open when the patch went live. The game needs the update.
* '''Both are current and it still fails.''' One side is on a beta branch, or a mod is changing the version the game reports. See fixes 3 and 4.
* '''Both are current and it still fails.''' One side is on a beta branch, or a mod is changing the version the game reports. See fixes 3 and 4.


Line 21: Line 21:
=== Self-hosted dedicated server ===
=== Self-hosted dedicated server ===


A dedicated server installed with SteamCMD does not update itself. Stop the server, then run the same install line you used to set it up:
A dedicated server installed with SteamCMD doesn't update itself. Stop the server, then run the same install line you used to set it up:


<pre>steamcmd.exe +force_install_dir "C:\Valheim\ValheimServer" +login anonymous +app_update 896660 validate +quit</pre>
<pre>steamcmd.exe +force_install_dir "C:\Valheim\ValheimServer" +login anonymous +app_update 896660 validate +quit</pre>
Line 29: Line 29:
=== Rented server ===
=== Rented server ===


On a Survival Servers server the update is the '''Server Update''' setting in the Command Center. Set it to '''Yes, run update''' and press '''Save Settings & Restart'''. If the panel still shows the old version afterwards, run the update once more with '''Yes, run update/validate'''; a patch that lands while the server is starting can leave it half applied.
On a Survival Servers server the update is the '''Server Update''' setting in the Command Center. Set it to '''Yes, run update''' and press '''Save Settings & Restart'''. If the Command Center still shows the old version afterwards, run the update once more with '''Yes, run update/validate'''. A patch that comes out while the server is starting can leave it half applied.


'''Note:''' Update the server first whenever you can.
'''Note:''' Update the server first whenever you can.
Line 35: Line 35:
== Fix 2: Update or verify the game ==
== Fix 2: Update or verify the game ==


If the server is on the current build and your game is not:
If the server is on the current build and your game isn't:


# Close Valheim completely.
# Close Valheim completely.
# In Steam, right-click Valheim, then '''Properties''', '''Installed Files''', and '''Verify integrity of game files'''. Steam downloads anything that is missing or out of date.
# In Steam, right-click Valheim, then '''Properties''', '''Installed Files''', and '''Verify integrity of game files'''. Steam downloads anything that's missing or out of date.
# If Steam shows the update as queued or paused, open the Downloads page and start it.
# If Steam shows the update as queued or paused, open the Downloads page and start it.
# Start Valheim and check the version number in the bottom left of the main menu.
# Start Valheim and check the version number in the bottom left of the main menu.
Line 46: Line 46:
== Fix 3: Match the Steam beta branch ==
== Fix 3: Match the Steam beta branch ==


Valheim has other branches on Steam besides the normal release, such as '''default_old''' (the previous stable build) and, when Iron Gate runs one, a '''public test''' branch that runs ahead of the release. A game on another branch cannot join a server on the release branch, and the other way round, when their network versions differ.
Valheim has other branches on Steam besides the normal release. One is '''default_old''' (the previous stable build). When Iron Gate runs one, there's also a '''public test''' branch that runs ahead of the release. A game on another branch can't join a server on the release branch, and the other way around, when their network versions differ.


To check: in Steam, right-click Valheim, '''Properties''', '''Game Versions & Betas'''. For a normal server the branch must be '''None'''. If you opted into the public test to try new content, switch back to None and let Steam download the release build.
To check: in Steam, right-click Valheim, '''Properties''', '''Game Versions & Betas'''. For a normal server the branch must be '''None'''. If you opted into the public test to try new content, switch back to None and let Steam download the release build.


A dedicated server can be on another branch too. Self-hosted, that is a <code>-beta</code> addition to the SteamCMD line, for example <code>-beta default_old</code>; remove it and run the update to return to the release branch. On a Survival Servers server, the branch is the '''Game Branch''' setting in the Command Center, where '''Stable release (recommended)''' is the normal release. Every player and the server must be on the same branch.
A dedicated server can be on another branch too. On a self-hosted server, that's a <code>-beta</code> option on the SteamCMD line, for example <code>-beta default_old</code>. Remove it and run the update to go back to the release branch. On a Survival Servers server, the branch is the '''Game Branch''' setting in the Command Center, where '''Stable release (recommended)''' is the normal release. Every player and the server must be on the same branch.


== Fix 4: Mods that change the version ==
== Fix 4: Mods that change the version ==


Server side mods such as Valheim Plus and many BepInEx mods compare their own version between client and server. A server running a mod your game does not have, or a different version of it, refuses the join with the same "Incompatible version" message even though the game builds match.
Mods on the server such as Valheim Plus and many BepInEx mods compare their own version between the server and each player's game. A server running a mod your game doesn't have, or a different version of it, refuses the join with the same "Incompatible version" message even when the game builds match.


* If the server runs Valheim Plus, every player needs the same Valheim Plus version installed. See [[How to Install Valheim Plus]].
* If the server runs Valheim Plus, every player needs the same Valheim Plus version installed. See [[How to Install Valheim Plus]].
* If the server was meant to be unmodded, remove the mod from the server. On a Survival Servers server, set '''Mod''' to '''No Mod''', or to '''ValheimOne''' if No Mod is not offered (players need nothing for it), and press '''Save Settings & Restart'''.
* If the server was meant to be unmodded, remove the mod from the server. On a Survival Servers server, set '''Mod''' to '''No Mod''', or to '''ValheimOne''' if No Mod isn't offered (players need nothing for it), and press '''Save Settings & Restart'''.
* After a game update, mods often break until their authors update them. A modded server needs the mod updated as well as the game, and until then even a fully updated vanilla game will not get in.
* After a game update, mods often break until their authors update them. A modded server needs the mod updated as well as the game, and until then even a fully updated vanilla game won't get in.


Valheim Plus has an '''Enforce Mod Version Check''' option in its configuration. Turning it off lets clients with a slightly different Valheim Plus version join. It does nothing for a game version mismatch.
Valheim Plus has an '''Enforce Mod Version Check''' option in its configuration. Turning it off lets players with a slightly different Valheim Plus version join. It does nothing for a game version mismatch.


== Crossplay and console players ==
== Crossplay and console players ==


Iron Gate ships each patch to Steam first. The Microsoft Store, Game Pass, Xbox, PlayStation 5 and Nintendo Switch 2 builds often follow a few days later. On a crossplay server, when a patch changes the network version, players on those platforms see "Incompatible version" from the moment the server updates until their platform receives the same patch. There is nothing to fix on the server; the platform update is the only cure. Setting up crossplay is covered in [[How to Set Up a Valheim Crossplay Server]].
Iron Gate releases each patch on Steam first. The Microsoft Store, Game Pass, Xbox, PlayStation 5 and Nintendo Switch 2 builds often follow a few days later. On a crossplay server, when a patch changes the network version, players on those platforms see "Incompatible version" from the moment the server updates until their platform receives the same patch. There's nothing to fix on the server: only the platform's own update fixes it. How to set up crossplay: [[How to Set Up a Valheim Crossplay Server]].


== Valheim 1.0 on September 9, 2026 ==
== Valheim 1.0 on September 9, 2026 ==


Valheim 1.0 rolled out on September 9, 2026, and it was the largest version change the game has had. Steam updates every client as soon as the build is live. A server still on the previous build refuses those clients with "Incompatible version" until it is updated, so on launch day the order mattered: update the server, then let players update and join.
Valheim 1.0 came out on September 9, 2026, and it was the largest version change the game has had. Steam updates every player's game as soon as the build is live. A server still on the previous build refuses those players with "Incompatible version" until it's updated, so on launch day the order mattered: update the server, then let players update and join.


The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, which 1.0.17 still uses. The server must show the same network version before anyone can join.
The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, and Patch 1.0.20 on October 15, 2026 moved to network version 41. The server must show the same network version before anyone can join.


Existing worlds carry over into 1.0. You do not need a new world, and moving a world between your PC and a server is covered in [[How to Download Your Valheim World]].
Existing worlds carry over into 1.0. You don't need a new world. How to move a world between your PC and a server: [[How to Download Your Valheim World]].


== Quick checklist ==
== Quick checklist ==
Line 91: Line 91:
:[[Valheim Admin Commands]]
:[[Valheim Admin Commands]]


On a Survival Servers [https://www.survivalservers.com/services/game_servers/valheim/ Valheim server] this whole fix is the '''Server Update''' setting in the Command Center: pick '''Yes, run update''' and press '''Save Settings & Restart'''.
On a Survival Servers [https://www.survivalservers.com/services/game_servers/valheim/ Valheim server], this whole fix is the '''Server Update''' setting in the Command Center: pick '''Yes, run update''' and press '''Save Settings & Restart'''.

Latest revision as of 12:21, 19 November 2026

The Valheim "Incompatible version" error usually means the game you're running and the server you're joining are on different builds. Mismatched required mods (Valheim Plus, BepInEx mods) cause the same error even when the base game versions match. Valheim only lets a game connect to a server that reports the same network version. The fix is to bring both sides to the same build, and the same mod versions if you run mods.

What the error means

Many Valheim updates change the network version the game reports to servers. When you pick a server in the Join Game list and the versions don't match, the join is refused with "Incompatible version". Nothing on the server is broken and nothing is lost. One side is behind.

The version number is shown in the bottom left corner of the Valheim main menu. A dedicated server prints its version in the console window when it starts, and a Survival Servers server shows it under SERVER DETAILS on the Game Server page in the Command Center.

Which side is behind decides the fix:

  • Steam updated your game and the server didn't update. The most common case, especially in the hours after a patch. The server needs the update.
  • The server updated and your game didn't. Steam hasn't applied the patch to your copy yet, usually because the game was open when the patch went live. The game needs the update.
  • Both are current and it still fails. One side is on a beta branch, or a mod is changing the version the game reports. See fixes 3 and 4.

Fix 1: Update the server

Self-hosted dedicated server

A dedicated server installed with SteamCMD doesn't update itself. Stop the server, then run the same install line you used to set it up:

steamcmd.exe +force_install_dir "C:\Valheim\ValheimServer" +login anonymous +app_update 896660 validate +quit

Wait for "Success! App '896660' fully installed", then start the server again. The validate option also repairs any damaged file. The full install and start steps are in How to Create a Valheim Server Guide.

Rented server

On a Survival Servers server the update is the Server Update setting in the Command Center. Set it to Yes, run update and press Save Settings & Restart. If the Command Center still shows the old version afterwards, run the update once more with Yes, run update/validate. A patch that comes out while the server is starting can leave it half applied.

Note: Update the server first whenever you can.

Fix 2: Update or verify the game

If the server is on the current build and your game isn't:

  1. Close Valheim completely.
  2. In Steam, right-click Valheim, then Properties, Installed Files, and Verify integrity of game files. Steam downloads anything that's missing or out of date.
  3. If Steam shows the update as queued or paused, open the Downloads page and start it.
  4. Start Valheim and check the version number in the bottom left of the main menu.

The Microsoft Store and Game Pass versions update through the Xbox app instead. Console versions update through the console's own store.

Fix 3: Match the Steam beta branch

Valheim has other branches on Steam besides the normal release. One is default_old (the previous stable build). When Iron Gate runs one, there's also a public test branch that runs ahead of the release. A game on another branch can't join a server on the release branch, and the other way around, when their network versions differ.

To check: in Steam, right-click Valheim, Properties, Game Versions & Betas. For a normal server the branch must be None. If you opted into the public test to try new content, switch back to None and let Steam download the release build.

A dedicated server can be on another branch too. On a self-hosted server, that's a -beta option on the SteamCMD line, for example -beta default_old. Remove it and run the update to go back to the release branch. On a Survival Servers server, the branch is the Game Branch setting in the Command Center, where Stable release (recommended) is the normal release. Every player and the server must be on the same branch.

Fix 4: Mods that change the version

Mods on the server such as Valheim Plus and many BepInEx mods compare their own version between the server and each player's game. A server running a mod your game doesn't have, or a different version of it, refuses the join with the same "Incompatible version" message even when the game builds match.

  • If the server runs Valheim Plus, every player needs the same Valheim Plus version installed. See How to Install Valheim Plus.
  • If the server was meant to be unmodded, remove the mod from the server. On a Survival Servers server, set Mod to No Mod, or to ValheimOne if No Mod isn't offered (players need nothing for it), and press Save Settings & Restart.
  • After a game update, mods often break until their authors update them. A modded server needs the mod updated as well as the game, and until then even a fully updated vanilla game won't get in.

Valheim Plus has an Enforce Mod Version Check option in its configuration. Turning it off lets players with a slightly different Valheim Plus version join. It does nothing for a game version mismatch.

Crossplay and console players

Iron Gate releases each patch on Steam first. The Microsoft Store, Game Pass, Xbox, PlayStation 5 and Nintendo Switch 2 builds often follow a few days later. On a crossplay server, when a patch changes the network version, players on those platforms see "Incompatible version" from the moment the server updates until their platform receives the same patch. There's nothing to fix on the server: only the platform's own update fixes it. How to set up crossplay: How to Set Up a Valheim Crossplay Server.

Valheim 1.0 on September 9, 2026

Valheim 1.0 came out on September 9, 2026, and it was the largest version change the game has had. Steam updates every player's game as soon as the build is live. A server still on the previous build refuses those players with "Incompatible version" until it's updated, so on launch day the order mattered: update the server, then let players update and join.

The 1.0 launch build reported version 1.0.7 (network version 39) in the bottom left of the main menu (Steam dedicated server build 25185644, published September 9, 2026 at 6:00 AM PDT). Hotfix 1.0.12 on September 11, 2026 moved to network version 40, and Patch 1.0.20 on October 15, 2026 moved to network version 41. The server must show the same network version before anyone can join.

Existing worlds carry over into 1.0. You don't need a new world. How to move a world between your PC and a server: How to Download Your Valheim World.

Quick checklist

  1. Compare the version in your main menu with the server's version.
  2. Update whichever side is behind. Server: SteamCMD or Server Update in the Command Center. Game: Steam verify.
  3. Check that the Steam beta branch is None on both sides.
  4. Check for mods on the server and match them on the game, or remove them.
  5. Console or Game Pass player: wait for that platform's patch.

See also

How to Create a Valheim Server Guide
How to Join a Valheim Server
How to Set Up a Valheim Crossplay Server
How to Download Your Valheim World
How to Install Valheim Plus
Valheim Admin Commands

On a Survival Servers Valheim server, this whole fix is the Server Update setting in the Command Center: pick Yes, run update and press Save Settings & Restart.