praydog/REFramework

项目介绍

REFramework 是面向 Capcom RE Engine 游戏的 Mod 框架、脚本平台和 VR 方案。它把 dinput8.dll 注入游戏进程，向玩家提供内置 Mod，向 Mod 作者提供 Lua 脚本 API 和插件系统，让脚本可以直接操作游戏内部对象，而不必手工改二进制。

内置功能包括：通用的 6DOF VR 支持，RE2/RE3/RE7/RE8 的体感控制，RE2/RE3 的第一人称，手电筒、自由相机、场景时间缩放、FOV 滑杆、关闭暗角、超宽屏/宽高比修复、隐藏 GUI。开发者模式还带有游戏对象显示和对象浏览器。项目同时包含 RE8 启动崩溃、RE8 卡顿以及 MHRise/RE8 第三方 DLL 相关崩溃的修复。

支持的游戏覆盖生化危机 2/3/4/7/村庄/安魂曲、鬼泣 5、街霸 6、怪物猎人崛起/荒野/物语 3、龙之信条 2、丧尸围城 豪华重制版等多款 RE Engine 作品。适合想在单机游戏里获得这些功能的玩家，以及编写 Lua 脚本的 Mod 开发者。

快速使用

1. 选择构建版本：稳定版在 Releases 页面，更新版本在 nightly 开发版仓库。
2. 不使用 VR 时，只把压缩包里的 dinput8.dll 解压到游戏目录。
3. 使用 VR 时，先安装 SteamVR（或在受支持头显上用 OpenXR），再把整个压缩包解压到游戏目录；遇到问题查 VR 故障排查页面。
4. 在 Proton/Linux 上，解压后在 Steam 游戏属性中添加启动选项：

WINEDLLOVERRIDES="dinput8.dll=n,b" %command%

DirectX 11 和 DirectX 12 都支持。游戏目录示例：G:\SteamLibrary\steamapps\common\RESIDENT EVIL 2 BIOHAZARD RE2。

编写脚本时，从 README 指向的脚本文档站开始。

使用约束

• DLL 会被加载进游戏进程，只适合允许外部 DLL 注入的场合；这通常是单机 Mod 用途，不能假定在竞技性联机中可用。
• VR 需要 SteamVR 或受支持的 OpenXR 环境，且要解压完整压缩包，而非只放 DLL。
• Linux 依赖 Proton/Wine 和上面的 DLL 覆盖选项，项目未介绍原生 Linux 构建。
• 功能因游戏而异：体感控制只列在 RE2/RE3/RE7/RE8，第一人称只列在 RE2/RE3。
• 项目不分发游戏资源，脚本和插件基于公开 API 编写。许可证为 MIT。

HotRepo 点评

在 2026-11-09 的 CPP 日榜上，REFramework 位列第 11，当天新增 6 星，总星数 5,738、Fork 683。项目自 2019 年 1 月公开，已经积累了相当规模的 Mod 用户群体。对这样一个绑定具体商业游戏的 Mod 加载器来说，站内记录是平稳而非爆发式的；它是否值得用，更多取决于你手上有哪款受支持游戏，而不是星数。

项目源码与说明