# quangbaong/il2cppdumper_gui_hok architecture

> Architecture diagram of the GitHub repository quangbaong/il2cppdumper_gui_hok, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/quangbaong/il2cppdumper_gui_hok
- Repository: https://github.com/quangbaong/il2cppdumper_gui_hok

## Overview

Il2CppDumper is a desktop tool for analyzing Unity IL2CPP binaries and metadata, then exporting readable code and related artifacts. The principal workflow runs from the GUI into DumpEngine, which loads platform-specific binaries and metadata, resolves registration data, constructs an IL2CPP model, and invokes exporters. Additional branches handle reference-dump enrichment, struct generation, and metadata-only exports. The README gives no capability details; relationships below are limited to those visible in excerpts or SOURCE INDEX references, so unsampled integrations are not expanded.

Main entry points: [`Il2CppDumper/Utils/DumpEngine.cs`](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/DumpEngine.cs) (Dump orchestration), [`Il2CppDumper/Il2Cpp/Il2Cpp.cs`](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2Cpp/Il2Cpp.cs) (IL2CPP model), [`Il2CppDumper/Outputs/Il2CppDecompiler.cs`](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/Il2CppDecompiler.cs) (Code decompiler), [`Il2CppDumper/Outputs/StructGenerator.cs`](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/StructGenerator.cs) (Struct generator)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_input["Input and UI"]
  node_gui["Desktop UI<br/>[MainForm.xaml.cs]"]
  node_engine["Dump orchestration<br/>[DumpEngine.cs]"]
end

subgraph group_analysis["Binary analysis"]
  node_stream["Binary stream<br/>[BinaryStream.cs]"]
  node_formats["Executable readers"]
  node_elf["ELF reader<br/>[Elf.cs]"]
  node_macho["Mach-O reader<br/>[Macho64.cs]"]
  node_section["Section search<br/>[SectionHelper.cs]"]
  node_scanner["Registration scanners"]
  node_methodscan["Method pointer scan"]
end

subgraph group_model["Metadata model"]
  node_metadata["Metadata reader<br/>[Metadata.cs]"]
  node_il2cpp["IL2CPP model<br/>[Il2Cpp.cs]"]
  node_executor["Model executor<br/>[Il2CppExecutor.cs]"]
  node_references["Reference dump importer"]
  node_enricher["Synthetic type enrichment"]
end

subgraph group_exports["Export generation"]
  node_decompiler["Code decompiler"]
  node_structs["Struct generator<br/>[StructGenerator.cs]"]
  node_constants["Export constants<br/>[Il2CppConstants.cs]"]
  node_metadataexport["Metadata-only exports"]
  node_dummy["Dummy assemblies"]
end

subgraph group_integrations["Analysis integrations"]
  node_scripts["Disassembler scripts<br/>[ghidra.py]"]
  node_binja["Binary Ninja support<br/>[__init__.py]"]
end

node_user(("Analyst"))

node_user -->|"uses"| node_gui
node_gui -->|"starts dump"| node_engine
node_engine -->|"loads executable"| node_formats
node_engine -->|"loads metadata"| node_metadata
node_formats -.->|"reads bytes"| node_stream
node_elf -->|"builds sections"| node_section
node_macho -->|"builds sections"| node_section
node_engine -->|"resolves registration"| node_scanner
node_engine -->|"scans pointers"| node_methodscan
node_engine -->|"initializes model"| node_il2cpp
node_il2cpp -->|"gets sections"| node_section
node_il2cpp -->|"uses metadata"| node_metadata
node_engine -->|"loads optional dump"| node_references
node_il2cpp -->|"imports reference data"| node_references
node_il2cpp -->|"enriches model"| node_enricher
node_engine -->|"creates executor"| node_executor
node_engine -->|"generates dump.cs"| node_decompiler
node_engine -->|"generates structs"| node_structs
node_engine -.->|"exports metadata"| node_metadataexport
node_engine -.->|"exports assemblies"| node_dummy
node_decompiler -->|"uses model services"| node_executor
node_decompiler -->|"reads definitions"| node_metadata
node_decompiler -->|"reads binary model"| node_il2cpp
node_decompiler -->|"uses imported data"| node_references
node_decompiler -->|"uses enriched types"| node_enricher
node_structs -->|"uses model services"| node_executor
node_structs -->|"reads definitions"| node_metadata
node_structs -->|"reads binary model"| node_il2cpp
node_structs -->|"uses constants"| node_constants

