universal-asset-ripper
Detects Delphi applications and extracts Delphi .dfm form resources from Windows PE files.
Enables extraction from Electron applications, including app.asar archives and Chromium resources.pak files.
Detects .NET applications and supports IL2CPP metadata analysis via Cpp2IL for Unity games.
Provides detection and asset extraction for Unity games, including IL2CPP global-metadata.dat analysis and export via AssetRipper headless web mode.
Supports Unreal Engine PAK and IoStore container inspection and extraction, including native .pak index parsing, AES-256 decryption, and categorized asset extraction.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Universal Asset Ripper
π Overview
Universal Asset Ripper is an engine-agnostic extraction and binary reverse engineering platform designed for game developers, modders, and security researchers. It seamlessly bridges native binary format parsers with AI pair-programming agents via the Model Context Protocol (MCP) and integrates into an advanced software reverse engineering (SRE) toolchain.
Whether analyzing Godot archives, Unreal Engine IoStore/PAK containers, Unity IL2CPP metadata, or desktop Windows PE executables, Universal Asset Ripper provides lightning-fast heuristic detection, categorized asset inventories, targeted extraction, and deep binary entropy inspection for cryptographic keys.
Related MCP server: REA (Reverse Engineer Anything)
π― Features
π Automatic Engine & Framework Detection (
ripper detect) :Heuristics and signature analysis for Unity, Unreal Engine, Godot and Electron (engine
electronwhen anapp.asar/resources.paksits next to an Electron executable).Application framework detection (Delphi, .NET, Electron, Qt, Native C/C++); the PE framework info is kept in
details.framework.PE header architecture analysis (x86, x64, ARM64) and encryption flagging.
π¦ 100% Native Pure TypeScript Parsers :
Godot PCK : Zero-dependency parser for standalone
.pckpackages and embedded executables (GDPCmagic) supporting format versions 1 through 4.Unreal
.pakindex (v1-v11) : lists and extracts stored, Zlib and Gzip entries natively, with AES-256 (ECB) decryption of the index and of entries (--aes-key, hex with/without0xor base64). Oodle and other codecs, and anything the native reader cannot parse, fall back to therepakCLI.Electron :
app.asar(incl..unpackedfiles) and Chromiumresources.pak(v3/v4/v5, extracted asres_<id>.<ext>, extension guessed from magic numbers - heuristic).Godot encrypted PCK : directory and per-file AES-256-CFB decryption with the script encryption key (
--aes-key, 64 hex chars);--convertwrites.ctex/.stexthat wrap a plain PNG/WebP as images.Windows PE (.rsrc) : Complete multi-resolution
.icoicon reconstruction, Delphi.dfmform extraction, Win32 dialog template decoding (RT_DIALOGβ JSON with title + every control label β DLGTEMPLATE and DLGTEMPLATEEX incl. the01 00 ff ffcompiled header order), XML manifests, bitmaps, and rawRCDATA.
π Asset Manifest & Inspection (
ripper inspect) :Full cataloging across unified categories: textures, 3D meshes, audio, scenes, scripts, shaders, fonts, videos, and manifests.
π Unreal IoStore containers (
.utoc/.ucas, UE 4.26+ / UE 5) : Native TOC reader (versions 1-8: chunk table with 40-bit offsets, compression blocks, method names, signatures, directory index) with file listing and chunk extraction (stored/Zlib/Gzip). Oodle and custom codecs are reported as unsupported (no game-side decoder). The same.utocsupport flows through the genericripper inspect/ripper extractCLI commands and MCP tools.πΌοΈ Unreal texture decoding (
--convert) : After extraction, cooked UE 4.26-4.27 packages (.uasset+.uexp+.ubulk/.uptnl) are parsed forTexture2Dexports and their mips are decoded to PNG: uncompressed layouts (BGRA/RGBA/R8/A8/RGB565/4444), DXT1/BC1, DXT5/BC3, BC4, BC5 (normal-map Z rebuilt), BC6H (HDR half-float, tone-mapped to sRGB) and BC7 β all 8 BPTC modes, verified against the Khronos specification's worked examples. Unreal 5 packages and unversioned-properties packages are refused with a clear error.β Authenticode signature report (
ripper audit) : Every audited binary gets its certificate table read (security directory,WIN_CERTIFICATEentries), its embedded PKCS#7 parsed (signer, certificates, digest and signature algorithms, timestamp / nested-signature attributes listed), the Authenticode file hash recomputed per spec (checksum and security directory entry excluded) and compared to the signed digest, and the signature verified natively (RSA / ECDSA vianode:crypto) against the embedded signer certificate. Embedded chain links are checked without any trust store β real-world binaries embed signer + intermediate CA but never the root, so an incomplete embedded chain is the norm, reported as such.β‘ Targeted & Secure Extraction (
ripper extract) :Zip Slip / Path Traversal Protection : Strict path resolution validation across all archive extractors (Unreal
.pak, IoStore.utoc/.ucas, Godot.pck, Electron.asar, Chromium.pak, and PE resources). Destination paths are verified to reside strictly inside the target output directory (isRelativeTo/assertSafeOutputPath), rejecting any traversal attempt withSecurityError("Tentative de Path Traversal dΓ©tectΓ©e dans l'archive").Category filtering (
--categories texture,audio,mesh) and regex/glob filename filtering (--filter).AES-256 keys (
--aes-key <key>) for Unreal.pakand Godot PCK;--convertfor Godot textures and Unreal textures; Unity export through AssetRipper headless web mode (ASSETRIPPER_PATH).
π€ AI-Assisted Binary Analysis (
ripper rea-inspect) :Complete vendored morluto/rea engine (v6.8.0) under
rea/with native bridges (Ghidra, Jadx, Hopper, Cutter, Swift LLDB/UI) and direct execution (npm run rea).Automated upstream sync tool (
npm run sync:rea:checkandnpm run sync:rea) to track future releases ofmorluto/reaand keep vendored source and agent skills updated automatically.Official agent skills in
.zcode/skills/:reverse-engineer-anything(35 KB master skill with 7 domain guides for native SRE, Android, runtime observation, environments),leanrea, andclean-room-port.The whole file is scanned in overlapping chunks; false positives are filtered (hex runs longer than 64, counting tables, low entropy, repeated blocks) and counts are reported honestly (
N candidates, showing M).--pak <file>verifies every candidate against an Unreal pak (verified keys first);--bundle <file>saves the evidence bundle;--jsonprints scan + bundle.Sliding-window Shannon entropy scanning to spot 256-bit encryption keys.
Proximity search around Rijndael S-Box lookup tables (
0x63, 0x7c, 0x77, 0x7b...).Header sniffing and version validation for Unity IL2CPP
global-metadata.dat.Automated generation of structured Evidence Bundles formatted for AI agents.
π Integrated Model Context Protocol (MCP) Server (
ripper mcp) :Exposes extraction, inspection, and scanning tools over standard I/O for Claude Code, Gemini CLI, Cursor, and Antigravity.
π¨ Downstream Modding Pipeline Ready :
Feeds extracted assets and decrypted structures directly into generative game modding frameworks such as rehan-remade/universal-modder (fal.ai / ComfyUI asset replacement and in-game testing).
𧬠Clean-Room Reimplementation Workflow
The PE recon capabilities power a proven inventory β port pipeline for installed Windows software (observation only β resources, built-in usage, embedded help; never decompilation):
ripper detect/ripper extractover the installation β dialog, string and help inventories (the feature map)capture the CLI tools' built-in usage text (authoritative)
write a precise inventory document (executables, DLLβOSS mapping, windows, options, coverage statuses)
clean-room port (e.g. Rust) verified against an in-process mock server
Packaged as the clean-room-port skill (.zcode/skills/ in this
repository), documented in
docs/workflow-clean-room-reimplementation.md.
Worked examples:
the Bitvise SSH Client port β CLI + egui GUI + Bitvise option compatibility β in
bitvise-rs/, with its precise inventory.the Notepad++ port β
npp-core+npp-cli+npp-gui(multi-tab editor, line endings, encodings, search) in modern Rust 1.99.1 (d:\git\notepadpp-rs), with its inventory.
ποΈ Architecture
ββββββββββββββββββββββββββββββββββ
β Universal Asset Ripper β
β (CLI & MCP stdio Server) β
ββββββββββββββββ¬ββββββββββββββββββ
β
ββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββββ
βΌ βΌ
[ EngineDetector Engine ] [ ReaBridge & AI Hub ]
(Unity, Unreal, Godot, Electron, PE) (BinaryScanner, Shannon Entropy,
β AES-256 discovery, Evidence)
ββββββββββββββΌβββββββββββββ¬βββββββββββββ β
βΌ βΌ βΌ βΌ ββββββββββββββΌβββββββββββββ
[ Godot ] [ Unreal ] [ Unity ] [ PE Soft. ] βΌ βΌ βΌ
Adapter Adapter Adapter Adapter [ Ghidra ] [ Cpp2IL ] [ Frida ]
(Native (repak / (AssetRipper (Resource (Native SRE (IL2CPP -> (Runtime
PCK reader) CUE4Parse) CLI bridge) Extractor) Decompiler) C# .NET) Hooking)π Installation & Quick Start
Prerequisites
Node.js >= 22.0.0
npm >= 10.0.0
Global CLI Installation
Clone and build the repository locally:
git clone https://github.com/laurentvv/universal-asset-ripper.git
cd universal-asset-ripper
npm install
npm run build
npm linkVerify your installation:
ripper --helpπ» CLI Usage
1. Detect Game Engine & Framework
Inspect any folder, game directory, or executable:
ripper detect "C:/Games/MyGame"
# Or point directly to an executable:
ripper detect "C:/Games/MyGame/MyGame.exe"2. Inspect Package Manifest
Display categorized file counts and size breakdowns without writing to disk:
ripper inspect "C:/Games/MyGame/game.pck"
# Encrypted Unreal pak index / Godot directory: pass the key
ripper inspect "PakChunk0.pak" --aes-key 0x4A6B... --json3. Extract Assets
Extract all assets or filter by specific categories:
# Full extraction
ripper extract "C:/Games/MyGame" -o "./extracted"
# Extract only textures and audio files
ripper extract "C:/Games/MyGame" -o "./extracted" --categories texture,audio
# Extract Unreal PAK with AES key
ripper extract "C:/Games/MyGame/Content/Paks/PakChunk0.pak" -o "./extracted" --aes-key 0x4A6B...
# Godot: convert PNG/WebP-backed .ctex/.stex textures to images
ripper extract game.pck -o ./extracted --convert
# Electron app (app.asar and resources.pak)
ripper extract "C:/Apps/MyElectronApp" -o ./extracted
# Unity: needs AssetRipper.GUI.Free; set ASSETRIPPER_PATH (file or folder) or add it to PATH
ripper extract "C:/Games/UnityGame" -o ./extracted4. Deep Binary Inspection (AI Evidence Bundle)
Scan an executable for cryptographic keys, S-Box constants, and IL2CPP metadata:
ripper rea-inspect "C:/Games/MyGame/Game-Win64-Shipping.exe"
# Verify candidates against a pak, save the evidence bundle, machine-readable output
ripper rea-inspect Game-Win64-Shipping.exe --pak Content/Paks/PakChunk0.pak --bundle ./evidence.json
ripper rea-inspect Game-Win64-Shipping.exe --json # { scan, bundle }5. Multi-Engine Disassembly & Decompilation
Drive GNU Binutils, NSA Ghidra, Cutter/Rizin, Hopper, and IDA Pro:
# List all 5 decompiler engines and readiness status
ripper decompilers
# Disassemble binary machine code (Intel syntax with opcodes & offsets)
ripper disasm "C:/Program Files/Notepad++/notepad++.exe" -n 50
# Dump symbols, functions, and imported DLL APIs
ripper symbols "C:/Program Files/Notepad++/notepad++.exe" --filter "Create"
# Decompile a function to C pseudocode with Ghidra
ripper decompile "target.exe" -f "MainEntryPoint" --backend ghidra -o ./decompiled.c
# Run setup guide for external engines
npm run setup:decompilers6. Automated Directory Audit & Mandatory Decompilation Pipeline
Point ripper audit (or alias ripper rea-dir) to any application or game directory to automatically launch the full end-to-end recovery pipeline:
# Run full automated audit with mandatory C decompilation (active by default)
ripper audit "C:/Program Files/Notepad++" -o ./audit-results
# Skip decompilation if only performing visual/surface audit
ripper audit "C:/Program Files/Notepad++" -o ./audit-results --no-decompileThe automated auditor detects the engine, scans all primary and sibling executables/DLLs, decompiles entrypoints and exported plugin functions to C via the native headless NSA Ghidra/Sleigh engine (< 900ms per function, zero Java), extracts Win32 dialogs and visual resources, recovers CLI switches and exported plugin APIs, categorizes all configuration models (syntax, themes, autocomplete, function outlines), and writes actionable clean-room recovery recommendations.
See the detailed Decompiler Guide and Complete Functional REA Workflow.
All commands accept --json (pure JSON on stdout).
Honest limitations
The native pak reader was written from the UE / repak format and tested against synthetic paks built by a test writer, not against commercial game archives. Pak v12+, Oodle and Zstd are not handled natively (Oodle goes through
repak, which unpacks whole containers, so it cannot honour--categories/--filter).The IoStore reader follows the same discipline: TOC versions 1-8 with a 144-byte header, tested against synthetic containers (encrypted directory indexes, AES-keyed chunk streams and Oodle blocks stay out of reach without the game's own decoder).
Unreal texture parsing covers UE 4.26-4.27 cooked packages (file version -7, versioned properties). Unreal 5 packages and packages written without property names are refused β reading them needs each game's own type layouts.
The Authenticode reader checks what the file alone can prove: digest match, signature validity against the embedded certificate, and embedded chain links. Windows trust, revocation (CRL/OCSP) and catalog-signed binaries (no embedded signature, e.g. Windows 11
notepad.exe) are out of reach by design.Godot encryption (AES-256-CFB, md5|size|iv|data) follows the engine source but is validated only against our own encryptor.
.ctexconversion lifts plain PNG/WebP payloads only (no WebP-to-PNG re-encoding, no VRAM-compressed textures).AssetRipper is driven through its headless web API (form field
Path); the endpoints are tested with a fake server only, and--categories/--filterare not supported for Unity.Electron: unpacked
resources/appfolders are not listed; Chromium.pakextension guessing is heuristic.Key verification with a plain (unencrypted) pak index can only probe an encrypted entry; otherwise candidates stay
unverifiable.
π€ MCP Server Setup (AI Agents)
Universal Asset Ripper runs as a standard Model Context Protocol (MCP) server over stdio. It connects natively with Claude Code, Gemini CLI, Cursor, and Antigravity.
Add the server to your mcpServers configuration file:
{
"mcpServers": {
"universal-asset-ripper": {
"command": "node",
"args": ["C:/git/universal-asset-ripper/dist/cli/index.js", "mcp"]
}
}
}Restricting file access
By default the MCP tools accept any path. To confine an agent to specific folders, pass --root (repeatable) or set UAR_ALLOWED_ROOTS (path-delimited: ; on Windows, : elsewhere). Every targetPath, binaryPath, pakPath and outputDir must then resolve (symlinks followed) inside one of the roots, otherwise the call returns an error.
"args": ["C:/git/universal-asset-ripper/dist/cli/index.js", "mcp", "--root", "D:/Games", "--root", "D:/Extracted"]Tools Exposed to Agents
Tool Name | Description |
| Run heuristic analysis to detect the game engine, architecture, and container type. |
| Return a complete manifest of files with counts and sizes grouped by category. |
| Extract assets to disk with category filters and optional AES-256 decryption keys. |
| Run Shannon entropy scans, find AES keys (optional |
π¬ Reverse Engineering Ecosystem
Universal Asset Ripper forms the upstream reconnaissance and extraction hub within a comprehensive SRE toolchain:
Tool | Category | Specialty & Role in Pipeline |
Agentic SRE | Autonomous LLM agents consuming Evidence Bundles to plan reverse engineering steps. | |
Static SRE | Deep native disassembly and C pseudocode decompilation (x86/x64/ARM). | |
Unity IL2CPP | Reconstructs executable CIL (.NET) bytecode from | |
Android SRE | Dex-to-Java decompiler for unpacking APK/AAB packages, manifests, and JNI bridges. | |
Dynamic SRE | Runtime memory hooking to capture live AES keys and dump uncompressed asset buffers. | |
Modding Studio | Downstream mod injection, generative AI assets (fal.ai/ComfyUI), and in-game automated testing. |
π Technical Documentation
π‘οΈ Clean-Room Porting Skill
π§ͺ Testing
The test suite validates parser accuracy against synthetically generated binary containers (PE headers, Godot PCK archives, and AES memory blocks):
npm testCheck your environment (Node.js, repak, AssetRipper, rea) with ripper doctor (--json for machine-readable output).
π οΈ Development
npm ci # install
npm run lint # ESLint (flat config, typescript-eslint)
npx tsc --noEmit # type check
npm run build # compile to dist/
npm test # build + vitest
npm run test:coverage # vitest with v8 coverage
npm run clean # remove dist/ and coverage/CI (.github/workflows/ci.yml) runs lint, build and tests on Ubuntu and Windows with Node 22 and 24.
π License
MIT Β© laurentvv
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Scan AI agent skills, MCP server packages and MCP configs before you install them. Static analysis.
Browser-local and CLI static evidence for deployed AI model artifacts.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
CVE lookups (NVD) and dependency-manifest audits (OSV) for AI agents. No API keys.
Related MCP Servers
- AlicenseCqualityBmaintenanceEnables an AI agent to auto-detect a game's engine (Unity, Unreal, Godot, Java, or native) from its files and then inspect, search, and patch the underlying binaries with in-process PE analysis, hex editing, pattern scanning, string extraction, checksums, diffing, and disassembly. Everything runs locally and offline with no cloud dependency or telemetry.10054 npm5MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to inspect and decompile software they have no source for β Android APKs, Electron bundles, .NET assemblies, and Go, Rust or WASM binaries β plus adb device interaction, through a token-guarded Streamable HTTP MCP endpoint, stdio MCP, or a CLI. Ghidra-powered native binary decompilation can be opted in at startup for ELF, PE and Mach-O targets.6Do What The F*ck You Want To Public
- AlicenseNot gradedqualityCmaintenanceEnables AI coding agents to inspect and reverse-engineer large binaries through bounded stdio JSON-RPC 2.0 tools for graph queries, SSA facts, path solving, runtime grounding, and mod scaffolding.1AGPL 3.0
- AlicenseNot gradedqualityCmaintenanceEnables AI agents (and a matching CLI) to inspect native binaries, JavaScript/Electron apps, .NET assemblies, Go/Rust/WASM artifacts, EVM bytecode, SQLite databases, recorded crashes, and websites without source code, explaining how features work and returning the evidence and limitations behind each conclusion. Analysis runs locally, using optional Hopper, Ghidra, or IDA providers for native targets.369,596 npmMIT