Installing Valheim Mods with BepInEx

What is BepInEx?

BepInEx is a mod framework for Unity games. It is required for Valheim mods to work.

Installing BepInEx on the Server

  1. Download BepInEx from Thunderstore
  2. Extract the contents into the Valheim server directory
  3. Restart the server – BepInEx automatically creates the config folders
/valheim/
├── BepInEx/
│   ├── config/          # Mod configurations
│   ├── plugins/         # Place mods here
│   └── patchers/
├── valheim_server.x86_64
└── start_server.sh

Installing Mods

  1. Download mods from Thunderstore
  2. Extract the DLL file into the BepInEx/plugins/ folder
  3. Restart the server

Recommended Mods

Mod Description Client required?
ValheimPlus Extensive customisations Yes
Better UI Improved user interface Yes
Plant Everything Plant anywhere Yes
Epic Loot Rare items with properties Yes
Better Wards Improved ward stones Yes

Important: Client Mods

Most Valheim mods must be installed both on the server and on the client. Use the Thunderstore Mod Manager for easy client installation.

r2modman as an Alternative

  1. Install r2modman
  2. Select "Valheim" as the game
  3. Browse and install mods with one click
  4. Export your modpack as a code → Share with friends

Troubleshooting

  • Mod does not work: Check the BepInEx version and mod compatibility
  • Server crashes: Remove mods one by one to find the cause
  • Desync: Make sure all players have the same mods