企业官网建设流程全解析

10 分钟跑通 REFramework：RE 引擎游戏 Mod 框架安装、脚本与 VR 完整指南

【免费下载链接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games项目地址: https://gitcode.com/GitHub_Trending/re/REFramework

想改《生化危机》的 FOV、给游戏加 VR 或者写一个自动脚本，却要先反编译、逆向 TDB 类型定义？REFramework 把这条路铺平了：它是一款面向 RE 引擎游戏的开源 Mod 框架，一个 dinput8.dll 注入游戏，FOV 滑块、自由摄像头、Lua 脚本和 VR 支持直接可用，还支持你写 C++ 插件继续扩展。

一分钟看懂：REFramework 是什么

REFramework 是一个 mod loader、脚本平台和 VR 支持框架，覆盖 RE2/RE3/RE4/RE7/RE8、DMC5、SF6、MHRise、DD2 等 18 款 RE 引擎游戏。它解决三个问题：

• 开箱即用的 9 类内置 Mod（FOV、自由摄像头、宽屏修复等），不用编译任何东西
• 完整的 Lua 脚本 API，直接读写游戏对象
• 二次开发能力：C++ / C# 插件、ImGui 渲染、逆向工具链

适合两类人：只想玩 Mod 的玩家，以及想给 RE 引擎游戏写 Mod 的开发者。

最快上手：从下载到进游戏只要 3 步

普通玩家无需任何编译，1 分钟即可生效：

1. 从 Releases 页面下载最新稳定版压缩包
2. 把dinput8.dll放进游戏根目录（非 VR 用户只解压这一个文件，不要解压整包）
3. 启动游戏，按Insert打开菜单，勾选 FOV Slider 或 Free Camera

需要 VR 的用户：先安装 SteamVR（或使用 OpenXR 头显），然后把整个压缩包解压到游戏目录。用 Steam Proton 的话，在游戏属性里加启动参数WINEDLLOVERRIDES="dinput8.dll=n,b"。

从源码编译只需两条命令（需 VS2022 C++ 桌面开发负载 + CMake）：

git clone https://gitcode.com/GitHub_Trending/re/REFramework cd REFramework && git submodule update --init --recursive

cmake -S . -B build -G "Visual Studio 17 2022" -A x64 cmake --build build --config Release

产物dinput8.dll位于build/bin/REFramework/，一个 DLL 通吃全部支持的游戏——运行时自动识别游戏并匹配对应的 TDB 布局。

核心能力拆解

内置 Mod：改 FOV、开自由摄像头、修宽屏

不写一行代码就能用的功能，全部在菜单里勾选：FOV Slider、Free Camera、Scene Timescale、Vignette Disabler、Ultrawide 修复、GUI Hider，RE2/RE3 还有 First Person，RE2/RE3/RE8 有 Manual Flashlight。相关实现集中在 src/mods/。

Lua 脚本：写 10 行代码就能改游戏

• 能做什么：改属性、遍历游戏对象、绑定按键事件，scripts/ 目录里有 VR 手雷投掷、平滑移动等现成脚本可参考
• 在哪里：把.lua脚本放进游戏目录的scripts/文件夹，启动即自动加载
• 怎么用：脚本里可用re与sdk两个全局对象——re.on_frame注册每帧回调，sdk.find_type_definition、sdk.get_managed_singleton按名称取游戏类型和单例，即可读到场景、玩家和物件

VR 系统：6 自由度 + 手柄动作映射

• 能做什么：所有游戏通用 6DOF VR；RE2/RE3/RE7/RE8 另有手柄动作控制
• 在哪里：运行时适配在 src/mods/vr/runtimes/，游戏专属逻辑在 src/mods/vr/games/
• 怎么用：解压全部文件进游戏目录，启动头显软件后直接进游戏即可

开发者工具：直接看游戏内存里的对象

• 能做什么：Object Explorer 浏览任意游戏对象树，Game Objects Display 把场景对象画在画面上
• 在哪里：src/mods/tools/ObjectExplorer.cpp 等
• 怎么用：编译时开启 Developer Mode（-DDEVELOPER_MODE=ON，默认已开），菜单里启用工具

进阶玩法：插件、C# API 与逆向工具

想二次开发，仓库给出了三条现成路径：

• C++ 插件：参考 examples/example_plugin/，继承 Plugin 基类、实现初始化入口即可；公开接口在 include/reframework/API.hpp，插件里还能直接调 Lua、用 ImGui 画自己的界面
• C# 插件：csharp-api/REFrameworkNET/ 提供托管层，支持反射访问与事件绑定，按需解压 csharp-api 包到游戏目录
• 逆向工具链：reversing/ 提供 dump 脚本与命名工具，shared/sdk/regenny/ 是按游戏组织的 SDK 头文件，写脚本前先翻这里查类型定义

建议先跑通内置功能，再按兴趣挑脚本、插件或逆向其中一条线深入。

避坑清单

• 解压了整包后游戏变卡或抗锯齿消失→ 非 VR 使用放入了多余的 DLL → 只保留dinput8.dll
• Steam Proton 下框架不加载→ Wine 加载了系统自带 dinput8 → 启动参数加WINEDLLOVERRIDES="dinput8.dll=n,b"
• 旧版（非 RT 版）RE2/RE3/RE7 无反应→ 单体构建暂不支持这些旧版本 → 改用对应夜更构建
• 编译报缺文件、链接错误→ 依赖子模块没初始化，或架构不是 x64 → 执行git submodule update --init --recursive，CMake 加-A x64
• CMake 报 "In-tree builds are not supported"→ 在项目根目录直接构建了 → 用-B build指定独立构建目录

写在最后

REFramework 把 RE 引擎 Mod 开发的门槛从逆向工程降到了"解压一个 dll"，剩下的 Lua、C++ 插件和 C# API 则把天花板抬得很高。建议先跑通内置功能，再按兴趣挑一条线深入。

【免费下载链接】REFrameworkMod loader, scripting platform, and VR support for all RE Engine games项目地址: https://gitcode.com/GitHub_Trending/re/REFramework