Install mods and join your server, step by step
From adding a mod in L'Atelier to arriving in the world, with real screenshots. About 10 minutes the first time, 1 minute afterwards.
The server owner, in L'Atelier
Done by whoever rents the server. Players can skip straight to part B.
Open the Mods page and install a mod
On your server's page in L'Atelier, click Mods in the menu on the left (1). Scroll down to the Catalog and click Install (2) on the right of the mod you want. The label above its name tells where it gets installed:
- server + players: installed on the server and on every player's PC (through the player link).
- players: only added to the players' profile.

Restart the server
A “server + players” mod only becomes active after a restart. Click the Restart button (the round arrow) in your server's card, at the top left.

It is normal for this to take 3 minutes. The server stops, waits 2 minutes for Valheim to release the old session, then starts again: that is what makes sure the join code works afterwards. Do not click more than once.
Copy the player link
Still on the Mods page, under Share with your players, click Copy next to Players link (1): the link is copied to your clipboard.

This link is always up to date: if you change the mods later, your players just open it again. It contains the server password: only send it to your players.
Paste the link in your browser and send it to your friends
Click the address bar, press Ctrl + V then Enter. Send the same link to your friends (Discord, WhatsApp…): part B is the same for everyone, you included.

Each player, on their PC
Got the player link? Open it: you land on the “Join” page. Steps 5 to 7 are only done once.
Get r2modman
r2modman is the free program that installs the mods for you. On the “Join” page, click the orange word r2modman.

Download r2modman
On the Thunderstore page, right-hand column, click Download. The file ebkr-r2modman-….zip (about 350 MB) lands in your Downloads folder.

Not the big green Install with App button: it installs a different program. Only download r2modman from Thunderstore or GitHub; other sites pretend to be it.
Install r2modman as administrator
Important: on some PCs the installation gets stuck, or r2modman cannot install the mods, when it is started normally (Windows denies it access). Run it as administrator to avoid the problem.
- In Downloads, right-click the .zip → Extract All… → Extract (or “Extract here” with WinRAR / 7-Zip).
- In the extracted folder, right-click r2modman-Setup-3.2.20.exe → Run as administrator (1).
- If the blue “Windows protected your PC” screen appears: More info (2) then Run anyway (3).
- At “Do you want to allow this app to make changes to your device?”: Yes (4). The installation finishes by itself and r2modman opens.
Application
Windows protected your PC
Microsoft Defender SmartScreen prevented an unrecognised app from starting.More info
r2modman
Next time, also open r2modman as administrator: right-click its icon → Run as administrator. To stop thinking about it: right-click → Properties → Compatibility tab → tick Run this program as an administrator → OK.
Download the server profile
Go back to the “Join” page and click the orange Download the server profile button (1). A small .r2z file lands in your Downloads: it is the exact list of the server's mods, in the right versions.

In r2modman: pick Valheim
9.1Search for the game
When it opens, r2modman asks which game you want mods for. Click the search bar and type Valheim.

9.2Select Valheim
Hover the Valheim picture and click Select game.

9.3Choose Steam
Keep Steam ticked (1) and click Select platform (2).

Import the server profile
10.1Import / Update
On the profile screen, click Import / Update.

10.2From file
Click From file.

10.3Pick the .r2z file
In your Downloads, click the server's file (1), then Import (2).

10.4Confirm the mod list
r2modman shows the mods it will install. Click Import.

10.5New profile
Click Import new profile. (Later, to update, you will choose Update existing profile.)

10.6Create
The profile name is already filled in. Click Create: r2modman downloads and installs all the mods by itself.

10.7Select the profile
Click the new profile (1) then Select (2).

This creates a separate profile: if you already have mods for another server, they are not touched.
Launch the game with Start modded
You see the list of installed mods. Click Start modded at the top left.

Do not click “Update all?” in the yellow banner: your mods must stay at the server's version, otherwise the connection is refused. ForgeServer validates new versions, and the server profile gives them to you.
Always launch Valheim from r2modman with Start modded, never from Steam: launched from Steam, the game starts without mods.
11.1Wait
This message shows while Steam starts the game. The first launch is longer than usual.

11.2The black BepInEx window
A black window full of text opens next to the game: it is the mod loader. It is a good sign, do not close it.

Join the server
12.1Main menu
At the bottom right, Valheim says you are playing a modded version: the mods are loaded. Click Start game.

12.2Character
Pick your character with the arrows, then Start.

12.3Add the server
Open the Join game tab (1), then click Add server (2).

12.4Type the join code
The code is on the “Join” page (the player link):

Type it in the field (1) then click Add server (2).

12.5Connect
The server shows up in the list. Select it (1) then Connect (2).

12.6Password
Type the password shown on the “Join” page, then Enter.

The code does not change: next time the server is already in your favourites. If the server has just restarted, wait 2 to 3 minutes before connecting.
Check that everything works
You appear in the world. Press F1: the mod settings menu opens (if the server has the “Settings menu (F1)” mod). Press F1 again to close it.

You are done. Next time: r2modman (as administrator) → your profile → Start modded. If the server changes its mods, open the player link again, download the profile again and redo step 10 choosing Update existing profile.
Not working?
The r2modman installation gets stuck or does nothing
Run the installer again with right-click → Run as administrator (step 7). Make sure the .zip was extracted first: a program started from inside a zip can fail.
The game starts without the mods
Launch it from r2modman with Start modded, never from Steam. If it keeps happening, close r2modman and open it again as administrator.
“Incompatible version” or connection refused
Your mods no longer match the server's version (often after clicking “Update all?”). Open the player link again, download the server profile again and import it with Import / Update → From file → Update existing profile.
The server does not show up with the code
The server may have restarted less than 3 minutes ago: wait a little. The owner can check in L'Atelier that it is “Online”.
I play on Xbox or Game Pass
Mods are not possible on those versions: you need the Steam version on PC.