REFramework 上手指南：10 分钟跑通你的第一个 RE 引擎 Mod

REFramework 上手指南：10 分钟跑通你的第一个 RE 引擎 Mod

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

REFramework 是覆盖 RE 引擎全系列游戏（生化危机 2 到龙之信条 2 共 19 款）的 Mod 加载器、Lua 脚本平台和 VR 运行框架，一次注入即可拿到对象浏览器、脚本 API 和 6 自由度 VR 支持，把"改参数要重编译"变成"改一行 Lua 立即生效"，适合第一次接触 RE 引擎 Mod 开发的人。

它到底能干什么

• Lua 脚本热更新：改完脚本直接重载，调 FOV 滑条这类功能不用重编 DLL
• 通用 VR 支持：全部游戏可用 6DOF，RE2/3/7/8 还带手柄交互
• 对象浏览器与工具：开发者模式下实时查看、编辑游戏对象树
• 内置 Mod 合集：Free Camera、Scene Timescale、超宽屏修复开箱即用

从零到跑通：最短路径

装好它

从 Release 页下载稳定版 ZIP（想尝鲜可看 Nightly 构建），解压后只需要dinput8.dll一个文件，把它拷进游戏根目录即可，游戏会同时兼容 DX11 和 DX12。如果你用 Proton 在 Linux 上跑，进 Steam 属性给启动项加WINEDLLOVERRIDES="dinput8.dll=n,b" %command%。想要 VR 的话则把整个 ZIP 内容解包到游戏目录，并先装好 SteamVR。

第一次打开

启动游戏、进入游戏画面后按一下 Insert 键，会弹出 ImGui 菜单，里面按 Mod 分组列出了所有功能。最小验证动作：勾上 FOV Slider 或 Free Camera，切回游戏窗口立刻生效，不用重启。

挑一个功能深钻

REFramework 的差异化能力是 Lua 脚本系统，它能解决"想改游戏行为但不想动 C++"的问题。框架通过 src/mods/ScriptRunner.cpp 注册了re.on_frame、re.on_application_entry等回调，脚本则统一放在 scripts/ 目录，里面已经有一个可直接参考的 re2_smooth_movement.lua，配套的工具函数在 scripts/utility/。

local camera = sdk.get_primary_camera() local go = camera:call("get_GameObject") local t = go:call("get_Transform") local pos = t:call("get_Position") print("camera at", pos.x, pos.y, pos.z) re.on_frame(function() end)

上面这六行做的事：拿到主相机、顺 GameObject 找到 Transform、读回它的坐标打印出来。改一行参数试试——把get_Position换成set_Position并传入新的Vector3f，相机就会跳到新坐标，这就是脚本系统能触达游戏内部方法的完整路径。

想再进一步

• 插件开发：C++ 侧继承 Plugin 基类，C# 侧有独立的 csharp-api/ 运行时，模板在 examples/example_plugin/
• 逆向工具链：reversing/ 里含 rsz 资源解析器和 IDA 命名脚本，用来摸清游戏内部结构
• 社区脚本库：scripts/utility/ 的GameObject.lua、RE2.lua等模块可以直接 require 复用

踩坑与排错

• Insert 没反应→ DLL 没加载 → 确认dinput8.dll放在了 exe 同目录且版本与游戏匹配
• 脚本报 nil 异常→ 类型名不存在 → 用sdk.find_type_definition先查该类型在 shared/sdk/regenny/ 里是否真的定义了对应游戏
• Proton 下闪退→ 原生 dinput8 冲突 → 按上面 Proton 启动项覆盖该 DLL

下一步很简单：打开scripts/，找个re2_*.lua复制一份，改掉回调里的那行参数重新加载，看游戏画面跟着变。

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