Il2CppDumper 完全使用指南：从入门到高级配置

一、核心功能解析：为什么选择 Il2CppDumper

1.1 什么是 Il2CppDumper

Il2CppDumper 是一款针对 Unity 游戏引擎 il2cpp 技术的逆向工程工具，能够解析 il2cpp 编译后的可执行文件和元数据文件（存储类型信息的关键文件），还原出原始的 C# 类型结构、方法和字段信息，为游戏分析和二次开发提供基础数据支持。

1.2 三大核心能力

• 类型信息还原：从二进制文件中提取类、结构体、枚举等类型定义，保留原始类型关系
• 代码结构重建：解析方法签名、参数列表和字段布局，生成可阅读的伪代码
• 辅助工具集成：提供与 IDA、Ghidra 等逆向工具的无缝对接脚本，加速逆向分析流程

二、快速上手流程：3分钟完成首次解析

2.1 环境准备与文件获取

1. 获取项目源码

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

   ⚠️ 注意：确保本地已安装 Git 和 .NET Framework 运行时环境

2. 准备目标文件

   • il2cpp 可执行文件（通常是游戏主程序）
   • global-metadata.dat 文件（元数据文件，通常位于游戏 Data 目录）

2.2 执行解析操作

1. 进入项目目录并运行主程序

   cd Il2CppDumper/Il2CppDumper
   dotnet run
   

2. 按照提示完成文件选择

   • 首先选择 il2cpp 可执行文件
   • 然后选择 global-metadata.dat 文件

3. 等待解析完成 💡 技巧：解析过程中保持默认配置即可获得基础输出，首次使用建议不修改任何参数

4. 查看输出结果 执行成功后，当前目录将生成以下关键文件：

   • dummy 目录：包含还原的 DLL 文件
   • script 目录：包含各类逆向工具脚本
   • il2cpp.h：C++ 头文件，包含所有类型定义

三、高级配置指南：场景化配置方案

3.1 基础配置项详解

配置项	默认值	适用场景
DumpMethod	true	需要分析方法实现逻辑时启用；关闭时仅保留类型结构
GenerateDummyDll	true	需要在 IDE 中查看类型结构时启用；仅需命令行输出时可关闭
RequireAnyKey	true	自动化脚本执行时建议关闭；手动运行时保持开启便于查看结果

3.2 进阶应用配置方案

场景一：深度逆向分析配置

{
  "DumpMethod": true,
  "DumpField": true,
  "DumpProperty": true,
  "DumpAttribute": true,
  "DumpFieldOffset": true,
  "DumpMethodOffset": true,
  "GenerateScript": true
}

此配置会输出完整的方法和字段偏移信息，配合 IDA 脚本可实现函数跳转和交叉引用分析

场景二：快速生成骨架代码

{
  "DumpMethod": false,
  "GenerateDummyDll": true,
  "DummyDllAddToken": true,
  "GenerateScript": false
}

关闭方法细节输出，仅生成类型骨架，适合快速了解项目类结构

3.3 配置文件使用方法

1. 在项目根目录找到 config.json 文件
2. 使用文本编辑器打开并修改配置项
3. 保存后重新运行程序即可应用新配置 💡 技巧：可以创建多个配置文件（如 config_ida.json、config_dll.json），通过命令行参数指定使用哪个配置

四、实用工具与脚本

4.1 IDA 辅助脚本

项目提供的 ida.py 和 ida_with_struct.py 脚本可将解析结果导入 IDA Pro，实现：

• 自动重命名函数和变量
• 恢复结构体定义
• 标记函数参数和返回值类型

使用方法：在 IDA 中通过 File → Script file 加载对应脚本

4.2 Ghidra 集成方案

ghidra.py 和 ghidra_with_struct.py 脚本为 Ghidra 用户提供类似功能，支持最新版本的 Ghidra 10.0+。执行脚本后，类型信息将自动导入到 Ghidra 项目中，大幅减少手动命名工作量。

五、常见问题解决

5.1 版本不匹配问题

当遇到 "il2cpp version not supported" 错误时：

1. 尝试启用 ForceIl2CppVersion 配置
2. 设置 ForceVersion 为目标版本号，如 "2019.4.0" ⚠️ 注意：强制版本可能导致部分信息解析不准确，建议优先使用自动检测

5.2 输出文件过大

当生成的 dummy DLL 体积过大时：

1. 关闭不需要的 Dump 选项
2. 设置 GenerateDummyDll 为 false，仅保留文本输出
3. 使用 DumpTypeDefIndex 选项过滤不需要的类型

通过以上配置和技巧，您可以充分发挥 Il2CppDumper 的强大功能，轻松应对各种 il2cpp 逆向分析场景。无论是游戏 mod 开发还是安全研究，这款工具都能为您提供坚实的技术支持。