Unity引擎BepInEx框架解码完整指南
📥 资源下载
- Mono脚本BepInEx:GitHub Releases下载
- IL2CPP脚本BepInEx:BepInEx Builds下载
- 首选解码插件:UniversalUnityDemosaics下载
- 备用解码插件:备用版本下载
- AssetStudio工具:AssetStudio下载
🎓 解码基础知识
在开始解码之前,了解一些基本概念很重要:
🔍 遮挡类型说明
动态遮挡(可移除):
- 可以通过插件移除的遮挡效果
- 在移动视角时会随着视角变动而闪烁
- 相当于在贴图上添加了半透明层
静态遮挡(不可移除):
- 无法通过插件移除的遮挡
- 不会随着视角移动而闪烁
- 通常是直接绘制在贴图上的
注意事项:如果移除遮挡后仍然看不到内容,可能是开发者没有在遮挡区域绘制完整内容。这种情况下需要使用AssetStudio和UABE工具导出贴图并手动绘制,过程较为复杂。
替代方案:如果觉得此方法过于复杂,可以尝试更便捷的解码方案:3Dmigoto:Unity与虚幻引擎解码
🔍 第一步:检查游戏脚本类型
首先需要确定游戏使用的是哪种脚本后端:
📁 检查游戏目录结构:
- 存在Mono文件夹或Managed文件夹 → Mono脚本
- 存在il2cpp_data文件夹 → IL2CPP脚本
根据脚本类型下载对应的BepInEx框架:
📋 框架版本选择:
Mono脚本:下载名称中不带IL2CPP的版本(通常是BepInEx 5)
示例:BepInEx_win_x64_5.4.23.4.zip
IL2CPP脚本:下载名称中包含IL2CPP的版本
示例:BepInEx-Unity.IL2CPP-win-x64-6.0.0-be.738+af0cba7.zip
💡 架构识别提示
检查游戏根目录下的UnityCrashHandler文件:
UnityCrashHandler32.exe→ 32位游戏UnityCrashHandler64.exe→ 64位游戏
下载框架时:32位游戏选择x86版本,64位游戏选择x64版本
⚙️ 第二步:安装BepInEx框架
将下载的BepInEx框架压缩包中的所有文件解压到游戏根目录:
🛠️ 安装步骤:
1. 将BepInEx压缩包解压到游戏根目录
2. 启动游戏(首次运行需要翻墙)
3. 检查BepInEx文件夹是否生成新的配置文件
框架安装成功后,BepInEx文件夹会生成新的配置文件和日志,表示框架已正常加载。
🔌 第三步:安装解码插件
将解码插件的DLL文件放置到指定位置:
📁 插件安装路径:
将解码插件的DLL文件放置到:
BepInEx\plugins\ 文件夹中
插件放置完成后,重新启动游戏即可生效。
🔧 常见问题解决
1. 控制台开关设置
如需开启或关闭控制台窗口:
⚙️ 控制台配置:
打开文件:BepInEx\config\BepInEx.cfg
找到 [Logging.Console] 部分:
Enabled = false
修改为:
Enabled = true # 开启控制台
Enabled = false # 关闭控制台
BepInEx 5默认关闭控制台,BepInEx 6默认开启控制台
2. 与翻译组件冲突解决
如果之前安装了翻译组件,需要先删除相关文件:
🗑️ 冲突文件清理:
删除游戏根目录下的文件夹:
- AutoTranslator
- ReiPatcher
删除 xxx_data/Managed 文件夹下的文件:
- 0Harmony.dll
- ExIni.dll
- Mono.Cecil.dll
- MonoMod.RuntimeDetour.dll
- MonoMod.Utils.dll
- ReiPatcher.exe
- UnityEngine.CoreModule.dll
- XUnity.AutoTranslator.Plugin.Core.dll
- XUnity.AutoTranslator.Plugin.ExtProtocol.dll
- XUnity.Common.dll
- XUnity.ResourceRedirector.dll
💡 使用提示
- 如果启动游戏后框架没有正常加载(BepInEx文件夹内没有生成新文件),可能是框架版本选择错误
- 确保下载的框架版本与游戏架构(32位/64位)匹配
- 如果解码后仍然看不到内容,可能是静态遮挡或开发者没有绘制相关内容
- 建议在操作前备份游戏文件
⚠️ 重要提示
本教程适用于大多数Unity引擎游戏,但具体效果可能因游戏版本和实现方式而异。建议:
- 在操作前备份游戏文件
- 确保游戏支持BepInEx框架
- 如遇到问题,请参考相关社区讨论
完成以上步骤后,重新启动游戏即可体验解码效果。