click node_gui "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Forms/MainForm.xaml.cs"
click node_engine "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/DumpEngine.cs"
click node_stream "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/IO/BinaryStream.cs"
click node_formats "https://github.com/quangbaong/il2cppdumper_gui_hok/tree/main/Il2CppDumper/ExecutableFormats"
click node_elf "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ExecutableFormats/Elf.cs"
click node_macho "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ExecutableFormats/Macho64.cs"
click node_section "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/SectionHelper.cs"
click node_scanner "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/RegistrationScanner.cs"
click node_methodscan "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/MethodPointerScanner.cs"
click node_metadata "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2Cpp/Metadata.cs"
click node_il2cpp "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2Cpp/Il2Cpp.cs"
click node_executor "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/Il2CppExecutor.cs"
click node_references "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/ReferenceDumpImporter.cs"
click node_enricher "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/SyntheticTypeEnricher.cs"
click node_decompiler "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/Il2CppDecompiler.cs"
click node_structs "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/StructGenerator.cs"
click node_constants "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/Il2CppConstants.cs"
click node_metadataexport "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/MetadataOnlyDecompiler.cs"
click node_dummy "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/MetadataOnlyDummyExporter.cs"
click node_scripts "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ghidra.py"
click node_binja "https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2CppBinaryNinja/__init__.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_gui,node_engine toneBlue
class node_stream,node_formats,node_elf,node_macho,node_section,node_scanner,node_methodscan toneAmber
class node_metadata,node_il2cpp,node_executor,node_references,node_enricher toneMint
class node_decompiler,node_structs,node_constants,node_metadataexport,node_dummy toneRose
class node_scripts,node_binja,node_user toneIndigo
```

## Components

### Input and UI

- [Desktop UI](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Forms/MainForm.xaml.cs): `Il2CppDumper/Forms/MainForm.xaml.cs`
- [Dump orchestration](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/DumpEngine.cs): `Il2CppDumper/Utils/DumpEngine.cs`

### Binary analysis

- [Binary stream](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/IO/BinaryStream.cs): `Il2CppDumper/IO/BinaryStream.cs`
- [Executable readers](https://github.com/quangbaong/il2cppdumper_gui_hok/tree/main/Il2CppDumper/ExecutableFormats): `Il2CppDumper/ExecutableFormats`
- [ELF reader](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ExecutableFormats/Elf.cs): `Il2CppDumper/ExecutableFormats/Elf.cs`
- [Mach-O reader](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ExecutableFormats/Macho64.cs): `Il2CppDumper/ExecutableFormats/Macho64.cs`
- [Section search](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/SectionHelper.cs): `Il2CppDumper/Utils/SectionHelper.cs`
- [Registration scanners](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/RegistrationScanner.cs): `Il2CppDumper/Utils/RegistrationScanner.cs`
- [Method pointer scan](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/MethodPointerScanner.cs): `Il2CppDumper/Utils/MethodPointerScanner.cs`

### Metadata model

- [Metadata reader](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2Cpp/Metadata.cs): `Il2CppDumper/Il2Cpp/Metadata.cs`
- [IL2CPP model](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2Cpp/Il2Cpp.cs): `Il2CppDumper/Il2Cpp/Il2Cpp.cs`
- [Model executor](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/Il2CppExecutor.cs): `Il2CppDumper/Utils/Il2CppExecutor.cs`
- [Reference dump importer](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/ReferenceDumpImporter.cs): `Il2CppDumper/Utils/ReferenceDumpImporter.cs`
- [Synthetic type enrichment](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Utils/SyntheticTypeEnricher.cs): `Il2CppDumper/Utils/SyntheticTypeEnricher.cs`

### Export generation

- [Code decompiler](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/Il2CppDecompiler.cs): `Il2CppDumper/Outputs/Il2CppDecompiler.cs`
- [Struct generator](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/StructGenerator.cs): `Il2CppDumper/Outputs/StructGenerator.cs`
- [Export constants](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/Il2CppConstants.cs): `Il2CppDumper/Outputs/Il2CppConstants.cs`
- [Metadata-only exports](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/MetadataOnlyDecompiler.cs): `Il2CppDumper/Outputs/MetadataOnlyDecompiler.cs`
- [Dummy assemblies](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Outputs/MetadataOnlyDummyExporter.cs): `Il2CppDumper/Outputs/MetadataOnlyDummyExporter.cs`

### Analysis integrations

- [Disassembler scripts](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/ghidra.py): `Il2CppDumper/ghidra.py`
- [Binary Ninja support](https://github.com/quangbaong/il2cppdumper_gui_hok/blob/main/Il2CppDumper/Il2CppBinaryNinja/__init__.py): `Il2CppDumper/Il2CppBinaryNinja/__init__.py`

### Other components

- **Analyst**

## Connections

- Analyst → Desktop UI: uses
- Desktop UI → Dump orchestration: starts dump (evidence: `Il2CppDumper/Forms/MainForm.xaml.cs`)
- Dump orchestration → Executable readers: loads executable (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → Metadata reader: loads metadata (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Executable readers → Binary stream: reads bytes (evidence: `Il2CppDumper/ExecutableFormats/MachoFat.cs`)
- ELF reader → Section search: builds sections (evidence: `Il2CppDumper/ExecutableFormats/Elf.cs`)
- Mach-O reader → Section search: builds sections (evidence: `Il2CppDumper/ExecutableFormats/Macho64.cs`)
- Dump orchestration → Registration scanners: resolves registration (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → Method pointer scan: scans pointers (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → IL2CPP model: initializes model (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- IL2CPP model → Section search: gets sections (evidence: `Il2CppDumper/Il2Cpp/Il2Cpp.cs`)
- IL2CPP model → Metadata reader: uses metadata (evidence: `Il2CppDumper/Il2Cpp/Il2Cpp.cs`)
- Dump orchestration → Reference dump importer: loads optional dump (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- IL2CPP model → Reference dump importer: imports reference data (evidence: `Il2CppDumper/Il2Cpp/Il2Cpp.cs`)
- IL2CPP model → Synthetic type enrichment: enriches model (evidence: `Il2CppDumper/Il2Cpp/Il2Cpp.cs`)
- Dump orchestration → Model executor: creates executor (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → Code decompiler: generates dump.cs (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → Struct generator: generates structs (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Dump orchestration → Metadata-only exports: exports metadata
- Dump orchestration → Dummy assemblies: exports assemblies (evidence: `Il2CppDumper/Utils/DumpEngine.cs`)
- Code decompiler → Model executor: uses model services (evidence: `Il2CppDumper/Outputs/Il2CppDecompiler.cs`)
- Code decompiler → Metadata reader: reads definitions (evidence: `Il2CppDumper/Outputs/Il2CppDecompiler.cs`)
- Code decompiler → IL2CPP model: reads binary model (evidence: `Il2CppDumper/Outputs/Il2CppDecompiler.cs`)
- Code decompiler → Reference dump importer: uses imported data (evidence: `Il2CppDumper/Outputs/Il2CppDecompiler.cs`)
- Code decompiler → Synthetic type enrichment: uses enriched types (evidence: `Il2CppDumper/Outputs/Il2CppDecompiler.cs`)
- Struct generator → Model executor: uses model services (evidence: `Il2CppDumper/Outputs/StructGenerator.cs`)
- Struct generator → Metadata reader: reads definitions (evidence: `Il2CppDumper/Outputs/StructGenerator.cs`)
- Struct generator → IL2CPP model: reads binary model (evidence: `Il2CppDumper/Outputs/StructGenerator.cs`)
- Struct generator → Export constants: uses constants (evidence: `Il2CppDumper/Outputs/StructGenerator.cs`)
