How To Install Mods on Your Risk of Rain 2 Server
Learn how to install Thunderstore and r2modman mods on your Risk of Rain 2 dedicated server.
Risk of Rain 2 has a thriving modding community built around the Thunderstore mod platform. Mods can add new characters, items, game modes, and quality-of-life improvements to your server.
📝 Note: All players connecting to your modded server need to have the same mods installed on their client. Players typically use the r2modman or Thunderstore Mod Manager to manage their client-side mods.
Find Mods to Install
Browse available mods on Thunderstore for Risk of Rain 2. Download the mods you want to install to your computer.
Open the XGamingServer Panel
Log in to the XGamingServer Panel.
Stop Your Server
Make sure your server is stopped before installing mods.
Open Files
In the sidebar, click Files.
Navigate to the BepInEx Plugins Folder
Navigate to the BepInEx/plugins/ directory. If BepInEx is not installed, you may need to install it first as a base framework.
📝 Note: BepInEx is the mod loading framework used by Risk of Rain 2. It should be pre-installed on your server. If it is not present, check the
BepInExfolder in your server root directory.
Upload the Mod Files
Click Upload and upload the mod files (typically .dll files) to the BepInEx/plugins/ directory.
If the mod comes as a ZIP file, upload it and use the Unarchive button to extract it. Make sure the mod's .dll file ends up in the plugins directory.
Check for Configuration Files
Some mods have configuration files that are generated after the first server start. These are located in BepInEx/config/. You can edit these files to customize mod behavior.
Start Your Server
Click Start to launch your server with the mods loaded.
Verify the Mods
Check the Console in the panel to verify that the mods loaded successfully. Look for any error messages related to your installed mods.
Updating Mods
To update a mod, simply replace the old mod files in BepInEx/plugins/ with the new versions. Always stop your server before updating mods.
Removing Mods
To remove a mod, delete its files from BepInEx/plugins/ and remove any related configuration files from BepInEx/config/.
⚠️ Warning: Make sure all players connecting to your server have the same mods and versions installed. Mismatched mods will cause connection failures or crashes.
💡 Tip: Keep a list of your installed mods and their versions so players know exactly what they need. You can share this as a mod profile in r2modman for easy distribution.
How is this guide?