Avec BepInEx, tu peux étendre des serveurs Valheim avec des mods si les fichiers serveur, les mods client et les versions correspondent proprement. Le point décisif n’est pas seulement de copier une DLL, mais de suivre un processus contrôlé : installer le framework, démarrer le serveur une fois, ajouter les mods de façon ciblée, aligner les clients et isoler les erreurs via les logs ou une désactivation progressive.
Ce que fait BepInEx dans Valheim
BepInEx est un framework de modding pour les jeux Unity. Pour Valheim, on utilise souvent BepInExPack Valheim, disponible sur Thunderstore : Documentation sur thunderstore.io. Cette page de projet est la source primaire pour le paquet Valheim-BepInEx mentionné concrètement.
BepInEx fournit les dossiers dans lesquels les mods Valheim sont chargés et configurés. Beaucoup de mods se composent d’un ou plusieurs fichiers DLL qui doivent se trouver dans BepInEx/plugins/. Après le premier démarrage du serveur, des fichiers de configuration supplémentaires sont généralement créés dans BepInEx/config/. Ne modifie ces fichiers qu’après avoir démarré le serveur au moins une fois avec le framework installé.
Si, en plus des mods, tu veux aussi planifier proprement les bases du serveur, la configuration et la progression des boss, le guide interne Louer un serveur Valheim : mods, configuration et ordre des boss 2026 complète bien le sujet. Pour d’autres setups Unity ou frameworks de modding, la comparaison avec Installer des mods V Rising avec BepInEx Server Mods est aussi utile.
Prérequis
Avant de commencer, tu as besoin d’un accès au répertoire du serveur Valheim, de la possibilité de redémarrer le serveur et d’une liste de mods claire. Avec un hébergement multi-jeux payant comme game-serverhosting, il est particulièrement important d’appliquer les changements de manière traçable : d’abord la sauvegarde, puis le framework, puis les mods un par un, ensuite la vérification. La maîtrise technique, la capacité de support et des processus d’exploitation transparents restent ainsi préservés.
Définis aussi quels mods fonctionnent uniquement côté serveur et lesquels chaque joueur doit installer localement. Beaucoup de mods Valheim nécessitent des composants correspondants sur serveur et client ; l’indication sur la page de chaque mod fait foi. Vérifie donc pour chaque mod la description Thunderstore correspondante avant de l’intégrer dans un modpack commun.
Installer BepInEx sur le serveur
- Télécharge BepInEx depuis Thunderstore.
- Décompresse le contenu dans le répertoire du serveur Valheim.
- Redémarre le serveur. BepInEx crée automatiquement les dossiers de config.
La structure cible devrait ensuite ressembler à ceci :
/valheim/
├── BepInEx/
│ ├── config/ # Configurations des mods
│ ├── plugins/ # Déposer les mods ici
│ └── patchers/
├── valheim_server.x86_64
└── start_server.sh
Le niveau est important : le dossier BepInEx/ doit se trouver directement dans le répertoire du serveur Valheim, pas dans un sous-dossier supplémentaire issu de l’archive ZIP. Si aucune structure config ou plugins n’apparaît après le redémarrage, l’erreur se trouve souvent précisément là.
Installer des mods
- Télécharge des mods depuis Thunderstore.
- Décompresse le fichier DLL dans le dossier
BepInEx/plugins/. - Redémarre le serveur.
N’installe pas de nouveaux mods à l’aveugle en gros paquets. Une approche contrôlée est plus pertinente : ajouter un mod, démarrer le serveur, vérifier le log, tester la connexion, puis seulement installer le mod suivant. Avec plusieurs joueurs, tu devrais documenter la liste des mods avec leurs numéros de version afin que tout le monde utilise la même base.
Si un mod apporte des fichiers supplémentaires ou ses propres dossiers, suis les instructions du mod concerné. Tous les mods ne se composent pas seulement d’une DLL unique. Ne déplace pas arbitrairement des fichiers de configuration entre plugins et config ; BepInEx et le mod lui-même attendent des chemins précis.
Aligner les mods client
La plupart des mods Valheim doivent être installés à la fois sur le serveur et sur le client. Utilise le Thunderstore Mod Manager pour une installation client simple.
Tu peux aussi utiliser r2modman :
- Installe r2modman.
- Choisis "Valheim" comme jeu.
- Parcours et installe les mods en un clic.
- Exporte ton modpack comme code → Partage-le avec tes amis.
L’avantage pratique d’un gestionnaire de mods se trouve dans l’alignement : tous les joueurs peuvent utiliser le même profil au lieu de chercher manuellement les DLL. Malgré tout, reste prudent après les mises à jour. Un mod client mis à jour peut être incompatible avec un mod serveur plus ancien. Note donc quand tu as modifié le modpack et quelles versions sont actives.
Mods recommandés
Le tableau suivant montre des exemples répandus ; vérifie chaque mod avant l’installation pour son actualité et ses dépendances. Ce n’est pas une promesse de performance et cela ne remplace pas la vérification de la page du mod concerné pour la compatibilité, l’actualité et les dépendances nécessaires.
| Mod | Description | Client nécessaire ? |
|---|---|---|
| ValheimPlus | Ajustements étendus | Oui |
| Better UI | Interface utilisateur améliorée | Oui |
| Plant Everything | Planter partout | Oui |
| Epic Loot | Objets rares avec propriétés | Oui |
| Better Wards | Pierres de protection améliorées | Oui |
Vérifier le résultat
Après l’installation, le serveur doit démarrer sans crash. Vérifie d’abord si BepInEx est chargé dans le log et si des messages d’erreur apparaissent concernant des dépendances manquantes, de mauvaises versions ou des DLL introuvables. Ensuite, teste avec un client qui utilise la même sélection de mods.
En jeu, tu devrais tester spécifiquement une fonction de chaque mod installé : changement d’UI visible, nouvelle option de configuration effective, nouvel objet présent ou comportement attendu actif. Si tout fonctionne, sauvegarde la liste de mods fonctionnelle et les fichiers de config les plus importants. Tu pourras ainsi comprendre les changements ultérieurs ou revenir en arrière en cas de problème.
Dépannage
Le mod ne fonctionne pas
Vérifie d’abord la version de BepInEx, la version du mod et la compatibilité du mod. Contrôle aussi si la DLL se trouve vraiment dans BepInEx/plugins/ et pas accidentellement dans un sous-dossier décompressé en double. Lis la page du mod sur Thunderstore, car beaucoup de mods nécessitent des dépendances supplémentaires.
Le serveur crash
Retire les mods un par un pour trouver le responsable. Commence par le mod installé ou mis à jour en dernier. Redémarre le serveur après chaque changement et vérifie le log. Si le serveur démarre sans mods mais crash avec un mod précis, la cause est généralement une dépendance, une version ou une configuration.
Désynchronisation ou problèmes de connexion
Assure-toi que tous les joueurs ont les mêmes mods dans des versions compatibles. Surtout avec les mods obligatoires côté client, modifier seulement le serveur ne suffit pas. Un profil r2modman ou Thunderstore exporté réduit les écarts et rend les cas de support plus faciles à comprendre.
La config n’est pas créée
Démarre le serveur une fois avec BepInEx installé et le mod concerné. Beaucoup de mods n’écrivent leur config qu’au premier chargement réussi. Si aucun fichier n’apparaît ensuite, le mod n’a peut-être pas été chargé, se trouve dans le mauvais dossier ou n’est pas compatible avec l’environnement actuel.
Vérification, limites et retour sûr
Le guide « Installer des mods Valheim avec BepInEx – Pas à pas » s’applique au type de serveur décrit dans l’article et à l’état de version visible au moment de la vérification. Les noms de menus, versions disponibles, compatibilités de mods ou plugins et ressources nécessaires peuvent changer après des mises à jour. Ne transfère donc aucune valeur sans vérification vers une autre version de jeu, de loader ou de serveur.
Avant toute modification du monde, de la sauvegarde, de la configuration ou des extensions, crée une sauvegarde des fichiers concernés. Modifie ensuite seulement une étape cohérente à la fois et vérifie-la avec la même version client et serveur que celle avec laquelle tu veux jouer ensuite.
| Point de contrôle | Résultat attendu | Arrêt et retour arrière |
|---|---|---|
| Démarrage du serveur | Le serveur atteint l’état opérationnel sans nouveau message d’erreur. | En cas d’erreurs de démarrage, annuler la modification et restaurer la dernière sauvegarde. |
| Test de connexion | Un compte de test peut se connecter via l’adresse affichée dans le panel. | En cas d’erreurs de version ou de connexion, revérifier la version, le port et les ouvertures. |
| Test fonctionnel | La fonction concrètement modifiée fonctionne sans endommager les données existantes du monde ou du jeu. | En cas d’effets secondaires, arrêter le serveur et restaurer les fichiers sauvegardés. |
Un test individuel réussi n’est pas une garantie de performance ou de disponibilité. La taille du monde, les mods, les plugins, le nombre de joueurs, le chemin réseau et la charge simultanée peuvent modifier le résultat. Documente la version, la modification et le résultat du test afin de pouvoir comprendre les écarts ultérieurs.
FAQ
BepInEx doit-il être installé sur le serveur et sur le client ?
Pour beaucoup de mods Valheim, oui. Si un mod est obligatoire côté client, le serveur et les joueurs ont besoin de la même version ou d’une version compatible. Vérifie toujours cela sur la page du mod concerné.
Puis-je installer des mods Valheim uniquement via Thunderstore ?
Non, tu peux aussi déposer les DLL manuellement dans BepInEx/plugins/. Thunderstore Mod Manager et r2modman facilitent toutefois l’alignement des versions et la distribution aux autres joueurs.
Pourquoi mon serveur ne démarre-t-il plus après un mod ?
Les causes fréquentes sont de mauvaises versions de BepInEx, des dépendances manquantes, des versions de mods incompatibles ou des fichiers dans le mauvais dossier. Retire les mods progressivement et vérifie le log après chaque redémarrage.
Où se trouvent les configurations des mods ?
Beaucoup de mods BepInEx créent leur configuration dans BepInEx/config/. Les fichiers n’apparaissent souvent qu’après le premier démarrage réussi du serveur avec le mod installé.
Dois-je installer tous les mods en même temps ?
Mieux vaut éviter. Installe les mods les uns après les autres ou en petits groupes afin de pouvoir attribuer clairement les erreurs. Cela fait gagner du temps si le serveur crash ou si les clients ne peuvent pas se connecter.