UE4SS-RE/RE-UE4SS
游戏面向 UE4/5 游戏的注入式 Lua/C++ 模组框架,附带 SDK 生成与运行时属性查看工具。
项目介绍
RE-UE4SS 是面向 Unreal Engine 4/5 游戏的模组与脚本平台。它以注入方式进入游戏进程,把引擎的对象系统暴露给 Lua 和 C++ 模组,让模组作者可以挂钩函数、读取和修改运行时属性,并在不替换游戏文件的情况下加载蓝图模组。仓库还包含多类导出工具:生成 Unreal Header Tool 兼容头文件、带偏移的标准 C++ 头文件、用于无版本属性的 .usmap 映射文件,以及 UMAP 重建数据;同时提供实时属性查看与编辑界面,便于调试模组 (功能列表、实时查看)。
项目覆盖 UE 4.7 到 5.8,但作者明确不追求对所有游戏开箱即用;针对具体游戏往往需要自行更新 AOB 签名等适配工作 (版本范围)。
快速使用
官方推荐的简单路径是使用预编译版本,而不是从源码构建:
- 从 Releases 下载最新的非实验性、非 dev 版本 zip。
- 将其内容解压到
{游戏目录}/GameName/Binaries/Win64/(安装步骤)。 - 如果该游戏在自定义配置列表里,再把对应文件夹的内容也解压到
Win64。 - 启动游戏;UE4SS 通过代理 DLL 加载,Lua 模组放入 mods 目录即可使用。
做模组开发应改用 zDEV 包。通过代理 DLL 安装时,启动参数 --disable-ue4ss 可临时禁用 UE4SS,--ue4ss-path <path> 可指定另一个 UE4SS.dll (命令行选项)。环境变量 UE4SS_MODS_PATHS 用分号分隔额外的模组目录,排在前面的目录优先级更高 (环境变量)。
从源码构建是另一套更重的流程:递归克隆并初始化子模块,需要把 GitHub 账号关联 Epic 账号以拉取 Unreal 子模块,然后用 CMake 以 Game__Shipping__Win64 之类的构建模式配置 (构建命令)。完整说明见安装指南和文档站。
使用约束
- 原生构建需要 Windows 和支持 C++23 的 MSVC 工具链(MSVC >= 19.43、VS >= 17.13),以及 Rust >= 1.73.0、CMake >= 3.22 和 Ninja 或 MSVC (构建要求)。
- 不支持原生 Linux 构建;可以在 Linux 上用 xwin 或 msvc-wine 交叉编译 Windows 二进制,但需要额外配置 Wine 和
binfmt_misc(交叉编译)。 - 游戏兼容性没有保证;对未适配的游戏可能需要更新 AOB 签名 (兼容性修复)。
- 注入和修改游戏进程会与游戏二进制、反作弊或在线服务发生交互,本项目不处理这些限制;使用前应确认具体游戏的相关规则。
HotRepo 点评
该项目在 2026-11-02 的 C++ 日榜上有记录,当天最好名次为第 6,新增 11 Star,累计 3,106 Star。单条快照只能说明它当天仍出现在 C++ 榜单中,不足以判断增长趋势。更值得关注的是工具本身的覆盖面:把 Lua/C++ 模组 API、多类导出器和运行时属性查看集中在一个注入式系统里,使其更像 UE 模组开发的共用基础设施,而非某个单款游戏的模组。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。