REFramework 怪物猎人崛起启动崩溃排查指南：着色器缓存与软件冲突修复
【免费下载链接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games项目地址: https://gitcode.com/GitHub_Trending/re/REFramework
REFramework 是面向 RE 引擎游戏（包括《怪物猎人：崛起》）的 Mod 加载器与脚本平台。启用它之后，部分玩家在《怪物猎人：崛起》启动时刚走到着色器编译这一步就会闪退。下面先给出快速判断方法，再按优先级给出两条可执行的修复路径，目标是尽快恢复正常进游戏。
先判断：是否命中这类启动崩溃
先对照以下特征，符合的条目越多，原因越可能是本文讨论的两类：
- 只启用 REFramework、不加载其他 Mod 时，游戏在启动初期、编译着色器的环节结束后立刻崩溃；
- 把其余 Mod 全部禁用、仅保留 REFramework 时依然复现；
- 崩溃稳定发生在画面渲染准备阶段，而不是某个具体脚本执行时报错。
如果崩溃总是伴随某个特定 Mod 或特定场景出现，而不是在启动阶段，那更可能是该 Mod 与当前游戏版本不兼容，建议先从 Mod 侧排查，本文路径未必适用。
上图为框架内置的节点图编辑器示例。REFramework 本身通过挂钩渲染管线工作，此类 UI 工具通常用于可视化对象与调用关系，可在排查脚本类问题时辅助定位。
最短修复路径
优先清理：删除 shader.cache 让引擎重建缓存
着色器缓存可以理解为：引擎把编译好的着色器二进制写到磁盘上，下次启动直接读取，省掉重复编译。这份文件在引擎版本更新、显卡驱动变更之后可能失效，读入无效数据就会让渲染初始化直接失败。
操作步骤：
- 进入游戏安装目录，通常在 Steam 库的
common文件夹下的《怪物猎人：崛起》目录里； - 找到
shader.cache文件，删除它； - 重新启动游戏。
删除后引擎会自动重建缓存，所以首次启动会明显变慢——所有着色器都要重新走一遍编译。属正常现象，等这一次正常进游戏后，之后的启动速度会恢复到原来的水平。
备选排查：Medal 等录制软件与驱动冲突
如果清缓存后依旧崩溃，或者崩溃只在你开着某些后台软件时出现，再往下查录制/叠加层软件。其中 Medal 这类游戏录制工具与 REFramework 的兼容性问题已被多次确认。
- 彻底退出 Medal 或其他录制、叠加层工具，注意不是最小化窗口；
- 打开任务管理器，确认相关进程已经真正结束；
- 再重新启动游戏验证。
使用 AMD 显卡的用户，尤其是 RX 7900 系列，这一步建议放在清缓存之前同步做。这批卡的驱动层与部分录制软件的交互更敏感，冲突出现的概率相对更高。
为什么会在渲染初始化阶段崩溃
REFramework 要实时改写游戏的渲染行为，就必须在游戏初始化时挂钩 DirectX 渲染管线的关键函数。所谓挂钩，就是在游戏原有调用的关键节点上插入一段自己的逻辑。当 Medal 之类的录制软件同时对同一组调用做挂钩时，双方的调用顺序可能互相打架，或者同时访问同一份资源，异常就集中爆发在渲染初始化的节点上。仓库中这部分挂钩逻辑位于 D3D11Hook.cpp 与 D3D12Hook.cpp 等模块。
着色器缓存属于另一类失败路径：缓存数据本身是引擎的优化手段，但引擎或驱动更新后，旧缓存可能不再匹配当前环境，直接读入就会触发异常。两类原因都指向同一表现——启动阶段崩溃，所以按上面顺序逐项排除即可。
降低再次出现的概率
- 定期用 Steam 客户端的"验证游戏文件的完整性"功能，确认游戏文件本身没有缺失或损坏；
- 显卡驱动保持较新版本，避免用很旧的驱动跑更新后的游戏；
- 使用 REFramework 时，尽量不要与录制、游戏增强类软件同时运行；确有需要时，建议先让游戏正常启动，再开启录制工具；
- 之后再次遇到图形相关崩溃时，优先清理一次
shader.cache，再往其他方向排查，通常能省掉不少弯路。
如果完成以上步骤问题仍然存在，建议整理更详细的系统信息（显卡型号、驱动版本、REFramework 版本、崩溃发生的时间点）用于进一步分析，单靠通用方案未必能覆盖所有组合。
【免费下载链接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games项目地址: https://gitcode.com/GitHub_Trending/re/REFramework
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
