RTTI Dumper - 2.31 和 2.5

RTTI Dumper - 2.31 和 2.5

RTTI Dumper是一个模组制作工具,用于导出《赛博朋克2077》REDengine 4脚本RTTI数据,以供研究、调试和模组开发使用。本次更新版本为游戏版本2.31和2.5提供了专用构建。需要匹配的RED4ext版本;源代码也可获取。

[center][size=6][b][color=#C18BFF]RED4.RTTIDUMPER[/color][/b][/size]
[color=#B69AD4][b]RUNTIME REFLECTION / REDENGINE / MODDING TOOLS[/b][/color]
[b]Cyberpunk 2077 2.31 与 2.5 的非官方兼容移植版[/b]
[color=#A78BFA]由 DShadow 维护[/color][/center]
[center][color=#9575CD]────────────────────────────────────[/color][/center]

[size=5][b][color=#C18BFF]简介[/color][/b][/size]

[b]RED4.RTTIDumper[/b] 是一款开发实用工具,可直接从 Cyberpunk 2077 的 REDengine 4 运行时中提取运行时类型信息(RTTI)。

该工具最初由 [b]Octavian Dima(WopsS)[/b] 开发,允许模组开发者查看引擎反射出的脚本结构,包括类、函数、属性、枚举、位域以及继承关系。

本发布版本提供 [b]面向 Cyberpunk 2077 2.31 和 2.5 的非官方、特定版本兼容移植[/b],保留了原始的转储功能及其多种导出格式。与那些暴露新脚本函数的工具不同,RTTI Dumper 旨在提取并记录现有的运行时信息。

生成的数据可作为原生插件开发、脚本研究、自定义工具制作以及游戏版本间对比的技术参考资料。

[color=#B69AD4][b]检视运行时。探索其结构。理解引擎。[/b][/color]


[size=5][b][color=#C18BFF]它会转储什么?[/color][/b][/size]

RED4.RTTIDumper 使用 RED4ext 和引擎的 RTTI 系统,从运行中的游戏收集反射类型信息。

[b]可用信息包括:[/b]
• 类和结构化类型。
• 类之间的继承关系。
• 类属性、名称、类型和标志。
• 原生函数、静态函数和脚本暴露的函数。
• 函数名称、参数和返回类型。
• 全局函数。
• 枚举及其关联值。
• 位域及其定义的成员。

可用信息的确切内容取决于游戏通过其运行时反射系统所暴露的内容。

[b]这有什么用?[/b]

对开发者而言,RTTI 提供了一种发现引擎所暴露的结构和接口的方式,无需完全依赖手动维护的文档。它有助于识别相关类、检查函数签名、理解引擎类型之间的关系,并调查游戏更新引入的变化。

[b]重要提示:[/b] RTTI Dumper 导出的是反射信息。它并非通用资源提取器、内存调试器或自动 SDK 生成器。


[size=5][b][color=#C18BFF]面向模组开发者[/color][/b][/size]

本节演示该工具产生的输出,以及开发者如何开始使用其输出内容。

[b][color=#D5BAFF]01 / 探索生成的文件[/color][/b]

在安装 RTTI Dumper 后启动游戏,该工具会生成若干包含提取信息的目录。生成的结构按输出格式组织。

[code]
dumps/
text/
globals.txt
classes/
enums/
bitfields/
json/
globals.json
classes/
enums/
bitfields/
csharp/
cp77enums.cs
classes/
nativedb/
json/
globals.json
classes.json
enums.json
bitfields.json
cpp/[/code]
每种格式服务于不同的开发用途。文本文件提供人类可读的定义,JSON 文件包含适合自动化处理的结构化数据,C# 文件提供生成的类型表示。NativeDB 风格的 JSON 提供紧凑的 RTTI 数据集,而 C++ 输出包含通过 RED4ext 生成的反射信息。

输出生成于进程的当前工作目录,通常为 Cyberpunk 2077 的安装目录。


[b][color=#D5BAFF]02 / 理解 JSON 输出[/color][/b]

JSON 导出器将类、属性、函数、枚举和位域组织到结构化文件中。一个类的导出可包含其名称、父类、标志、属性以及已注册的函数。

[b]基于实际导出器架构的示例:[/b]

[code]
{
"parent": "ExampleParent",
"name": "ExampleClass",
"flags": 0,
"props": [
{
"type": "Int32",
"name": "exampleValue",
"flags": 0
}
],
"funcs": [
{
"fullName": "ExampleClass::ExampleMethod",
"shortName": "ExampleMethod",
"flags": 0
}
]
}[/code]
此示例演示了导出数据的结构。类名和函数名仅为示意,并非复制自实际的游戏转储。

[b]开发者可以从这些信息中提取什么?[/b]
• 类名和继承关系。
• 属性名称及其关联类型。
• 函数名称和签名。
• 参数和返回类型信息。
• 描述反射属性和函数的标志。

这些信息可由外部脚本处理、索引到可搜索的数据库,或作为开发工具和模组时的参考资料使用。

[b]注意:[/b] 并非每个类或函数都包含所有可能的字段。导出器会根据运行时中可用的信息来包含字段。


[b][color=#D5BAFF]03 / 搜索与对比 RTTI 数据[/color][/b]

导出完成后,开发者可以使用外部工具搜索生成的文件。例如,PowerShell 可以定位文件名包含特定词的类导出文件。

[b]查找与车辆相关的类:[/b]

[code]
Get-ChildItem ".\dumps\json\classes" -Filter "vehicle.json"[/code]
此命令在生成的类文件中搜索名称包含 "vehicle" 的文件。请从 Cyberpunk 2077 工作目录运行,或将相对路径替换为你的转储文件的完整位置。

JSON 输出还可以对比不同 Cyberpunk 2077 版本之间的反射结构。

[b]使用 Git 对比两份分别保存的导出数据的示例:[/b]

[code]
git diff --no-index "dumps-2.31\json\classes" "dumps-2.5\json\classes"[/code]
进行此对比需要安装 Git,并且必须先将两个生成的转储目录分别以相应名称保存。

这有助于开发者调查游戏版本之间新增或移除的类、反射属性的变化、函数签名的差异,以及枚举或类型定义的修改。

[b]重要提示:[/b] 这些搜索和对比使用外部工具。RTTI Dumper 目前不包含内置的搜索界面或版本差异分析器。


[size=5][b][color=#C18BFF]导出格式[/color][/b][/size]

RTTI Dumper 包含多个导出器,允许开发者以最适合其工作流程的格式处理提取的信息。

[b][color=#D5BAFF]文本导出[/color][/b]
[b]目录:[/b] dumps\text


生成人类可读的类定义、函数、属性、枚举和位域。该格式类似于脚本声明,并包含继承关系和函数签名等信息。

[b]推荐用于:[/b] 手动检查、脚本研究以及理解暴露的引擎结构。


[b][color=#D5BAFF]结构化 JSON 导出[/color][/b]
[b]目录:[/b] dumps\json


生成结构化 JSON 文件,分别为类、枚举和位域建立独立目录,外加全局函数信息。

[b]推荐用于:[/b] 自动化分析、索引、外部解析器和自定义开发工具。


[b][color=#D5BAFF]面向 WolvenKit 的 C# 导出[/color][/b]
[b]目录:[/b] dumps\csharp


生成反射引擎类型的 C# 表示。导出器包含类型映射和对选定类的特殊处理,以生成面向 WolvenKit 相关开发的表示。

[b]推荐用于:[/b] C# 工具开发、REDengine 类型研究以及检查生成的类表示。

[b]限制:[/b] 不保证与每个 WolvenKit 版本或项目直接兼容。


[b][color=#D5BAFF]NativeDB 风格 JSON 导出[/color][/b]
[b]目录:[/b] dumps\nativedb\json


生成包含反射类、函数、枚举和位域的紧凑结构化数据集。

[b]推荐用于:[/b] 面向 NativeDB 的数据处理及兼容的外部分析工具。

[b]限制:[/b] 导出器不会自动将信息上传至 NativeDB,也不会更新现有安装。


[b][color=#D5BAFF]C++ 反射转储[/color][/b]
[b]目录:[/b] dumps\cpp


使用 RED4ext 的反射转储功能生成面向 C++ 的参考数据。

[b]推荐用于:[/b] 原生插件开发、RED4ext 研究以及调查反射引擎类型。


[size=5][b][color=#C18BFF]兼容性[/color][/b][/size]

本发布版本提供两个独立的、版本锁定的 DLL。每个构建都针对特定的 Cyberpunk 2077 运行时和 RED4ext 版本。

[b][color=#D5BAFF]CYBERPUNK 2077 — 版本 2.31[/color][/b]
• 所需 RED4ext:1.30.0
• 已验证发行渠道:Steam
• 运行时文件版本:3.0.80.51928
• 插件:RED4.RTTIDumper-2.31.dll

[b][color=#D5BAFF]CYBERPUNK 2077 — 版本 2.5[/color][/b]
• 所需 RED4ext:1.31.0
• 已验证发行渠道:GOG
• 运行时文件版本:3.0.88.46235
• 插件:RED4.RTTIDumper-2.5.dll

[b]验证信息:[/b]

随附的发布记录报告了在各自测试配置上成功编译、插件加载、完整转储生成以及干净关闭。

不保证与其他游戏构建、运行时版本、RED4ext 版本或商店发行渠道的兼容性。

[color=#D5BAFF][b]只安装与你确切游戏版本对应的 DLL。不要同时安装两个构建。[/b][/color]


[size=5][b][color=#C18BFF]要求[/color][/b][/size]

• Cyberpunk 2077 — 上述受支持的版本。
• [url=https://www.nexusmods.com/cyberpunk2077/mods/2380]RED4ext[/url] — 匹配的版本。

[b]不需要 Cyber Engine Tweaks。[/b]

生成对应导出格式不需要 WolvenKit 和 NativeDB。


[size=5][b][color=#C18BFF]安装与使用[/color][/b][/size]

[b][color=#D5BAFF]步骤 01 / 准备[/color][/b]

完全关闭 Cyberpunk 2077 并安装匹配版本的 RED4ext。


[b][color=#D5BAFF]步骤 02 / 选择正确的文件[/color][/b]

下载与你的游戏版本匹配的包:
• RED4.RTTIDumper-2.31.zip
• RED4.RTTIDumper-2.5.zip


[b][color=#D5BAFF]步骤 03 / 安装[/color][/b]

将压缩包解压到你的 Cyberpunk 2077 安装目录。压缩包已包含所需的文件夹结构。

DLL 必须位于:
[b]Cyberpunk 2077\red4ext\plugins[/b]

在安装所选版本之前,移除任何先前安装的 RED4.RTTIDumper DLL。


[b][color=#D5BAFF]步骤 04 / 生成转储[/color][/b]

正常启动 Cyberpunk 2077。当游戏到达适当的运行时状态时,转储器会自动启动。

无需手动命令、控制台访问或配置文件。

[b]如何知道转储何时完成?[/b]

在提取过程中,游戏可能会暂时无响应。一旦它重新响应,请检查生成的目录中是否包含输出文件,并确认文件写入已停止,然后再正常关闭游戏。

当前实现不提供已确认的屏幕完成指示器,因此不要期待特定的通知或进度条。


[b][color=#D5BAFF]步骤 05 / 导出之后[/color][/b]

转储操作完成后,正常关闭游戏并找到生成的 [b]dumps[/b] 目录。

从 plugins 目录中移除 RTTI Dumper DLL。导出的数据仍可用于开发和分析。


[size=5][b][color=#C18BFF]技术说明[/color][/b][/size]

[b][color=#D5BAFF]性能与执行[/color][/b]

RTTI 提取是一项资源密集型操作。该工具在处理引擎的反射类型时可能生成数万个单独的文件。

在操作期间,游戏可能会暂时看起来冻结或无响应。该实现在转储期间会临时挂起其他进程线程。

[b]不要将暂时的无响应视为崩溃。[/b] 留出足够的时间让操作完成,除非必须恢复,否则避免强制终止游戏。


[b][color=#D5BAFF]存储要求[/color][/b]

完整的转储可能需要数百兆字节的可用磁盘空间。确切的输出大小取决于反射信息的数量和生成的文件。

在开始导出前确保有足够的可用存储空间。


[b][color=#D5BAFF]临时开发实用工具[/color][/b]

RTTI Dumper 旨在用于生成或更新技术参考资料时使用。它不提供游戏玩法功能,也不需要在正常游戏过程中保持安装。

完成导出后移除插件 DLL。


[b][color=#D5BAFF]版本特定的结果[/color][/b]

RTTI 结构可能在不同 Cyberpunk 2077 版本之间发生变化。因此,从不同运行时生成的导出应被视为独立的数据集。

可下载的包不包含预生成的游戏转储。


[size=5][b][color=#C18BFF]源代码与构建[/color][/b][/size]

源代码以对应每个受支持运行时的独立压缩包提供。

[b]源代码包:[/b]
• RED4.RTTIDumper-2.31-source.zip
• RED4.RTTIDumper-2.5-source.zip

每个压缩包包含对应的移植快照、构建配置和源文件清单。

[b]构建环境:[/b]
• C++
• Visual Studio 2022 — Release x64
• RED4ext SDK
• Premake 5
• nlohmann/json

外部开发依赖故意未与源代码压缩包捆绑。正确的依赖修订版和构建说明记录在随附文件中。

[b]技术文档:[/b]
• BUILD-TARGET.md — 运行时特定的编译说明。
• SOURCE-MANIFEST.json — 源文件清单和 SHA-256 哈希值。
• BUILD-AND-SOURCES.md — 原始仓库和移植修订信息。
• COMPATIBILITY.md — 合格的运行时和 RED4ext 配置。
• DLL-SHA256.txt — 打包 DLL 的校验和。

构建说明和源文件清单包含在源代码包中,而兼容性信息和 DLL 校验和随编译发布版提供。

开发者可以检查实现、重新构建版本特定的 DLL,并研究受支持的导出格式。

[b]原始项目:[/b] [url=https://github.com/wopss/RED4.RTTIDumper]由 Octavian Dima(WopsS)开发的 RED4.RTTIDumper[/url]

本发布版本是非官方兼容移植。原始的 MIT 许可证和版权声明保留在分发的压缩包中。

本移植版本不隶属于原始作者、CD PROJEKT RED 或 RED4ext 项目,也未获得其官方认可。


[size=5][b][color=#C18BFF]支持与反馈[/color][/b][/size]

如果你遇到问题,请提供:
• 你的确切 Cyberpunk 2077 版本。
• 你安装的 RED4ext 版本。
• 你选择的 RTTI Dumper DLL。
• 你的游戏发行渠道(Steam、GOG 或 Epic)。
• 相关的 RED4ext 日志或错误消息。
• 游戏是否启动以及转储生成是否开始。
• 哪些输出文件夹或文件已成功生成。

提供这些细节有助于识别运行时特定的问题,并使故障排除更有效。


[center][color=#9575CD]────────────────────────────────────[/color]
[color=#C18BFF][size=4][b]DSHADOW[/b][/size][/color]
[color=#B69AD4]Cyberpunk 2077 模组工具与开发[/color]
[b]探索引擎。理解其结构。以更好的信息进行构建。[/b][/center]