BepInEx is the mod loader that nearly every Valheim mod depends on. Once installed, you can add mods for QoL, new content, and server features. Here is how to set it up.
What Is BepInEx?
BepInEx is a modding framework for Unity games. It loads mod DLLs when the game starts. Valheim mods on Thunderstore and Nexus require BepInEx to function.
Method 1: Mod Manager (Easiest)
The simplest way is using a mod manager like r2modman or the Thunderstore Mod Manager:
- Download r2modman or Thunderstore Mod Manager
- Select Valheim as the game
- Create a profile
- Install mods, BepInEx is installed automatically as a dependency
- Launch the game through the manager
This method handles BepInEx, dependencies, and updates for you. It is the recommended approach.
Method 2: Manual Installation
- Download BepInEx for Valheim from Thunderstore
- Extract the contents into your Valheim game folder (where
valheim.exeis)- Default:
steamapps/common/Valheim
- Default:
- The folder should now contain a
BepInExfolder,winhttp.dll, anddoorstop_config.ini - Launch the game once to generate config files
- Place mod DLLs in
BepInEx/plugins
Installing Mods
After BepInEx is set up:
- Mod manager: Browse and click install
- Manual: Drop the mod's DLL into
BepInEx/plugins
Always read each mod's instructions, some need extra config or dependencies.
Server-Side Mods
For a modded Valheim dedicated server:
- Install BepInEx on the server as well
- Place server-compatible mods in the server's
BepInEx/plugins - Players must have the same client-side mods that require sync
- Restart the server
Some mods are client-only (visual), some are server-only, and some require both. Check each mod's description.
Common Issues
Mods not loading:
- Confirm BepInEx installed correctly (check for the BepInEx folder)
- Launch the game once after installing BepInEx before adding mods
- Verify mod compatibility with your Valheim version
Game crashes on launch:
- A mod may be outdated. Remove mods one by one to find the culprit
- Update BepInEx and all mods
Steam launch options: If using Proton on Linux, you may need to set launch options for BepInEx to load.
FAQ
Do I need BepInEx for Valheim mods? Yes. Almost all Valheim mods require BepInEx as the loader.
What is the easiest way to install BepInEx? Use a mod manager like r2modman, which installs BepInEx automatically.
Do server and client both need mods? It depends on the mod. Some are client-only, some server-only, some require both.
Related: Valheim dedicated server, Valheim Thunderstore mods server guide, Valheim progression guide