从 MelonLoader 换到 BepInEx：CircuitLordVRModInstaller 自动迁移设置不丢档的秘密-开发者社区

【免费下载链接】CircuitLordVRModInstaller

One-click installer for Big Walk VR and Titanfall 2 VR

项目地址：https://gitcode.com/gh_mirrors/ci/CircuitLordVRModInstaller

CircuitLordVRModInstaller 是Big Walk VR与Titanfall 2 VR两款 VR Mod 的免费一键安装工具。新版 Big Walk VR 已将底层 Mod 加载器从 MelonLoader 换成 BepInEx，安装器能自动识别旧的 MelonLoader 环境，在切换时自动迁移你已有的相机与操控设置，换完加载器不用重新配置、不丢档。本文拆解它「检测 → 清理 → 迁移」三步走的完整流程与背后实现。

💡 如果你的 Big Walk 目录里还留着 MelonLoader，不用慌——不需要手动删文件、也不需要改配置文件，交给安装器一键完成。

为什么 Big Walk VR 要换掉 MelonLoader？

早期版本（安装器 1.1.x）为 Big Walk VR 安装的是 MelonLoader 0.7.3，可参见历史清单 manifest.json
现在新版本统一改用BepInEx 6.0.755（IL2CPP 版），下载地址与 SHA-256 校验值由 manifest-v3.json 集中管理
两个加载器无法共存，因此安装器内置了自动迁移机制：先完整清理 MelonLoader，再安装 BepInEx

第一步：自动检测 MelonLoader 环境

检测逻辑位于 BepInExInstaller.cs：

✅完整 MelonLoader 环境：游戏目录同时存在version.dll文件和MelonLoader文件夹 → 状态栏提示「Remove MelonLoader in step 2 to continue.」
⚠️残缺环境：只有version.dll却没有MelonLoader目录 → 安装器判定为未知引导文件，会拒绝安装BepInEx，提示你先手动确认来源，避免误删别人的 Mod

检测完成后，主界面第二步按钮会从Install变为Remove MelonLoader，明确告诉你当前该执行什么操作（见 MainWindow.xaml.cs）。

第二步：一键清理 + 自动迁移，全程只需点一次按钮

点击「Remove and install」后，安装器依次执行（核心代码 BepInExInstaller.cs）：

删除 MelonLoader 核心文件：version.dll、dobby.dll、NOTICE.txt
整体移除关联目录：MelonLoader、Mods、Plugins、UserLibs
清空旧安装记录：避免 MelonLoader 时代的文件清单干扰新版加载器（PackageInstaller.cs）
安装新版 BepInEx：从官方包解压部署，下载过程校验 SHA-256，确保文件未被篡改

⚠️ 注意：Mods目录中的其他 Mod 会一并被清理，且安装器不会自动备份。如果里面有你在意的 Mod，请先手动备份再执行迁移。

不丢档的秘密：自动迁移的 6 项关键设置

Big Walk VR 的相机参数原本保存在 MelonLoader 的UserData\MelonPreferences.cfg中。安装器的 MigratePreferences 函数会精准提取[BigWalkVR]段下的 6 项关键设置：

设置项	含义
`SnapTurn`	是否启用急转弯
`SnapTurnDegrees`	急转弯角度
`SmoothTurnSpeed`	平滑转身速度
`DevCameraMode`	开发相机模式
`LeftHandCamera`	相机是否握在左手
`CameraStabilization`	相机稳定

迁移目标是 BepInEx 的标准配置文件BepInEx\config\com.circuit.bigwalkvr.cfg。若源文件不存在或没有有效条目，则静默跳过，不会生成空配置。迁移完成后，状态栏会显示：

「MelonLoader and its mods were removed. BigWalkVR settings were migrated to BepInEx.」

也就是说，你辛苦调好的转身手感、相机姿势，换完加载器后原样生效，这就是「不丢档」的关键。

常见问题 FAQ

Q：和「Restore vanilla（还原原版）」有什么区别？A：还原原版会一次性移除所有已安装 Mod + BepInEx + MelonLoader，把游戏恢复纯净状态（MainWindow.xaml.cs）；而 MelonLoader 迁移是换加载器后继续游玩的场景，二者目的不同。

Q：可以手动迁移吗？A：可以——删除version.dll及MelonLoader、Mods目录，自行安装 BepInEx，再把上面 6 项设置手工复制过去。但步骤繁琐、容易漏项，推荐直接用安装器的一键迁移。

Q：Titanfall 2 VR 也走这套迁移流程吗？A：不走。Titanfall 2 VR 走独立路线，通过 Northstar 装入单独的TF2VRprofile，与 MelonLoader 无关，普通战役存档完全不受影响（详见 README.md）。