[{"data":1,"prerenderedAt":31},["ShallowReactive",2],{"doc-en-install-bepinex-mod-valheim":3},{"path":4,"slug":5,"title":6,"description":7,"category":8,"subcategory":9,"icon":10,"date":11,"author":12,"order":13,"image":14,"tags":15,"keywords":21,"docGroup":28,"docGroupIcon":28,"link_fr":29,"bodyHtml":30},"\u002Fdocs\u002Fen\u002Fgaming\u002Fvalheim\u002Finstall-bepinex-mod-valheim","install-bepinex-mod-valheim","How to Install a BepInEx Mod on a Valheim Server","Complete guide to installing a BepInEx mod on your Winheberg Valheim server. Step-by-step example using the Server Devcommands mod.","jeux","valheim","tabler:file-text","2026-08-11","Winheberg",80,"\u002Fstatics\u002Fimages\u002Fdocs\u002Fen\u002Fgaming\u002Fvalheim\u002Finstall-bepinex-mod-valheim.webp",[16,17,18,19,20],"Valheim","Mods","BepInEx","Tutorial","Server",[22,23,24,25,26,27],"install valheim mod","valheim bepinex plugins","server devcommands valheim","add mod valheim server","thunderstore valheim","valheim modding winheberg","","\u002Fdocs\u002Fvalheim\u002Finstaller-mod-bepinex-valheim","\u003Ch2>Context\u003C\u002Fh2>\n\u003Cp>Once BepInEx is enabled on your Valheim server, you can add mods to unlock new features or expand your administrative capabilities.\u003C\u002Fp>\n\u003Cp>This guide details the general process for installing any BepInEx mod (\u003Ccode>.dll\u003C\u002Fcode> format), using the popular \u003Ca href=\"https:\u002F\u002Fthunderstore.io\u002Fc\u002Fvalheim\u002Fp\u002FJereKuusela\u002FServer_devcommands\u002F\">Server_devcommands mod by JereKuusela\u003C\u002Fa> as an example, which unlocks full developer\u002Fadmin commands on dedicated servers.\u003C\u002Fp>\n\u003Ch2>Prerequisites\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>A Valheim server with \u003Cstrong>BepInEx enabled\u003C\u002Fstrong> on your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa> (See our guide: \u003Ca href=\"https:\u002F\u002Fwinheberg.com\u002Fen\u002Fdocs\u002Fvalheim\u002Finstall-bepinex-valheim\">How to Install and Enable BepInEx\u003C\u002Fa>).\u003C\u002Fli>\n\u003Cli>The mod file downloaded from a platform such as Thunderstore.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Step 1: Download and Extract the Mod\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Go to the mod page, for example \u003Ca href=\"https:\u002F\u002Fthunderstore.io\u002Fc\u002Fvalheim\u002Fp\u002FJereKuusela\u002FServer_devcommands\u002F\">Server_devcommands on Thunderstore\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>Click \u003Cstrong>Manual Download\u003C\u002Fstrong> to download the \u003Ccode>.zip\u003C\u002Fcode> archive.\u003C\u002Fli>\n\u003Cli>Extract the archive on your computer. You will find a \u003Ccode>.dll\u003C\u002Fcode> file (e.g., \u003Ccode>ServerDevcommands.dll\u003C\u002Fcode>).\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Ch2>Step 2: Transfer the Mod to Your Server\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Log in to your \u003Ca href=\"https:\u002F\u002Fpanel.winheberg.com\">Winheberg panel\u003C\u002Fa>.\u003C\u002Fli>\n\u003Cli>To avoid file lock issues during transfer, \u003Cstrong>stop your server\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>In the sidebar menu, click \u003Cstrong>Files\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Navigate to the following directory: \u003Ccode>BepInEx\u002Fplugins\u002F\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>Drag and drop the mod&#39;s \u003Ccode>.dll\u003C\u002Fcode> file (e.g., \u003Ccode>ServerDevcommands.dll\u003C\u002Fcode>) directly into the \u003Ccode>plugins\u003C\u002Fcode> folder.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cdiv class=\"markdown-alert markdown-alert-note\">\u003Cspan class=\"alert-icon\">\u003Csvg xmlns=\"http:\u002F\u002Fwww.w3.org\u002F2000\u002Fsvg\" width=\"16\" height=\"16\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\">\u003Ccircle cx=\"12\" cy=\"12\" r=\"10\"\u002F>\u003Cline x1=\"12\" y1=\"16\" x2=\"12\" y2=\"12\"\u002F>\u003Cline x1=\"12\" y1=\"8\" x2=\"12.01\" y2=\"8\"\u002F>\u003C\u002Fsvg>\u003C\u002Fspan>\u003Cdiv class=\"markdown-alert-body\">\u003Cp>If the mod&#39;s \u003Ccode>.zip\u003C\u002Fcode> file includes additional folders or specific configuration files, upload the full extracted structure into the \u003Ccode>plugins\u002F\u003C\u002Fcode> directory.\u003C\u002Fp>\n\u003C\u002Fdiv>\u003C\u002Fdiv>\n\u003Ch2>Step 3: Restart the Server\u003C\u002Fh2>\n\u003Col>\n\u003Cli>Return to the \u003Cstrong>Console\u003C\u002Fstrong> tab and click \u003Cstrong>Start\u003C\u002Fstrong>.\u003C\u002Fli>\n\u003Cli>Upon startup, BepInEx will load the mod and automatically generate a dedicated configuration file inside the \u003Ccode>BepInEx\u002Fconfig\u002F\u003C\u002Fcode> folder.\u003C\u002Fli>\n\u003C\u002Fol>\n\u003Cp>For the \u003Cem>Server_devcommands\u003C\u002Fem> mod, you now have access to all dev\u002Fcheat commands directly as an administrator!\u003C\u002Fp>\n\u003Ch2>Troubleshooting\u003C\u002Fh2>\n\u003Ch3>❌ The mod does not load in the console\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Wrong path:\u003C\u002Fstrong> Double-check that the \u003Ccode>.dll\u003C\u002Fcode> file is placed inside \u003Ccode>BepInEx\u002Fplugins\u002F\u003C\u002Fcode> and not at the root or directly inside \u003Ccode>BepInEx\u002F\u003C\u002Fcode>.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Missing dependencies:\u003C\u002Fstrong> Some mods require prerequisite mods to work (e.g., Jotunn, HookGenPatcher). Check the \u003Cem>Dependencies\u003C\u002Fem> section on the mod&#39;s Thunderstore page.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch3>❌ Server crashes on launch\u003C\u002Fh3>\n\u003Cul>\n\u003Cli>\u003Cstrong>Check the logs:\u003C\u002Fstrong> Open the \u003Ccode>BepInEx\u002FLogOutput.log\u003C\u002Fcode> file from the file manager to inspect the exact error thrown by the mod.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Client\u002FServer mismatch:\u003C\u002Fstrong> Some mods must be installed on both the server \u003Cstrong>and\u003C\u002Fstrong> the player&#39;s local game client.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Best Practices\u003C\u002Fh2>\n\u003Cul>\n\u003Cli>\u003Cstrong>Check Server-Side vs Client-Side requirements:\u003C\u002Fstrong> Carefully read the mod description on Thunderstore to see if players also need to install it locally.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Install mods incrementally:\u003C\u002Fstrong> Installing mods one by one helps you quickly isolate broken or incompatible files if something goes wrong.\u003C\u002Fli>\n\u003Cli>\u003Cstrong>Create a Backup:\u003C\u002Fstrong> Use the \u003Cstrong>Backups\u003C\u002Fstrong> tab in your panel before adding any new mod.\u003C\u002Fli>\n\u003C\u002Ful>\n\u003Ch2>Need Assistance?\u003C\u002Fh2>\n\u003Cp>If you encounter issues while installing a mod, our technical support team is here to assist you. Submit a ticket through \u003Ca href=\"https:\u002F\u002Fbilling.winheberg.com\u002Flogin\">Winheberg Support\u003C\u002Fa>. 🎮\u003C\u002Fp>\n",1788993143416]