Il2CppDumper：Unity il2cpp逆向工程终极指南

项目介绍

Il2CppDumper是一个专门用于Unity il2cpp逆向工程的开源工具。它能够从il2cpp二进制文件中提取类型、方法、字段等关键信息，支持多种文件格式，包括ELF、ELF64、Mach-O、PE、NSO和WASM。该工具还支持生成IDA和Ghidra脚本，帮助这些专业逆向工具更好地分析il2cpp文件。

核心功能特性

• 还原DLL文件（不包含代码），可用于提取MonoBehaviour和MonoScript
• 支持ELF、ELF64、Mach-O、PE、NSO和WASM格式
• 支持Unity 5.3至2022.2版本
• 生成IDA和Ghidra的脚本，提升逆向分析效率
• 生成结构体头文件
• 支持从内存dump的libil2cpp.so文件以绕过保护
• 支持绕过简单的PE保护

快速开始指南

环境准备

首先克隆项目到本地：

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

基本使用

直接运行Il2CppDumper.exe并依次选择il2cpp的可执行文件和global-metadata.dat文件，然后根据提示输入相应信息。

程序运行完成后将在当前运行目录下生成输出文件。

命令行使用

Il2CppDumper.exe <executable-file> <global-metadata> <output-directory>

输出文件详解

DummyDll

包含所有还原的DLL文件的文件夹，可用于提取Unity的MonoBehaviour和MonoScript，适用于UtinyRipper或者UABE等工具。

IDA相关脚本

• ida.py：用于IDA的基本脚本
• ida_with_struct.py：用于IDA，读取il2cpp.h文件并在IDA中应用结构信息

Ghidra相关脚本

• ghidra.py：用于Ghidra的基本脚本
• ghidra_wasm.py：用于Ghidra，专为WASM文件设计

BinaryNinja支持

• Il2CppBinaryNinja：用于BinaryNinja的插件

其他重要文件

• il2cpp.h：包含结构体的头文件
• script.json：用于IDA和Ghidra脚本的配置文件
• stringliteral.json：包含所有stringLiteral信息的文件

配置文件详解

config.json文件包含以下重要配置项：

• DumpMethod、DumpField、DumpProperty、DumpAttribute、DumpFieldOffset、DumpMethodOffset、DumpTypeDefIndex

  • 控制是否在dump.cs输出相应的内容

• GenerateDummyDll、GenerateScript

  • 控制是否生成这些内容

• DummyDllAddToken

  • 控制是否在DummyDll中添加token

• RequireAnyKey

  • 在程序结束时是否需要按键退出

• ForceIl2CppVersion、ForceVersion

  • 当ForceIl2CppVersion为true时，程序将根据ForceVersion指定的版本读取il2cpp的可执行文件

• ForceDump

  • 强制将文件视为dump文件

• NoRedirectedPointer

  • 将dump文件中的指针视为未重定向的

常见问题解决方案

元数据文件无效错误

如果遇到"Metadata file supplied is not valid metadata file."错误，说明global-metadata.dat已被加密。对于这类问题，建议寻求相关破解论坛的帮助。

自动模式处理失败

当出现"Can't use auto mode to process file, try manual mode."错误时，请注意PC平台的可执行文件通常是GameAssembly.dll或者*Assembly.dll。

文件保护检测

如果Il2CppDumper检测到可执行文件已被保护，建议使用GameGuardian从游戏内存中dump libil2cpp.so，然后使用Il2CppDumper载入并按提示操作，这样可以绕过大部分保护机制。

项目架构解析

核心模块结构

Il2CppDumper项目采用模块化设计，主要包含以下几个核心模块：

• ExecutableFormats：支持多种可执行文件格式的解析
• Il2Cpp：il2cpp文件的核心处理逻辑
• Outputs：各种输出格式的生成器
• Utils：工具类和辅助功能
• Extensions：扩展方法库

文件格式支持

项目支持解析多种平台的可执行文件格式：

• PE格式：Windows平台的GameAssembly.dll
• ELF格式：Android平台的libil2cpp.so
• Mach-O格式：iOS平台的UnityFramework
• NSO格式：Nintendo Switch平台的main
• WASM格式：WebAssembly平台的GameAssembly.wasm

进阶使用技巧

内存转储技术

对于受保护的文件，建议从内存中转储libil2cpp.so文件。这种技术能够有效绕过大多数保护机制，让你的分析工作更加顺畅。

配置优化建议

根据不同的分析需求，合理配置config.json文件可以显著提升工作效率。例如，对于大型项目，可以适当关闭一些不必要的输出选项以减少处理时间。

生态项目集成

Il2CppDumper拥有丰富的生态系统，包括图形化界面版本和移动端支持项目，这些项目使得工具的使用更加便捷和强大。

通过本指南，您将能够充分利用Il2CppDumper的强大功能，在Unity il2cpp逆向工程中取得更好的效果。