How To Install Valheim Mods

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

Installing BepInEx

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

1. Log in to the GhostCap Panel and select your Valheim server.
2. In the sidebar, navigate to Tools > Mod Manager.
3. Locate BepInEx and click Install.
4. Restart your server.

How to update BepInEx

To update BepInEx, simply follow the above process again but click Uninstall and then Install again. This will install a fresh copy of BepInEx and update it.

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..

1. Log in to the GhostCap Panel and Stop your Valheim server.
2. Download the plugin you want from Thunderstore, right click, and extract it.
3. Access your Valheim server using SFTP.
4. Navigate to BepInEx/plugins and upload your extracted plugin folder.
5. Start your server.

Here's what your server should typically look like after installing plugins:

BepInEx
└── plugins
    ├── OdinPlus-GoodestBoy
    │   └── GoodestBoy.dll
    ├── Azumatt-AzuExtendedPlayerInventory
    │   └── AzuExtendedPlayerInventory.dll
    └── Therzie-Warfare
        └── Warfare.dll

Troubleshooting Mods

If a mod isn't working after a restart, the BepInEx log will tell you whether it actually loaded.

1. Log in to the GhostCap Panel and go to File Manager.
2. Open BepInEx/LogOutput.log.
3. Look for a Loading [ModName x.y.z] line for each mod you installed. If a mod has no Loading line, BepInEx never picked it up; check that its .dll is inside BepInEx/plugins.
4. Check any [Error] or [Warning] entries near your mod's name. These usually point to a missing dependency, a mod built for a different Valheim version, or a client-only mod running on the server.