Upgrading
Migration from previous versions of BepInEx
Upgrading from 4.x
Important
pre-BepInEx 5 plugins are not compatible with BepInEx 5!
This guide only provides a temporary upgrade solution.
It is suggested that you do a clean install of BepInEx instead -- remove all BepInEx files and start over fresh.
- Delete
BepInEx/core
folder if it exists. - Download and install BepInEx 5 according to the installation guide.
- Download latest version of
BepInEx.BepInEx4Upgrader
and place it inBepInEx/patchers
folder. - Run the game normally.
Upgrading from 3.x
To migrate from a previous version of BepInEx, do the following:
- Delete
UnityEngine.dll
,0Harmony.dll
andBepInEx.dll
from the*_Data\Managed
folder for your game
- IMPORTANT: Check all game folders for their respective
Managed
folders. BepInEx 3 creates the aforementioned files for each valid Unity executable it finds, which means that you may have to repeat this process multiple times.
- Rename
UnityEngine.dll.bak
toUnityEngine.dll
- Delete
BepInEx.Patcher.exe
from the game's root folder. - Delete your
config.ini
file in your BepInEx folder - Follow the upgrading guide for 4.x
Migrating from Sybaris 2.x
- Delete all occurences of the following DLLs in the game's folder:
ExIni.dll
UnityInjector.dll
Mono.Cecil.dll
Sybaris.Loader.dll
COM3D2.UnityInjector.Patcher
(and other UnityInjector patchers)opengl32.dll
Use Windows' search tool if you cannot find those.
- Install BepInEx 4 normally
- Download and install UnityInjectorLoader and SybarisLoader to enable UnityInjector and Sybaris compatibility