Reloaded-II 启动失败与 Mod 失效不求人：四个翻车现场，三步定位一次修通

1. 核对 .NET 运行时。打开终端执行下面的命令，看看 Microsoft.NETCore.App 是不是装了（当前版本基于 .NET 9，至少要能看到相近的大版本）：

   # Linux / macOS / Wine 终端 dotnet --list-runtimes | grep "Microsoft.NETCore.App"

   # Windows PowerShell 用这条 dotnet --list-runtimes | Select-String "Microsoft.NETCore.App"

   如果输出为空或版本明显偏低，去 .NET 官网把对应版本的运行时装上再试。

2. 备份并移走配置文件。配置文件位于：

   • Windows：%appdata%\Reloaded-Mod-Loader-II\ReloadedII.json
   • Linux/Wine：~/.wine/drive_c/users/$USER/AppData/Roaming/Reloaded-Mod-Loader-II/ReloadedII.json

   先复制一份留底，再把原件移出目录（改名或剪切到桌面都行）：

   # Linux/Wine：复制备份后，把原文件移走 cp ~/.wine/drive_c/users/$USER/AppData/Roaming/Reloaded-Mod-Loader-II/ReloadedII.json ~/ReloadedII.json.backup

3. 重新启动启动器。这次它会用默认配置重新生成一个全新的 ReloadedII.json，能正常打开就说明问题出在旧配置上。

.NET 运行时包含公共语言运行时（CLR）和类库，负责代码执行与内存管理。启动器一上来就要加载 CLR，运行时版本不匹配或缺组件，进程直接初始化失败，表现就是"无响应或闪退"。好消息是官方安装器一般会顺带装好所需运行时；容易踩坑的是两种情况——把安装目录整体拷到别的电脑，或手动卸载过 .NET。

配置损坏的常见诱因是异常关机、磁盘写满或手动编辑配置时写坏了 JSON。注意 32 位与 64 位进程要对应：Reloaded-II 同时支持 x86 与 x64 游戏，装错位数的运行时也会静默失败。

回滚方案：如果移走配置后问题依旧、或你想恢复原状，把备份放回去即可：

cp ~/ReloadedII.json.backup ~/.wine/drive_c/users/$USER/AppData/Roaming/Reloaded-Mod-Loader-II/ReloadedII.json

1. 检查勾选与依赖状态。在启动器里把目标游戏选中，看左边 Mod 列表的勾选框是否为启用状态（红色为启用，灰色为禁用）。同时点开Download Mods界面的Check Updates & Dependencies，看看有没有缺依赖没装上。

   图：启用 Mod 的勾选操作，先确认它不是"看起来装了、实际没勾"的状态

2. 核对 .exe 绑定与加载顺序。点进Manage Mods（齿轮图标），确认你的 Mod 下面勾选的是正确游戏；再到Configure Mods界面，把核心依赖 Mod 拖到列表顶部，让它们先加载。最后用界面左上角的Launch Application按钮启动游戏，而不是直接双击游戏 exe——这是最常被忽略的一步。

   图：从启动器内启动游戏，Mod 才会按你配置的顺序被注入

3. 手动注入验证 + 防病毒排除。如果游戏是绕过启动器直接开的，Reloaded-II 会把它列为"未被托管"的进程，此时可以选中该进程点Inject手动注入。若注入按钮是灰色或注入后仍无效，大概率是防病毒在拦截，把 Reloaded-II 加入排除名单再试。

   图：手动注入界面，注入失败往往与权限或防病毒拦截有关

注入流程本质上要完成"打开进程 → 分配内存 → 写入 DLL 路径 → 创建远程线程"四步，这套动作和某些恶意软件的行为高度相似，因此主流杀软都会盯着它。Windows 上可用管理员 PowerShell 添加排除项：

# 把 Reloaded-II 加入 Windows Defender 排除名单（需管理员权限） Add-MpPreference -ExclusionPath "C:\Program Files\Reloaded-II" Add-MpPreference -ExclusionPath "$env:APPDATA\Reloaded-Mod-Loader-II"

如果同时装了多个 Mod，加载顺序还可能引发冲突——想快速验证"是不是顺序问题"，可以打开ReloadedII.json，把LoadModsInParallel改成false，让 Mod 逐个串行加载，再拖动列表调整顺序。

1. 更新 Wine 并补齐字体。先升级 Wine，再安装 Windows 核心字体：

   # Debian/Ubuntu 系：升级 Wine sudo apt update && sudo apt upgrade wine-staging # 安装 Windows 核心字体，解决乱码 winetricks corefonts

