How To Install Valheim Mods

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

Enabling BepInEx

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

1. Log in to the GhostCap Panel and select your Valheim server.
2. Open Mods.
3. Click Enable BepInEx Modding, then click Enable & restart.

You can also turn on Enable Modding (Bepinex) under Modding in Settings.

How to update BepInEx

Your server installs and updates BepInEx each time it starts while modding is turned on, so there's nothing to update by hand.

Installing Mods From The Panel

Once BepInEx is enabled, you can install mods from Thunderstore right in the panel.

1. Log in to the GhostCap Panel and select your Valheim server.
2. Open Mods and select Browse.
3. Search for the mod you want and click Install. Any mods it depends on are installed with it.
4. Restart your server.

Installing Plugins Manually

If a mod 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..

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