# How To Install Mods on Your Risk of Rain 2 Server (/docs/risk-of-rain-2/install-mods)



import { Step, Steps } from 'fumadocs-ui/components/steps';

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.

<div className="fd-steps">
  <div className="fd-step">
    Find Mods to Install [#1-find-mods-to-install]

    Browse available mods on [Thunderstore](https://thunderstore.io/package/r2modman/) for Risk of Rain 2. Download the mods you want to install to your computer.
  </div>

  <div className="fd-step">
    Open the XGamingServer Panel [#2-open-the-xgamingserver-panel]

    Log in to the [XGamingServer Panel](https://panel.xgamingserver.com).
  </div>

  <div className="fd-step">
    Stop Your Server [#3-stop-your-server]

    Make sure your server is **stopped** before installing mods.
  </div>

  <div className="fd-step">
    Open Files [#4-open-files]

    In the sidebar, click **Files**.
  </div>

  <div className="fd-step">
    Navigate to the BepInEx Plugins Folder [#5-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 `BepInEx` folder in your server root directory.
  </div>

  <div className="fd-step">
    Upload the Mod Files [#6-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.
  </div>

  <div className="fd-step">
    Check for Configuration Files [#7-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.
  </div>

  <div className="fd-step">
    Start Your Server [#8-start-your-server]

    Click **Start** to launch your server with the mods loaded.
  </div>

  <div className="fd-step">
    Verify the Mods [#9-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.
  </div>
</div>

Updating 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 [#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.