A high-performance Python port of IL2CPP Dumper, a tool for extracting metadata from Unity IL2CPP compiled games.

• Multi-format support: ELF (Android), PE (Windows), Mach-O (iOS/macOS), NSO (Nintendo Switch), WebAssembly
• Full metadata extraction: Types, methods, fields, properties, events, generics
• Web Interface: Modern UI with Tailwind CSS, real-time console, chunked uploads
• REST API: Full API with SSE streaming for real-time progress
• Output formats:
  • dump.cs - C#-like pseudocode with addresses and offsets
  • il2cpp.h - C header file with struct definitions for IDA/Ghidra
  • script.json - Method addresses for scripting
  • stringliteral.json - String literal data

# Clone the repository
git clone https://github.com/springmusk026/Il2CppDumper-Python.git
cd Il2CppDumper-Python

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venvScriptsactivate

# Install dependencies
pip install -r requirements.txt

python -m il2cpp_dumper_py <il2cpp-binary> <global-metadata.dat> [output-directory]

Example:

python -m il2cpp_dumper_py libil2cpp.so global-metadata.dat ./output

python server.py

Then visit http://localhost:5000 to use the web interface.

See API.md for full documentation.

• IL2CPP versions 16 to 31
• Sub-versions: 24.1, 24.2, 24.3, 24.4, 24.5, 27.1, 27.2, 29.1

Optimized Python implementation with batch operations and caching:

├── server.py                 # Flask web server
├── requirements.txt          # Python dependencies
├── templates/                # HTML templates
│   └── index.html           # Web UI (Tailwind + Alpine.js)
├── static/
│   └── js/app.js            # Frontend JavaScript
├── il2cpp_dumper_py/         # Core dumper package
│   ├── cli.py               # Command-line interface
│   ├── config.py            # Configuration
│   ├── executor/            # Type resolution
│   ├── formats/             # Binary parsers (ELF, PE, Mach-O, NSO, WASM)
│   ├── il2cpp/              # IL2CPP structures and metadata
│   ├── io/                  # Binary stream reading
│   ├── output/              # Output generators
│   ├── search/              # Registration search
│   └── utils/               # Utilities
├── API.md                   # API documentation
├── DEVELOPMENT.md           # Development notes
└── VIBE.md                  # The vibe coding manifesto 🎭

The server uses these default settings:

• Port: 5000
• Max upload size: 500 MB
• Job retention: 30 minutes
• Chunk size: 10 MB

# Run development server
./devserver.sh

# Or manually
source .venv/bin/activate
python -u server.py

MIT License

• Original C# implementation: Perfare/Il2CppDumper
• Python port & web interface: This project
• UI: Tailwind CSS, Alpine.js, Lucide Icons

⚠️ Disclaimer: This tool is for educational and research purposes. Respect game developers' rights and terms of service.