企业官网建设流程全解析

REFramework 上手指南：一个框架搞定 RE 引擎游戏的 Mod、脚本与 VR

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

给 RE 引擎游戏装 Mod，常见的坑是：改个参数找一套工具，跑脚本换一套，想上 VR 再装一套，版本对不上时游戏直接闪退，你还不知道是哪个文件的问题。REFramework 就是为这种场景做的：一个dinput8.dll同时承担 Mod 加载器、Lua 脚本平台和 VR 支持三件事，装进游戏目录就能用。

三个卖点速览

• 覆盖 RE2/RE4/RE8、鬼泣 5、怪猎等 20 款游戏
• 内置 Lua 脚本 API 和 C++ 插件系统
• 全游戏 6DOF VR，RE2/3/7/8 带动作控制

三步跑通安装，按 Insert 见到界面就算成功

1. 从 Releases 下载最新构建的 zip；想拿完整源码就克隆仓库：

git clone https://gitcode.com/GitHub_Trending/re/REFramework

2. 标准版：只把 zip 里的dinput8.dll解压到游戏根目录（如RESIDENT EVIL 2 BIOHAZARD RE2这个文件夹本身，不是子文件夹）。VR 版：整个 zip 解压到游戏目录，前提是装好 SteamVR，或头显自带 OpenXR 运行时。Linux/Proton：解压后，在 Steam 启动选项里加这一行：

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

3. 启动游戏，按Insert键。弹出开发者菜单，安装就成功了。具体版本兼容性以仓库 README 为准。

REFramework 内置的节点编辑器，可在菜单里直接打开

在菜单里拨开关：不写代码先改游戏行为

装完不用写任何代码就能用的东西：FOV 滑块、场景时间缩放、自由摄像机、宽屏/宽高比修复、UI 隐藏、暗角去除，这些全游戏通吃；第一人称视角只开放给 RE2/RE3，手动手电筒覆盖 RE2/RE3/RE8。另外它顺手修了几个已知问题：RE8 启动崩溃、RE8 击杀和受伤时的卡顿、MHRise/RE8 与第三方 DLL 相关的崩溃。

往 scripts 目录丢 Lua：脚本跟着游戏走

Lua 脚本不需要编译，放进游戏目录下的scripts/文件夹就会加载。仓库自带了一批可以直接抄的样例：scripts/re2_vr_melee.lua（VR 近战）、scripts/re2_sharpness_removal.lua（去锐化）、scripts/re8_vr.lua等。Lua 侧能直接拿到 C++ 绑定的游戏对象，改参数、读状态、挂回调都在同一层。scripts/utility/里还有按游戏分的工具脚本，比如RE2.lua、RE4.lua。

戴上头显上 VR：从 6DOF 到动作控制

VR 不是单一游戏的特例，而是默认能力：所有支持的游戏有通用 6DOF，RE2/RE3/RE7/RE8 额外支持手柄动作控制，含头部追踪。想改 VR 行为，实现都在src/mods/vr/下，按运行时（runtimes/OpenVR.cpp、OpenXR.cpp）和游戏适配（games/）分层。

开开发者模式看内部对象：对象浏览器和节点编辑器

开发者模式下有三个常用工具：Game Objects Display 实时列出游戏里的对象及属性，Object Explorer 可以钻进对象层级里逐层看，节点编辑器则负责可视化的脚本逻辑与渲染管线配置。它们适合两类人：写脚本前想确认"游戏里到底有什么"的，以及调试渲染问题的。工具入口和实现分别在菜单和src/mods/tools/目录里。

实战场景：三件事照着目录找

改 RE2 手感。目标文件是scripts/re2_smooth_movement.lua和scripts/re2_sharpness_removal.lua。把文件复制进你游戏目录的scripts/，进游戏生效，改其中几个数值就能得到自己的版本。

给自己游戏写个小工具。参照examples/example_plugin/：Plugin.cpp演示了初始化 ImGui、拿到渲染数据、挂 DX11/DX12 后端，rendering/子目录是现成的 D3D 封装。核心就是继承框架的 Plugin 接口，接上 PluginManager，再决定要不要画界面。

摸清一个游戏的内部结构。shared/sdk/下有每个游戏的 SDK 定义，如regenny/re7/、regenny/re4/，配套ReClass_Internal_RE7.hpp这类头文件给出类型和字段布局。写脚本卡住时，先来这里查字段名和偏移，比盲猜快。

编译与插件开发怎么进，装不上先查这四处

进阶方向两个：一是自己编译，需要 C++23 编译器（推荐 VS2022）加 CMake，完整步骤在 COMPILING.md，根目录的build_vs2022.bat可以一键全量构建；二是插件开发，按examples/example_plugin/的骨架抄。依赖库统一放在dependencies/（sol2、ImGui、minhook、spdlog 等），编译时一并处理。

排错四连：

• 如果装完游戏无法启动，先确认dinput8.dll在游戏根目录而不是子文件夹，再看 REFramework 版本与游戏版本是否匹配
• 如果 VR 没反应，检查 SteamVR/OpenXR 运行时是否在运行、头显驱动是否为最新
• 如果 Lua 脚本不生效，确认脚本放的是游戏目录下的scripts/，语法报错会写进 REFramework 日志
• 如果编译失败，先确认 VS 装过"C++ 桌面开发"工作负载，再执行git submodule update --init --recursive拉全依赖

资源索引

• README.md：支持游戏列表和内置 Mod 清单
• COMPILING.md：编译前置条件和三种构建方式
• examples/example_plugin/：插件最小可运行示例
• scripts/：Lua 脚本样例
• shared/sdk/：各游戏 SDK 与类型定义
• src/mods/：内置 Mod（VR、摄像机、脚本运行器）实现

下一步建议：从scripts/里挑一个和你游戏同名的 Lua 文件，改一个数值放进游戏目录跑一遍，确认整条链路通了，再开始写自己的脚本。

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