BepInEx 新手入门：从安装到配置的超简单指南

🚀 认识 BepInEx：游戏插件界的万能钥匙

你玩游戏时有没有想过：要是能改改角色属性就好了？或者加个小地图？BepInEx 就是帮你实现这些想法的神奇工具！它就像游戏的"插件管理器"，能让开发者给 Unity、IL2CPP 和 .NET 游戏写各种扩展功能（我们叫它"插件"或"模组"）。

🎮 它支持哪些游戏引擎？

• Unity Mono：最常见的 Unity 游戏都用这个（稳定支持）
• Unity IL2CPP：性能更好的 Unity 引擎版本（部分支持）
• .NET 框架：包括 XNA、FNA、MonoGame 等老游戏（基础支持）

💻 支持哪些操作系统？

引擎类型	Windows	macOS	Linux
Unity Mono	✔️ 完美支持	✔️ 支持	✔️ 支持
Unity IL2CPP	✔️ 支持	❌ 暂不支持	✔️ 实验性
.NET 游戏	✔️ 支持	部分支持	部分支持

📌 重点：安装前一定要确认你的游戏用的是哪个引擎！不知道？看游戏根目录有没有 UnityPlayer.dll（Mono）或 GameAssembly.dll（IL2CPP）

📋 准备工作：开干前你需要这些

1️⃣ 检查游戏版本兼容性

⚠️ 注意：BepInEx 版本和游戏版本要匹配！比如：

• 老游戏（2019年前的Unity）用 BepInEx 5.x
• 新游戏（2020+ Unity）用 BepInEx 6.x
• 查看游戏论坛或官方群，大佬们通常会分享适配版本

2️⃣ 必备工具

• 📂 游戏本体（已安装到电脑）
• 📦 BepInEx 压缩包（从可靠渠道获取）
• 📝 解压软件（WinRAR/7-Zip/系统自带都可以）
• ✏️ 文本编辑器（记事本也行，推荐用 VS Code 更专业）

3️⃣ 确认游戏路径

找到你的游戏安装文件夹，通常在：

• Steam 游戏：C:\Program Files (x86)\Steam\steamapps\common\游戏名称
• Epic 游戏：C:\Program Files\Epic Games\游戏名称
• 手动安装：你自己选的安装目录

🔍 技巧：右键桌面游戏图标 → "打开文件位置" 就能快速找到

🛠️ 5分钟快速上手：BepInEx 安装实战

步骤1：解压 BepInEx 压缩包

📌 重点操作：

1. 右键下载好的 BepInEx 压缩包 → "解压到当前文件夹"
2. 打开解压后的文件夹，你会看到这些核心文件：
   • BepInEx 文件夹（插件主程序）
   • doorstop_config.ini（启动配置文件）
   • winhttp.dll 或 libdoorstop.so（启动器文件）

❓ 常见问题：解压后没有这些文件？可能下载了错误的版本，重新检查并下载对应架构（x86/x64）的包

步骤2：复制文件到游戏目录

⚠️ 注意：不是复制整个解压文件夹，而是复制里面的所有文件！

1. 全选解压文件夹里的所有内容（按 Ctrl+A）
2. 复制（Ctrl+C）并粘贴（Ctrl+V）到游戏根目录
3. 粘贴后游戏目录应该像这样：

   游戏目录/
   ├─ BepInEx/
   ├─ doorstop_config.ini
   ├─ winhttp.dll
   └─ 游戏主程序.exe
   

为什么这么做？BepInEx 需要和游戏程序在同一目录才能正确加载

步骤3：首次启动游戏验证安装

📌 关键步骤：

1. 双击游戏启动程序（.exe 文件）
2. 观察启动过程：
   • 会多出一个命令行窗口（黑色窗口）
   • 游戏目录会生成 output_log.txt 文件
   • 游戏启动后，BepInEx 文件夹会自动创建 plugins、config 等子文件夹

🔍 检查安装是否成功：看 BepInEx 文件夹是否生成了 plugins 目录，有就说明成功了！

⚙️ 配置技巧：让 BepInEx 听你的话

核心配置文件：doorstop_config.ini

这个文件控制 BepInEx 如何启动，用记事本打开它：

[General]
enabled = true          ; 是否启用BepInEx（必须true）
target_assembly = BepInEx\core\...  ; 启动程序路径（别动它）
redirect_output_log = true  ; 是否生成日志文件（建议设为true）

[UnityMono]
dll_search_path_override = "BepInEx\core"  ; 插件搜索路径（别动）

📌 新手必改设置：把 redirect_output_log 改成 true，方便后续排错

BepInEx.cfg 高级设置

首次启动后会在 BepInEx\config 目录生成这个文件，主要设置：

[Logging]
Enabled = true          ; 启用日志
LogLevel = Info         ; 日志详细度（新手用Info即可）

[Chainloader]
Enabled = true          ; 启用插件加载器

为什么这么做？日志是排查问题的关键，开启后能看到插件加载情况

版本兼容性检查清单

安装插件前一定要做这几步：

1. 查看插件说明支持的 BepInEx 版本
2. 确认游戏引擎类型（Mono/IL2CPP）
3. 检查插件是否有额外依赖（如 HarmonyX）
4. 先备份 BepInEx\plugins 文件夹再测试新插件

❌ 常见问题解决指南

问题1：游戏启动没反应/闪退

🔍排查步骤：

• 检查 winhttp.dll 是否复制到游戏目录
• 确认 doorstop_config.ini 中 enabled 是 true
• 查看游戏目录下的 output_log.txt，搜索 "error" 关键词

问题2：插件不加载

📌 可能原因 & 解决：

• 插件放错位置：必须在 BepInEx\plugins 目录
• 版本不兼容：插件版本和 BepInEx 版本不匹配
• 依赖缺失：检查插件说明是否需要安装额外库

问题3：日志文件太大

🔍 解决方法：

1. 打开 BepInEx.cfg
2. 找到 [Logging.Disk] 部分
3. 设置 MaxLogFileSize 为 1048576（1MB）
4. 设置 LogRotation 为 true（自动分割日志）

💡 小技巧：定期删除 BepInEx\LogOutput.log 可以释放空间

🎯 总结：开启你的游戏插件之旅

恭喜🎉！现在你已经掌握了 BepInEx 的安装和基础配置技能。记住几个关键点：

1. 版本匹配是第一要务
2. 文件一定要复制到游戏根目录
3. 日志是解决问题的好帮手
4. 安装新插件前先备份

接下来你可以：探索 BepInEx\plugins 目录，安装第一个插件试试；或者查看官方文档学习高级配置。玩得开心，探索无限可能吧！