REFramework：一个 DLL 撑起的 RE Engine 模组与 VR 入口
所有 RE 引擎游戏的 Mod 加载器、脚本平台和 VR 支持。
秒懂
- 它是什么？
- REFramework 以单个 dinput8.dll 同时承担模组加载、Lua 脚本、插件系统与通用 VR 支持，覆盖十余款 RE Engine 游戏。它解决的是“每个游戏单独写注入器”的重复劳动，但代价是版本敏感和调试困难。
- 适合谁用？
- REFramework 适合那些想在 RE Engine 游戏上做模组、写脚本或体验 VR 的玩家和开发者，尤其是 Resident Evil 2/3/4、Village、Devil May Cry 5 等官方支持的游戏。如果你只玩 Monster Hunter Rise 或 Dragon's Dogma 2，且不想处理第三方 DLL 与游戏更新之间的兼容问题，那它可能不是最省心的选择。
- 能商用吗？
- 可以。MIT 是宽松许可证：你可以使用、修改并销售基于它的软件，只需保留版权和许可证声明。
- 还在维护吗？
- 在维护。仓库最近一次提交在 3 天前。
- 用什么语言写的？
- 主要是 C++（依据 GitHub 的语言统计）。
以上回答依据项目的 GitHub 数据（最近同步于 2026年9月14日）和我们的分析，不构成法律意见。
开源项目深度解析
一个 DLL 解决什么
RE Engine 游戏有十多个，每个都有自己的可执行文件、渲染后端和脚本接口。模组作者如果每个游戏都写一个注入器，工作量会爆炸。REFramework 的思路是把这些游戏共有的底层能力抽出来，做成一个统一的框架。你只需要把 dinput8.dll 放进游戏目录，游戏启动时就会加载它。这个 DLL 同时承担三件事：加载其他模组、提供 Lua 脚本 API、启用 VR 支持。它不是一个游戏内菜单那么简单，而是一个运行在游戏进程里的宿主环境。
从 dinput8.dll 到游戏进程
安装过程看起来简单得可疑，非 VR 用户只需要解压一个文件。但背后是 Windows 的 DLL 搜索顺序机制。游戏启动时会按固定顺序查找 dinput8.dll，REFramework 利用这个顺序，把自己放在游戏目录里，从而被游戏进程加载。加载后，它通过 Hook 和内存操作接管游戏的部分功能。README 里提到它使用了 Kanan 项目的代码，Kanan 是另一个 RE Engine 模组框架，这说明了 REFramework 不是从零开始，而是站在已有工作的肩膀上。它支持 DirectX 11 和 DirectX 12，这意味着它需要同时处理两种渲染管线的差异，这在实际维护中是一个持续的负担。
内置功能清单：从 VR 到 FOV 滑块
README 列出的内置功能分为三类。第一类是 VR，包括通用 6DOF 支持和 RE2/RE3/RE7/RE8 的动作控制。第二类是游戏性调整，比如第一人称视角、手动手电筒、自由相机、时间缩放、FOV 滑块、宽屏修复。第三类是开发者工具，需要开启开发者模式才能使用，包括 Game Objects Display 和 Object Explorer。这些功能不是每个游戏都完全可用，比如第一人称只支持 RE2 和 RE3，手动手电筒支持 RE2/RE3/RE8。这种选择性支持意味着你需要查看具体游戏的 Wiki 页面，而不是假设所有功能都适用于你的游戏。
支持的十七款游戏，但方式不同
REFramework 的支持列表分为两类。一类是原生支持，比如 Resident Evil 2/3/4/7/Village、Devil May Cry 5、Street Fighter 6、Monster Hunter Rise/Wilds、Dragon's Dogma 2。另一类是通过指定其他游戏的构建版本来运行，比如 Ghosts 'n Goblins Resurrection 使用 RE8 构建，Apollo Justice 使用 DD2 构建，Onimusha 2 使用 MHWILDS 构建。这种“借用构建”的方式降低了适配成本，但也意味着这些游戏可能缺少某些功能，或者需要手动选择正确的构建版本。如果你玩的是这些边缘游戏，安装时不能只看最新 release，还要确认它是否包含你需要的构建。
Lua 脚本与插件系统：真正的扩展点
READMEE 强调 Lua Scripting API 和插件系统是所有游戏通用的。脚本 API 的文档在 refdocs.praydog.com，这暗示脚本接口相当庞大，足以实现复杂的游戏逻辑修改。插件系统则允许用 C++ 编写更底层的扩展，适合性能敏感或需要深度 Hook 的场景。这种双轨设计是合理的：Lua 适合快速原型和简单调整，C++ 插件适合需要直接访问游戏内存的复杂模组。但这也带来一个学习曲线，脚本作者需要理解 REFramework 的 API 约定，而不是直接使用游戏的内部函数。Wiki 中提到的 VR 故障排查页面说明，即使有框架，VR 支持也不是即插即用的，需要针对头显和游戏做调试。
Proton/Linux 下的运行方式
Linux 用户不能直接解压 DLL 就完事。README 明确要求通过 Steam 启动选项添加 WINEDLLOVERRIDES="dinput8.dll=n,b" %command%。这个环境变量告诉 Wine 优先使用游戏目录里的 DLL，而不是 Wine 自带的版本。这暴露了一个事实：REFramework 本质上是 Windows 工具，Linux 支持只是 Wine 兼容层的结果，不是原生支持。如果你在 Steam Deck 或 Linux 桌面上玩 RE Engine 游戏，需要额外处理这个启动选项，而且 VR 在 Linux 下可能更不稳定，因为 SteamVR 本身在 Linux 上的支持就有限。
版本敏感性与维护成本
REFramework 的 release 频率并不规律，从 2024 年 10 月的 v1.5.8 到 2025 年 3 月的 v1.5.9.1，中间隔了五个月。游戏更新后，REFramework 可能需要跟进，否则可能崩溃或失效。README 中提到的“RE8 启动崩溃修复”和“MHRise/RE8 第三方 DLL 崩溃修复”说明它不仅要适配游戏，还要处理与其他 DLL 的冲突。这意味着你每次更新游戏后，都要检查 REFramework 是否有新版本。MIT 许可证允许你自行修改和重新分发，但如果你依赖上游修复，就需要关注 release 页面。对于只想玩游戏的普通用户，这种维护负担可能比想象中重。
替代方案与选择边界
REFramework 不是唯一的选择。Kanan 是它灵感的来源，也是一个 RE Engine 模组框架，但 README 没有说明 Kanan 是否还在维护。另一个方向是游戏特定的模组工具，比如 Resident Evil 2 的 Fluffy Mod Manager，它专注于 mod 管理，不提供脚本 API 或 VR。RE2 的 VR 模组也有独立的实现，但只针对单个游戏。REFramework 的优势在于覆盖面广，一次学习就能用在多个游戏上。但如果你只玩一个游戏，且只需要简单的 mod 管理，那么专用工具可能更轻量。如果你需要深度脚本控制，REFramework 的 Lua API 是文档化的，而 Kanan 的文档可能不完整。选择的关键是看你的需求是广度还是深度。
编辑结论
REFramework 适合那些想在 RE Engine 游戏上做模组、写脚本或体验 VR 的玩家和开发者，尤其是 Resident Evil 2/3/4、Village、Devil May Cry 5 等官方支持的游戏。如果你只玩 Monster Hunter Rise 或 Dragon's Dogma 2，且不想处理第三方 DLL 与游戏更新之间的兼容问题，那它可能不是最省心的选择。采用前先确认你的游戏版本与 REFramework 最新 release 的对应关系，查看 Wiki 中的 VR 故障排查页，并备份游戏目录中的 dinput8.dll 原文件。REFramework 的 MIT 许可证允许自由使用和修改，但游戏本身的 EULA 可能限制模组行为，这是你需要自己判断的部分。
社区笔记