mirror of
https://github.com/BepInEx/BepInEx.git
synced 2026-10-19 15:51:45 +00:00
f8ba0a41afb8eb6a790f1ce2583c00ce421f1a66
When the Unity base-libraries download fails (commonly a 404 for a Unity version not yet hosted on unity.bepinex.dev), the uncaught HttpRequestException surfaced only as a cryptic "Failed to generate Il2Cpp interop assemblies" and the game would not launch -- even though a local fallback (the unity-libs directory) already exists. Catch the download failure and throw a clear message naming the Unity version, the URL and the two workarounds: place a matching base-libraries .zip in the unity-libs directory, or point the [IL2CPP] UnityBaseLibrariesSource config at a valid URL. Refs #1295, #1084, #986, #941, #515
BepInEx
Bepis Injector Extensible
BepInEx is a plugin / modding framework for Unity Mono, IL2CPP and .NET framework games (XNA, FNA, MonoGame, etc.)
(Currently only Unity Mono has stable releases)
Platform compatibility chart
| Windows | OSX | Linux | ARM | |
|---|---|---|---|---|
| Unity Mono | ✔️ | ✔️ | ✔️ | N/A |
| Unity IL2CPP | ✔️ | ❌ | ✔ | ❌ |
| .NET / XNA | ✔️ | Mono | Mono | N/A |
A more comprehensive comparison list of features and compatibility is available at https://bepis.io/unity.html
Resources
How to install (latest releases)
How to install (Bleeding Edge, BepInEx 6)
Available plugin loaders
| Name | Link to project |
|---|---|
| BSIPA | BepInEx.BSIPA.Loader |
| IPA | IPALoaderX |
| MelonLoader | BepInEx.MelonLoader.Loader |
| MonoMod | BepInEx.MonoMod.Loader |
| MuseDashModLoader | BepInEx.MDML.Loader |
| Partiality | BepInEx-Partiality-Wrapper |
| Sybaris | BepInEx.SybarisLoader.Patcher |
| UnityInjector | BepInEx.UnityInjector.Loader |
| Unity Mod Manager | Yan.UMMLoader |
| uMod | BepInEx.uMod.Loader |
Used libraries
- NeighTools/UnityDoorstop - v4.5.0
- BepInEx/HarmonyX - v2.10.2
- 0x0ade/MonoMod - v22.7.31.1
- jbevain/cecil - v0.10.4
IL2CPP libraries
- SamboyCoding/Cpp2IL - v2022.0.7.2
- BepInEx/Il2CppInterop - v1.4.5
- BepInEx/dotnet-runtime - v6.0.7
License
The BepInEx project is licensed under the LGPL-2.1 license.
Languages
C#
96.2%
Shell
3.8%
