Forcer des mods identiques sur un serveur Valheim
« Incompatible version », une déconnexion au bout de trois secondes, un coffre qui affiche des objets fantômes chez un seul joueur : sur un serveur Valheim moddé, presque tous les problèmes de connexion viennent d’un écart de mods entre le serveur et un joueur.
Bonne nouvelle : l’écosystème de mods Valheim a prévu des mécanismes pour refuser à l’entrée un joueur dont les mods ne correspondent pas, et pour imposer la configuration du serveur. Ce guide explique lesquels, comment lire leurs messages, et la méthode pour que tout le clan reste synchronisé.
⚔️ Serveur Valheim moddé
Accès SFTP complet, logs en direct
Un hébergeur Valheim pensé pour les mods : BepInEx, console en temps réel et 8 Go de RAM dès 11,90 €/mois sur Ryzen 9 5950X, support français 24/7.
Pourquoi un écart de mods casse tout
Sur Valheim, chaque joueur simule une partie du monde — les zones autour de lui, les créatures qu’il « possède ». Le serveur, lui, arbitre et stocke. Si un mod ajoute un objet, une recette ou une créature d’un côté mais pas de l’autre, les deux ne parlent plus de la même chose :
- dans le meilleur des cas, le joueur est refusé à la connexion avec un message clair ;
- dans le pire, il entre, et les incohérences apparaissent plus tard : objets qui disparaissent, créatures invisibles, config différente d’un joueur à l’autre.
Le but de ce guide est de vous placer dans le premier cas, jamais dans le second.
Les quatre niveaux de contrôle
| Niveau | Qui le fait | Ce qui est vérifié |
|---|---|---|
| Version du jeu | Valheim lui-même | Client et serveur ont la même version du jeu |
| Jötunn | Les mods construits sur Jötunn | Présence et version de chaque mod, selon le niveau choisi par l’auteur |
| ServerSync | Les mods qui l’intègrent | Version minimale + synchronisation et verrouillage de la config |
| Réglage propre au mod | Certains gros mods | Exemple : l’option enforceMod de ValheimPlus |
Un mod qui n’utilise aucun de ces mécanismes n’est jamais vérifié. C’est lui qui provoque les bugs silencieux.
Niveau 1 — La version du jeu
Valheim compare la version du client et celle du serveur à chaque connexion. Un écart = refus, avec un message « incompatible version » côté joueur.
Depuis la 1.0, c’est un piège fréquent : les correctifs s’enchaînent (1.0.15 le 18 septembre, 1.0.16 le 25 septembre 2026) et arrivent d’abord sur Steam. Mettez le serveur à jour en même temps que les clients : mettre à jour un serveur Valheim.
Si la version du jeu est identique partout et que le refus persiste, le problème vient des mods.
Niveau 2 — Jötunn et son contrôle de compatibilité
Jötunn est une bibliothèque sur laquelle reposent de nombreux mods Valheim. Chaque mod qui l’utilise déclare un niveau de compatibilité réseau (NetworkCompatibility), et c’est le serveur qui décide si le client est admis :
| Niveau déclaré par le mod | Ce qu’il exige |
|---|---|
NotEnforced | Rien : ni présence, ni version |
VersionCheckOnly | Si le mod est installé des deux côtés, les versions doivent correspondre |
EveryoneMustHaveMod | Le mod doit être présent partout, dans une version compatible |
ClientMustHaveMod | S’il est sur le serveur, chaque joueur doit l’avoir |
ServerMustHaveMod | S’il est chez un joueur, le serveur doit l’avoir |
Le degré d’exigence sur la version (majeure, mineure ou correctif) est aussi choisi par l’auteur du mod.
Ce que voit le joueur refusé : une erreur de version qui nomme le mod en cause (son identifiant de plugin), la version installée et la version exigée. C’est le message le plus utile de tout l’écosystème : lisez-le, il vous dit exactement quoi corriger.
Vous ne réglez pas ce niveau vous-même : il est défini par chaque auteur. Votre seul levier est d’avoir les mêmes mods, dans les mêmes versions, partout.
Niveau 3 — ServerSync : version minimale et config verrouillée
ServerSync est une autre brique utilisée par beaucoup de mods. Elle apporte deux choses.
La version minimale
Un mod qui intègre ServerSync peut déclarer :
- une version courante : si le joueur n’a pas la même, un avertissement apparaît dans son log BepInEx (sans blocage) ;
- une version minimale requise : si le joueur a une version plus ancienne que ce minimum, il est immédiatement déconnecté avec un message qui explique pourquoi.
La config imposée par le serveur
C’est la fonction la plus précieuse pour un admin : les réglages déclarés « synchronisés » sont envoyés par le serveur aux joueurs. Le fichier .cfg du serveur fait foi.
La plupart de ces mods exposent une option de verrouillage, souvent nommée Lock Configuration dans la première section de leur fichier de config :
- verrouillée : seul un administrateur du serveur peut modifier les réglages synchronisés ;
- déverrouillée : chaque joueur peut changer ses réglages localement.
Sur un serveur communautaire, verrouillez. Sinon, un joueur peut par exemple s’octroyer un poids de portage ou des taux de récolte différents des autres.
Le nom exact de l’option varie d’un mod à l’autre : ouvrez son fichier dans
BepInEx/config/et cherchez « lock ».
Niveau 4 — Les réglages propres à certains mods
Certains gros mods ont leur propre contrôle. L’exemple le plus connu est ValheimPlus, dont la section [Server] de valheim_plus.cfg contient une option enforceMod qui impose la présence du mod chez les joueurs.
Vérifiez dans la documentation de chacun de vos mods majeurs s’il propose ce type d’option — et s’il a bien été mis à jour pour la 1.0 avant de l’installer.
Où lire l’erreur exacte
| Où | Ce que vous y trouvez |
|---|---|
| Écran du joueur refusé | Le message de version, avec le nom du mod pour les mods Jötunn |
Log BepInEx du joueur (BepInEx/LogOutput.log dans son profil) | Les avertissements ServerSync, les erreurs de chargement |
Log BepInEx du serveur (BepInEx/LogOutput.log) | La liste des plugins chargés au démarrage, et ceux qui ont échoué |
| Log du serveur Valheim | Les connexions et les refus |
Tout ce qu’il faut savoir pour lire ces fichiers : lire les logs d’un serveur Valheim.
La méthode qui évite 90 % des problèmes
- Un seul profil de référence. L’admin construit le modpack dans r2modman et diffuse le code de profil : tout le monde importe exactement la même liste, dans les mêmes versions. Procédure : installer un modpack r2modman sur un serveur Valheim.
- Pas de mise à jour individuelle. Un joueur qui clique « tout mettre à jour » dans son r2modman se crée un écart de version. Règle du serveur : on ne met à jour que quand l’admin diffuse un nouveau code.
- Mises à jour groupées. L’admin met à jour le profil, teste en solo, met à jour le serveur, puis diffuse le nouveau code.
- Config verrouillée sur tous les mods qui le proposent.
- Un test à deux avant chaque ouverture : l’admin et un joueur avec le profil importé.
Cas particulier : les joueurs console et Game Pass
Les joueurs PS5, Switch 2 et Xbox ne peuvent pas installer de mods, et un serveur BepInEx ne tourne pas en crossplay. Tout mod qui doit être présent chez le client les exclut de fait.
Il faut donc choisir : serveur moddé réservé aux joueurs PC Steam, ou serveur vanilla en crossplay. Beaucoup de clans font tourner les deux. Voir activer le crossplay sur un serveur Valheim.
FAQ
Que veut dire « incompatible version » sur un serveur Valheim ?
Soit la version du jeu diffère entre le joueur et le serveur, soit un mod vérifié (via Jötunn, ServerSync ou un réglage propre au mod) n’a pas la même version, ou manque d’un côté. Commencez par la version du jeu, puis lisez le message : les mods Jötunn nomment le mod en cause.
Comment obliger tous les joueurs à avoir les mêmes mods ?
Diffusez un code de profil r2modman unique, interdisez les mises à jour individuelles, et privilégiez des mods qui intègrent un contrôle de version (Jötunn, ServerSync). Les mods sans contrôle ne peuvent pas être imposés : c’est à vous de vérifier.
Comment empêcher un joueur de modifier la config d’un mod ?
Si le mod utilise ServerSync, activez son option de verrouillage (souvent Lock Configuration) dans son fichier .cfg côté serveur. Seuls les administrateurs pourront alors modifier les réglages synchronisés.
Un joueur entre sur le serveur mais voit des objets bizarres, pourquoi ?
Un mod présent chez lui ou sur le serveur n’est pas vérifié à la connexion. Comparez sa liste de mods avec le profil de référence, et faites-lui réimporter le code.
Les mods fonctionnent-ils avec le crossplay ?
Non : BepInEx n’est pas compatible avec un serveur lancé en -crossplay, et les joueurs console ne peuvent pas installer de mods.
Conclusion
Un serveur Valheim moddé stable repose sur une règle simple : un profil de référence, diffusé par code, mis à jour par l’admin seul. Les contrôles de Jötunn et ServerSync font ensuite le travail de refuser à l’entrée ceux qui ne sont pas à jour, et le verrouillage de config garantit que tout le monde joue avec les mêmes règles.
Pour un serveur moddé avec accès complet aux fichiers et aux logs, HebergTonServ propose 8 Go de RAM dès 11,90 €/mois et 16 Go à 17,90 €/mois.
Pour aller plus loin
- Meilleur hébergeur Valheim 2026 : comment choisir
- Installer un modpack r2modman sur un serveur Valheim
- Installer BepInEx sur un serveur Valheim
- Mettre à jour un serveur Valheim
- Lire les logs d’un serveur Valheim
Sources : Jötunn — Network compatibility, ServerSync (README), Conditional Config Sync — verrouillage et exemption admin, README de l’image Docker communautaire (option
enforceModde ValheimPlus), patch 1.0.16 (valheim.com).
