Il2CppDumper：Unity开发者必备的元数据解析工具

核心功能概览

Il2CppDumper 是一款专注于 Unity 应用逆向工程的专业工具，主要用于解析 il2cpp（Unity 使用的 C++ 编译中间件）编译后的可执行文件与元数据，帮助开发者实现代码分析与还原。以下是三个核心应用场景：

游戏逆向工程支持

🔍 功能解析：通过解析 il2cpp 编译产物，提取游戏逻辑中的类、方法、字段等关键信息，为游戏 mod 开发和功能扩展提供底层数据支持。开发者可基于解析结果理解游戏内部机制，实现自定义功能开发。

Unity 项目兼容性分析

📌 应用价值：在面对使用 il2cpp 编译的 Unity 项目时，该工具能帮助开发者分析不同版本 Unity 引擎生成的 il2cpp 结构差异，解决跨版本项目迁移中的兼容性问题，确保项目在不同环境下的稳定运行。

代码审计与安全评估

🔍 核心作用：对于需要进行安全评估的 Unity 应用，Il2CppDumper 可提取可执行文件中的关键代码结构，帮助安全人员发现潜在的安全漏洞和代码缺陷，为应用安全加固提供依据。

快速上手流程

准备工作

1. 环境配置

   • 确保系统已安装 .NET Framework 4.7.2 或更高版本，以保证工具正常运行。
   • 准备 il2cpp 编译生成的可执行文件（如 GameAssembly.dll）和对应的元数据文件 global-metadata.dat。

2. 工具获取

   • 通过以下命令克隆项目仓库：

   git clone https://gitcode.com/gh_mirrors/il/Il2CppDumper
   

执行流程

1. 启动工具

   • 进入项目目录，找到并运行 Il2CppDumper.exe 可执行文件。

2. 文件选择

   • 在工具界面中，依次选择 il2cpp 可执行文件和 global-metadata.dat 文件。

3. 参数设置

   • 根据需求在工具中设置相关参数，如输出目录、解析模式等，然后点击“开始解析”按钮。

结果验证

1. 输出文件检查

   • 解析完成后，在指定输出目录中查看生成的文件，主要包括：
     • DummyDll 目录：包含还原后的 DLL 文件，如 Assembly-CSharp.dll。
     • 脚本文件：如 ida.py、ghidra.py 等，用于在逆向工具中进一步分析。

2. 常见误区

   ❌ 误区：未正确匹配可执行文件与元数据文件版本，导致解析失败。 ✅ 正确做法：确保 il2cpp 可执行文件与 global-metadata.dat 来自同一编译产物，版本信息一致。

深度配置解析

基础配置

参数名	默认值	适用场景
DumpMethod	true	需要获取方法信息时启用
DumpField	true	需要分析字段数据时启用
GenerateDummyDll	true	需生成还原 DLL 时设置
RequireAnyKey	true	希望程序执行完毕后暂停时启用

高级配置

参数名	默认值	适用场景
ForceIl2CppVersion	false	当自动识别版本失败时，强制指定 il2cpp 版本
ForceVersion	"2017.4.39"	与 ForceIl2CppVersion 配合使用，指定具体版本号
DummyDllAddToken	true	需要在生成的 DLL 中添加 Token 信息时启用

常见问题

1. 解析无输出

   • 检查输入文件是否完整且匹配，确保 global-metadata.dat 未损坏。
   • 确认工具版本与 il2cpp 版本兼容，可尝试使用 ForceIl2CppVersion 配置强制指定版本。

2. DLL 文件无法使用

   • 检查 GenerateDummyDll 配置是否为 true，若未生成，重新运行工具并确保该参数启用。
   • 确认输出目录权限，避免因权限问题导致文件生成失败。

3. 脚本文件报错

   • 确保使用的逆向工具（如 IDA、Ghidra）版本与脚本兼容，可尝试更新工具或使用对应版本的脚本文件。