Comment installer BepInEx sur un serveur Valheim et ajouter des mods (.dll) ?
Dans ce guide, vous allez installer l'environnement de mods BepInExPack_Valheim sur votre serveur dédié (dedicated) Valheim sous Windows et Linux, ajouter des mods à l'extension .dll dans le dossier BepInEx/plugins et modifier leurs réglages. Vous verrez aussi comment vérifier l'installation dans le journal, synchroniser les versions avec les joueurs et garder une configuration propre lors des mises à jour.
Avant de commencer
- Un serveur Valheim fonctionnel : le serveur doit avoir été installé avec SteamCMD et lancé au moins une fois sans mod ; sinon, suivez d'abord le guide d'installation d'un serveur Valheim de zéro. Les exemples reprennent son organisation : sous Windows,
C:\ValheimServeretstart_north.bat; sous Linux, l'utilisateursteam,/home/steam/valheim,start_north.shet le service systemd nommévalheim. - Une installation propre : le pack demande un dossier Valheim non modifié. Si vous avez déjà essayé BepInEx, déplacez l'ancien dossier
BepInExet le fichierwinhttp.dllhors du dossier du serveur. - Sauvegarde : avant d'ajouter des mods, faites une copie de vos fichiers de monde (
.dbet.fwl) hors du serveur. Les VDS n'incluent pas de sauvegarde automatique ; pour la méthode, consultez le guide de transfert et de sauvegarde des fichiers save. - Un chemin de dossier simple : d'après la documentation de BepInEx, certaines versions de Unity Mono posent problème avec des chemins très longs ou contenant des caractères non anglais. Le chemin du dossier du serveur ne doit pas contenir d'accents ni de caractères spéciaux comme é, è, à, ç.
- Marge de ressources : à mesure que vous ajoutez des mods, surveillez l'utilisation du CPU et de la RAM dans les graphiques d'utilisation en direct de l'Espace client. Pour les offres, consultez la page Location de serveur Valheim.
1. Déterminez où chaque mod doit fonctionner
BepInEx est un framework qui charge des plugins dans les jeux réalisés avec Unity ; Valheim n'ayant pas de dossier de mods propre, les mods .dll se chargent par son intermédiaire. Tous les mods ne sont pas nécessaires à la fois sur le serveur et chez le joueur : classez donc d'abord vos mods en trois groupes :
| Type de mod | Où l'installer | Exemple typique |
|---|---|---|
| Serveur uniquement (server-side) | Uniquement sur le serveur ; les joueurs n'ont pas à l'installer | Modification de la limite de joueurs, commande ou redémarrage planifié, notification Discord |
| Client uniquement (client-side) | Uniquement sur l'ordinateur du joueur | Modifications personnelles comme l'interface et la caméra |
| Serveur et client | Des deux côtés, dans la même version | Mods qui ajoutent des objets, des constructions ou des créatures ; qui synchronisent les réglages depuis le serveur ou qui contrôlent les versions |
Sur Thunderstore, les mods Valheim sont étiquetés avec les catégories Server-side et Client-side ; l'information fiable se trouve toutefois dans la description du mod lui-même. Les joueurs Xbox ne peuvent pas installer de mods et peuvent rencontrer des problèmes pour rejoindre des serveurs moddés.
2. Téléchargez BepInExPack_Valheim
N'utilisez pas la version générique de BepInEx publiée sur GitHub, mais le paquet BepInExPack_Valheim de Thunderstore. Ce paquet contient un BepInEx.cfg préconfiguré pour Valheim (console activée, bon point d'entrée) et les scripts de lancement Linux ; la version générique n'est pas configurée pour Valheim et peut faire planter le serveur. Au moment de la rédaction de ce guide, la version actuelle du paquet est la 5.4.2351 (basée sur BepInEx 5.4.23.5).
Vous pouvez télécharger le paquet directement sur le serveur ; remplacez le numéro de version à la fin de l'adresse par la version actuelle indiquée sur la page du paquet. Sous Windows, dans un PowerShell administrateur :
Invoke-WebRequest -UseBasicParsing -Uri https://thunderstore.io/package/download/denikson/BepInExPack_Valheim/5.4.2351/ -OutFile C:\bepinex.zip
Expand-Archive -Path C:\bepinex.zip -DestinationPath C:\BepInExPackage -Force
Si la commande renvoie une erreur de connexion, téléchargez le zip depuis le navigateur avec le bouton Manual Download de la page du paquet. Conformément à l'avertissement des mainteneurs, extrayez l'archive dans un dossier séparé, et non dans le dossier du serveur.
Sous Linux, installez d'abord l'outil unzip avec votre utilisateur administrateur, puis passez à l'utilisateur steam et téléchargez le paquet :
sudo apt install unzip
sudo -iu steam
wget -O /home/steam/bepinex.zip https://thunderstore.io/package/download/denikson/BepInExPack_Valheim/5.4.2351/
unzip -o /home/steam/bepinex.zip -d /home/steam/bepinex-package
exit
L'archive contient un dossier nommé BepInExPack_Valheim ; les fichiers à installer sont ceux qui se trouvent dans ce dossier.
3. Windows : copiez le pack dans le dossier du serveur
Si le serveur tourne, arrêtez-le avec CTRL+C dans la fenêtre de console. Copiez ensuite tout le contenu du dossier BepInExPack_Valheim (et pas seulement le dossier BepInEx) dans le dossier qui contient le fichier valheim_server.exe :
Copy-Item -Path C:\BepInExPackage\BepInExPack_Valheim\* -Destination C:\ValheimServer -Recurse -Force
Après la copie, le dossier BepInEx, winhttp.dll et doorstop_config.ini doivent apparaître dans C:\ValheimServer. Ces deux fichiers constituent le composant Unity Doorstop qui charge BepInEx au démarrage du serveur ; vous n'avez donc pas besoin de modifier votre script de lancement. Démarrez le serveur comme d'habitude avec start_north.bat.
4. Linux : démarrez le serveur avec start_server_bepinex.sh
Sous Linux, BepInEx ne se charge pas tout seul ; le script start_server_bepinex.sh fourni avec le pack définit les variables d'environnement nécessaires et démarre le serveur. Arrêtez le serveur avec votre utilisateur administrateur, puis passez à l'utilisateur steam, copiez le pack dans le dossier du serveur et créez une copie du script :
sudo systemctl stop valheim
sudo -iu steam
cp -a /home/steam/bepinex-package/BepInExPack_Valheim/. /home/steam/valheim/
cd /home/steam/valheim
cp start_server_bepinex.sh start_north_bepinex.sh
chmod u+x start_north_bepinex.sh
nano start_north_bepinex.sh
La copie protège vos réglages si une mise à jour du pack écrase le script d'origine. Les lignes DOORSTOP_, LD_LIBRARY_PATH et LD_PRELOAD du haut du script chargent BepInEx ; n'y touchez pas. Rendez seulement les paramètres de la ligne exec ./valheim_server.x86_64, tout en bas, identiques à ceux de votre script start_north.sh actuel :
exec ./valheim_server.x86_64 -name "North Clan" -port 2456 -world "Midgard" -password "Odin2456x"
Le script indique les chemins de fichiers avec ./, c'est-à-dire par rapport au dossier où il se trouve ; il doit donc être exécuté depuis le dossier du serveur. La ligne WorkingDirectory=/home/steam/valheim du fichier de service du guide d'installation s'en charge. Quittez l'utilisateur steam avec exit, ouvrez le fichier de service avec sudo nano /etc/systemd/system/valheim.service et ne modifiez que la ligne ExecStart :
ExecStart=/bin/sh /home/steam/valheim/start_north_bepinex.sh
Rechargez et démarrez le service, puis suivez le journal :
sudo systemctl daemon-reload
sudo systemctl start valheim
journalctl -u valheim -f
Si l'installation est correcte, les messages de démarrage (bootstrap) de BepInEx apparaissent dans le journal.
5. Vérifiez que BepInEx est chargé
Au premier démarrage, BepInEx crée le dossier BepInEx/config et le fichier journal BepInEx/LogOutput.log ; le journal est réécrit à chaque démarrage réussi. Sous Windows, le fichier se trouve à l'emplacement C:\ValheimServer\BepInEx\LogOutput.log, sous Linux à l'emplacement /home/steam/valheim/BepInEx/LogOutput.log. Il doit commencer par une ligne de ce type, qui indique la version du pack :
[Message: BepInEx] User is running BepInExPack Valheim version 5.4.2351 from Thunderstore
En cas de doute, arrêtez le serveur, supprimez le fichier LogOutput.log et redémarrez ; si aucun nouveau journal n'est créé, BepInEx ne se charge pas (voir Erreurs fréquentes).
Si le dossier BepInEx/plugins, dans lequel vous placerez les mods, n'existe pas, créez-le. Sous Windows :
New-Item -ItemType Directory -Force -Path C:\ValheimServer\BepInEx\plugins
Sous Linux, de façon que le propriétaire soit l'utilisateur steam :
sudo -u steam mkdir -p /home/steam/valheim/BepInEx/plugins
6. Ajoutez le mod (.dll) au dossier plugins
Récupérez les mods dans la section Valheim de Thunderstore. La page de chaque paquet comporte une chaîne de dépendance (dependency string) et une liste de dépendances. La chaîne a la forme Equipe-NomDuPaquet-Version ; par exemple, l'unique dépendance du fork de ValheimPlus s'écrit denikson-BepInExPack_Valheim-5.4.2351. Pour une installation manuelle, installez d'abord les bibliothèques de la liste (exemple fréquent : Jotunn), puis le mod lui-même.
Les fichiers manifest.json, README.md et icon.png à la racine des paquets Thunderstore sont des fichiers d'information ; ce dont le serveur a besoin, c'est du fichier .dll du mod et des fichiers supplémentaires indiqués dans le README. Sous Linux, vous pouvez télécharger le mod directement sur le serveur ; remplacez l'équipe, le nom du paquet et la version dans l'adresse par les valeurs indiquées sur la page du mod :
sudo -iu steam
wget -O /home/steam/NomDuMod.zip https://thunderstore.io/package/download/EQUIPE/NOMDUPAQUET/VERSION/
unzip -o /home/steam/NomDuMod.zip -d /home/steam/mod-package/NomDuMod
find /home/steam/mod-package/NomDuMod -name "*.dll"
cp /home/steam/mod-package/NomDuMod/NomDuMod.dll /home/steam/valheim/BepInEx/plugins/
Utilisez sur la ligne cp le chemin affiché par la commande find ; dans certains paquets, le .dll se trouve dans un sous-dossier. Sous Windows, téléchargez le zip avec le bouton Manual Download de la page du paquet, extrayez-le et copiez le fichier .dll dans le dossier C:\ValheimServer\BepInEx\plugins.
Redémarrez le serveur et cherchez dans le journal la ligne indiquant que le mod a été chargé. Sous Windows, dans PowerShell :
Select-String -Path C:\ValheimServer\BepInEx\LogOutput.log -SimpleMatch -Pattern "Loading ["
Sous Linux, quittez l'utilisateur steam avec exit, puis avec votre utilisateur administrateur :
sudo systemctl restart valheim
sudo grep -F "Loading [" /home/steam/valheim/BepInEx/LogOutput.log
Pour chaque mod chargé, vous devez voir une ligne de la forme [Info : BepInEx] Loading [NomDuMod 1.2.3]. Ne placez pas deux copies du même mod : BepInEx identifie les plugins par leur identifiant unique (GUID) et ne charge que la version la plus récente parmi les copies.
7. Modifiez les réglages des mods
Les mods qui utilisent le système de configuration de BepInEx créent, au premier lancement, un fichier nommé <GUID>.cfg dans le dossier BepInEx/config. Après avoir ajouté le mod, démarrez puis arrêtez une fois le serveur, modifiez ensuite le fichier avec un éditeur de texte et redémarrez le serveur. Avec les mods qui synchronisent les réglages du serveur vers les joueurs, les joueurs reçoivent les valeurs du serveur ; pour ces mods, faites la modification dans le fichier du serveur.
ValheimPlus, souvent cité dans les anciens guides, en est un bon exemple. La dernière version du projet d'origine est la 0.9.9.11 et il n'est plus mis à jour depuis longtemps. Pour les versions actuelles de Valheim, on utilise le fork communautaire publié sur Thunderstore sous le nom ValheimPlus_Grantapher_Temporary. Dans cette version, le fichier de réglages ne s'appelle pas valheim_plus.cfg, mais org.bepinex.plugins.valheim_plus.cfg ; si un fichier portant l'ancien nom est trouvé, il est importé une fois. Le mod doit être installé à la fois sur le serveur et chez les joueurs. Les réglages de la section serveur figurent dans le tableau de configuration d'exemple ci-dessous.
8. Faites installer les mêmes mods aux joueurs
Pour les mods également nécessaires côté client, donnez aux joueurs la liste complète avec les numéros de version. Pour les joueurs, le plus simple est un gestionnaire de mods comme Gale, Thunderstore Mod Manager ou r2modman, qui installe lui-même BepInExPack et les dépendances. Dans r2modman, vous pouvez partager la liste des mods et les réglages avec d'autres en exportant le profil (export). Le joueur qui préfère une installation manuelle copie le contenu du pack dans le dossier steamapps\common\Valheim et place les mods dans le dossier BepInEx\plugins qui s'y trouve.
Si vous avez d'abord testé la configuration sur votre propre ordinateur avec r2modman, vous pouvez ouvrir le dossier du profil avec Browse profile folder dans les réglages du profil et copier le contenu de BepInEx\plugins et BepInEx\config dans les mêmes dossiers du serveur ; veillez simplement à ne pas y transférer les mods client uniquement.
Si les versions ne correspondent pas, le serveur refuse le joueur. Avec les mods qui utilisent Jotunn, c'est le serveur qui effectue le contrôle ; le joueur voit une fenêtre d'erreur indiquant quel plugin (GUID) ne correspond pas et avec quelle version.
9. Gardez une configuration propre lors des mises à jour
Les mises à jour de Valheim peuvent casser les mods ; le délai d'adaptation d'un mod à la nouvelle version dépend de son auteur. Lorsque le client des joueurs est mis à jour, mettez aussi le serveur à jour dans cet ordre :
- Consultez sur les pages Thunderstore de vos mods les notes concernant la nouvelle version du jeu et l'étiquette Deprecated (obsolète).
- Arrêtez le serveur ; sauvegardez les fichiers du monde ainsi que les dossiers
BepInEx/pluginsetBepInEx/config. L'espace de sauvegarde cloud, qui offre un accès SFTP et WebDAV, est une destination adaptée pour une copie hors du serveur. - Mettez le serveur à jour avec SteamCMD. D'après l'explication de Valve,
validatene vérifie que les fichiers de l'installation par défaut ; il ne touche pas aux fichiers BepInEx ajoutés ensuite. - Si une nouvelle version du pack existe, téléchargez BepInExPack comme à l'étape 2 et recopiez-le comme aux étapes 3 ou 4. Les fichiers de réglages des mods sont conservés. Sous Linux, comparez votre propre copie du script avec le nouveau
start_server_bepinex.sh. - Passez les mods à leurs versions actuelles et communiquez aux joueurs la nouvelle liste des versions.
Exemple de configuration : arborescence et réglages serveur de ValheimPlus
Une fois l'installation terminée, le dossier du serveur contient les éléments suivants (chemins relatifs au dossier du serveur) :
| Élément | Plateforme | Rôle |
|---|---|---|
BepInEx/plugins | Windows et Linux | Fichiers .dll des mods |
BepInEx/config | Windows et Linux | BepInEx.cfg et fichiers de réglages <GUID>.cfg des mods |
BepInEx/LogOutput.log | Windows et Linux | Journal de BepInEx ; réécrit à chaque démarrage |
winhttp.dll, doorstop_config.ini | Windows | Chargent BepInEx au démarrage ; enabled = true doit être défini |
doorstop_libs, start_server_bepinex.sh | Linux | Bibliothèque qui charge BepInEx et script de lancement |
start_north.bat / start_north_bepinex.sh | Windows / Linux | Votre propre script de lancement ; non affecté par les mises à jour |
Section [Server] du fichier org.bepinex.plugins.valheim_plus.cfg du fork de ValheimPlus :
| Réglage | Valeur d'exemple | Rôle |
|---|---|---|
enabled | true | Active la section |
maxPlayers | 10 | Nombre maximal de joueurs sur le serveur |
enforceMod | true | Seuls les joueurs ayant la même version de ValheimPlus peuvent rejoindre |
serverSyncsConfig | true | Envoie les réglages du serveur aux joueurs qui se connectent ; le fichier du joueur n'est pas modifié |
Les développeurs du mod recommandent de ne pas désactiver les réglages enforceMod et serverSyncsConfig.
Erreurs fréquentes
- LogOutput.log n'est pas créé, les mods ne se chargent pas : sous Windows, seul le dossier
BepInExdu pack a peut-être été copié ;winhttp.dlletdoorstop_config.inidoivent aussi se trouver dans le même dossier quevalheim_server.exe, etdoorstop_config.inidoit contenirenabled = true. Sous Linux, le serveur démarre peut-être encore avec l'ancienstart_north.sh; vérifiez la ligneExecStartdu fichier de service. Une liste de contrôle détaillée se trouve dans la documentation de dépannage de BepInEx. - « Permission denied » sous Linux : si vous avez copié les fichiers en root, corrigez le propriétaire avec
sudo chown -R steam:steam /home/steam/valheim. - Fenêtre d'incompatibilité de version (version mismatch) à la connexion : comparez les GUID et les versions de la fenêtre avec les lignes
Loading [du serveur et alignez les mods du joueur. Si la liste des mods du serveur (remote) est vide dans la fenêtre, le problème ne vient pas du joueur, mais du fait que BepInEx ne se charge pas sur le serveur. - Écran noir après la connexion : d'après la page de dépannage serveur de la communauté de modding Valheim, cela provient le plus souvent d'un mod qui utilise une ancienne version de ServerSync. Retirez un à un les derniers mods ajoutés pour trouver le mod en cause.
MissingMethodException,MissingFieldExceptionou « Could not find method » dans le journal : le mod est incompatible avec la version actuelle du jeu. Le nom du mod qui apparaît dans la pile d'appels (stack trace) de la ligne d'erreur désigne le mod en cause ; mettez-le à jour ou supprimez-le.- Plantage au démarrage après une mise à jour du jeu : le plus souvent, la version de BepInExPack ne correspond pas à la version du jeu ; passez le pack à la version actuelle sur Thunderstore.
Questions fréquentes
Les joueurs doivent-ils aussi installer BepInEx ?
Si vous n'utilisez que des mods qui fonctionnent côté serveur, non ; les joueurs peuvent se connecter avec Valheim sans mod. Dès qu'un seul mod doit fonctionner à la fois sur le serveur et chez le client, chaque joueur doit installer BepInExPack et la même version de ce mod.
Puis-je désactiver temporairement les mods ?
Oui. Sous Windows, passez la valeur enabled = true du fichier doorstop_config.ini à false et redémarrez le serveur. Sous Linux, remettez votre ancien script start_north.sh dans la ligne ExecStart du fichier de service. Pour désactiver un seul mod, il suffit de déplacer le fichier .dll concerné hors du dossier plugins. Avant de désactiver, sauvegardez votre monde.
Puis-je utiliser le crossplay sur un serveur moddé ?
Ce n'est pas recommandé. Les joueurs Xbox ne peuvent pas installer de mods, et la communauté de modding conseille d'éviter le crossplay sur les serveurs moddés, car de nombreux mods ne le prennent pas en charge. Si le crossplay est indispensable, n'utilisez que des mods côté serveur. Pour plus de détails, consultez le guide du crossplay.
Guides associés
- Comment installer un serveur Valheim ? SteamCMD sur un VDS Windows et Linux
- Sauvegarder et transférer les fichiers de sauvegarde (save) de Valheim
- Configurer un serveur Valheim en crossplay (Steam et Xbox)
- Ouvrir les ports d'un serveur Valheim (2456-2458 UDP) et corriger l'erreur Disconnected
- Comment corriger les problèmes de performances et la désynchronisation (desync) d'un serveur Valheim ?
Pour les autres articles, consultez la page Guides Valheim.
Commentaires0
Pas encore de commentaire
Soyez le premier à partager votre avis.
Veuillez vous connecter ou vous inscrire pour laisser un commentaire.