中文说明请戳这里
Extract .NET metadata from il2cpp binaries. (types, methods, fields, etc.)
Extraction code is based on Il2CppDumper
- Supports il2cpp binaries in ELF, ELF64, Mach-O, PE and NSO format
- Supports global-metadata version 16 and 19-24
- Extracts .NET metadata including types, fields, properties, methods and attributes
- Supports automated IDA script generation
- rename method
- name and tag metadata
- makefunction to improve ida analysis
- Generates dummy DLLs that can be viewed in .NET decompilers
Run Il2CppDumper.exe
and choose the main il2cpp executable (in ELF, Mach-O or PE format) and global-metadata.dat
file, then select the extraction mode. The program will then generate all the output files in current working directory.
The parameters (CodeRegistration
and MetadataRegistration
) that are passed to il2cpp::vm::MetadataCache::Register()
needs to be manually reverse engineered and passed to the program.
Automatically finds the il2cpp_codegen_register()
function by signature matching and read out the first (CodeRegistration
) and second (MetadataRegistration
) parameter passed to the il2cpp::vm::MetadataCache::Register()
method that will be invoked in the registration function. May not work well due to compiler optimizations.
Matches possible pointers in the data section with some guidance from global-metadata.
Supports metadata version 20 and up
only CodeRegistration
address can be found on metadata version 16
Uses symbols in the il2cpp binary to locate CodeRegistration
and MetadataRegistration
.
Only supports certain Android ELF files.
C# pseudocode. Can be viewed in text editors (syntax highlighting recommended)
Requires IDA and IDAPython. Can be loaded in IDA via File -> Script file
.
DLLs generated by Mono.Cecil which contain the .NET metadata extracted from the binary (no code included). Can be viewed in .NET decompilers.
All the configuration options are located in config.json
Available options:
-
DumpMethod
,DumpField
,DumpProperty
,DumpAttribute
,DumpFieldOffset
,DumpMethodOffset
,DumpTypeDefIndex
- Whether or not the program should extract these information
-
DummyDll
- Whether or not the program should generate dummy DLLs
-
ForceIl2CppVersion
,ForceVersion
- If
ForceIl2CppVersion
istrue
, the program will use the version number specified inForceVersion
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 ilcpp v20 (Android) binaries in order to work properly)
- If
The specified global-metadata.dat
is invalid and the program cannot recognize it. 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.
Try other extraction modes.
If all automated extraction modes failed with this error and you are sure that the files you supplied are not corrupted/obfuscated, please file an issue with the logs and sample files.
His git: https://github.com/morelli690/