Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Tool:Il2CppDumper

From ReverseEngineering.wiki
Tool
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

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