Comment installer un mod BepInEx sur un serveur Valheim ?

Contexte

Une fois BepInEx activé sur votre serveur Valheim, vous pouvez y ajouter des mods pour débloquer de nouvelles fonctionnalités ou étendre vos capacités d'administration.

Dans ce guide, nous abordons la méthode générale pour installer n'importe quel mod BepInEx au format .dll, en utilisant comme exemple le mod très populaire Server_devcommands par JereKuusela qui débloque l'intégralité des commandes de développement pour les administrateurs sur serveur dédié.

Prérequis

Un serveur Valheim avec BepInEx activé sur votre panel Winheberg (Voir notre guide : Comment installer et activer BepInEx).
Le fichier du mod téléchargé depuis une plateforme comme Thunderstore.

Étape 1 : Télécharger et extraire le mod

Rendez-vous sur la page du mod souhaité, par exemple Server_devcommands sur Thunderstore.
Cliquez sur Manual Download pour récupérer l'archive .zip.
Extrayez l'archive sur votre ordinateur. Vous y trouverez un fichier .dll (ex: ServerDevcommands.dll).

Étape 2 : Transférer le mod sur votre serveur

Connectez-vous à votre panel Winheberg.
Pour éviter tout conflit lors du transfert, arrêtez votre serveur.
Dans le menu latéral, cliquez sur Files (Gestionnaire de fichiers).
Naviguez dans le dossier : BepInEx/plugins/.
Glissez-déposez le fichier .dll du mod (ex: ServerDevcommands.dll) directement dans le dossier plugins.

Si le fichier .zip du mod contient également un dossier ou des fichiers de configuration spécifiques, déposez l'ensemble du contenu extrait dans le dossier plugins/.

Étape 3 : Redémarrer le serveur

Retournez sur la Console et cliquez sur Start.
Lors du démarrage, BepInEx chargera le mod et créera automatiquement un fichier de configuration dédié dans le dossier BepInEx/config/.

Pour le mod Server_devcommands, vous disposez désormais de toutes les commandes de triche/développement directement accessibles en tant qu'administrateur !

En cas de problème

❌ Le mod ne se charge pas dans la console

Mauvais emplacement : Vérifiez que le fichier .dll est bien déposé dans BepInEx/plugins/ et non à la racine ou directement dans le dossier BepInEx/.
Dépendances manquantes : Certains mods nécessitent d'autres mods prérequis pour fonctionner (ex: Jotunn, HookGenPatcher). Vérifiez la section Dependencies sur la page Thunderstore du mod.

❌ Le serveur plante au lancement

Consultez les logs : Ouvrez le fichier BepInEx/LogOutput.log depuis le gestionnaire de fichiers pour identifier l'erreur exacte générée par le mod.
Incompatibilité client/serveur : Certains mods nécessitent d'être installés à la fois sur le serveur et sur le PC du joueur pour fonctionner correctement.

Bonnes pratiques

Vérifiez la compatibilité Server-Side / Client-Side : Lisez attentivement la description du mod sur Thunderstore pour savoir si les joueurs doivent aussi l'installer de leur côté.
Installez les mods un par un : En cas de problème ou de bug, tester un mod après l'autre vous permettra d'isoler immédiatement le fichier responsable.
Effectuez une sauvegarde : Utilisez l'onglet Backups de votre panel avant toute nouvelle installation de mod.

Besoin d'aide ?

Si vous rencontrez des difficultés lors de l'installation d'un mod, notre équipe technique reste à votre disposition. Ouvrez un ticket depuis le support Winheberg. 🎮