Installer des mods sur un serveur Valheim avec BepInEx

Peut-on installer des mods sur un serveur Valheim ?

Oui, tu peux installer des mods sur ton serveur Valheim pour ajouter du contenu, modifier certaines règles du jeu ou enrichir l’expérience de tous les joueurs.

Sur Valheim, les mods serveur fonctionnent généralement avec BepInEx, un chargeur de mods qui permet au serveur de détecter et lancer les fichiers nécessaires.

Contrairement à une installation locale sur ton PC, l’installation des mods sur un serveur se fait principalement via SFTP, en envoyant les fichiers directement dans les dossiers du serveur.

Réponse rapide

Pour installer des mods sur ton serveur Valheim Nitroserv, tu dois activer la version Valheim BepInEx depuis ton manager Nitroserv, démarrer une première fois le serveur pour générer les dossiers nécessaires, puis envoyer les fichiers des mods dans le dossier BepInEx/plugins via SFTP.

Pré-requis

Avant de commencer, assure-toi :

• d’avoir accès à ton manager Nitroserv
• d’avoir créé un accès SFTP à ton serveur
• d’avoir installé un logiciel SFTP comme FileZilla ou Cyberduck
• d’avoir téléchargé les mods que tu veux installer

[image version manager]

Si tu ne sais pas encore utiliser le transfert SFTP, tu peux consulter notre guide dédié :

Utiliser le transfert SFTP

Étape 1 : activer BepInEx sur ton serveur Valheim

Pour que ton serveur puisse charger des mods, il doit utiliser BepInEx.

Depuis le manager Nitroserv

1. connecte-toi à ton manager Nitroserv
2. ouvre la page de ton serveur Valheim
3. change la version du serveur pour sélectionner Valheim - BepInEx
4. démarre le serveur une première fois
5. attends environ 1 à 2 minutes
6. arrête à nouveau le serveur

Cette première mise en route est importante : elle permet au serveur de créer automatiquement les dossiers nécessaires à l’installation des mods.

Sans cette étape, certains dossiers comme BepInEx ou plugins peuvent ne pas encore exister.

Étape 2 : télécharger des mods Valheim

Le site le plus utilisé pour trouver des mods Valheim est Thunderstore :

Thunderstore - Mods Valheim

Sur la page du mod que tu veux installer :

1. clique sur Manual Download
2. télécharge l’archive du mod
3. extrais le fichier .zip sur ton ordinateur

À l’intérieur, tu trouveras souvent :

• un fichier .dll
• parfois un dossier de configuration
• parfois des fichiers ou dossiers supplémentaires nécessaires au mod

Attention aux dépendances

Certains mods ont besoin d’autres mods pour fonctionner.

Ces mods nécessaires sont appelés des dépendances.

Sur Thunderstore, vérifie toujours la section Dependencies de la page du mod.

Par exemple, certains mods peuvent demander :

• Jotunn
• HookGenManager
• BepInExPack Valheim
• d’autres bibliothèques ou mods complémentaires

Si une dépendance est manquante, ton mod peut ne pas se charger correctement, ou ton serveur peut afficher des erreurs au démarrage.

Étape 3 : envoyer les mods sur ton serveur via SFTP

Avant de modifier les fichiers, arrête ton serveur Valheim depuis le manager Nitroserv.

Ensuite :

1. connecte-toi à ton serveur via SFTP
2. ouvre le dossier de ton serveur Valheim
3. rends-toi dans le dossier suivant :

Valheim-BepInEx/BepInEx/plugins/

4. envoie les fichiers du mod dans le dossier plugins

Comment placer les fichiers dans le dossier plugins ?

Selon le mod, tu peux avoir deux cas.

Cas 1 : le mod contient seulement un fichier .dll

Si le mod contient uniquement un fichier .dll, tu peux l’envoyer directement dans :

Valheim-BepInEx/BepInEx/plugins/

Exemple :

Valheim-BepInEx/BepInEx/plugins/MonMod.dll

Cas 2 : le mod contient un dossier complet

Si le mod contient un dossier avec plusieurs fichiers, garde le dossier complet.

Envoie-le dans :

Valheim-BepInEx/BepInEx/plugins/

Exemple :

Valheim-BepInEx/BepInEx/plugins/NomDuMod/MonMod.dll

C’est souvent nécessaire quand le mod contient aussi des fichiers de configuration, des assets ou d’autres fichiers utiles.

Étape 4 : démarrer et vérifier le serveur

Une fois les mods envoyés :

