# shadowhedgehog76/strokalauncher architecture

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

- Interactive diagram: https://gitdiagram.com/shadowhedgehog76/strokalauncher
- Repository: https://github.com/shadowhedgehog76/strokalauncher

## Overview

Stroka Launcher is a C Minecraft launcher with both graphical and terminal interfaces. The player workflow is to browse published or local packs, authenticate with a Microsoft account, synchronize the selected pack and shared game files, then start Minecraft; the GUI also supports pack editing, personal mods, migration, animated scenes, and launcher updates. The graph combines sampled call relationships with capabilities explicitly documented in the README; several feature modules were not sampled, so their connections are shown only where documented.

Main entry points: [`gui/app.c`](https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/app.c) (Graphical launcher), [`src/game.c`](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/game.c) (Game launch), [`src/main.c`](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/main.c) (Terminal launcher), [`src/pack.c`](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/pack.c) (Pack catalog)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["Player interfaces"]
  node_gui["Graphical launcher<br/>[app.c]"]
  node_cli["Terminal launcher<br/>[main.c]"]
  node_render["UI and scenes<br/>[scene.c]"]
end

subgraph group_packs["Packs and installation"]
  node_pack_catalog["Pack catalog<br/>[pack.c]"]
  node_local_packs["Solo packs<br/>[localpacks.c]"]
  node_game["Game launch<br/>[game.c]"]
  node_java["Java runtime<br/>[java.c]"]
  node_sync["Pack synchronization<br/>[sync.c]"]
  node_usermods["Personal mods<br/>[usermods.c]"]
  node_migration["Instance import<br/>[migrate.c]"]
end

subgraph group_account["Identity and services"]
  node_auth["Microsoft sign-in<br/>[auth.c]"]
  node_http["HTTP and downloads<br/>[http.c]"]
  node_supabase["Pack service<br/>[supabase.c]"]
end

subgraph group_support["Player features"]
  node_settings["Settings<br/>[settings.c]"]
  node_updater["Launcher updates<br/>[updater.c]"]
  node_scene_data["Custom scenes<br/>[customscene.c]"]
  node_online["Server status<br/>[ping.c]"]
  node_skin["Player skins<br/>[skin.c]"]
  node_modmeta["Mod metadata<br/>[modmeta.c]"]
end

node_player(("Player"))
node_modrinth["Modrinth"]
node_microsoft["Microsoft account"]
node_minecraft["Minecraft process"]

node_player -->|"uses"| node_gui
node_player -->|"uses"| node_cli
node_gui -->|"fetches packs"| node_pack_catalog
node_cli -->|"fetches packs"| node_pack_catalog
node_cli -->|"signs in"| node_auth
node_cli -->|"launches pack"| node_game
node_gui -->|"launches pack"| node_game
node_gui -->|"manages solo packs"| node_local_packs
node_gui -->|"imports instance"| node_migration
node_gui -->|"manages mods"| node_usermods
node_gui -->|"draws interface"| node_render
node_gui -->|"loads settings"| node_settings
node_gui -->|"checks updates"| node_updater
node_gui -->|"renders custom scenes"| node_scene_data
node_game -->|"selects runtime"| node_java
node_game -->|"synchronizes pack"| node_sync
node_game -->|"applies mods"| node_usermods
node_game -->|"starts game"| node_minecraft
node_game -->|"downloads metadata"| node_http
node_auth -->|"authenticates with"| node_microsoft
node_pack_catalog -->|"retrieves packs"| node_supabase
node_supabase -->|"uses requests"| node_http
node_usermods -->|"searches and downloads"| node_modrinth
node_gui -->|"shows player counts"| node_online
node_gui -->|"shows player heads"| node_skin
node_gui -->|"shows mod details"| node_modmeta

