Skip to main content

BepInEx Modding

Modding Games with BepInEx on Linux​

BepInEx is a popular Unity game modding framework. Getting it to work on Linux requires one extra step: you need to tell Wine/Proton to load BepInEx's custom DLL instead of the built-in Windows one.

Install BepInEx into your game folder as you normally would, then follow the instructions for your launcher below.

Steam​

You need to add a launch option to force Proton to use the custom DLL.

  1. Right-click the game in your Steam Library and select Properties.
  2. In the General tab, scroll down to Launch Options.
  3. Paste the following line exactly as written:
WINEDLLOVERRIDES="winhttp=n,b" %command%
note

If your BepInEx download came with version.dll instead of winhttp.dll, change the command to:

WINEDLLOVERRIDES="version=n,b" %command%

Lutris​

  1. Right-click the game and select Configure.
  2. Go to the Runner options tab.
  3. Scroll down to DLL overrides and click Add.
  4. Under Key, type winhttp. Under Value, type n,b.
  5. Save and launch.

Heroic Games Launcher​

  1. Click the Settings icon for the specific game.
  2. Scroll down to the Wine/Proton section and find Advanced Options or Winetricks / Game Settings.
  3. Look for DLL Overrides.
  4. Add winhttp and set it to Native then Builtin (which is what n,b stands for).