AwesomeREA.org

工具

BepInEx Unity/.NET 游戏插件与修补框架

面向 Unity Mono、Unity IL2CPP 以及 XNA、FNA、MonoGame 等 .NET Framework 游戏的插件与修补框架，可将模组和分析插件加载到本地安装的游戏中。插件借助随附的 HarmonyX 和 MonoMod.RuntimeDetour 在运行时修补方法，预加载修补器则在游戏加载托管程序集之前用 Mono.Cecil 改写它们；在 IL2CPP 游戏上，它会调用 Cpp2IL 和 Il2CppInterop，从游戏二进制和 global-metadata.dat 生成互操作程序集。其指南还介绍了配置、日志，以及用 dnSpy 调试插件和游戏程序集。

使用条件与局限

  • 审阅时最新稳定版为 v5.4.23.5，于 2026-02-08 从 v5-lts 分支发布，提供 Windows x86/x64、Linux x86/x64、macOS 通用版和修补器压缩包；README 称目前只有 Unity Mono 提供稳定版。所审阅的 master 提交（2026-10-16）声明的版本为尚未发布的 6.0.0，比最新的 6.x 预发布版 v6.0.0-pre.2（2024-08-27，提供 Unity Mono、Unity IL2CPP 和 .NET 构建）多 75 个提交；更新的 bleeding edge 构建另行发布。指南指出，预加载修补器的接口约定在 v5 与 v6 之间有所变化。
  • README 的兼容性表列出：Unity Mono 支持 Windows、macOS 和 Linux；Unity IL2CPP 支持 Windows 和 Linux，不支持 macOS 和 ARM；.NET/XNA 游戏支持 Windows，在 macOS 和 Linux 上需通过 Mono 运行。master 分支的安装指南列出 Windows 7–10、带 GCC 10+ 的 Linux 发行版、macOS 10.13+ 以及 Unity 3 或更新版本。从源码构建使用随附的 Cake 脚本，需要 .NET 6.0 或更新版本。
  • BepInEx 安装在使用者自己的游戏目录中：指南以 Managed 文件夹识别 Unity Mono 游戏，以 il2cpp_data 识别 IL2CPP 游戏。IL2CPP 互操作程序集的生成会读取游戏二进制和 global-metadata.dat，并默认从 unity.bepinex.dev 下载与游戏 Unity 版本对应的托管 Unity 基础库；也可通过配置项改用本地放置的压缩包。部分游戏需按文档中的故障排除步骤处理，本条目不代表对任何具体游戏的兼容性。
  • 采用 LGPL-2.1 许可（软件包元数据为 LGPL-2.1-only）；其使用的 UnityDoorstop、HarmonyX、MonoMod、Mono.Cecil、Cpp2IL 和 Il2CppInterop 等库保留各自的许可。本条目只涉及对本地安装游戏的单机模组制作与分析；游戏本身的许可条款与该框架的许可相互独立。本次未修改或运行任何游戏，所审来源也未确立与 REA 的关联。

关于此条目

类型
工具
类别
游戏分析工具
关联
基础工具
目标
游戏

来源复核于

说明已依据一手来源复核；这不代表已运行验证、经过安全审计或确认兼容。

一手来源

  1. README.md GitHub · BepInEx/BepInEx · 修订 6cea286
  2. LICENSE GitHub · BepInEx/BepInEx · 修订 6cea286
  3. Directory.Build.props GitHub · BepInEx/BepInEx · 修订 6cea286
  4. docs/BUILDING.md GitHub · BepInEx/BepInEx · 修订 6cea286
  5. Runtimes/Unity/BepInEx.Unity.IL2CPP/Il2CppInteropManager.cs#L48-L110 GitHub · BepInEx/BepInEx · 修订 6cea286
  6. BepInEx.Preloader.Core/Patching/AssemblyPatcher.cs GitHub · BepInEx/BepInEx · 修订 6cea286
  7. https://github.com/BepInEx/BepInEx/releases/tag/v5.4.23.5
  8. https://github.com/BepInEx/BepInEx/releases/tag/v6.0.0-pre.2
  9. https://docs.bepinex.dev/master/articles/user_guide/installation/index.html
  10. https://docs.bepinex.dev/master/articles/dev_guide/runtime_patching.html
  11. https://docs.bepinex.dev/master/articles/dev_guide/preloader_patchers.html