Skip to content

Releases: MyDearMoon/il2cpp-Dumper

v1.4.0 - Binary Inspection & Metadata Hardening

Choose a tag to compare

@github-actions github-actions released this 03 Oct 03:31

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 .ipa support.
  • 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.json with 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 TempWorkspace cleanup.
  • 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

Choose a tag to compare

@github-actions github-actions released this 22 Sep 18:36

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 0xFAB11BAF magic in a normalized buffer for seamless downstream compatibility with LibCpp2IL and MoontonDumper.

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 (0xFAB11BAF at 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

Choose a tag to compare

@github-actions github-actions released this 06 Sep 05:47

What's Changed

New Features

  • Moonton Partitioned Metadata Support: Native detection and reconstruction of Moonton / MLBB partitioned metadata (Asset/vwi) into valid IL2CPP v29 global-metadata.dat structures.
  • Resilient Metadata-Only Fallback: Added MetadataOnlyDumper to 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 MetadataNormalizer to automatically detect, align, and strip custom headers or envelope wrappers from non-standard metadata files.

Improvements & Architecture

  • Enhanced Container Extraction: PackageExtractor now supports multi-APK sets (Split APKs, config.arm64_v8a.apk), .xapk, and .apkm bundles 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

Choose a tag to compare

@github-actions github-actions released this 04 Sep 19:11

What's Changed

New Features

  • Game Executable Bootstrapper: Added support for dropping Unity game executables (e.g. Game.exe) directly into Il2CppDumper to automatically locate GameAssembly.dll and global-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 NullReferenceException in Mono.Cecil when generating mscorlib.dll dummy assemblies.
  • Fixed .ctor method declarations being omitted in dump.cs output.
  • 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

Choose a tag to compare

@github-actions github-actions released this 04 Sep 04:58