REFramework 完整指南：RE Engine 游戏模组框架与 Lua 脚本平台快速跑通

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

REFramework 是一款面向 RE Engine 游戏的开源模组框架与 Lua 脚本平台，让你不改动游戏文件就能给生化危机、鬼泣、怪物猎人等作品加功能。只需注入一个dinput8.dll，游戏立刻获得 VR 支持、自由相机、FOV 调节等能力。它是给谁用的？想改游戏行为的玩家，几行 Lua 就能搞定；想深入控制的开发者，可以直接写带界面的 C++ 插件。这篇新手指南会带你从环境准备一路走到独立写脚本。

它能先替你干哪些活

先看你拿到它之后能立刻用上什么，做法后面再讲：

• Lua 脚本平台：把.lua文件丢进游戏目录的scripts文件夹即可被加载，可以读写游戏对象、调用引擎方法。
• C++ 插件系统：自带 SDK 头文件和 ImGui 渲染封装，适合开发带界面的原生插件。
• VR 支持：全部 RE 游戏支持通用 6DOF VR，RE2/RE3/RE7/RE8 还有手柄动作控制。
• 内置 mod：FOV 滑块、自由相机、第一人称、场景时间缩放、超宽屏修正，打开就能用。
• 开发者工具：开发模式下有 Object Explorer、Game Objects Display，不用 IDA 就能浏览运行时对象图。

动手前备齐这些环境

全部是 Windows 侧工具链，逐条勾一遍再开工：

• Windows 10/11 64 位系统
• Visual Studio 2022（装 C++ 桌面开发工作负载，需 C++23 支持）
• CMake 3.15 及以上版本
• Git

从克隆到构建成功

第 1 步：克隆仓库

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

完成后检查：当前目录下能看到src/、scripts/、CMakeLists.txt等内容。

第 2 步：初始化子模块

git submodule update --init --recursive

完成后检查：dependencies/目录不再为空，ImGui、Lua、sol2 等第三方库已就位。

第 3 步：配置 CMake

mkdir build64_all cd build64_all cmake .. -G "Visual Studio 17 2022" -A x64 -DDEVELOPER_MODE=ON

完成后检查：build64_all里生成了CMakeCache.txt，终端末尾没有报错。

第 4 步：编译

cmake --build . --config Release

完成后检查：构建正常结束，无编译错误。图省事的话，仓库根目录的build_vs2022.bat一键走完前三步。

成功验证

✅ 跑通之后，你应该看到这些：

• build64_all/bin/REFramework目录下出现dinput8.dll（注入主程序）
• 把dinput8.dll复制到 RE 游戏目录并启动游戏，画面右下角出现悬浮入口
• 点开入口弹出 mod 菜单，能看到 FOV 滑块、自由相机等内置开关——菜单能弹出，就说明注入成功

跑通之后：三种递进玩法

1. 先跑现成脚本（最简单）

看 scripts/re2_smooth_movement.lua，它演示如何通过via.Transform读写玩家位置实现移动平滑；类似的还有 scripts/re2_vr_crosshair.lua。你的脚本丢进游戏目录scripts文件夹就能被加载。

2. 照着官方示例改（进阶）

examples/example_plugin/ 是完整可编译的插件模板，演示初始化 ImGui、绑定 DirectX 11/12、注册 Lua 沙箱；examples/weapon_stay_big_plugin/ 是最小化的单文件例子，适合先读懂再动手。

3. 自己开发插件（完整）

从 example_plugin 复制一套，改两行名字就能当起点；类型定义主要在 shared/sdk/ 下按游戏（re4、re9、sf6 等）分目录查找。

🧭 新手避坑清单

• 编译器必须支持 C++23，编译时刷出大量模板报错，先确认装的是 Visual Studio 2022。
• 跳过git submodule初始化，dependencies/是空的，构建必挂，别偷懒。
• dinput8.dll要放进游戏根目录，放错子目录游戏不会加载。
• 脚本改动拆小步：先打印一个字段，再改一个方法，最后挂 UI，别一次写完。
• 动手前先在官方教程（reframework-book）里查一下脚本用到的类型名，少走弯路。

生态与继续学习

• shared/sdk/：插件和脚本共享的类型定义与 SDK 头文件，写插件主要和它打交道
• scripts/utility/：RE2.lua、RE4.lua等按游戏分类的工具函数库，省掉大量重复代码
• reversing/：IDA 命名脚本与 dump 工具，给需要逆向新游戏的人准备，初学可以先跳过
• 官方教程 reframework-book：Lua API 完整文档，脚本入门前建议过一遍

跑通第一个 Lua 脚本只需半小时，而当你照着改出一版自己的版本时，会发现 RE 引擎的运行时比想象中开放。现在就打开scripts/目录，挑一个脚本改一行试试。

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