Il2CppDumper 实战指南：从零还原 Unity 游戏类型结构的完整链路

Il2CppDumper 实战指南从零还原 Unity 游戏类型结构的完整链路【免费下载链接】Il2CppDumperUnity il2cpp reverse engineer项目地址: https://gitcode.com/gh_mirrors/il/Il2CppDumper打开一个 Unity 手游的 APKlib目录下躺着几十 MB 的libil2cpp.soassets/bin/Data/里还有个神秘的global-metadata.dat——但你翻遍整个包也找不到熟悉的Assembly-CSharp.dll。用反编译软件去撞.so文件看到的只有一排排机器码。Il2CppDumper正是为破解这道C# 变原生码的谜题而生的开源工具它能把这两个二进制文件翻译回一份结构清晰的类型清单让后续分析从猜变成看。本文以该项目为主线带新手走完一条完整可复现的实战链路。一、先想明白IL2CPP 到底把 C# 藏到了哪里在动手之前先建立一个心智模型否则后面遇到报错会一头雾水。Unity 的 IL2CPP 编译流程可以类比成翻译 搬家C# 源码先被编译成中间语言IL再由 il2cpp 编译器转成 C 代码最终编译进平台的原生二进制。与此同时程序集里的类型、字段、方法签名、字符串字面量等元信息被单独打包进global-metadata.dat而方法体则编译成了libil2cpp.soAndroid/iOS 为 Mach-OWindows 为GameAssembly.dll里的原生函数。 结论很关键元数据与代码是分离的。Dummy DLL伪程序集只能还原有什么类、类里有什么成员不含方法实现想看逻辑必须把类型信息映射回原生二进制再交给 IDA/Ghidra 反汇编。二、环境准备拿到工具与两份原料用途工具/文件说明核心解析Il2CppDumper跨平台Windows 直接运行 exeLinux/macOS 可用 .NET 运行时执行查看 DLLdnSpy 或 ILSpy浏览生成的 Dummy DLL反汇编IDA Pro / Ghidra配合生成的脚本分析原生代码原料一libil2cpp.so 等可执行文件ELF/Mach-O/PE/NSO/WASM 均可原料二global-metadata.dat从 assets 目录提取# 获取项目源码或直接下载已发布版本 git clone https://gitcode.com/gh_mirrors/il/Il2CppDumper⚠️平台差异提醒PC 平台的可执行文件是GameAssembly.dll或*Assembly.dll不是libil2cpp.soAndroid 是 ELFiOS 是 Mach-OSwitch 平台还可能是 NSO。项目源码中Il2CppDumper/ExecutableFormats/目录下按格式分别实现了对应解析器遇到识别问题可对照检查。三、首个完整案例Android APK 的类型还原场景从game.apk中提取两份文件完成第一次成功解析。第一步解包并定位关键文件7z x game.apk -oextracted_apk ls extracted_apk/lib/arm64-v8a/libil2cpp.so ls extracted_apk/assets/bin/Data/global-metadata.dat第二步确认配置项目根目录的config.json控制了所有输出开关新手保持默认即可{ GenerateDummyDll: true, DumpMethod: true, DumpField: true, DumpAttribute: true, GenerateStruct: true }各开关含义集中在Il2CppDumper/Config.cs中定义DumpMethod/DumpField控制 dump.cs 是否输出成员信息GenerateDummyDll决定是否生成伪 DLLDummyDllAddToken决定是否写入元数据 token。第三步命令行解析Il2CppDumper.exe libil2cpp.so global-metadata.dat output程序按 执行文件 → 元数据 → 输出目录 三个参数执行。源码入口在Il2CppDumper/Program.cs先初始化 Metadata校验魔数0xFAB11BAF与版本号再识别可执行文件魔数决定解析器随后自动搜索CodeRegistration与MetadataRegistration完成映射。✅预期产物输出目录下DummyDll/—— 还原的全部程序集用 dnSpy 打开即可浏览dump.cs—— 类型/字段/方法/偏移的纯文本清单il2cpp.h—— 结构体头文件script.json—— 供 IDA/Ghidra/Binary Ninja 脚本使用第四步验证用 dnSpy 打开DummyDll/Assembly-CSharp.dll在左侧树里按命名空间找到PlayerController之类的业务类检查字段与方法签名是否齐全。dump.cs里还能看到每个字段的偏移量——这些偏移正是后续动态调试的定位依据。 原理点睛Dummy DLL 是空壳——只有签名、没有方法体。它的价值在于让分析者快速摸清程序集结构与成员布局再以此为索引回到原生代码中定位实现。四、进阶疑难解析报错与加密 metadata 的绕过报错一Metadata file supplied is not valid metadata file.这是新手最常撞上的墙。它出自Il2CppDumper/Il2Cpp/Metadata.cs的魔数与版本双重校验文件头不是0xFAB11BAF或版本号不在 16–31 区间都会直接抛错。出现该提示通常意味着 metadata 被加密或混淆了。绕行思路用 x64dbg 或 GameGuardian 附加游戏进程在il2cpp::metadata::Init处下断等其解密后从内存中 dump 出真正的 metadata对 Android 设备也可借助基于 Zygisk 的方案直接从内存提取libil2cpp.so。报错二This file may be protected.工具检测到libil2cpp.so本身被加壳。对策一致内存 dump 优先。从游戏内存中 dump 出运行时的libil2cpp.so再用 Il2CppDumper 加载。{ ForceDump: true, NoRedirectedPointer: false }加载 dump 文件时程序会提示输入 dump 地址输入 0 强制继续。ForceDump强制按 dump 文件处理部分设备 dump 出的文件指针未重定向需将NoRedirectedPointer置为true。报错三Cant use auto mode to process file, try manual mode.自动搜索失败时会退入手动模式要求你输入两个十六进制地址CodeRegistration与MetadataRegistration。这两个地址对应元数据注册结构在内存中的位置通常需要配合 IDA 在il2cpp_codegen_register的调用点处分析得到。⚠️版本不匹配也常见IL2CPP 格式随 Unity 版本迭代。若解析结果异常可在 config 中强制指定解析器版本{ ForceIl2CppVersion: true, ForceVersion: 24.3 }五、高级玩法让反汇编器开眼的脚本导入类型信息还原后真正的高价值操作是把它们灌进反汇编器。项目输出目录自带四个脚本脚本适用工具作用ida.pyIDA Pro标注函数名与调用关系ida_with_struct.pyIDA Pro额外读取il2cpp.h应用结构体ghidra.pyGhidra批量打标签Il2CppBinaryNinja插件Binary Ninja插件化集成以 Ghidra 为例先导入libil2cpp.so完成自动分析再File - Script Manager运行ghidra.py。导入后之前一大片FUN_xxxx会被替换成PlayerController::Move这类可读名称函数参数也会自动套用结构体类型反编译可读性直接上一个台阶。扩展阅读希望把解析过程嵌入自己的自动化流水线如批量分析多个 APK可参考Il2CppDumper/Utils/Il2CppExecutor.cs它把解析 输出封装成了可程序化调用的执行器。六、问答式避坑手册Q1Dummy DLL 里为什么看不到方法实现A设计使然。它只含类型与签名方法体在原生二进制里。正确姿势是DLL 看结构、反汇编看实现。Q2dump 出来的文件还是解析失败A先确认 dump 时机是否正确要等 metadata 解密后再检查指针重定向选项NoRedirectedPointer最后核对 Unity 版本与ForceVersion是否匹配。Q3Windows 平台该选哪个文件APC 端选GameAssembly.dll或*Assembly.dll不是.so。文件格式直接影响魔数识别路径。Q4metadata 魔数正常但仍报版本不支持A说明版本号越界如未来新版本。升级 Il2CppDumper 到最新版或等待项目跟进支持——这类问题通常会在仓库更新中解决。Q5所有保护都能靠内存 dump 绕开吗A不能一概而论。内存 dump 能绕过大部分常见加壳但遇到运行时完整性校验等更强保护时仍需结合动态调试人工处理。七、写在最后工具是起点理解才是终点回顾这条链路解包提取两份文件 → Il2CppDumper 还原类型 → dnSpy 浏览结构 → 反汇编脚本辅助定位逻辑。每一步都有明确产物与验证方式这正是新手建立信心的最佳路径。往深走你可以进一步研究Il2CppDumper/Il2Cpp/Metadata.cs中的元数据布局、ExecutableFormats/下的各平台解析实现甚至为加密变种编写自己的解析补丁——项目的源码本身就是一份极佳的 IL2CPP 内部格式教材。合规声明本文所有内容仅供学习研究使用请务必在合法合规的前提下开展逆向分析尊重软件使用条款与相关法律法规。工具只是起点真正有价值的是你对二进制世界运行规律的理解。【免费下载链接】Il2CppDumperUnity il2cpp reverse engineer项目地址: https://gitcode.com/gh_mirrors/il/Il2CppDumper创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考