---
title: "Comment installer un mod BepInEx sur un serveur Valheim ?"
description: "Guide complet pour installer un mod BepInEx sur votre serveur Valheim Winheberg. Exemple pas à pas avec le mod Server Devcommands."
category: jeux
subcategory: valheim
icon: tabler:file-text
date: 2026-08-11
author: Winheberg
slug: "installer-mod-bepinex-valheim"
order: 80
image: /statics/images/docs/fr/gaming/valheim/installer-mod-bepinex-valheim.webp
tags: [Valheim, Mods, BepInEx, Tutoriel, Serveur]
keywords: [installer mod valheim, bepinex plugins valheim, server devcommands valheim, ajouter mod serveur valheim, thunderstore valheim, modding valheim winheberg]
link_en: "/en/docs/valheim/install-bepinex-mod-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](https://thunderstore.io/c/valheim/p/JereKuusela/Server_devcommands/) 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](https://panel.winheberg.com) (Voir notre guide : [Comment installer et activer BepInEx](https://winheberg.com/docs/valheim/installer-bepinex-valheim)).
- Le fichier du mod téléchargé depuis une plateforme comme Thunderstore.

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

1. Rendez-vous sur la page du mod souhaité, par exemple [Server_devcommands sur Thunderstore](https://thunderstore.io/c/valheim/p/JereKuusela/Server_devcommands/).
2. Cliquez sur **Manual Download** pour récupérer l'archive `.zip`.
3. Extrayez l'archive sur votre ordinateur. Vous y trouverez un fichier `.dll` (ex: `ServerDevcommands.dll`).

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

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

> [!NOTE]
> 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

1. Retournez sur la **Console** et cliquez sur **Start**.
2. 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](https://billing.winheberg.com/login). 🎮