1. retourne dans ton manager Nitroserv
2. démarre ton serveur Valheim
3. ouvre la console ou les logs de démarrage
4. vérifie que BepInEx détecte bien les fichiers .dll

Si tout se passe bien, tu devrais voir des lignes indiquant que BepInEx charge les plugins installés.

Les joueurs doivent-ils installer les mêmes mods ?

Dans beaucoup de cas, oui.

Si le mod ajoute du contenu, modifie le gameplay, ajoute des objets ou change des mécaniques importantes, les joueurs doivent généralement installer les mêmes mods sur leur PC.

Ils peuvent le faire avec un gestionnaire de mods comme :

• Thunderstore Mod Manager
• r2modman
• Vortex

Si les joueurs n’ont pas les bons mods, ou pas les mêmes versions, ils peuvent être refusés à la connexion ou rencontrer des erreurs en jeu.

Mods serveur uniquement et mods client uniquement

Tous les mods Valheim ne fonctionnent pas de la même façon.

Certains mods doivent être installés :

• uniquement sur le serveur
• uniquement côté joueur
• à la fois sur le serveur et sur le PC des joueurs

Avant d’installer un mod, vérifie toujours sa description sur Thunderstore. Les auteurs indiquent souvent si le mod est server-side, client-side ou nécessaire des deux côtés.

Problèmes fréquents

Le mod ne fonctionne pas

Si le mod ne semble pas actif, vérifie que :

• le fichier .dll est bien dans le dossier BepInEx/plugins
• le serveur utilise bien la version Valheim BepInEx
• les dépendances du mod sont installées
• le mod est compatible avec la version actuelle de Valheim
• le serveur a bien été redémarré après l’envoi des fichiers

Les joueurs n’arrivent pas à rejoindre le serveur

Si les joueurs ne peuvent pas se connecter, vérifie que :

• ils utilisent les mêmes mods que le serveur
• les versions des mods correspondent
• les dépendances sont aussi installées côté joueur si nécessaire
• le mod n’est pas réservé uniquement au serveur ou uniquement au client

Le serveur crash au démarrage

Un crash au démarrage peut venir :

• d’un mod incompatible
• d’une dépendance manquante
• d’une mauvaise version du mod
• d’un fichier mal placé
• d’une mise à jour récente de Valheim

Dans ce cas, consulte les logs du serveur pour repérer le mod ou l’erreur concernée.

Attention aux mises à jour de Valheim

Valheim reçoit régulièrement des mises à jour officielles.

Après une mise à jour du jeu, certains mods peuvent temporairement ne plus fonctionner. C’est particulièrement fréquent avec les mods qui modifient beaucoup de mécaniques ou qui dépendent de bibliothèques externes.

Si ton serveur crash après une mise à jour :

1. vérifie si tes mods ont été mis à jour sur Thunderstore
2. mets à jour les dépendances
3. retire temporairement les mods les plus anciens
4. redémarre le serveur pour tester

Bonnes pratiques avant d’ajouter des mods

Avant d’installer ou de mettre à jour des mods sur ton serveur Valheim :

• arrête toujours ton serveur
• fais une sauvegarde
• vérifie les dépendances du mod
• évite d’ajouter trop de mods d’un coup
• teste les mods progressivement
• garde les mêmes versions côté serveur et côté joueurs quand c’est nécessaire

Ces quelques réflexes évitent beaucoup de crashs et de problèmes de connexion.

Résumé rapide

Pour installer des mods sur ton serveur Valheim :

1. sélectionne la version Valheim BepInEx dans ton manager Nitroserv
2. démarre le serveur une première fois
3. arrête le serveur
4. télécharge les mods depuis Thunderstore
5. vérifie les dépendances
6. envoie les fichiers dans BepInEx/plugins via SFTP
7. redémarre le serveur
8. vérifie les logs pour confirmer que les mods sont bien chargés

Aller plus loin

Pour gérer les fichiers de ton serveur, tu utiliseras souvent le SFTP :

Utiliser le transfert SFTP

Tu peux aussi consulter nos autres guides :

• Sauvegarder son serveur
• Lire les logs de son serveur
• Modifier les fichiers de configuration de son serveur

Besoin d’aide ?

Si ton serveur Valheim ne démarre pas après l’installation d’un mod, ou si tu ne sais pas quels fichiers envoyer, tu peux nous contacter.

On peut t’aider :

• via un ticket depuis ton manager Nitroserv
• sur notre Discord
• via notre compte Twitter/X

Pense à nous envoyer les logs du serveur si tu rencontres une erreur : ça nous aidera à identifier plus rapidement le problème.