Repo brief: Perfare/Il2CppDumper

Generated by RepoPilot · document generated 2026-09-17 · concise human review Evidence snapshot · analyzed 2026-09-17T03:09:21.483Z · commit 4741d46ba9cd

Verdict

Mixed — Stale — last commit 2y ago

• 12 active contributors
• MIT licensed

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Il2CppDumper is a reverse engineering tool for Unity's il2cpp runtime that reconstructs .NET assemblies from compiled il2cpp executables. It parses both the il2cpp binary (ELF, Mach-O, PE, NSO, WASM formats) and the global-metadata.dat file to recover class definitions, methods, fields, and properties, then outputs restored DLLs and IDA/Ghidra/Binary Ninja analysis scripts. Modular single-project architecture: ExecutableFormats/ handles binary parsing (ELF, Mach-O, PE, NSO, WASM classes); Il2Cpp/ contains metadata and il2cpp structure parsing (Metadata.cs, Il2Cpp.cs); Outputs/ generates artifacts (DummyAssemblyExporter, StructGenerator, IL decompiler); Extensions/ provides utilities…

Start here

Open these first:

• Il2CppDumper/Program.cs — Main entry point orchestrating the entire dump workflow; all execution flows start here
• Il2CppDumper/Il2Cpp/Il2Cpp.cs — Core Il2Cpp binary parsing engine that extracts metadata and reconstructs type information
• Il2CppDumper/Il2Cpp/Metadata.cs — Parses global-metadata.dat file structure; critical for extracting all assembly metadata
• Il2CppDumper/ExecutableFormats/ElfBase.cs — Abstract base for executable format handlers; defines interface for all binary file parsers
• Il2CppDumper/Outputs/Il2CppDecompiler.cs — Generates human-readable IL code and reconstructs DummyDll assemblies from parsed metadata

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/Perfare/Il2CppDumper.git
cd Il2CppDumper
dotnet build Il2CppDumper.sln
# Then run: Il2CppDumper/bin/Debug/Il2CppDumper.exe <executable> <global-metadata.dat> <output-dir>

Daily commands:

# GUI mode (default):
Il2CppDumper.exe
# CLI mode:
Il2CppDumper.exe <executable-file> <global-metadata.dat> <output-directory>

Configuration via config.json in working directory (DumpMethod, GenerateDummyDll, ForceIl2CppVersion, etc.).

Key cautions & unknowns

• Stale — last commit 2y ago
• Single-maintainer risk — top contributor 84% of recent commits
• 1. Version-specific parsing: Il2Cpp format changed significantly across Unity versions; ForceIl2CppVersion config option required for older Android binaries—mismatching parser version causes silent struct…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.