# allcoolthingsatoneplace/unrealpaktool architecture

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

- Interactive diagram: https://gitdiagram.com/allcoolthingsatoneplace/unrealpaktool
- Repository: https://github.com/allcoolthingsatoneplace/unrealpaktool

## Overview

UnrealPak is a command-line tool for inspecting, extracting, creating, modifying, and analyzing Unreal Engine .pak archives. The documented workflow is a user invoking the packaged executable with an archive and mode-specific options, then receiving listings, extracted files, reports, or modified archives. The graph separates archive inspection, archive operations, and analysis capabilities. Source excerpts are unavailable, so subsystem relationships below reflect only the README’s documented commands and options.

Main entry points: [`UnrealPak.exe`](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe) (UnrealPak CLI), [`Crypto.json`](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/Crypto.json) (Crypto keys)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inspection["Archive inspection"]
  node_inspect_test["Test archive<br/>[UnrealPak.exe]"]
  node_inspect_list["List contents<br/>[UnrealPak.exe]"]
  node_diff["Compare archives<br/>[UnrealPak.exe]"]
end

subgraph group_operations["Archive operations"]
  node_extract["Extract files<br/>[UnrealPak.exe]"]
  node_create["Create archive<br/>[UnrealPak.exe]"]
  node_mount["Set mount point<br/>[UnrealPak.exe]"]
  node_repack["Repack archive<br/>[UnrealPak.exe]"]
end

subgraph group_analysis["Archive analysis"]
  node_dependencies["Export dependencies<br/>[UnrealPak.exe]"]
  node_audit["Audit files<br/>[UnrealPak.exe]"]
  node_offset["Inspect offsets<br/>[UnrealPak.exe]"]
  node_pix["Generate PIX mapping<br/>[UnrealPak.exe]"]
end

subgraph group_security["Crypto configuration"]
  node_crypto["Crypto keys<br/>[Crypto.json]"]
end

node_user(("Operator"))
node_cli["UnrealPak CLI<br/>[UnrealPak.exe]"]
node_pak["Pak archive"]
node_response["Response file"]
node_destination["Output destination"]
node_report["Report output"]

node_user -->|"invokes"| node_cli
node_cli -->|"runs -Test"| node_inspect_test
node_cli -->|"runs -List"| node_inspect_list
node_cli -->|"runs -Extract"| node_extract
node_cli -->|"runs -Create"| node_create
node_cli -->|"runs -Dest"| node_mount
node_cli -->|"runs -Repack"| node_repack
node_cli -->|"runs -diff"| node_diff
node_cli -->|"exports dependencies"| node_dependencies
node_cli -->|"runs -AuditFiles"| node_audit
node_cli -->|"runs -WhatsAtOffset"| node_offset
node_cli -->|"generates mapping"| node_pix
node_inspect_test -->|"tests"| node_pak
node_inspect_list -->|"lists contents"| node_pak
node_extract -->|"extracts from"| node_pak
node_extract -->|"writes files"| node_destination
node_create -->|"reads"| node_response
node_create -->|"creates"| node_pak
node_mount -->|"sets mount point"| node_pak
node_repack -->|"repacks"| node_pak
node_diff -->|"compares archives"| node_pak
node_dependencies -->|"reads"| node_pak
node_dependencies -->|"exports to"| node_report
node_audit -->|"audits files"| node_pak
node_audit -->|"writes CSV"| node_report
node_offset -->|"checks offsets"| node_pak
node_pix -->|"maps files"| node_pak
node_pix -->|"writes mapping"| node_destination
node_cli -->|"loads with -cryptokeys"| node_crypto

click node_cli "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_inspect_test "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_inspect_list "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_extract "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_create "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_mount "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_repack "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_diff "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_dependencies "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_audit "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_offset "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_pix "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe"
click node_crypto "https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/Crypto.json"

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_inspect_test,node_inspect_list,node_diff toneBlue
class node_extract,node_create,node_mount,node_repack toneAmber
class node_dependencies,node_audit,node_offset,node_pix toneMint
class node_crypto toneRose
class node_user,node_pak,node_response,node_destination,node_report toneIndigo
class node_cli toneTeal
```

## Components

### Archive inspection

- [Test archive](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [List contents](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Compare archives](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`

### Archive operations

- [Extract files](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Create archive](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Set mount point](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Repack archive](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`

### Archive analysis

- [Export dependencies](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Audit files](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Inspect offsets](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- [Generate PIX mapping](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`

### Crypto configuration

- [Crypto keys](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/Crypto.json): `Crypto.json`

### Other components

- **Operator**
- [UnrealPak CLI](https://github.com/allcoolthingsatoneplace/unrealpaktool/blob/master/UnrealPak.exe): `UnrealPak.exe`
- **Pak archive**
- **Response file**
- **Output destination**
- **Report output**

## Connections

- Operator → UnrealPak CLI: invokes (evidence: `Readme.md`)
- UnrealPak CLI → Test archive: runs -Test (evidence: `Readme.md`)
- UnrealPak CLI → List contents: runs -List (evidence: `Readme.md`)
- UnrealPak CLI → Extract files: runs -Extract (evidence: `Readme.md`)
- UnrealPak CLI → Create archive: runs -Create (evidence: `Readme.md`)
- UnrealPak CLI → Set mount point: runs -Dest (evidence: `Readme.md`)
- UnrealPak CLI → Repack archive: runs -Repack (evidence: `Readme.md`)
- UnrealPak CLI → Compare archives: runs -diff (evidence: `Readme.md`)
- UnrealPak CLI → Export dependencies: exports dependencies (evidence: `Readme.md`)
- UnrealPak CLI → Audit files: runs -AuditFiles (evidence: `Readme.md`)
- UnrealPak CLI → Inspect offsets: runs -WhatsAtOffset (evidence: `Readme.md`)
- UnrealPak CLI → Generate PIX mapping: generates mapping (evidence: `Readme.md`)
- Test archive → Pak archive: tests (evidence: `Readme.md`)
- List contents → Pak archive: lists contents (evidence: `Readme.md`)
- Extract files → Pak archive: extracts from (evidence: `Readme.md`)
- Extract files → Output destination: writes files (evidence: `Readme.md`)
- Create archive → Response file: reads (evidence: `Readme.md`)
- Create archive → Pak archive: creates (evidence: `Readme.md`)
- Set mount point → Pak archive: sets mount point (evidence: `Readme.md`)
- Repack archive → Pak archive: repacks (evidence: `Readme.md`)
- Compare archives → Pak archive: compares archives (evidence: `Readme.md`)
- Export dependencies → Pak archive: reads (evidence: `Readme.md`)
- Export dependencies → Report output: exports to (evidence: `Readme.md`)
- Audit files → Pak archive: audits files (evidence: `Readme.md`)
- Audit files → Report output: writes CSV (evidence: `Readme.md`)
- Inspect offsets → Pak archive: checks offsets (evidence: `Readme.md`)
- Generate PIX mapping → Pak archive: maps files (evidence: `Readme.md`)
- Generate PIX mapping → Output destination: writes mapping (evidence: `Readme.md`)
- UnrealPak CLI → Crypto keys: loads with -cryptokeys (evidence: `Readme.md`)
