In this guide, you will learn how to install mods and plugins on your V Rising server using BepInEx.
Enabling BepInEx
Before installing any mods or plugins, you must first turn on BepInEx.
- Log in to the GhostCap Panel and select your V Rising server.
- Open
Mods. - Click
Enable BepInEx Modding, then clickEnable & restart.
You can also turn on Enable Modding (Bepinex) under Modding in Settings.
Your server installs and updates BepInEx each time it starts while modding is turned on, so there's nothing to update by hand.
Installing Plugins From The Panel
Once BepInEx is enabled, you can install plugins from Thunderstore right in the panel.
- Log in to the GhostCap Panel and select your V Rising server.
- Open
Modsand selectBrowse. - Search for the plugin you want and click
Install. Any plugins it depends on are installed with it. - Restart your server.
Installing Plugins Manually
If a plugin isn't listed in the panel, you can upload it yourself. 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
Stopyour 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/pluginsand 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.
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.
- Open
Files. - 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.
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.

