Tu veux modder ton serveur Valheim sans te prendre la tête ? On va importer ton profil Thunderstore/r2modman en quelques minutes avec un fichier .r2z
. Suis les étapes, et ton serveur charge BepInEx et tous tes mods comme en solo.
Prérequis
- Accès au panel Oxygenserv (ton login et mot de passe)
- Thunderstore Mod Manager ou r2modman installé sur ton PC
- Profil Valheim exporté en fichier
.r2z
- Serveur Valheim installé sur Oxygenserv et à l’arrêt
- BepInEx (Valheim) activé/présent côté serveur
- Client Valheim avec le même modpack pour te connecter
- Optionnel : SFTP (FileZilla/WinSCP) si tu préfères l’upload par FTP
Étapes détaillées
-
Exporte ton modpack depuis Thunderstore/r2modman
Lance Thunderstore Mod Manager (ou r2modman), choisis ton profil Valheim dans la liste. Clique sur « Settings » puis « Export profile as a file ». Coche l’option pour inclure les dépendances si proposée, puis sauvegarde le fichier.r2z
(exemple :MonPackValheim.r2z
). Le fichier contient les mods à déployer côté serveur (plugins + configs). Si tu as plusieurs profils, exporte celui que tu utilises pour jouer. -
Envoie le fichier .r2z sur le serveur
Connecte-toi au panel Oxygenserv et va dans « Fichiers ». Téléverse le.r2z
dans le dossier principal du serveur (même niveau questart_server.sh
ouvalheim_server.x86_64
). Tu verras ton fichier apparaître dans la liste (ex :MonPackValheim.r2z
). En SFTP, dépose-le à la racine du serveur pour que l’installateur le détecte. Si l’upload échoue, vérifie la taille du fichier et ta connexion. -
Active/installe BepInEx pour Valheim
Dans le panel, ouvre l’onglet « Démarrage » ou « Mods ». Active l’option BepInEx (Valheim) ou clique sur « Installer BepInExPack ». Sauvegarde puis lance le serveur une fois pour générer les dossiers, et arrête-le juste après. Tu verras apparaîtreBepInEx/
, dontBepInEx/plugins
etBepInEx/config
. Si BepInEx n’apparaît pas au démarrage, c’est que l’activation n’est pas prise en compte : réactive et relance. -
Installe le modpack (.r2z) avec l’outil intégré
Va dans l’onglet « Mods » ou « Démarrage » > section « Import R2Z ». Selon l’interface, sélectionne le fichier dans un menu déroulant ou colle son nom exact (ex :MonPackValheim.r2z
). Certains installateurs demandent le nom sans l’extension : dans ce cas, renseigneMonPackValheim
(sans.r2z
). Clique sur « Installer » : les mods seront extraits dansBepInEx/plugins
et les configs dansBepInEx/config
. Si tu vois « Invalid archive » ou rien ne se passe, réexporte ton profil et renomme le fichier sans accents/espaces. -
Démarre et vérifie que tout tourne
Clique sur « Démarrer ». Surveille la console : tu dois voir des lignes BepInEx (ex : «BepInEx 5.x
loaded ») et le chargement des plugins. Ouvre le gestionnaire de fichiers et vérifie queBepInEx/plugins
contient tes mods. Connecte-toi depuis ton client avec le même profil Thunderstore/r2modman. Si tu obtiens « mod mismatch » ou crash, compare les versions et retire le dernier mod ajouté.
Astuces & optimisation
– Garde un pack raisonnable : 20–60 mods max. Trop de mods = temps de chargement long et risques de conflits.
– Sauvegarde avant chaque import : copie le dossier BepInEx/
et le monde. Ça évite les mauvaises surprises.
– Mémoire conseillée : 4–6 Go pour un serveur moddé avec 10+ joueurs. Surveille l’usage RAM/CPU dans le panel et ajuste.
– Mets à jour par profil : réexporte un .r2z
propre quand tu ajoutes/supprimes des mods, puis réinstalle. Évite le mélange manuel dans plugins
.
– Installe « ServerSync » quand dispo : il synchronise les configs BepInEx/config
avec les joueurs, moins d’erreurs côté client.
FAQ
Dois-je aussi installer les mods côté client ?
Oui, pour Valheim la plupart des mods exigent client + serveur. Le plus simple : utilise le même profil Thunderstore/r2modman que tu as exporté. Lance le jeu depuis ce profil pour garantir la compatibilité.
BepInEx ne se lance pas sur le serveur, que faire ?
Vérifie que BepInEx est « Activé » dans l’onglet Démarrage/Mods, redémarre le serveur, puis contrôle la présence du dossier BepInEx/
. Si rien n’apparaît en console, réinstalle « BepInExPack (Valheim) », puis démarre et arrête une fois pour générer l’arborescence avant d’installer les mods.
L’import .r2z échoue (« Invalid archive ») ou aucun mod n’apparaît
Réexporte le profil en « Export profile as a file », sans le zipper toi-même. Renomme le fichier en ASCII simple (ex : PackVh.r2z
), réuploade-le à la racine et réessaie. Vérifie aussi que le serveur est arrêté lors de l’installation.
Tu as maintenant un serveur Valheim moddé propre et stable. Continue d’itérer : un export, un import, un test. Simple, rapide, efficace.