Perfare /Il2CppDumper

Unity il2cpp reverse engineer

★ 9,660⑂ 1,971👁 159⑃ 74● 827▤ 97
C#MITCreated 2016-12-30
More from this author
Download: Il2CppDumper v6.7.46Il2CppDumper-6.7.46 ↓6.7.462024-07-06
+7
Daily
9,660
stars
1,971
forks
159
watchers
74
prs
827
issues
97
releases

README

Il2CppDumper



中文说明请戳这里

Unity il2cpp reverse engineer

 Features

 Complete DLL restore (except code), can be used to extract MonoBehaviour and MonoScript
 Supports ELF, ELF64, Mach-O, PE, NSO and WASM format
 Supports Unity 5.3 - 2022.2
 Supports generate IDA, Ghidra and Binary Ninja scripts to help them better analyze il2cpp files
 Supports generate structures header file
 Supports Android memory dumped libil2cpp.so file to bypass protection
 Support bypassing simple PE protection

 Usage

Run Il2CppDumper.exe and choose the il2cpp executable file and global-metadata.dat file, then enter the information as prompted

The program will then generate all the output files in current working directory

 Command-line


Il2CppDumper.exe   


 Outputs

 DummyDll

Folder, containing all restored dll files

Use dnSpy, ILSpy or other .Net decompiler tools to view

Can be used to extract Unity MonoBehaviour and MonoScript, for UtinyRipper, UABE

 ida.py

For IDA

 ida_with_struct.py

For IDA, read il2cpp.h file and apply structure information in IDA

 il2cpp.h

structure information header file

 ghidra.py

For Ghidra

 Il2CppBinaryNinja

For BinaryNinja

 ghidra_wasm.py

For Ghidra, work with ghidra-wasm-plugin

 script.json

For ida.py, ghidra.py and Il2CppBinaryNinja

 stringliteral.json

Contains all stringLiteral information

 Configuration

All the configuration options are located in config.json

Available options:

 DumpMethod, DumpField, DumpProperty, DumpAttribute, DumpFieldOffset, DumpMethodOffset, DumpTypeDefIndex
   Whether to output these information to dump.cs

 GenerateDummyDll, GenerateScript
   Whether to generate these things

 DummyDllAddToken
   Whether to add token in DummyDll

 RequireAnyKey
   Whether to press any key to exit at the end

 ForceIl2CppVersion, ForceVersion
   If ForceIl2CppVersion is true, the program will use the version number specified in ForceVersion to choose parser for il2cpp binaries (does not affect the choice of metadata parser). This may be useful on some older il2cpp version (e.g. the program may need to use v16 parser on il2cpp v20 (Android) binaries in order to work properly)

 ForceDump
   Force files to be treated as dumped

 NoRedirectedPointer
   Treat pointers in dumped files as unredirected, This option needs to be true for files dumped from some devices

 Common errors

 ERROR: Metadata file supplied is not valid metadata file.  

Make sure you choose the correct file. Sometimes games may obfuscate this file for content protection purposes and so on. Deobfuscating of such files is beyond the scope of this program, so please DO NOT file an issue regarding to deobfuscating.

If your file is libil2cpp.so and you have a rooted Android phone, you can try my other project Zygisk-Il2CppDumper, it can bypass this protection.

 ERROR: Can't use auto mode to process file, try manual mode.

Please note that the executable file for the PC platform is GameAssembly.dll or Assembly.dll

You can open a new issue 

Top issues

Latest release

Il2CppDumper v6.7.46 v6.7.46 2024-07-06

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON