# How to Install Mods on Your V Rising Server (/docs/v-rising/mod-setup)



import { Step, Steps } from 'fumadocs-ui/components/steps';
import { Files, Folder, File } from 'fumadocs-ui/components/files';

V Rising mods use the **BepInEx** framework. Server-side mods work without clients needing them. Client-side mods require all players to have matching mods installed.

Install BepInEx [#install-bepinex]

<Steps>
  <Step>
    Download BepInExPack [#download-bepinexpack]

    Download the V Rising BepInExPack from [Thunderstore](https://thunderstore.io/c/v-rising/).
  </Step>

  <Step>
    Stop the server [#stop-the-server]

    Go to **Console** in the [XGamingServer Panel](https://panel.xgamingserver.com) and stop the server.
  </Step>

  <Step>
    Upload to the server [#upload-to-the-server]

    Extract the BepInExPack and upload the contents to your server root via **Files**. The structure should look like:

    <Files>
      <Folder name="(server root)" defaultOpen>
        <File name="winhttp.dll" />

        <File name="doorstop_config.ini" />

        <Folder name="BepInEx" defaultOpen>
          <Folder name="plugins" />

          <Folder name="config" />

          <Folder name="core" />
        </Folder>
      </Folder>
    </Files>
  </Step>

  <Step>
    Start the server [#start-the-server]

    Start from **Console**. BepInEx initializes on first run and creates config files.
  </Step>
</Steps>

Install Mods [#install-mods]

<Steps>
  <Step>
    Download mods [#download-mods]

    Find V Rising mods on [Thunderstore](https://thunderstore.io/c/v-rising/) or [Nexus Mods](https://www.nexusmods.com/vrising).
  </Step>

  <Step>
    Upload mod DLLs [#upload-mod-dlls]

    Place `.dll` mod files in `BepInEx/plugins/`.

    {/* Screenshot needed: File Manager showing BepInEx/plugins/ directory */}
  </Step>

  <Step>
    Restart [#restart]

    Restart from **Console**. Mod configs auto-generate in `BepInEx/config/` on first load.
  </Step>
</Steps>

Popular Modding Framework [#popular-modding-framework]

**Bloodstone** is the primary server-side modding framework for V Rising. Many server mods depend on it — install Bloodstone first, then mods that require it.

Server-Side vs Client-Side [#server-side-vs-client-side]

| Type        | Players Need Mods? | Examples                                   |
| ----------- | ------------------ | ------------------------------------------ |
| Server-side | No                 | Admin tools, loot tweaks, server utilities |
| Client-side | Yes, all players   | UI changes, custom abilities               |

Related Guides [#related-guides]

* [Server Configuration](/docs/v-rising/server-config)