click node_gui "https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/app.c"
click node_cli "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/main.c"
click node_render "https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/scene.c"
click node_pack_catalog "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/pack.c"
click node_local_packs "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/localpacks.c"
click node_game "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/game.c"
click node_java "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/java.c"
click node_sync "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/sync.c"
click node_usermods "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/usermods.c"
click node_migration "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/migrate.c"
click node_auth "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/auth.c"
click node_http "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/http.c"
click node_supabase "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/supabase.c"
click node_settings "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/settings.c"
click node_updater "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/updater.c"
click node_scene_data "https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/customscene.c"
click node_online "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/ping.c"
click node_skin "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/skin.c"
click node_modmeta "https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/modmeta.c"

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_cli,node_render toneBlue
class node_pack_catalog,node_local_packs,node_game,node_java,node_sync,node_usermods,node_migration toneAmber
class node_auth,node_http,node_supabase toneMint
class node_settings,node_updater,node_scene_data,node_online,node_skin,node_modmeta toneRose
class node_player,node_modrinth,node_microsoft,node_minecraft toneIndigo
```

## Components

### Player interfaces

- [Graphical launcher](https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/app.c): `gui/app.c`
- [Terminal launcher](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/main.c): `src/main.c`
- [UI and scenes](https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/scene.c): `gui/scene.c`

### Packs and installation

- [Pack catalog](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/pack.c): `src/pack.c`
- [Solo packs](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/localpacks.c): `src/localpacks.c`
- [Game launch](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/game.c): `src/game.c`
- [Java runtime](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/java.c): `src/java.c`
- [Pack synchronization](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/sync.c): `src/sync.c`
- [Personal mods](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/usermods.c): `src/usermods.c`
- [Instance import](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/migrate.c): `src/migrate.c`

### Identity and services

- [Microsoft sign-in](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/auth.c): `src/auth.c`
- [HTTP and downloads](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/http.c): `src/http.c`
- [Pack service](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/supabase.c): `src/supabase.c`

### Player features

- [Settings](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/settings.c): `src/settings.c`
- [Launcher updates](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/updater.c): `src/updater.c`
- [Custom scenes](https://github.com/shadowhedgehog76/strokalauncher/blob/main/gui/customscene.c): `gui/customscene.c`
- [Server status](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/ping.c): `src/ping.c`
- [Player skins](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/skin.c): `src/skin.c`
- [Mod metadata](https://github.com/shadowhedgehog76/strokalauncher/blob/main/src/modmeta.c): `src/modmeta.c`

### Other components

- **Player**
- **Modrinth**
- **Microsoft account**
- **Minecraft process**

## Connections

- Player → Graphical launcher: uses
- Player → Terminal launcher: uses
- Graphical launcher → Pack catalog: fetches packs (evidence: `gui/app.c`)
- Terminal launcher → Pack catalog: fetches packs (evidence: `src/main.c`)
- Terminal launcher → Microsoft sign-in: signs in (evidence: `src/main.c`)
- Terminal launcher → Game launch: launches pack (evidence: `src/main.c`)
- Graphical launcher → Game launch: launches pack (evidence: `gui/app.c`)
- Graphical launcher → Solo packs: manages solo packs
- Graphical launcher → Instance import: imports instance
- Graphical launcher → Personal mods: manages mods
- Graphical launcher → UI and scenes: draws interface (evidence: `gui/app.c`)
- Graphical launcher → Settings: loads settings (evidence: `gui/app.c`)
- Graphical launcher → Launcher updates: checks updates
- Graphical launcher → Custom scenes: renders custom scenes
- Game launch → Java runtime: selects runtime (evidence: `src/game.c`)
- Game launch → Pack synchronization: synchronizes pack (evidence: `src/game.c`)
- Game launch → Personal mods: applies mods (evidence: `src/game.c`)
- Game launch → Minecraft process: starts game
- Game launch → HTTP and downloads: downloads metadata (evidence: `src/game.c`)
- Microsoft sign-in → Microsoft account: authenticates with
- Pack catalog → Pack service: retrieves packs
- Pack service → HTTP and downloads: uses requests
- Personal mods → Modrinth: searches and downloads
- Graphical launcher → Server status: shows player counts
- Graphical launcher → Player skins: shows player heads
- Graphical launcher → Mod metadata: shows mod details
