Installer BepInEx sur un serveur Valheim (guide 1.0)
Valheim n’a aucun support officiel des mods : pas de Steam Workshop, pas d’API, et Iron Gate l’a redit dans sa FAQ 1.0. Tout l’écosystème repose sur BepInEx, un chargeur de plugins qui s’injecte dans le moteur Unity au démarrage.
Depuis la mise à jour 1.0 du 9 septembre 2026, qui embarque une montée de version du moteur Unity, la quasi-totalité des plugins ont dû être recompilés. Ce guide explique comment installer proprement BepInEx côté serveur, dans la version qui fonctionne aujourd’hui.
Nos serveurs Valheim HebergTonServ donnent un accès SFTP complet et laissent éditer la ligne de lancement — les deux conditions pour faire tourner BepInEx.
Avant de commencer : trois règles
- Sauvegardez le monde. Un plugin incompatible peut empêcher le serveur de démarrer, et certains mods de contenu modifient les données du monde de façon irréversible. Voir sauvegarder et restaurer un monde Valheim.
- BepInEx et
-crossplaysont incompatibles. BepInEx s’accroche à la couche réseau Steam, le crossplay console passe par PlayFab. Un serveur modé ne peut pas accueillir de joueurs PS5, Switch 2 ou Xbox. - Les clients doivent avoir les mêmes mods. La plupart des plugins Valheim vérifient la correspondance entre serveur et client : un joueur sans le mod sera rejeté à la connexion, ou verra un monde incohérent.
Étape 1 : récupérer le pack BepInEx
Le pack de référence est BepInExPack Valheim (par denikson), version 5.4.2350 — une build de BepInEx 5.4.23.5 préconfigurée pour Valheim. Téléchargez-le depuis Thunderstore, puis décompressez l’archive.
À l’intérieur, le contenu utile se trouve dans un sous-dossier. Les éléments à déployer sont :
| Élément | Rôle |
|---|---|
BepInEx/ | Le chargeur, ses dossiers plugins/, config/ et ses logs |
doorstop_libs/ | La bibliothèque d’injection (Linux) |
winhttp.dll | Le point d’entrée d’injection sous Windows |
doorstop_config.ini | La configuration de l’injecteur |
start_server_bepinex.sh | Le script de démarrage modifié pour Linux |
Ne déposez pas l’archive entière : ce sont le contenu du dossier, pas le dossier parent, qui doit se retrouver à la racine du serveur.
Étape 2 : déposer les fichiers à la racine du serveur
La racine du serveur, c’est le dossier qui contient l’exécutable — valheim_server.exe sous Windows, valheim_server.x86_64 sous Linux.
Connectez-vous en SFTP et copiez-y tous les éléments listés ci-dessus. Le résultat doit ressembler à :
/valheim_server.exe (ou valheim_server.x86_64)
/winhttp.dll
/doorstop_config.ini
/doorstop_libs/
/BepInEx/
/plugins/
/config/
/core/
/start_server_bepinex.sh (Linux)Étape 3 : adapter le démarrage
Sous Linux
C’est le cas le plus fréquent chez un hébergeur. BepInEx ne s’injecte pas tout seul : il faut passer par le script fourni.
chmod u+x start_server_bepinex.shÉditez ce script pour y remettre vos arguments de lancement — nom du serveur, monde, mot de passe, modifiers :
./valheim_server.x86_64 -name "Mon Serveur" -port 2456 -world "Midgard" \
-password "vikings2026" -public 1 -preset hard -modifier raids lessPuis configurez le panel ou votre service pour lancer start_server_bepinex.sh au lieu du script standard. C’est l’étape que les gens oublient : sans elle, le serveur démarre… sans mods.
Sous Windows
L’injection se fait par winhttp.dll : il n’y a rien à changer au lancement. Le serveur se démarre normalement, et BepInEx se charge automatiquement.
Si votre hébergeur ne permet pas de changer le script de démarrage, vous ne pourrez pas faire tourner BepInEx sous Linux. C’est un critère à vérifier avant de payer — voir meilleur hébergeur Valheim.
Étape 4 : premier démarrage à vide
Démarrez le serveur sans aucun plugin pour valider l’injection. Dans la console, vous devez voir apparaître les messages de démarrage de BepInEx (version du chargeur, chemin du jeu, nombre de plugins chargés : 0).
Un fichier de log est également créé :
BepInEx/LogOutput.logSi ce fichier n’existe pas et qu’aucun message BepInEx n’apparaît dans la console, l’injection n’a pas eu lieu : vous avez lancé le mauvais script (Linux), ou les fichiers ne sont pas à la racine.
Étape 5 : installer les plugins
Les mods se déposent dans :
BepInEx/plugins/Un plugin est un fichier .dll, parfois accompagné d’un dossier de ressources. Certains mods demandent aussi une dépendance — Jötunn est la plus répandue — qui s’installe de la même manière.
Après le premier démarrage avec un plugin, chaque mod génère son fichier de configuration dans :
BepInEx/config/C’est là que se règlent les options : taux, contenu, équilibrage. Arrêtez toujours le serveur avant d’éditer ces fichiers, sinon ils seront réécrits à l’extinction.
Notre sélection de mods : meilleurs mods Valheim pour serveur.
La question qui fâche : les mods après la 1.0
La mise à jour 1.0 a apporté une montée de version du moteur Unity. Comme BepInEx s’exécute à l’intérieur d’Unity et que les plugins s’accrochent à des classes et des méthodes du jeu, un changement de build casse ce qui n’a pas été recompilé.
Ce qu’il faut retenir concrètement :
- le chargeur lui-même a été mis à jour pour la 1.0, donc l’outillage n’est pas le problème ;
- les plugins, eux, dépendent de leurs auteurs : certains ont publié une build 1.0 en quelques heures, d’autres jamais ;
- il n’existe aucune branche de test publique pour la 1.0, donc aucun moddeur n’a pu préparer sa mise à jour à l’avance.
La bonne méthode après un gros patch :
- Sauvegardez le monde.
- Démarrez d’abord en vanilla et vérifiez que le serveur tourne.
- Re-téléchargez chaque mod plutôt que de supposer que la copie présente sur le serveur est à jour.
- Réintroduisez les plugins un par un, en relançant à chaque fois.
Un serveur qui ne démarre plus juste après une mise à jour a presque toujours un chargeur de mods en cause : voir mon serveur Valheim ne s’affiche pas.
Récapitulatif des dossiers
| Chemin | Contenu |
|---|---|
BepInEx/core/ | Le chargeur lui-même — ne pas toucher |
BepInEx/plugins/ | Vos mods (.dll) |
BepInEx/config/ | Les fichiers de configuration générés par les mods |
BepInEx/LogOutput.log | Le journal : la première chose à lire en cas de problème |
doorstop_config.ini | Configuration de l’injecteur, à laisser par défaut |
FAQ
Où installer les mods sur un serveur Valheim ?
Dans BepInEx/plugins/, à la racine du serveur. Les fichiers de configuration générés apparaissent ensuite dans BepInEx/config/.
Les joueurs doivent-ils installer les mêmes mods que le serveur ?
Dans la grande majorité des cas, oui. La plupart des plugins Valheim vérifient la correspondance entre client et serveur et refusent la connexion en cas d’écart. Quelques mods purement serveur font exception, mais c’est minoritaire.
BepInEx fonctionne-t-il avec le crossplay ?
Non. BepInEx s’appuie sur la couche réseau Steam tandis que le crossplay utilise le relais PlayFab. Un serveur lancé avec -crossplay ne peut pas faire tourner de mods, et un serveur modé n’est pas joignable depuis PS5, Switch 2 ou Xbox.
Mes mods ne se chargent pas, que vérifier ?
Dans l’ordre : le serveur démarre-t-il bien via start_server_bepinex.sh sous Linux ; BepInEx/LogOutput.log existe-t-il ; les fichiers sont-ils à la racine et non dans un sous-dossier ; les .dll sont-ils bien dans BepInEx/plugins/ ; les plugins ont-ils une build compatible 1.0.
Quelle version de BepInEx pour Valheim ?
Le pack communautaire BepInExPack Valheim 5.4.2350, qui est une build de BepInEx 5.4.23.5 préconfigurée pour le jeu. N’installez pas un BepInEx générique : il n’a pas la configuration Doorstop adaptée.
Faut-il plus de RAM avec des mods ?
Oui. Un serveur vanilla tient dans 4 Go pour un monde récent ; avec des mods de contenu, visez 8 à 16 Go. Détail dans combien de RAM pour un serveur Valheim.
Comment désinstaller BepInEx proprement ?
Arrêtez le serveur, supprimez winhttp.dll, doorstop_config.ini, doorstop_libs/, le dossier BepInEx/, puis relancez le script de démarrage standard. Attention : un monde modifié par des mods de contenu peut garder des objets devenus inconnus du jeu vanilla.
Conclusion
Installer BepInEx sur un serveur Valheim tient en trois points : copier le contenu du pack à la racine du serveur, démarrer via start_server_bepinex.sh sous Linux, et vérifier BepInEx/LogOutput.log avant d’ajouter le moindre plugin. Depuis la 1.0, ajoutez-en un quatrième : re-télécharger les mods après chaque patch, et les réintroduire un par un.
Pour un hébergeur Valheim avec accès SFTP complet, script de démarrage éditable et sauvegardes automatiques, HebergTonServ démarre à 7,90 €/mois.
