Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

BepInEx

github.com

  • Free plan
  • Open source
  • Windows
  • macOS
  • Linux
  • API
7.9 Club score Visit github.com

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.

BepInEx

Free

BepInEx Free

Free

Free plan

Getting started

  1. Open the BepInEx GitHub repository
  2. Identify the game engine and operating system
  3. Download the correct stable or bleeding-edge build
  4. Place the downloaded contents in the game's root folder
  5. Configure the installation and logging settings
  6. 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.