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

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

- 类型：工具
- 目标：游戏
- 类别：游戏分析工具
- 关联：基础工具
- 来源复核于：2026-10-19
- 收录于：2026-10-19
- 原始资源：<https://github.com/BepInEx/BepInEx>
- 一手来源：<https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/bepinex/>
- 记录 JSON：<https://awesomerea.org/resources/bepinex/record.json>
- 英文版：[English](https://awesomerea.org/resources/bepinex/index.md)

## 使用条件与局限

- 审阅时最新稳定版为 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 等库保留各自的许可。游戏本身的许可条款与该框架的许可相互独立。

## 一手来源

1. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/README.md>
2. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/LICENSE>
3. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/Directory.Build.props>
4. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/docs/BUILDING.md>
5. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/Runtimes/Unity/BepInEx.Unity.IL2CPP/Il2CppInteropManager.cs#L48-L110>
6. <https://github.com/BepInEx/BepInEx/blob/6cea286d204eb3754d3b8363a5a1fd6640164a49/BepInEx.Preloader.Core/Patching/AssemblyPatcher.cs>
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>

## 同分区更多条目：游戏

- [ReXGlue Xbox 360 静态重编译 SDK](https://awesomerea.org/zh/resources/rexglue-sdk/index.md) · 工具
- [ps3recomp PS3 静态重编译工具包](https://awesomerea.org/zh/resources/ps3recomp/index.md) · 工具
- [Nebula（NebulaFD）Clickteam Fusion 反编译器](https://awesomerea.org/zh/resources/nebulafd/index.md) · 工具
- [swe1r-assets-unity：Racer 模型块编辑器样例](https://awesomerea.org/zh/resources/swe1r-assets-unity/index.md) · 工具
- [LuaJIT Decompiler v2 字节码反编译器](https://awesomerea.org/zh/resources/luajit-decompiler-v2/index.md) · 工具
- [NTRGhidra Nintendo DS 程序 Ghidra 加载器](https://awesomerea.org/zh/resources/ntrghidra/index.md) · 工具

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。