# vnnc1/gow-native-pc architecture

> Architecture diagram of the GitHub repository vnnc1/gow-native-pc, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vnnc1/gow-native-pc
- Repository: https://github.com/vnnc1/gow-native-pc

## Overview

God of War — Native PC is a PS2-to-C++ recompilation port with a launcher and installer. The main user journey is to provide a legally acquired disc, prepare it for the port, build or install the runnable game, then launch it. The repository also includes mod management, save-slot support, regional builds, and session diagnostics. The README documents several capabilities whose implementation files are not in the supplied tree; those are represented at the documented subsystem level. Arrows use explicit README statements or visible source references; unsampled implementation details are not inferred.

Main entry points: [`launcher/src/main.cpp`](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/main.cpp) (Launcher UI), [`tools/disc/prepare.py`](https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/prepare.py) (Disc preparation), [`launcher/src/installer_backend.cpp`](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/installer_backend.cpp) (Install backend), [`launcher/src/lanzador.cpp`](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/lanzador.cpp) (Play backend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_launcher["Launcher and play"]
  node_launcher_app["Launcher UI<br/>[main.cpp]"]
  node_installer_backend["Install backend"]
  node_play_backend["Play backend<br/>[lanzador.cpp]"]
  node_controls["Input mappings<br/>[mando.cpp]"]
  node_mods_ui["Mods model<br/>[mods_model.cpp]"]
  node_translations["Launcher translations<br/>[Textos.js]"]
  node_installer["Windows setup<br/>[setup.cpp]"]
end

subgraph group_disc["Disc preparation"]
  node_disc_images["Game disc images"]
  node_disc_identify["Disc identification<br/>[identify.py]"]
  node_disc_prepare["Disc preparation<br/>[prepare.py]"]
  node_disc_access["Disc access<br/>[discfs.py]"]
  node_save_slots["Save slots<br/>[save_slots.py]"]
end

subgraph group_pipeline["Build and regions"]
  node_build["Recompilation<br/>[recompile.py]"]
  node_profiles["Game profiles<br/>[profile.py]"]
  node_region_builds["Regional builds<br/>[register_region.py]"]
end

subgraph group_extras["Mods and diagnostics"]
  node_mods_cli["Mod management<br/>[gow_mods_cli.py]"]
  node_diagnostics_ui["Diagnostics UI<br/>[diagnostic_kit.cpp]"]
  node_session_recorder["Session recorder"]
  node_session_summary["Session reports<br/>[session_summary.h]"]
end

node_player(("Player"))
node_runtime["PS2Recomp runtime"]

node_player -->|"uses"| node_launcher_app
node_launcher_app -->|"exposes install"| node_installer_backend
node_launcher_app -->|"exposes play"| node_play_backend
node_launcher_app -->|"configures controls"| node_controls
node_launcher_app -->|"registers model"| node_mods_ui
node_launcher_app -->|"loads language text"| node_translations
node_installer_backend -->|"identifies discs"| node_disc_identify
node_player -->|"provides own disc"| node_disc_images
node_disc_images -->|"scans"| node_disc_identify
node_disc_identify -->|"reads disc data"| node_disc_access
node_installer_backend -->|"prepares installation"| node_disc_prepare
node_disc_prepare -->|"recognizes editions"| node_disc_identify
node_disc_prepare -->|"reads disc contents"| node_disc_access
node_disc_prepare -->|"prepares save assets"| node_save_slots
node_disc_prepare -->|"prepares for recompilation"| node_build
node_build -->|"loads game profile"| node_profiles
node_build -->|"reads prepared disc"| node_disc_access
node_region_builds -->|"registers regional build"| node_build
node_installer_backend -->|"downloads runtime"| node_runtime
node_play_backend -->|"starts game"| node_runtime
node_mods_ui -.->|"manages mods"| node_mods_cli
node_mods_cli -->|"launches with mod plan"| node_runtime
node_play_backend -->|"integrates save slots"| node_save_slots
node_diagnostics_ui -->|"records game session"| node_session_recorder
node_session_recorder -->|"summarizes session"| node_session_summary
node_play_backend -->|"collects session report"| node_session_recorder
node_installer -.->|"installs launcher"| node_launcher_app

click node_launcher_app "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/main.cpp"
click node_installer_backend "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/installer_backend.cpp"
click node_play_backend "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/lanzador.cpp"
click node_controls "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/mando.cpp"
click node_mods_ui "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/mods_model.cpp"
click node_translations "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/qml/Textos.js"
click node_installer "https://github.com/vnnc1/gow-native-pc/blob/main/installer/setup.cpp"
click node_disc_identify "https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/identify.py"
click node_disc_prepare "https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/prepare.py"
click node_disc_access "https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/discfs.py"
click node_save_slots "https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/save_slots.py"
click node_build "https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/recompile.py"
click node_profiles "https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/profile.py"
click node_region_builds "https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/register_region.py"
click node_mods_cli "https://github.com/vnnc1/gow-native-pc/blob/main/tools/mods/gow_mods_cli.py"
click node_diagnostics_ui "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/diagnostics/diagnostic_kit.cpp"
click node_session_recorder "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/session_diagnostics.cpp"
click node_session_summary "https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/session_summary.h"

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_launcher_app,node_installer_backend,node_play_backend,node_controls,node_mods_ui,node_translations,node_installer toneBlue
class node_disc_images,node_disc_identify,node_disc_prepare,node_disc_access,node_save_slots toneAmber
class node_build,node_profiles,node_region_builds toneMint
class node_mods_cli,node_diagnostics_ui,node_session_recorder,node_session_summary toneRose
class node_player,node_runtime toneIndigo
```

## Components

### Launcher and play

- [Launcher UI](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/main.cpp): `launcher/src/main.cpp`
- [Install backend](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/installer_backend.cpp): `launcher/src/installer_backend.cpp`
- [Play backend](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/lanzador.cpp): `launcher/src/lanzador.cpp`
- [Input mappings](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/mando.cpp): `launcher/src/mando.cpp`
- [Mods model](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/mods_model.cpp): `launcher/src/mods_model.cpp`
- [Launcher translations](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/qml/Textos.js): `launcher/qml/Textos.js`
- [Windows setup](https://github.com/vnnc1/gow-native-pc/blob/main/installer/setup.cpp): `installer/setup.cpp`

### Disc preparation

- **Game disc images**
- [Disc identification](https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/identify.py): `tools/disc/identify.py`
- [Disc preparation](https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/prepare.py): `tools/disc/prepare.py`
- [Disc access](https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/discfs.py): `tools/disc/discfs.py`
- [Save slots](https://github.com/vnnc1/gow-native-pc/blob/main/tools/disc/save_slots.py): `tools/disc/save_slots.py`

### Build and regions

- [Recompilation](https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/recompile.py): `tools/pipeline/recompile.py`
- [Game profiles](https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/profile.py): `tools/pipeline/profile.py`
- [Regional builds](https://github.com/vnnc1/gow-native-pc/blob/main/tools/pipeline/register_region.py): `tools/pipeline/register_region.py`

### Mods and diagnostics

- [Mod management](https://github.com/vnnc1/gow-native-pc/blob/main/tools/mods/gow_mods_cli.py): `tools/mods/gow_mods_cli.py`
- [Diagnostics UI](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/diagnostics/diagnostic_kit.cpp): `launcher/diagnostics/diagnostic_kit.cpp`
- [Session recorder](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/session_diagnostics.cpp): `launcher/src/session_diagnostics.cpp`
- [Session reports](https://github.com/vnnc1/gow-native-pc/blob/main/launcher/src/session_summary.h): `launcher/src/session_summary.h`

### Other components

- **Player**
- **PS2Recomp runtime**

## Connections

- Player → Launcher UI: uses (evidence: `README.md`)
- Launcher UI → Install backend: exposes install (evidence: `launcher/src/main.cpp`)
- Launcher UI → Play backend: exposes play (evidence: `launcher/src/main.cpp`)
- Launcher UI → Input mappings: configures controls (evidence: `launcher/src/main.cpp`)
- Launcher UI → Mods model: registers model (evidence: `launcher/src/main.cpp`)
- Launcher UI → Launcher translations: loads language text
- Install backend → Disc identification: identifies discs (evidence: `README.md`)
- Player → Game disc images: provides own disc (evidence: `README.md`)
- Game disc images → Disc identification: scans (evidence: `README.md`)
- Disc identification → Disc access: reads disc data (evidence: `tools/disc/identify.py`)
- Install backend → Disc preparation: prepares installation (evidence: `README.md`)
- Disc preparation → Disc identification: recognizes editions (evidence: `tools/disc/prepare.py`)
- Disc preparation → Disc access: reads disc contents (evidence: `tools/disc/prepare.py`)
- Disc preparation → Save slots: prepares save assets (evidence: `tools/disc/prepare.py`)
- Disc preparation → Recompilation: prepares for recompilation (evidence: `README.md`)
- Recompilation → Game profiles: loads game profile (evidence: `tools/pipeline/recompile.py`)
- Recompilation → Disc access: reads prepared disc (evidence: `tools/pipeline/recompile.py`)
- Regional builds → Recompilation: registers regional build (evidence: `tools/pipeline/register_region.py`)
- Install backend → PS2Recomp runtime: downloads runtime (evidence: `README.md`)
- Play backend → PS2Recomp runtime: starts game (evidence: `README.md`)
- Mods model → Mod management: manages mods
- Mod management → PS2Recomp runtime: launches with mod plan (evidence: `tools/mods/gow_mods_cli.py`)
- Play backend → Save slots: integrates save slots (evidence: `README.md`)
- Diagnostics UI → Session recorder: records game session
- Session recorder → Session reports: summarizes session (evidence: `launcher/src/session_diagnostics.cpp`)
- Play backend → Session recorder: collects session report (evidence: `launcher/src/lanzador.cpp`)
- Windows setup → Launcher UI: installs launcher
