REFrame

REFramework 项目分析报告

项目地址 : https://github.com/praydog/REFramework
分析日期 : 2026-05-07
报告版本: v1.0

一、项目概览

项目属性	详情
项目名称	REFramework
作者	praydog (GitHub ID: 2909949)
项目定位	RE Engine 游戏的 Mod 加载器、脚本平台与 VR 支持框架
开源协议	MIT License
创建时间	2019-01-31
最后更新	2026-04-26（最新 commit）
主语言	C++（占 94.3%）
仓库大小	~53 MB
默认分支	master
官方网站	https://reframework.praydog.com/

REFramework 是一个面向 Capcom RE Engine 引擎游戏的综合性修改框架，集成了 Mod 加载、Lua 脚本系统和通用 6DOF VR 支持三大核心能力。灵感来源于 Kanan 项目。

二、社区数据

指标	数值
⭐ Stars	5,061
🍴 Forks	544
👀 Watchers	91
🐛 Open Issues	623
📦 最新版本	v1.5.9.1 (2025-03-05)
🔧 Contributors	10+

贡献者排名

排名	用户	贡献次数	角色
1	praydog	1,980	项目创始人 & 核心维护者
2	cursey	138	VR 组件 & 脚本系统联合开发
3	hcdd0304	16	贡献者
4	Strackeror	---	贡献者

致谢名单（README 中提及）

SkacikPL --- 手电筒 Mod 原作者
cursey --- VR 组件 & 脚本系统联合开发
The Hitchhiker & alphaZomega --- 压力测试、脚本创建、建议贡献

三、技术栈与语言分布

语言	字节数	占比
C++	41,888,285	94.30%
C	589,695	1.33%
C#	412,977	0.93%
Lua	192,038	0.43%
Python	118,113	0.27%
CMake	109,554	0.25%
JavaScript	56,078	0.13%
CSS	14,519	0.03%
HTML	4,291	0.01%
Batchfile	2,593	0.01%

分析：

核心代码以 C++ 为主（绝对主导），符合游戏引擎级别的性能需求
Lua 作为脚本语言，为 Mod 作者提供低门槛的扩展能力
C# 可能用于编辑器工具或部分辅助组件
Python 用于构建/CI 工具脚本
CMake 作为构建系统，支持多目标编译

四、项目结构

复制代码

REFramework/
├── .clang-format          # 代码格式化配置
├── .clang-tidy            # 静态分析配置
├── .github/
│   ├── ISSUE_TEMPLATE/    # Bug 报告 & 功能请求模板
│   └── workflows/
│       ├── build-pr.yml       # PR 构建 CI
│       └── dev-release.yml    # 开发版自动发布
├── CMakeLists.txt         # 主构建文件 (67KB，多目标)
├── CMakePresets.json       # CMake 预设
├── COMPILING.md           # 编译指南
├── LICENSE                # MIT 协议
├── README.md              # 项目说明
├── dev/                   # 开发/CI 工具脚本
├── src/                   # 源代码目录
│   ├── D3D11Hook.cpp/hpp      # DirectX 11 Hook
│   ├── D3D12Hook.cpp/hpp      # DirectX 12 Hook
│   └── ...                    # 核心框架代码
├── shared/                # 共享库
├── scripts/               # Lua 脚本示例
├── games/                 # 各游戏适配模块
│   ├── re2/               # 生化危机 2
│   ├── re3/               # 生化危机 3
│   ├── re4/               # 生化危机 4
│   ├── re7/               # 生化危机 7
│   ├── re8/               # 生化危机 8
│   ├── dmc5/              # 鬼泣 5
│   ├── sf6/               # 街霸 6
│   ├── mhrise/            # 怪物猎人：崛起
│   ├── mhwilds/           # 怪物猎人：荒野
│   └── dd2/               # 龙之信条 2
└── imgui/                 # ImGui 调试界面

五、核心功能模块

5.1 Mod 加载系统

DLL 注入方式加载（dinput8.dll）
支持运行时热加载/卸载 Mod
对游戏内存的实时修改能力

5.2 Lua 脚本 API & 插件系统

