Ghidrust provides a hyper fast, AI native reverse engineering platform built in Rust, inspired by Ghidra. Includes experimental GPU kernels to rapidly decompile large files, a decryption suite, and network monitor for packet to binary reverse engineering.
IL2CPP + Unity inventory (Ghidrust)
Hand-rolled support for Unity IL2CPP metadata and player-install inventory. No Il2CppDumper, Cpp2IL, or goblin at runtime.
Commands
ghidrust strings <path> [--raw] [--match substr|token|whole|glob] [--limit N] [--out FILE]
ghidrust bytes <path> --addr HEX [--count N] [--out FILE] [--json]
ghidrust il2cpp meta <global-metadata.dat> [--filter SUB] [--json] [--out FILE]
ghidrust il2cpp map --binary <GameAssembly.dll> --meta <metadata.dat>|--meta-sections DIR
[--baseline PREV.json] [--baseline-strict] [--script-json]
ghidrust il2cpp touch-map --meta PATH|--meta-sections DIR --filter SUB [--binary PE] [--json]
ghidrust il2cpp stubs --binary <GameAssembly.dll> [--filter SUB]
ghidrust il2cpp icalls --binary <UnityPlayer.dll> [--filter SUB] [--json] [--out FILE]
ghidrust xrefs … [--skip-stubs] [--classify] [--out FILE]
ghidrust disasm … [--out FILE]
ghidrust decompile … [--follow-stub] [--out FILE]
ghidrust unity-inventory <player-dir> [--json]
Meta-sections directory
When a clear monolithic global-metadata.dat is available (or decrypted offline), pass it with --meta, or point --meta-sections DIR at a folder that contains one of:
| Candidate | Notes |
|---|---|
DIR/global-metadata.dat |
Preferred clear dump |
DIR/metadata.dat |
Alternate filename |
DIR/global-metadata.dat.decrypted |
Explicit decrypted alias |
DIR/Metadata/global-metadata.dat |
Nested Metadata folder |
DIR/il2cpp_data/Metadata/global-metadata.dat |
Unity player layout fragment |
DIR/*_Data/il2cpp_data/Metadata/global-metadata.dat |
One-level player-data scan |
Ghidrust does not reassemble encrypted or v39+/v106 sectioned heaps. Place a clear 0xFAB11BAF file in the directory. Wrong magic → fail closed with next_steps (includes touch-map / meta-sections).
Touch-map + body proof
il2cpp touch-map searches metadata string heaps for --filter and classifies rows as method|field|type|property|other. With --binary, proven method pointers upgrade confidence to rva_bound.
il2cpp map fingerprints each resolved VA:
body_class:thin_thunk|shared_stub|empty_xor_al_ret|bool_bit_test|complex|unreadable|runtime_unresolvedshared_stubs[]aggregate when many names collapse to one tiny bodysemantics_mismatchwhenget_/set_/is*/has*names disagree with stub/empty bodies
--baseline PREV.json emits build_skew: { moved, missing, appeared, sample }. --baseline-strict exits nonzero if any RVA moved.
Engine icall resolve (name‖fn tables)
Unity engine PEs often store parallel pointer arrays: one of C-string name VAs (Namespace.Type::method / *_Injected) and one of code VAs. After Create Address Tables (stitched runs with DataPtrs / CodePtrs roles):
ghidrust strings <engine.dll> --filter <ICallNameFragment> --json
ghidrust xrefs <engine.dll> --to <name_string_va> --json # hits rdata pointer slots
ghidrust il2cpp icalls --binary <engine.dll> --filter <ICallNameFragment> --json
ghidrust bytes <engine.dll> --addr <fn_va> --count 64 --json
ghidrust disasm <engine.dll> --addr <fn_va> --count 20 --json
il2cpp icalls never invents RVAs: it only emits pairs when a name table of length N sits adjacent to a code table of length N. Ambiguous multi-table hits are returned as candidates with confidence.
Resolve stubs vs real callers
GameAssembly resolve thunks (LEA name → resolve → store slot → jmp reg) are lazy. Prefer:
ghidrust xrefs GA.dll --to HEX --skip-stubs --classify --json
ghidrust il2cpp stubs --binary GA.dll --filter <ICallNameFragment> --json
ghidrust decompile GA.dll --addr <stub_va> --follow-stub --json
--follow-stub reports follow_stub.status = runtime_unresolved when the slot is still zero (filled at runtime). Filter matches parsed icall_name or the C-string at name_string_va.
MCP tools
Launch: ghidrust mcp (or target/release/ghidrust.exe mcp after build). Stdio JSON-RPC; no host-specific paths required.
| Tool | Args | Purpose |
|---|---|---|
il2cpp_meta |
path, optional filter |
Parse global-metadata.dat → types/methods |
il2cpp_map |
binary, meta or meta_sections, optional filter, baseline |
Metadata ↔ RVA map + body_class / shared_stubs / optional build_skew |
il2cpp_touch_map |
filter, meta or meta_sections, optional binary |
Substring touch-map over heaps |
il2cpp_stubs |
binary, optional filter, max |
Classify resolve stubs |
il2cpp_icalls |
binary, optional filter |
Engine name‖fn icall tables |
read_bytes |
path, addr, optional count |
Raw VA dump |
unity_inventory |
path |
Player layout inventory (assemblies, plugins, metadata) |
list_strings |
path, optional encoding/filter/match/limit/raw/min |
Blob-capable string scan |
get_xrefs_to |
path, addr, optional skip_stubs/classify |
Data-ptr + stub-aware xrefs |
decompile |
path, optional addr/count/stage/follow_stub |
Follow resolve stub when mapped |
Metadata version matrix
| Metadata version | Dialect | Status |
|---|---|---|
| 27.x | V27 |
supported |
| 29.x | V29 |
supported |
| 31.x | V31 |
supported |
| 24.x family | — | P1 (unsupported error with hint) |
| 39 / 106 | — | P1 (sectioned / variable-width) |
Magic must be 0xFAB11BAF. Wrong magic → fail closed. CLI/MCP JSON:
{
"error": "metadata_encrypted_or_obfuscated",
"magic": "0x…",
"next_steps": [
"Use engine PE strings + il2cpp icalls for native internal-call RVAs",
"Treat GameAssembly resolve stubs as lazy thunks, not gameplay callers (xrefs --skip-stubs)",
"Instance/type latch may require live inspection when metadata is unavailable",
"If you have a decrypted dump: il2cpp touch-map --meta PATH|--meta-sections DIR --filter SUB",
"meta-sections DIR expects global-metadata.dat (or clear metadata.dat); section dumps documented in docs/IL2CPP.md"
]
}
Notes
- Managed type/method names live in metadata heaps — use
il2cpp meta, not PE string scans alone. - Method RVAs are emitted only when CodeRegistration-style pointer arrays pass multi-field validation; otherwise
rva: null. - Encrypted/obfuscated metadata is reported with
next_steps, not guessed. unity-inventoryclassifies scripting assemblies and plugins from the player layout (including stock engine XR modules vs XR provider packages when present).- Lone rdata qword pointers to strings are found by
xrefs --to(kindptr), not only by address-table slots.
Fixtures
Synthetic acceptance fixtures (no private game trees):
fixtures/il2cpp/meta_v27.dat
fixtures/il2cpp/meta_v29.dat
fixtures/il2cpp/meta_v31.dat
fixtures/il2cpp/il2cpp_stub_lab.pe
Regenerate: python scripts/gen_il2cpp_fixtures.py
Unity inventory schema
unity-inventory emits schema_version: 1 with scripting assemblies, plugins, metadata peek, engine fingerprint, and optional XR-related fields:
xr_stock_modules/xr_packages/xr_subsystem_manifestsnative_xr_imports/external_vr_indicatorsverdict:none|stock_stubs_only|unity_xr_packaged|external_mod_likely|mixedconfidence:low|medium|high