2. 换一个干净的 Wine 前缀重装 Reloaded-II。前缀（prefix）相当于独立的环境沙箱，旧的里面可能残留了损坏的配置或字体设置：

   # 新建独立前缀并初始化 WINEPREFIX=~/.wine-reloaded winecfg

   然后把这个前缀里的 Reloaded-II 重新安装一遍，界面通常就正常了。

3. 重新添加游戏。前缀变了，之前绑定的游戏路径也要重新指认：打开添加应用对话框，定位到游戏可执行文件并保存。

   图：换前缀后记得重新添加游戏，路径选到真正的 .exe 而不是启动器

Wine 对 WPF 的渲染管线支持不完整，字体平滑、DPI 缩放相关的注册表配置也会影响表现。复杂界面问题靠"打补丁"往往治标不治本，直接新建前缀更省心——这也是社区最推荐的方案。用不同的前缀隔离不同游戏环境，还能避免一个游戏的补丁影响另一个。

不同环境速查：

1. 确认游戏与 Reloaded-II 在同一个前缀。先用 Protontricks 列出游戏及 AppID：

   # 列出所有能被 Protontricks 识别的游戏 protontricks -l

   找到目标游戏后，把前缀指到它的兼容目录（<APPID>换成实际数字）：

   export WINEPREFIX="/home/deck/.local/share/Steam/steamapps/compatdata/<APPID>/pfx"

   然后在这个前缀里重装/移动 Reloaded-II，保证两边同源。

2. 给 Steam 启动选项加注入白名单。右键游戏 → 属性 → 启动选项，填入：

   WINEDLLOVERRIDES="winhttp=n,b" %command%

   这是为了让游戏进程允许加载 winhttp 相关的注入 DLL，避免被 Proton 的 DLL 覆盖策略挡掉。

3. 验证加载日志与游戏内效果。启动游戏后看控制台日志，确认Current Process Location指向的路径确实落在目标前缀内（而不是被映射到别处），再进游戏验证效果。

   图：日志显示加载流程走完，此时要回头核对前缀路径是否与游戏一致

Steam Deck 用 SD 卡装游戏时，前缀路径会变成E:\steamapps\common\...这类映射盘，手动指路径时最容易出错。想省心的话，直接用 Protontricks 把官方 Setup-Linux.exe 装进游戏的前缀里，桌面会生成快捷方式，用它启动就是"同前缀"的正确姿势。若希望 Steam 直接拉起游戏就自动注入，可以在 Reloaded-II 的"编辑应用 → 高级"里点击Deploy ASI Loader部署原生加载器，让游戏进程自己把 Mod 加载器带起来，绕开手动注入环节。

1. 完整卸载并备份。卸载前先把配置目录整个复制一份留底（后面要恢复设置就靠它），然后同时删除安装目录与配置目录：

   # Linux/Wine：先备份，再删除安装目录与配置目录 cp -r ~/.wine/drive_c/users/$USER/AppData/Roaming/Reloaded-Mod-Loader-II ~/Reloaded-Mod-Loader-II.backup rm -rf ~/.wine/drive_c/Program\ Files/Reloaded-II rm -rf ~/.wine/drive_c/users/$USER/AppData/Roaming/Reloaded-Mod-Loader-II

   Windows 用户用"设置 → 应用"正常卸载后，再手动删除安装目录和%appdata%\Reloaded-Mod-Loader-II。

2. 清理注册表残留。在终端执行（Linux/Wine 用 wine 前缀，Windows 直接用 reg）：

   # Linux/Wine wine reg delete "HKCU\Software\Reloaded-Mod-Loader-II" /f

   # Windows reg delete "HKCU\Software\Reloaded-Mod-Loader-II" /f

3. 重新安装。从官方渠道下载最新 Setup.exe 重新安装。如果你是开发者、想从源码构建，可以拉取仓库后用 .NET SDK 编译（进阶操作，需要已安装对应 SDK）：

   git clone https://gitcode.com/gh_mirrors/re/Reloaded-II cd Reloaded-II dotnet build source/Reloaded-II.sln

"删配置仍崩溃"通常意味着损坏不止一处：安装目录里可能残留了被杀软改动过的文件，注册表里则存着上次会话留下的坏状态。所以排查顺序必须是"卸载 → 清残留 → 重装"，一步都不能省。如果你重装后想找回以前的游戏列表和 Mod 勾选，把第一步的备份目录内容拷回新的配置目录即可，但要注意：如果崩溃元凶正是旧配置，这样做可能把问题也带回来，建议先空跑一次确认正常再恢复。