完整的 Lua 绑定，覆盖游戏对象、内存、输入等
支持所有已适配游戏
有完善的文档 Wiki: https://cursey.github.io/reframework-book/
社区已有大量 Lua 脚本生态

5.3 VR 支持（通用 6DOF）

通用 6DOF VR：所有 RE Engine 游戏均可通过 SteamVR 或 OpenXR 启用 VR 模式
运动控制器支持：RE2/RE3/RE7/RE8
第一人称视角：RE2, RE3
手动手电筒：RE2, RE3, RE8
需安装 SteamVR 或使用 OpenXR 头显

5.4 通用游戏工具

工具	说明	适用范围
Free Camera	自由视角相机	所有游戏
Scene Timescale	场景时间缩放	所有游戏
FOV Slider	视场角调节	所有游戏
Vignette Disabler	禁用暗角效果	所有游戏
Ultrawide Fix	超宽屏/比例修复	所有游戏
GUI Hider	隐藏/禁用 UI	所有游戏
Game Objects Display	游戏对象显示	调试用
Object Explorer	对象浏览器	调试用

5.5 已修复的游戏问题

RE8 启动崩溃
RE8 卡顿（击杀敌人、受伤等触发）
MHRise/RE8 第三方 DLL 导致的崩溃

六、支持的游戏列表

完全支持（有专用构建）

游戏	英文名	引擎
生化危机 2 重制版	Resident Evil 2	RE Engine
生化危机 3 重制版	Resident Evil 3	RE Engine
生化危机 4 重制版	Resident Evil 4	RE Engine
生化危机 7	Resident Evil 7	RE Engine
生化危机：村庄	Resident Evil Village (RE8)	RE Engine
生化危机：安魂曲	Resident Evil Requiem (RE9)	RE Engine
鬼泣 5	Devil May Cry 5	RE Engine
街头霸王 6	Street Fighter 6	RE Engine
怪物猎人：崛起	Monster Hunter Rise	RE Engine
怪物猎人：荒野	Monster Hunter Wilds	RE Engine
怪物猎人物语 3	Monster Hunter Stories 3	RE Engine
龙之信条 2	Dragon's Dogma 2	RE Engine

通过复用构建支持

游戏	复用构建
Ghosts 'n Goblins Resurrection	RE8 构建
Apollo Justice: Ace Attorney Trilogy	DD2 构建
Kunitsu-Gami: Path of the Goddess	DD2 构建
Onimusha 2: Samurai's Destiny	MHWILDS 构建

七、构建系统

编译环境要求

编译器：C++23 兼容（推荐 Visual Studio 2022 / MSVC）
构建工具：CMake
平台：Windows x64
图形 API：同时支持 DirectX 11 和 DirectX 12

编译方式

命令行方式：

bash 复制代码

git clone https://github.com/praydog/REFramework
git submodule update --init --recursive
cmake -S . -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_BUILD_TYPE=Release
cmake --build ./build --config Release

单目标编译（如只编译 RE2）：

bash 复制代码

cmake --build ./build --config Release --target RE2

VSCode 方式：通过 CMake Tools 扩展，选择 VS2022 Kit 即可。

CI/CD

GitHub Actions 自动构建 PR
开发版自动发布到 Nightly Builds

八、发布历史（近期）

版本	发布日期	主要内容
v1.5.9.1	2025-03-05	最新稳定版，包含 DD2/DMC5/MHRISE 等多游戏构建
Nightly	持续更新	开发版，包含最新修复（如 RE9 崩溃修复）

日期	提交信息
2026-04-26	`LooseTextureLoader: Fix RE9 crash` --- 修复 RE9 松散纹理加载崩溃
2026-04-25	`cleanup: remove AI slop docs and move scripts to dev/` --- 清理文档，移动构建脚本到 dev/

v1.5.9.1 下载统计（部分资产）

构建	文件大小	下载次数
DD2.zip	5.28 MB	25,599
DMC5.zip	5.24 MB	20,474
MHRISE.zip	5.28 MB	18,919

九、技术架构分析

9.1 核心架构