Installer un modpack r2modman sur un serveur Valheim

Vous avez monté un profil r2modman aux petits oignons : 25 mods, des configs réglées une par une, tout fonctionne en solo. Reste à mettre exactement la même chose sur le serveur et chez vos amis. C’est là que la plupart des serveurs moddés cassent : un mod manquant côté serveur, une version différente chez un joueur, et plus personne ne se connecte.

Ce guide donne la méthode propre, en deux volets : vos joueurs récupèrent le profil par code, le serveur reçoit les fichiers du profil.

---

Avant tout : trois règles de la 1.0

1. Le crossplay et les mods ne font pas bon ménage. BepInEx n’est pas compatible avec un serveur lancé en -crossplay, et les joueurs console ne peuvent de toute façon pas installer de mods. Un serveur moddé est un serveur PC Steam.
2. La 1.0 a changé de version d’Unity. Une grande partie des mods a dû être recompilée. Avant d’exporter votre profil, vérifiez sur Thunderstore que chaque mod a été mis à jour après le 9 septembre 2026.
3. Le serveur a besoin de BepInEx. Si ce n’est pas fait : installer BepInEx sur un serveur Valheim.

---

Étape 1 — Exporter le profil pour vos joueurs

Dans r2modman, ouvrez votre profil puis Settings → Export profile (« Exporter le profil » si r2modman est en français). Deux choix, As a code ou As a file :

Export	Forme	Usage
Code	Un identifiant texte du type 019eb41e-401b-a408-b431-2915043cbf7f	À coller sur Discord : le plus rapide pour vos joueurs
Fichier	Un fichier .r2z (« r2modman zip »)	À archiver : c’est une vraie copie que vous gardez

Vos joueurs importent le profil depuis l’écran de sélection des profils de r2modman avec Import profile, en collant le code ou en choisissant le fichier .r2z. Ils récupèrent les mêmes mods, dans les mêmes versions, et vos fichiers de config.

Limite documentée : les mods installés manuellement ou importés en local ne sont pas inclus dans l’export. Si votre profil en contient, envoyez-les à part.

Conseil : exportez aussi un fichier .r2z à chaque changement du modpack, daté. C’est votre point de retour si une mise à jour casse tout.

---

Étape 2 — Trouver le dossier du profil sur votre PC

Le serveur ne peut pas utiliser r2modman : il faut lui envoyer les fichiers. Ils se trouvent dans le dossier du profil. Sous Windows :

%APPDATA%\r2modmanPlus-local\Valheim\profiles\<NomDuProfil>\BepInEx\

Le plus simple pour l’ouvrir : dans r2modman, Settings → Data and profile folders → Profile folder (« Dossiers de données et de profil → Dossier du profil » en français).

Vous y trouverez notamment :

Dossier	Contenu	À envoyer sur le serveur ?
BepInEx/plugins/	Les mods (DLL et leurs dossiers)	✅ Oui (sauf mods client-only)
BepInEx/config/	Les fichiers .cfg de réglages	✅ Oui
BepInEx/patchers/	Les patchers, si un mod en utilise	✅ Oui s’il n’est pas vide
BepInEx/core/	Le cœur de BepInEx	❌ Non : déjà installé sur le serveur

---

Étape 3 — Écarter les mods client-only

Tous les mods n’ont pas leur place sur un serveur dédié. Un mod purement visuel ou d’interface (textures, minicarte, HUD, sons) ne sert à rien côté serveur et peut même l’empêcher de démarrer, puisque le serveur tourne sans affichage.

Comment trier :

• sur Thunderstore, les pages de mods portent des catégories comme Server-side ou Client-side ;
• la description de chaque mod précise presque toujours s’il faut l’installer « sur le serveur et tous les clients », « côté client seulement » ou « côté serveur seulement » ;
• en cas de doute : installez-le des deux côtés et vérifiez les logs au démarrage.

---

Étape 4 — Envoyer les fichiers sur le serveur

1. Arrêtez le serveur.
2. Sauvegardez le monde avant tout changement de mods : sauvegarder et restaurer un monde Valheim.
3. En SFTP, copiez le contenu de BepInEx/plugins/ du profil dans BepInEx/plugins/ du serveur.
4. Faites de même pour BepInEx/config/ (et BepInEx/patchers/ si besoin).
5. Démarrez le serveur et lisez les logs : BepInEx/LogOutput.log liste chaque plugin chargé, et signale ceux qui échouent.

