How To Install Mods On Your V Rising Server - V-rising Guide

In this guide, you will learn how to install mods and plugins on your V Rising server using BepInEx.

Installing BepInEx

Before installing any mods or plugins, you must first install BepInEx.

Log in to the GhostCap Panel and select your V Rising server.
In the sidebar, navigate to Tools > Mod Manager.
Locate BepInEx and click Install.

Note

To update BepInEx, simply follow the above process again but click Uninstall and then Install again.

Installing Plugins

Once BepInEx is installed, you can now add the plugins you wish. We suggest downloading them from Thunderstore. You will also need to know how to upload files to your game server..

Log in to the GhostCap Panel and Stop your V Rising server.
Download the plugin you want from Thunderstore, right click, and extract it.
Access your V Rising server using SFTP.

Navigate to BepInEx/plugins and upload your extracted plugin folder.

Your file structure should look like this:

BepInEx
└── plugins
    └── odjit-KindredPortals   ← Example plugin
        ├── KindredPortals.dll
        ├── manifest.json
        └── ...

Start your server.

Tip

Did you know?

Some plugins may require additional configuration before use, make sure to install any and all dependencies listed by the plugin author and follow any installation instructions.
Some plugins also require that you become an admin to use commands.
You can tell if a plugin is loading by opening the log file at BepInEx/LogOutput.log.

Troubleshooting Mods

BepInEx writes everything it loads to a log at BepInEx/LogOutput.log. When a plugin isn't working, check this file first.

Log in to the GhostCap Panel and select your V Rising server.
In the sidebar, navigate to File Manager.
Open BepInEx/LogOutput.log.
Search for your plugin name. A line like [Info : BepInEx] Loading [KindredPortals 1.2.1] means the plugin loaded.
Check any [Error] or [Warning] lines to find what broke.

Note

BepInEx overwrites this log every time your server starts, so it only shows the most recent boot. Reproduce the issue first, then read the log.

Most load failures come from a missing dependency or an outdated plugin. Install every dependency listed on the plugin page, and update your plugins after each game update.

If you get stuck at any time, just reach out to us on Discord or via a support ticket.