# nightworldteam/lexplosion architecture

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

- Interactive diagram: https://gitdiagram.com/nightworldteam/lexplosion
- Repository: https://github.com/nightworldteam/lexplosion

## Overview

Lexplosion is a Windows WPF Minecraft launcher backed by a separate Core library. The main user workflow is to choose or import a game profile, resolve/download its game files and add-ons, then launch it with suitable Java settings. The README also documents mod catalogs, profile sharing, customization, account types, and peer-to-peer/server multiplayer. Core relationships are based on the excerpts and SOURCE INDEX; broader capability links use README statements where implementation was not sampled.

Main entry points: [`src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs`](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs) (Game profile), [`src/Lexplosion.Core/Logic/FileSystem/WithDirectory.cs`](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/FileSystem/WithDirectory.cs) (Downloads and files), [`src/Lexplosion.UI.WPF/Main.cs`](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Main.cs) (WPF application), [`src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs`](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs) (Profile management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_desktop["Desktop experience"]
  node_wpf["WPF application<br/>[Main.cs]"]
  node_appcore["UI coordination<br/>[AppCore.cs]"]
  node_themes["Themes and settings<br/>[ThemeLoader.cs]"]
end

subgraph group_profiles["Profiles and launch"]
  node_library["Profile library"]
  node_instances["Profile management<br/>[ClientsManager.cs]"]
  node_instance["Game profile<br/>[InstanceClient.cs]"]
  node_install["Profile installation"]
  node_launch["Game launch<br/>[LaunchGame.cs]"]
  node_java["Java selection<br/>[JavaChecker.cs]"]
  node_import["Import and export"]
end

subgraph group_content["Content management"]
  node_catalog["Add-on catalogs<br/>[AddonsManager.cs]"]
  node_addon["Add-on install and sync<br/>[InstanceAddon.cs]"]
  node_curseforge["CurseForge API<br/>[CurseforgeApi.cs]"]
  node_modrinth["Modrinth API<br/>[ModrinthApi.cs]"]
end

subgraph group_connectivity["Accounts and networking"]
  node_auth["Account authentication<br/>[Account.cs]"]
  node_multiplayer["Multiplayer networking"]
  node_network["Network transport<br/>[NetworkClient.cs]"]
end

subgraph group_foundation["Core services"]
  node_runtime["Runtime composition<br/>[Runtime.cs]"]
  node_storage["Launcher data storage"]
  node_filesystem["Downloads and files<br/>[WithDirectory.cs]"]
end

node_user(("Player"))
node_minecraft["Minecraft process"]
node_external["Game services"]

node_user -->|"uses"| node_wpf
node_wpf -->|"coordinates UI"| node_appcore
node_wpf -->|"initializes"| node_runtime
node_user -->|"manages profiles"| node_library
node_library -->|"manages"| node_instances
node_instances -->|"creates profiles"| node_instance
node_instances -->|"imports profiles"| node_import
node_user -->|"shares profiles"| node_import
node_instance -.->|"installs files"| node_install
node_install -->|"downloads and extracts"| node_filesystem
node_filesystem -.->|"fetches resources"| node_external
node_instance -.->|"browses add-ons"| node_catalog
node_catalog -.->|"queries catalog"| node_curseforge
node_catalog -.->|"queries catalog"| node_modrinth
node_addon -.->|"downloads add-ons"| node_filesystem
node_user -->|"signs in"| node_auth
node_auth -.->|"authenticates"| node_external
node_user -->|"customizes"| node_themes
node_instance -.->|"selects runtime"| node_java
node_java -->|"obtains JRE"| node_external
node_user -->|"starts game"| node_launch
node_launch -.->|"starts process"| node_minecraft
node_user -->|"joins session"| node_multiplayer
node_multiplayer -.->|"uses transport"| node_network
node_network -->|"connects peers or server"| node_external
node_runtime -->|"creates service"| node_storage
node_storage -.->|"persists launcher data"| node_filesystem

click node_wpf "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Main.cs"
click node_appcore "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Core/AppCore.cs"
click node_themes "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Core/Resources/Theme/ThemeLoader.cs"
click node_library "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Mvvm/Models/InstanceControllers/LibraryController.cs"
click node_instances "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs"
click node_instance "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs"
click node_install "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Installers/ArchiveInstallManager.cs"
click node_launch "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/LaunchGame.cs"
click node_java "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/JavaChecker.cs"
click node_import "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Mvvm/Models/InstanceTransfer/InstanceImportModel.cs"
click node_catalog "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Addons/AddonsManager.cs"
click node_addon "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Addons/InstanceAddon.cs"
click node_curseforge "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/Web/CurseforgeApi.cs"
click node_modrinth "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/Web/ModrinthApi.cs"
click node_auth "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Accounts/Account.cs"
click node_multiplayer "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/OnlineGameGateway.cs"
click node_network "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/NetworkClient.cs"
click node_runtime "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Runtime.cs"
click node_storage "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/FileSystem/DataFilesManager.cs"
click node_filesystem "https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/FileSystem/WithDirectory.cs"

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_wpf,node_appcore,node_themes toneBlue
class node_library,node_instances,node_instance,node_install,node_launch,node_java,node_import toneAmber
class node_catalog,node_addon,node_curseforge,node_modrinth toneMint
class node_auth,node_multiplayer,node_network toneRose
class node_runtime,node_storage,node_filesystem,node_user,node_minecraft,node_external toneIndigo
```

## Components

### Desktop experience

- [WPF application](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Main.cs): `src/Lexplosion.UI.WPF/Main.cs`
- [UI coordination](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Core/AppCore.cs): `src/Lexplosion.UI.WPF/Core/AppCore.cs`
- [Themes and settings](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Core/Resources/Theme/ThemeLoader.cs): `src/Lexplosion.UI.WPF/Core/Resources/Theme/ThemeLoader.cs`

### Profiles and launch

- [Profile library](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Mvvm/Models/InstanceControllers/LibraryController.cs): `src/Lexplosion.UI.WPF/Mvvm/Models/InstanceControllers/LibraryController.cs`
- [Profile management](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs): `src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs`
- [Game profile](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs): `src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs`
- [Profile installation](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Installers/ArchiveInstallManager.cs): `src/Lexplosion.Core/Logic/Management/Installers/ArchiveInstallManager.cs`
- [Game launch](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/LaunchGame.cs): `src/Lexplosion.Core/Logic/Management/LaunchGame.cs`
- [Java selection](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/JavaChecker.cs): `src/Lexplosion.Core/Logic/Management/JavaChecker.cs`
- [Import and export](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.UI.WPF/Mvvm/Models/InstanceTransfer/InstanceImportModel.cs): `src/Lexplosion.UI.WPF/Mvvm/Models/InstanceTransfer/InstanceImportModel.cs`

### Content management

- [Add-on catalogs](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Addons/AddonsManager.cs): `src/Lexplosion.Core/Logic/Management/Addons/AddonsManager.cs`
- [Add-on install and sync](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Addons/InstanceAddon.cs): `src/Lexplosion.Core/Logic/Management/Addons/InstanceAddon.cs`
- [CurseForge API](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/Web/CurseforgeApi.cs): `src/Lexplosion.Core/Logic/Network/Web/CurseforgeApi.cs`
- [Modrinth API](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/Web/ModrinthApi.cs): `src/Lexplosion.Core/Logic/Network/Web/ModrinthApi.cs`

### Accounts and networking

- [Account authentication](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Management/Accounts/Account.cs): `src/Lexplosion.Core/Logic/Management/Accounts/Account.cs`
- [Multiplayer networking](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/OnlineGameGateway.cs): `src/Lexplosion.Core/Logic/Network/OnlineGameGateway.cs`
- [Network transport](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/Network/NetworkClient.cs): `src/Lexplosion.Core/Logic/Network/NetworkClient.cs`

### Core services

- [Runtime composition](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Runtime.cs): `src/Lexplosion.Core/Runtime.cs`
- [Launcher data storage](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/FileSystem/DataFilesManager.cs): `src/Lexplosion.Core/Logic/FileSystem/DataFilesManager.cs`
- [Downloads and files](https://github.com/nightworldteam/lexplosion/blob/master/src/Lexplosion.Core/Logic/FileSystem/WithDirectory.cs): `src/Lexplosion.Core/Logic/FileSystem/WithDirectory.cs`

### Other components

- **Player**
- **Minecraft process**
- **Game services**

## Connections

- Player → WPF application: uses
- WPF application → UI coordination: coordinates UI (evidence: `src/Lexplosion.UI.WPF/Main.cs`)
- WPF application → Runtime composition: initializes (evidence: `src/Lexplosion.UI.WPF/Main.cs`)
- Player → Profile library: manages profiles
- Profile library → Profile management: manages (evidence: `src/Lexplosion.UI.WPF/Mvvm/Models/InstanceControllers/LibraryController.cs`)
- Profile management → Game profile: creates profiles (evidence: `src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs`)
- Profile management → Import and export: imports profiles (evidence: `src/Lexplosion.Core/Logic/Management/Instances/ClientsManager.cs`)
- Player → Import and export: shares profiles
- Game profile → Profile installation: installs files
- Profile installation → Downloads and files: downloads and extracts (evidence: `src/Lexplosion.Core/Logic/Management/Installers/ArchiveInstallManager.cs`)
- Downloads and files → Game services: fetches resources
- Game profile → Add-on catalogs: browses add-ons (evidence: `src/Lexplosion.Core/Logic/Management/Instances/InstanceClient.cs`)
- Add-on catalogs → CurseForge API: queries catalog
- Add-on catalogs → Modrinth API: queries catalog
- Add-on install and sync → Downloads and files: downloads add-ons
- Player → Account authentication: signs in
- Account authentication → Game services: authenticates
- Player → Themes and settings: customizes
- Game profile → Java selection: selects runtime
- Java selection → Game services: obtains JRE
- Player → Game launch: starts game
- Game launch → Minecraft process: starts process
- Player → Multiplayer networking: joins session
- Multiplayer networking → Network transport: uses transport
- Network transport → Game services: connects peers or server
- Runtime composition → Launcher data storage: creates service (evidence: `src/Lexplosion.Core/Runtime.cs`)
- Launcher data storage → Downloads and files: persists launcher data (evidence: `src/Lexplosion.Core/Logic/FileSystem/DataFilesManager.cs`)
