Context
To join a modded Valheim server or enhance your solo gameplay experience, mods must be installed directly on your computer (client).
There are two primary methods for modding Valheim on PC:
- The Recommended Method (Mod Manager): Using software like r2modman or Thunderstore Mod Manager to install, update, and manage your mods with one click.
- The Manual Method: Manually downloading and installing the BepInEx framework into your local game files.
This guide walks you through both methods step by step.
Prerequisites
- The game Valheim installed on your PC via Steam.
- An internet connection to download files from Thunderstore.
Method 1: Use a Mod Manager (Recommended)
Using a mod manager isolates mod files from your root game directory, preventing file corruption and simplifying multiplayer server connections. You can choose between two main tools:
- r2modman (Recommended): A lightweight, fast, ad-free mod manager.
- Thunderstore Mod Manager: The official manager powered by Overwolf.
Option A: Install and Use r2modman
- Go to the r2modman page on Thunderstore.
- Click Manual Download and run the installer on your PC.
- Open r2modman, search for Valheim in the game list, and click Select game.
- Choose the default profile (
Default) or create a new one.
Option B: Install and Use Thunderstore Mod Manager
- Go to the official Thunderstore App page.
- Click Get App to download the installer (requires the Overwolf platform).
- Run the installer file and follow the on-screen setup instructions.
- Open the app, select Valheim from the game list, and choose your profile.
Next Step: Download Mods and Launch the Game
- In your mod manager (r2modman or Thunderstore), go to the Online tab.
- Search for your desired mod (e.g., Server_devcommands, Jotunn, etc.).
- Click on the mod, then click Download (confirm dependencies if prompted).
- To play with mods enabled, click the Start modded button in the top-left corner of the app. To play vanilla, click Start vanilla.
Method 2: Manual Installation with BepInEx
If you prefer not to use third-party managers, you can install the BepInEx framework directly into your local game directory.
Step 1: Locate Local Game Files
- Open Steam and go to your Library.
- Right-click Valheim > Manage > Browse local files.
- A file explorer window will open at the root of your Valheim installation (where
valheim.exeis located).
Step 2: Install BepInExPack Valheim
- Download the latest release of BepInExPack Valheim on Thunderstore.
- Click Manual Download and extract the
.ziparchive. - Open the extracted
BepInExPack_Valheimfolder. - Copy all contents located inside this folder (
BepInEx/,doorstop_config.ini,winhttp.dll, etc.). - Paste these items directly into your root Valheim folder (opened in Step 1).
Step 3: Add Mods (.dll)
- Launch Valheim once and exit to allow BepInEx to build its file directory structure.
- Download your desired mod from Thunderstore as a
.zipfile and extract it. - Navigate to the following path inside your game directory:
Valheim/BepInEx/plugins/. - Drag and drop the mod's
.dllfile directly into thispluginsfolder. - Launch Valheim via Steam.
When joining a modded server hosted on Winheberg, make sure your client has the exact same mod versions installed as the server (see our guide: How to Install a BepInEx Mod on a Valheim Server).
Troubleshooting
❌ The game launches vanilla (without mods)
- Manual setup: Ensure
winhttp.dlland theBepInExfolder are placed directly alongsidevalheim.exeand not nested inside a subfolder. - Mod Manager setup: Ensure you launch the game using the Start modded button inside your manager app rather than directly through Steam.
❌ Cannot join a dedicated server
- Version mismatch: Verify that the mods installed on your PC match the exact list and versions required by the target server.
Best Practices
- Use a Mod Manager for multiplayer: It allows you to switch easily between dedicated mod profiles tailored to different servers.
- Back up local save files: Before installing mods that alter world generation or items, back up your local saves located at
%USERPROFILE%\AppData\LocalLow\IronGate\Valheim\.
Need Assistance?
If you run into issues while setting up client mods, our support team is available to assist you. Contact us through Winheberg Support. 🎮


