BepInEx
github.com
- Free plan
- Open source
- Windows
- macOS
- Linux
- API
What BepInEx is
BepInEx is a free, open-source plugin and modding framework for games built with Unity Mono, Unity IL2CPP, or .NET Framework technologies such as XNA, FNA, and MonoGame. It provides configuration and logging tools, runtime method patching, and in-memory assembly patching. Runtime patching uses Harmony, including HarmonyX and MonoMod; in-memory patching uses Mono.Cecil with UnityDoorstop. The installation guide lists Windows, Linux, and macOS, though supported versions and architectures depend on the build and game. Setup is manual: download the appropriate build and put its contents in the game's root folder. Official binaries come in stable and bleeding edge channels; the documentation recommends stable builds in most cases and says bleeding edge builds tend to be buggier. Only Unity Mono has stable releases, and BepInEx 6 documentation is still in progress. BepInEx 5 is in long-term support, and its plugins do not yet work with the BepInEx 6.0.0 pre-release. Guides cover installation, configuration, troubleshooting, and plugin development.
Who it suits
BepInEx suits people who mod supported games or develop game plugins. Users need to choose a build for their game and install it manually.
Good to know, and what to watch
- Works with Unity and several .NET Framework game technologies.
- Provides runtime and in-memory patching.
- Lists Windows, Linux, and macOS support.
- Includes guides for plugin development and troubleshooting.
- Installation requires placing files in the game's root folder.
- Only Unity Mono has stable releases.
- BepInEx 5 plugins do not yet work with the 6.0.0 pre-release.
- Bleeding edge builds tend to be buggier.
Plans
Every plan and priceBepInEx
BepInEx Free
Free plan
Getting started
- Open the BepInEx GitHub repository
- Identify the game engine and operating system
- Download the correct stable or bleeding-edge build
- Place the downloaded contents in the game's root folder
- Configure the installation and logging settings
- Add plugins using the documented plugin-development and loading workflow
Limits to check
The free framework has compatibility limits: only Unity Mono has stable releases, and support varies by build, game, operating-system version, and architecture. BepInEx 6 documentation is work in progress, and BepInEx 5 plugins do not yet work with the BepInEx 6.0.0 pre-release.
The verdict
BepInEx provides modding and plugin-development tools across several game technologies and operating systems. Check game compatibility and build channel before installing, particularly when considering the BepInEx 6 pre-release.
Questions people ask
How much does BepInEx cost?
BepInEx is free, with a listed price of free.
Which games does it support?
It targets Unity Mono, Unity IL2CPP, and .NET Framework games, including XNA, FNA, and MonoGame.
Which operating systems are supported?
The installation guide lists Windows, Linux, and macOS, with versions and architectures varying by build and game.
How is BepInEx installed?
Download the correct build and manually place its contents in the game's root folder.
Are stable and bleeding-edge builds available?
Yes. Stable builds are recommended in most cases, while bleeding-edge builds tend to be buggier.
What license covers the project?
BepInEx is open source under the LGPL-2.1 license.
What the maker publishes
- Antivirus complaint
- A 2021 GitHub issue reports Norton deleting BepInEx.Preloader.dll as a threat, which the reporter associated with the loader's injection behavior. source
- Antivirus false positive
- A GitHub discussion records Gridinsoft flagging winhttp.dll and .doorstop_version in the 5.4.23.2 archive, with the reporter concluding it appeared benign after checking a related issue. source
- API documentation
- The API reference documents namespaces for core plugin classes, configuration, paths, bootstrap access and logging. source
- Assembly patching
- Mono.Cecil and UnityDoorstop enable in-memory patching of game assemblies. source
- Audience
- The docs provide instructions for installing BepInEx and writing plugins, indicating it is intended for people modding games and developing game plugins. source
- BepInEx 6 limitation
- The BepInEx 6.0.0-pre.2 release warns that BepInEx 5 plugins do not yet work with it and that the prerelease has many issues. source
- Bleeding-edge builds
- The builds site publishes platform-specific archives for Windows, Linux and macOS Unity Mono and IL2CPP, plus .NET Framework and CoreCLR targets. source
- Build channels
- Official binaries are available as stable builds and bleeding edge builds; the docs say stable builds are recommended in most cases and bleeding edge builds tend to be buggier. source
- Compatibility limit
- The repository says only Unity Mono has stable releases, and BepInEx 6 documentation is marked as work in progress. source
- Compatibility matrix
- The repository marks Unity Mono for Windows, macOS and Linux; Unity IL2CPP for Windows and Linux but not macOS; and .NET/XNA with Mono on macOS and Linux. source
- Configuration
- BepInEx includes a built-in configuration system for the framework and plugins. source
- Developer tooling
- The developer guide covers C# project setup, starter templates, logging, configuration files, preloader patchers and runtime method patching. source
- Drop-in installation
- The documentation lists drop-in installation as a core capability. source
- Ecosystem dependence
- PC Gamer says most Valheim mods require BepInEx and recommends installing its BepInExPack before additional mods. source
- Engine requirements
- Supported engines include Unity 3 or newer plus XNA, FNA, MonoGame and other .NET Framework engines. source
- Features
- It provides drop-in installation, built-in configuration and logging, runtime method patching, and in-memory assembly patching. source
- Game support
- The documentation lists Unity 3 or newer and .NET Framework games such as XNA, FNA, and MonoGame as supported game engines. source
- Independent listing status
- SourceForge hosts an exact mirror, states it is not affiliated with BepInEx, and shows 430 downloads in the reported week. source
- Installation
- BepInEx is installed manually by downloading the correct build and placing its contents in the game's root folder. source
- Installation method
- The official guide says installation is currently manual and requires choosing binaries for the game's runtime. source
- Latest stable release
- GitHub lists BepInEx 5.4.23.5 as the latest stable release and records fixes for Unity 2022.3.62f3, Doorstop 4.5.0 and Unity 6 logging. source
- Licence
- The GitHub repository identifies the BepInEx project licence as LGPL-2.1. source
- License
- The project is open source under the LGPL-2.1 license. source
- Limit: compatibility dependence
- Hysen Labs notes that plugin failures can follow game updates, runtime changes or obfuscation when targeted methods no longer exist. source
Checked against the maker's pages on 15 Oct 2026.