企业官网建设流程全解析

REFramework 10分钟跑通教程：RE引擎游戏模组框架、Lua脚本与VR支持完整上手指南

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

REFramework 是一个面向所有 RE Engine（RE 引擎）游戏的Mod 加载器 + Lua 脚本平台 + VR 支持框架：它以一个dinput8.dll的形式注入《生化危机》《怪物猎人：荒野》《鬼泣5》《街霸6》等游戏，进游戏后按一个键就能呼出内置菜单，直接开 FOV 调节、自由视角、时间缩放、VR 手柄等操作，还能跑你自己的 Lua 脚本改数值、改行为，甚至用 C++ 开发完整插件。这篇 REFramework 教程带你从零跑通注入、5 分钟调完常用参数、学会脚本与排障，全程不需要写一行代码。

一、REFramework 解决什么问题

RE 引擎游戏的玩家长期被三件事卡住：

• 画面和操控不可调：FOV 被锁死、视角跟着镜头走、没有 21:9 超宽屏适配，想截一张干净的全景图都得靠外部软件；
• 改游戏内容要动内存：改数值、加功能，传统做法是找偏移、写 CE 脚本，版本一更新全废；
• 没有统一的开发入口：想给游戏加插件，得自己搭注入、渲染钩子和 UI。

REFramework 的思路是把这三层一次性打通：注入层（借dinput8.dll标准名进游戏）、功能层（内置一整套常用 Mod）、开发层（Lua 脚本 + C++ 插件 API + 运行时对象浏览器）。你既可以只把它当"增强版游戏选项菜单"用，也可以把它当成 RE 引擎游戏的 Mod 开发平台。

二、零基础极速上车：从下载到呼出菜单

整个过程分 4 步，熟练后 10 分钟以内能完成：

1. 拿构建。到项目的 Releases 页面下载：日常使用选稳定版（Stable），追新特性选夜间构建（Nightly）。注意 REFramework按游戏出不同构建，《怪物猎人：荒野》要用 MHWilds 对应的包，别拿 RE2 的包去开 MH 游戏。
2. 放文件。普通玩家只需要从压缩包里取出dinput8.dll这一个文件，放进游戏安装目录（和主 exe 同级）。它借的是 Windows 标准动态库的名字，框架靠它完成注入，覆盖同名文件无所谓。
3. 启动游戏，正常进到标题画面。
4. 按 Insert 呼出菜单（小键盘 Insert 同理）。屏幕浮出一块带版本号的深色菜单，就说明注入成功、跑通了。

两个容易忽略的分支：

• VR 玩家：如果要 SteamVR 支持，需要把整个压缩包解压到游戏目录，而不是只放一个 DLL；
• Linux/Proton 玩家：在 Steam 属性里加启动项WINEDLLOVERRIDES="dinput8.dll=n,b" %command%即可，DX11 和 DX12 游戏都支持。

三、内置 Mod 与核心参数：跑通之后先调什么

菜单里的内置 Mod 全部游戏通用（个别功能按游戏开放），最常用的几项：

此外框架还顺手修了几个已知 bug：RE8 启动崩溃、RE8 杀敌/受击卡顿、MHRise/RE8 与第三方 DLL 相关的崩溃，注入后自动生效，不用手动开。

配置文件与最常改的 5 个选项

菜单里改的每一项都会即时写回配置文件，你也可以直接编辑文件、下次启动生效。配置文件默认写在游戏安装目录（框架启动时会先测试该目录可写，写不了才回退到 AppData），文件名固定为re2_fw_config.txt，目录按游戏可执行文件名区分：

<游戏安装目录>\re2_fw_config.txt ← 目录可写时 %APPDATA%\REFramework\<游戏exe名>\re2_fw_config.txt ← 目录不可写时（如 Steam 只读库）

下面这 5 项是日常最常动的（默认值来自 src/mods/REFrameworkConfig.hpp）：

小提醒：MenuKey_V2才是菜单键的配置名（带_V2后缀），直接编辑文件时别漏了。

四、进阶折腾：Lua 脚本、Object Explorer 与插件开发

当你不满足于内置开关，REFramework 给了三条深入的路。

1. Lua 脚本系统：不改代码改游戏

脚本是"放在游戏里、进游戏自动跑"的 Lua 文件，改数值、加显示、调交互逻辑都走这条路。关键路径：

• 自动加载脚本放%APPDATA%\REFramework\<游戏exe名>\reframework\autorun\（目录里所有.lua进游戏自动执行，也支持子目录/init.lua）；
• 菜单里有脚本运行入口，可以手动加载/卸载任意.lua文件，改了随时撤回重跑；
• 仓库的 scripts/ 目录有一批现成范例可以直接抄写法：re2_smooth_movement.lua（平滑移动）、re8_vr.lua、re2_vr_melee.lua等，scripts/utility/ 下还有GameObject.lua、Statics.lua这类按游戏分类的工具模块。

写自己的脚本前，建议先用下面的 Object Explorer 摸一遍目标对象长什么样，再去查项目 Wiki 里的 Lua API 文档。

2. Object Explorer：游戏内部"体检仪"

在菜单的Developer Tools里有两个运行时工具：

• Object Explorer：浏览游戏当前活动的所有托管对象，查字段值、手动调方法，类似游戏内存的可视化检查器；
• Game Objects Display：直接把当前场景的 GameObject 树画出来。

写脚本前用它们把"我想改的那个对象叫什么、字段是什么类型"摸透，能省掉大量盲试时间。

3. C++ 插件开发：从示例插件起步

想写完整插件（带自己的 ImGui 界面、自己的渲染回调），仓库里有官方示例可以参考：

• 示例插件在 examples/example_plugin/，入口Plugin.cpp/Plugin.hpp，连 DX11/DX12 的 ImGui 实现（imgui/、rendering/）都齐了；
• 插件 API 头文件在 include/reframework/，核心是API.hpp，C# 侧接口（REFrameworkNET）也在这里定义；
• 底层能力分层在 src/mods/（各内置 Mod）、src/mods/bindings/（Lua 绑定）和 shared/sdk/（各游戏 SDK 布局，按 RE2/RE4/MHWilds 等分目录），读源码理解框架行为最快的路径就是顺着这三层看；
• 本地构建用 CMake 走 cmake.toml 配置，构建脚本见 COMPILING.md；需要完整源码可以从 https://gitcode.com/GitHub_Trending/re/REFramework 克隆仓库。

五、故障急救包：崩溃、菜单呼不出、杀毒误报

排障时日志是第一手材料：框架自己的日志会记录哪个模块初始化失败、哪个钩子挂不上，先读日志再猜原因，比满网搜快得多。

六、生态延伸：文档、脚本库与 Issue 区

• 系统学脚本/插件：项目 Wiki 文档是权威 API 参考，REFrameworkNET 的 C# 接口和 Lua API 说明都在里面，写脚本前先翻一遍；
• 抄作业：scripts/ 里的现成脚本按游戏分文件，是最快的"语法速查"；
• 看完整插件怎么搭：examples/example_plugin/ 从入口到渲染回调都是可运行的；
• 遇到问题：先去仓库 Issue 区搜一下，RE 引擎游戏版本更新频繁，同类崩溃和解法大概率已经有人踩过坑。

跑起来之后的建议路径：先开 FOV + Free Camera 适应几天，再按玩法需求开 Vignette Disabler、Timescale，最后才碰 Lua 脚本——框架给你的余量比想象中多得多。

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