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.

Where to click (follow the numbers) Do not click here Private information blurred
PART A

The server owner, in L'Atelier

Done by whoever rents the server. Players can skip straight to part B.

1

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.
L'Atelier Mods page and catalogue
Click a screenshot to enlarge it. An installed mod shows Disable / Uninstall instead of the button.
2

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.

Restart button

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.

3

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.

Copy button of the players link

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.

4

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.

Link pasted in the address bar
PART B

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.

5

Get r2modman

r2modman is the free program that installs the mods for you. On the “Join” page, click the orange word r2modman.

r2modman link on the Join page
6

Download r2modman

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

Download button on Thunderstore

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.

7

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.

  1. In Downloads, right-click the .zip → Extract All… → Extract (or “Extract here” with WinRAR / 7-Zip).
  2. In the extracted folder, right-click r2modman-Setup-3.2.20.exe → Run as administrator (1).
  3. If the blue “Windows protected your PC” screen appears: More info (2) then Run anyway (3).
  4. At “Do you want to allow this app to make changes to your device?”: Yes (4). The installation finishes by itself and r2modman opens.
Downloads › ebkr-r2modman-3.2.20
R
r2modman-Setup-3.2.20.exe
Application
→

Windows protected your PC

Microsoft Defender SmartScreen prevented an unrecognised app from starting.
More info
Run anywayDon't run
User Account Control
Do you want to allow this app to make changes to your device?
r2modman
YesNo

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.

8

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.

Download the server profile button
9

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.

r2modman game selection

9.2Select Valheim

Hover the Valheim picture and click Select game.

Select game button on Valheim

9.3Choose Steam

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

Steam platform choice
10

Import the server profile

10.1Import / Update

On the profile screen, click Import / Update.

Profile selection, Import / Update button

10.2From file

Click From file.

From file choice

10.3Pick the .r2z file

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

Selecting the profile file

10.4Confirm the mod list

r2modman shows the mods it will install. Click Import.

Packages to be installed

10.5New profile

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

Import new profile

10.6Create

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

Profile name and Create button

10.7Select the profile

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

Selecting the imported profile

This creates a separate profile: if you already have mods for another server, they are not touched.

11

Launch the game with Start modded

You see the list of installed mods. Click Start modded at the top left.

Start modded button and updates banner

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.

Valheim is launching via Steam message

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.

BepInEx console
12

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.

Modded Valheim main menu

12.2Character

Pick your character with the arrows, then Start.

Character selection

12.3Add the server

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

Join game tab

12.4Type the join code

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

Join code and password on the Join page

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

Typing the join code

12.5Connect

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

Server added, Connect button

12.6Password

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

Password prompt

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.

13

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.

In game, F1 mod settings menu open

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.

HELP

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.