Sur un serveur Linux, n’oubliez pas qu’il doit être lancé via start_server_bepinex.sh, sinon aucun mod n’est chargé — même si les fichiers sont au bon endroit.

---

Étape 5 — Tester avant d’ouvrir

1. Connectez-vous seul, avec le profil importé.
2. Vérifiez qu’un mod de contenu fonctionne réellement (un objet, une recette, un réglage visible).
3. Faites connecter un deuxième joueur qui a importé le profil par code.
4. Seulement ensuite, ouvrez au reste du clan.

Si un joueur est refusé avec une erreur de version, un de ses mods ne correspond pas à celui du serveur : forcer des mods identiques sur un serveur Valheim.

---

Mettre à jour le modpack sans tout casser

Chaque mise à jour du jeu ou d’un mod doit suivre le même ordre :

1. mettez à jour le profil dans r2modman et testez en solo ;
2. exportez un nouveau code (et un .r2z daté) ;
3. arrêtez le serveur, sauvegardez, remplacez plugins/ et vérifiez les config/ ;
4. redémarrez et contrôlez LogOutput.log ;
5. diffusez le nouveau code : tout le monde réimporte le profil (option Update existing profile à l’import).

Attention : lors de la mise à jour d’un profil existant, r2modman supprime les mods installés manuellement dans ce profil.

---

Et pour automatiser ?

Il existe un outil communautaire en ligne de commande, r2modman-headless, qui applique un export .r2z directement sur un dossier de serveur (--profile-zip, --install-dir). Pratique sur un serveur Linux auto-hébergé, mais le dépôt n’a plus été mis à jour depuis juin 2024 : testez-le sur une copie avant de lui confier votre serveur.

---

FAQ

Peut-on utiliser r2modman directement sur un serveur Valheim dédié ?

Non, r2modman est une application de bureau. On l’utilise sur son PC pour construire le profil, puis on envoie le contenu de BepInEx/plugins/ et BepInEx/config/ sur le serveur.

Où se trouve le dossier des profils r2modman ?

Sous Windows : %APPDATA%\r2modmanPlus-local\Valheim\profiles\<NomDuProfil>\. Le réglage Data and profile folders → Profile folder de r2modman l’ouvre directement.

Code ou fichier .r2z : lequel partager ?

Le code est plus rapide à diffuser sur Discord. Le fichier .r2z est une copie que vous conservez : idéal comme sauvegarde datée du modpack.

Mes joueurs sur PS5 ou Xbox peuvent-ils rejoindre le serveur moddé ?

Non. Les joueurs console ne peuvent pas installer de mods, et un serveur BepInEx ne tourne pas en crossplay. Un serveur moddé Valheim est réservé aux joueurs PC Steam.

Faut-il envoyer les fichiers de config sur le serveur ?

Oui. Beaucoup de mods lisent leurs réglages côté serveur, et certains imposent la config du serveur aux joueurs. Si vous n’envoyez que les DLL, le serveur tourne avec les réglages par défaut.

Un mod bloque le démarrage du serveur, que faire ?

Ouvrez BepInEx/LogOutput.log : l’erreur nomme le plugin fautif. Retirez-le de plugins/, redémarrez, et vérifiez sur Thunderstore s’il a été mis à jour pour la 1.0.

---

Conclusion

La méthode fiable tient en deux gestes : un code r2modman pour que tous vos joueurs aient le même profil, et le contenu de plugins/ et config/ du profil envoyé sur le serveur, sans les mods client-only. Gardez un .r2z daté à chaque changement : c’est votre retour arrière.

Un serveur Valheim HebergTonServ vous donne l’accès SFTP complet nécessaire, avec 8 Go de RAM dès 11,90 €/mois et 16 Go pour les gros modpacks.

Pour aller plus loin

• Meilleur hébergeur Valheim 2026 : comment choisir
• Installer BepInEx sur un serveur Valheim
• Forcer des mods identiques sur un serveur Valheim
• Les meilleurs mods Valheim pour serveur
• Lire les logs d’un serveur Valheim

Sources : wiki r2modmanPlus — Profiles (export code / fichier .r2z, import, limites), libellés de l’interface r2modman, EN/FR, ValheimPlus — INSTALL.md (chemin %APPDATA%/r2modmanPlus-local/Valheim/profiles/), r2modman-headless, patch notes 1.0 (valheim.com).