Tool:Il2CppDumper
| On this wiki | Facts · Code · Notes · Topics |
|---|
Il2CppDumper (Perfare, MIT) reads a Unity IL2CPP native binary plus its global-metadata.dat and writes dump.cs, dummy DLLs, script.json and header/IDA/Ghidra scripts that restore type, method and field names and method addresses.
Overview
C# command line tool: Il2CppDumper <executable-file> <global-metadata> <output-directory> (usage text in Program.cs). It parses Format:IL2CPP global-metadata.dat (versions 16 to 31 accepted), detects the native binary format from its first 4 bytes (PE, ELF 32/64, Mach-O thin or fat, NSO, WebAssembly), finds Il2CppCodeRegistration and Il2CppMetadataRegistration, refines the version into sub-versions (24.1-24.5, 27.1, 27.2, 29.1) and exports names and addresses.
What the source shows
- Metadata structs per version:
Il2CppDumper/Il2Cpp/MetadataClass.cs(version gates as[Version(Min, Max)]attributes, sizes computed by reflection). - Native structs:
Il2CppDumper/Il2Cpp/Il2CppClass.cs; version promotion and registration reading:Il2Cpp.cs; pattern search:Utils/SectionHelper.cs; per-format parsers underExecutableFormats/. - Details and facts: see the format page, especially Format:IL2CPP global-metadata.dat#Sub-version detection (version 24) and Format:IL2CPP global-metadata.dat#Finding the registrations in the native binary.
- Dumped memory images (
CheckDump) make it ask for the dump base address; when everything fails it asks for CodeRegistration and MetadataRegistration by hand.
Limits
Unverified: behavior on Unity versions newer than the commit read (metadata versions above 31 are rejected with 'not a supported version'). Games that encrypt or modify the metadata need the decrypted file first; this wiki does not document defeating such protections. Source read, not built or run. Not read: Il2CppInspector (AGPL-3.0).
Code & repositories
- https://github.com/Perfare/Il2CppDumper @
4741d46ba9cd6159c5d853eb9d6fc48b4bfa2b1a· license: MIT
Restores names and addresses from IL2CPP games. Useful without running: Il2CppDumper/Il2Cpp/MetadataClass.cs (metadata structs per version), Il2CppClass.cs (Code/MetadataRegistration, Il2CppType), Il2Cpp.cs (version promotion), Utils/SectionHelper.cs (registration search).
Tested on: source read, not run · checked 2026-10-19; last activity 2024-08-18; Note: the latest release ships binaries; the wiki links only the source, never the binaries