Les mods transforment Valheim : plus de pièces de construction, inventaire agrandi, qualité de vie… Sur un serveur dédié, ils passent tous par BepInEx, le chargeur de mods standard. Voici comment l’installer proprement.
⚠️ Valheim 1.0 et les mods
La 1.0 a mis à jour le moteur du jeu : beaucoup de mods ont cassé à sa sortie. Avant d'installer quoi que ce soit, vérifiez sur la page du mod qu'il est compatible 1.0. Iron Gate ne garantit pas le fonctionnement des mods. Voir Valheim 1.0 : ce qui change.
Serveur, client, ou les deux ?
| Type de mod | Où l’installer | Exemple d’usage |
|---|---|---|
| Serveur seul | Serveur uniquement | Règles, sauvegardes, outils d’admin |
| Client seul | Chez le joueur uniquement | Interface, carte, graphismes |
| Les deux | Serveur et chaque joueur, même version | Nouveaux objets, nouvelles pièces, créatures |
La page Thunderstore du mod précise en général ce qu’il faut.
📌 Joueurs console
Les joueurs Xbox, PS5 et Switch 2 ne peuvent pas installer de mods. Sur un serveur crossplay, limitez-vous aux mods serveur seul.
Étape 1 : sauvegarder
Avant tout mod, sauvegardez votre monde (guide). Un mod qui ajoute des objets peut laisser des traces dans le monde si on le retire.
Étape 2 : installer BepInEx sur le serveur
- Sur Thunderstore, téléchargez BepInExPack_Valheim
- Ouvrez l’archive : elle contient un dossier
BepInExPack_Valheim - Envoyez le contenu de ce dossier à la racine du serveur (à côté de
valheim_server.exeouvalheim_server.x86_64) - Sous Linux, lancez le serveur avec le script BepInEx fourni (
start_server_bepinex.sh), après y avoir mis vos arguments (-name,-world…) - Démarrez le serveur une fois, puis arrêtez-le
Le dossier BepInEx contient maintenant plugins, config et LogOutput.log.
💡 Chez HebergTonServ
Un doute sur l'installation de BepInEx sur votre serveur ? Contactez le support : on vous aide à configurer le lancement.
Étape 3 : ajouter des mods
- Téléchargez le mod sur Thunderstore (et ses dépendances, listées sur sa page, par exemple la bibliothèque Jötunn)
- Déposez les fichiers
.dll(ou le dossier du mod) dansBepInEx/plugins - Redémarrez le serveur
- Vérifiez
BepInEx/LogOutput.log: chaque mod chargé y apparaît
Étape 4 : configurer les mods
Au premier démarrage, chaque mod crée son fichier dans BepInEx/config (souvent auteur.nomdumod.cfg). Arrêtez le serveur, modifiez, redémarrez.
Étape 5 : équiper les joueurs
Pour les mods « les deux », chaque joueur doit avoir exactement les mêmes versions. Le plus simple :
- Créez un profil dans r2modman avec tous les mods du serveur
- Exportez le profil en code (Settings → Export profile as code)
- Partagez le code : vos joueurs l’importent en un clic
Dépannage
| Problème | Solution |
|---|---|
| Le serveur ne démarre plus | Retirez le dernier mod ajouté, lisez LogOutput.log |
| Aucun mod chargé | BepInEx mal placé (pas à la racine) ou serveur lancé sans le script BepInEx |
| « Incompatible version » à la connexion | Versions de mods différentes entre joueur et serveur |
| Tout a cassé après une mise à jour du jeu | Attendez / installez les versions à jour de BepInEx et des mods |
Questions fréquentes
Comment installer des mods sur un serveur Valheim ?
BepInExPack_Valheim à la racine, un premier démarrage, puis les mods dans BepInEx/plugins.
Les joueurs doivent-ils installer les mods ?
Seulement pour les mods qui ne sont pas « serveur seul ».
Pourquoi mes mods ne marchent plus depuis la 1.0 ?
Changement de moteur : mettez à jour BepInEx et chaque mod.
Un serveur moddé sans prise de tête ? Voir notre guide hébergeur Valheim.
Équipe HebergTonServ
Administrateurs serveurs de jeux
