Repolode
Submit
BepInEx

BepInEx/BepInEx

A plugin and modding framework that lets developers and players load custom code into Unity, XNA, FNA and MonoGame games.

View on GitHub
Stars
8,989
Forks
933
Open issues
383
Last commit
2 days ago

What is it?

BepInEx is a plugin and modding framework for games built on Unity Mono, Unity IL2CPP and .NET runtimes such as XNA, FNA and MonoGame. It injects into a game process at startup so that mods can be loaded, configured and run without modifying the original game files directly.

The framework provides a plugin system with configuration handling, logging and a patching layer based on Harmony-style method hooks. Unity Mono games are supported on Windows, macOS and Linux, while Unity IL2CPP games are supported on Windows and Linux. Support for .NET and XNA games runs through Mono on macOS and Linux.

Many other mod loaders, such as BSIPA, MelonLoader and uMod, are built on top of or work alongside BepInEx, so mod authors can target a shared base.

Key features

  • 01Loads plugins into Unity Mono and IL2CPP games at startup.
  • 02Provides a plugin configuration system and logging.
  • 03Supports method patching through Harmony-style hooks.
  • 04Runs on Windows, macOS and Linux depending on the runtime.

Use cases

  • Adding gameplay mods or quality-of-life changes to Unity games.
  • Building a plugin for a Unity or XNA game that other players can install.
  • Patching and inspecting game code at runtime during reverse engineering or modding research.

Quick start

  1. 1

    Open the latest releases page on GitHub

  2. 2

    Follow the official installation guide for your game

Things to know

  • Only Unity Mono has stable releases; other targets are still in development.
  • Unity IL2CPP is not supported on macOS or ARM.
  • Licensed under LGPL-2.1, a copyleft license.

In collections

Game development tools & enginesFrameworks for building apps and websites

Topics

#modding#plugin-framework#unity#game-development#mod-loader#dotnet#il2cpp#bepinex#framework#modloader

FAQ

What is BepInEx?
A plugin and modding framework that lets developers and players load custom code into Unity, XNA, FNA and MonoGame games. BepInEx is a plugin and modding framework for games built on Unity Mono, Unity IL2CPP and .NET runtimes such as XNA, FNA and MonoGame. It injects into a game process at startup so that mods can be loaded, configured and run without modifying the original game files directly.
Is BepInEx free to use? What license does it have?
BepInEx is open source under the LGPL-2.1 license. Check the license terms before using it in commercial products.
Is BepInEx still maintained?
Actively maintained. The last commit to BepInEx was on Nov 5, 2026.
What can I use BepInEx for?
Adding gameplay mods or quality-of-life changes to Unity games. Building a plugin for a Unity or XNA game that other players can install. Patching and inspecting game code at runtime during reverse engineering or modding research.
How do I install BepInEx?
Open the latest releases page on GitHub Follow the official installation guide for your game
Where can I get BepInEx?
The source code and installation instructions are on GitHub: https://github.com/BepInEx/BepInEx

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects

m969 / EGamePlay

A lightweight Unity combat and skill framework built on the Entity-Component pattern, with configuration via ScriptableObject or Excel tables.

Developer Tools#unity#gameplay#skill-system
2.4K+6 this week545C#MITUpdated 26 days ago

Cysharp / UniTask

Allocation-free async/await integration for Unity that makes Unity AsyncOperations, coroutines and events awaitable, running on PlayerLoop without threads.

Developer Tools#unity#csharp#async-await
11.3K+14 this week1KC#MITUpdated last month