Repository navigation
Releases: MyDearMoon/il2cpp-Dumper
Releases · MyDearMoon/il2cpp-Dumper
Release list
v1.4.0 - Binary Inspection & Metadata Hardening
What's Changed
New Features
- Binary Inspector: Auto-detects ELF, PE, Mach-O (32/64-bit & Fat binary ARM64 slice extraction), and WASM, with native iOS
.ipasupport. - Metadata Profiles & Validation: Added
MetadataVersionProfile(v16–v31, v1024) with transform-aware validation for repeating XOR and envelope wrappers. - Candidate Scoring: Discovers and ranks multiple metadata candidates by confidence score (0–100).
- Dump Manifest: Automatically writes
dump-manifest.jsonwith SHA-256 hashes, architecture, and exporter provenance.
Improvements & Fixes
- Address Fidelity: Zero fabricated addresses in fallback mode (explicitly emitted as
// RVA: UNKNOWN). - Exporter Hardening: C# keyword sanitization (
@class), collision-free C++ overloaded typedefs, and compile-time struct layout checks. - Safety & Hygiene: Added zip-bomb protection limits and leak-free
TempWorkspacecleanup. - CLI: Added strict validation for
--magic, unbounded--scan-depth 0/all, and--no-open. - Tests: 12 new regression tests (61/61 tests passing).
Full Changelog: v1.3.0...v1.4.0
v1.3.0 - Better Metadata Recovery
What's Changed
New Features
- Metadata Recovery Engine: Upgraded metadata pipeline with
MetadataRecoveryEngine, capable of structurally validating and recovering IL2CPP metadata even when headers have been modified, zeroed, or relocated. - XOR Auto-Detection & Streaming Decryption: Automatically identifies and decrypts metadata protected with 1-byte and 4-byte repeating XOR masks without requiring manual key extraction.
- Tampered & Zeroed Magic Resilience: Automatically scores structural integrity (0–100%) and restores canonical
0xFAB11BAFmagic in a normalized buffer for seamless downstream compatibility withLibCpp2ILandMoontonDumper.
CLI & Diagnostics
- Metadata Fingerprint Registry: Added diagnostic detection for HoYoverse (
MHY\0), byte-swapped big-endian (FA B1 1B AF), and zeroed anti-dump signatures. - Recovery Reporting: CLI completion table now reports the recovery method, confidence score, and recovered XOR keys.
Improvements & Architecture
- 64-Bit Safe Bounds Arithmetic: Hardened offset and size calculations (
(ulong)offset + (ulong)size <= fileLength) against 32-bit integer overflow and malformed fuzz inputs. - Zero-Overhead Fast Path: Canonical metadata (
0xFAB11BAFat offset 0) returns immediately with zero disk copying or performance penalty.
Full Changelog: v1.2.0...v1.3.0
v1.2.0 - Moonton Partitioned Metadata & Resilient Fallback Engine
What's Changed
New Features
- Moonton Partitioned Metadata Support: Native detection and reconstruction of Moonton / MLBB partitioned metadata (
Asset/vwi) into valid IL2CPP v29global-metadata.datstructures. - Resilient Metadata-Only Fallback: Added
MetadataOnlyDumperto gracefully recover and dump all assemblies, types, methods, fields, and strings directly from metadata if binary analysis encounters packed or protected binaries. - Metadata Envelope Normalizer: Added
MetadataNormalizerto automatically detect, align, and strip custom headers or envelope wrappers from non-standard metadata files.
Improvements & Architecture
- Enhanced Container Extraction:
PackageExtractornow supports multi-APK sets (Split APKs,config.arm64_v8a.apk),.xapk, and.apkmbundles with automatic architecture matching. - Comprehensive Test Suite: Added automated tests for normalizers, container extraction, and fallback modes with 34/34 unit tests passing.
Performance & Packaging
- Native single-file ahead-of-time builds for 6 target architectures (Windows x64/arm64, Linux x64/arm64, macOS x64/arm64).
Full Changelog: v1.1.0...v1.2.0
v1.1.0 - Game Executable Bootstrapper & Stability Improvements
What's Changed
New Features
- Game Executable Bootstrapper: Added support for dropping Unity game executables (e.g.
Game.exe) directly into Il2CppDumper to automatically locateGameAssembly.dllandglobal-metadata.dat. - Enhanced CLI UX: Added positional argument support (
Il2CppDumper <binary> <metadata> [output]), shell quote sanitization, and an interactive prompt to open the output folder in File Explorer.
Bug Fixes
- Fixed
NullReferenceExceptionin Mono.Cecil when generatingmscorlib.dlldummy assemblies. - Fixed
.ctormethod declarations being omitted indump.csoutput. - Fixed Spectre.Console markup escaping on paths containing brackets or special characters.
Performance & Packaging
- Native single-file ahead-of-time builds for 6 target architectures (Windows x64/arm64, Linux x64/arm64, macOS x64/arm64).
Full Changelog: v1.0.0...v1.1.0
v1.0.0
Full Changelog: https://github.com/MyDearMoon/il2cpp-Dumper/commits/v1.0.0