# aethelreborn/aethelone architecture

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

- Interactive diagram: https://gitdiagram.com/aethelreborn/aethelone
- Repository: https://github.com/aethelreborn/aethelone

## Overview

AethelONE is a Rust Minecraft launcher fork whose key user workflow is onboarding an account, creating or choosing a cluster, installing content and Java as needed, then launching the game. The app also provides cluster management, package browsing, settings, storage cleanup, and cosmetics customization. The graph combines documented capabilities with relationships visible in the supplied excerpts and SOURCE INDEX; unsampled internals are represented at their existing subsystem paths, and uncertain connections are omitted.

Main entry points: [`packages/oneclient_core/src/state.rs`](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/state.rs) (Launcher services), [`packages/oneclient_app/src/routes.rs`](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/routes.rs) (App routes), [`packages/oneclient_core/src/game/session.rs`](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/game/session.rs) (Game launch and sessions), [`packages/oneclient_app/src/view/app/settings/storage.rs`](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/view/app/settings/storage.rs) (Storage settings)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop app"]
  node_routes["App routes<br/>[routes.rs]"]
  node_onboarding["Onboarding"]
  node_home["Home and analytics"]
  node_clusters_ui["Cluster views"]
  node_browser["Content browser"]
  node_settings["Settings<br/>[settings_shell.rs]"]
  node_storage_ui["Storage settings<br/>[storage.rs]"]
  node_app_state["App state and actions<br/>[state.rs]"]
end

subgraph group_domain["Launcher services"]
  node_auth["Account authentication<br/>[service.rs]"]
  node_cluster_manager["Cluster management<br/>[manager.rs]"]
  node_core_state["Launcher services<br/>[state.rs]"]
  node_game_launch["Game launch and sessions<br/>[session.rs]"]
  node_database[("Launcher database<br/>[pool.rs]")]
  node_updater["Self-updater<br/>[updater.rs]"]
  node_cosmetics["Cosmetics proxy<br/>[cosmetics_proxy.rs]"]
end

subgraph group_content["Content and runtime"]
  node_content_manager["Bundles and packages<br/>[manager.rs]"]
  node_minecraft_install["Minecraft installation<br/>[install.rs]"]
  node_java_service["Java discovery and install<br/>[service.rs]"]
end

subgraph group_integrations["External services"]
  node_release_channel["AethelONE release channel"]
  node_polyplus_catalog["Public cosmetics catalog"]
  node_game["Minecraft game"]
end

node_user(("Player"))

node_user -.->|"uses"| node_routes
node_routes -->|"routes to"| node_onboarding
node_routes -->|"routes to"| node_home
node_routes -->|"routes to"| node_clusters_ui
node_routes -->|"routes to"| node_browser
node_routes -->|"routes to"| node_settings
node_settings -.->|"contains view"| node_storage_ui
node_storage_ui -->|"reads scan state"| node_app_state
node_app_state -.->|"obtains services"| node_core_state
node_core_state -->|"opens database"| node_database
node_core_state -.->|"initializes auth"| node_auth
node_core_state -.->|"initializes Java"| node_java_service
node_core_state -.->|"initializes clusters"| node_cluster_manager
node_core_state -->|"provides content context"| node_content_manager
node_core_state -.->|"owns game manager"| node_game_launch
node_storage_ui -->|"requests storage report"| node_core_state
node_content_manager -->|"reads bundle records"| node_database
node_user -->|"chooses offline account"| node_auth
node_user -.->|"creates cluster"| node_cluster_manager
node_user -->|"browses packages"| node_browser
node_user -.->|"launches cluster"| node_game_launch
node_game_launch -->|"starts game"| node_game
node_user -->|"receives updates"| node_updater
node_updater -->|"checks releases"| node_release_channel
node_game_launch -->|"configures proxy"| node_cosmetics
node_cosmetics -->|"serves locker data"| node_polyplus_catalog

click node_routes "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/routes.rs"
click node_onboarding "https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/onboarding"
click node_home "https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/home"
click node_clusters_ui "https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/cluster"
click node_browser "https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/browser"
click node_settings "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/layout/settings_shell.rs"
click node_storage_ui "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/view/app/settings/storage.rs"
click node_app_state "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/state.rs"
click node_auth "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_auth/src/service.rs"
click node_cluster_manager "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_cluster/src/manager.rs"
click node_core_state "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/state.rs"
click node_game_launch "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/game/session.rs"
click node_content_manager "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_content/src/bundles/manager.rs"
click node_minecraft_install "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_mc/src/install.rs"
click node_java_service "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_java/src/service.rs"
click node_database "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_db/src/pool.rs"
click node_updater "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/updater.rs"
click node_cosmetics "https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/cosmetics_proxy.rs"

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_routes,node_onboarding,node_home,node_clusters_ui,node_browser,node_settings,node_storage_ui,node_app_state toneBlue
class node_auth,node_cluster_manager,node_core_state,node_game_launch,node_database,node_updater,node_cosmetics toneAmber
class node_content_manager,node_minecraft_install,node_java_service toneMint
class node_release_channel,node_polyplus_catalog,node_game toneRose
class node_user toneIndigo
```

## Components

### Desktop app

- [App routes](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/routes.rs): `packages/oneclient_app/src/routes.rs`
- [Onboarding](https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/onboarding): `packages/oneclient_app/src/view/onboarding`
- [Home and analytics](https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/home): `packages/oneclient_app/src/view/app/home`
- [Cluster views](https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/cluster): `packages/oneclient_app/src/view/app/cluster`
- [Content browser](https://github.com/aethelreborn/aethelone/tree/main/packages/oneclient_app/src/view/app/browser): `packages/oneclient_app/src/view/app/browser`
- [Settings](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/layout/settings_shell.rs): `packages/oneclient_app/src/layout/settings_shell.rs`
- [Storage settings](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/view/app/settings/storage.rs): `packages/oneclient_app/src/view/app/settings/storage.rs`
- [App state and actions](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/state.rs): `packages/oneclient_app/src/state.rs`

### Launcher services

- [Account authentication](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_auth/src/service.rs): `packages/oneclient_auth/src/service.rs`
- [Cluster management](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_cluster/src/manager.rs): `packages/oneclient_cluster/src/manager.rs`
- [Launcher services](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/state.rs): `packages/oneclient_core/src/state.rs`
- [Game launch and sessions](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_core/src/game/session.rs): `packages/oneclient_core/src/game/session.rs`
- [Launcher database](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_db/src/pool.rs): `packages/oneclient_db/src/pool.rs`
- [Self-updater](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/updater.rs): `packages/oneclient_app/src/updater.rs`
- [Cosmetics proxy](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_app/src/cosmetics_proxy.rs): `packages/oneclient_app/src/cosmetics_proxy.rs`

### Content and runtime

- [Bundles and packages](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_content/src/bundles/manager.rs): `packages/oneclient_content/src/bundles/manager.rs`
- [Minecraft installation](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_mc/src/install.rs): `packages/oneclient_mc/src/install.rs`
- [Java discovery and install](https://github.com/aethelreborn/aethelone/blob/main/packages/oneclient_java/src/service.rs): `packages/oneclient_java/src/service.rs`

### External services

- **AethelONE release channel**
- **Public cosmetics catalog**
- **Minecraft game**

### Other components

- **Player**

## Connections

- Player → App routes: uses
- App routes → Onboarding: routes to (evidence: `packages/oneclient_app/src/routes.rs`)
- App routes → Home and analytics: routes to (evidence: `packages/oneclient_app/src/routes.rs`)
- App routes → Cluster views: routes to (evidence: `packages/oneclient_app/src/routes.rs`)
- App routes → Content browser: routes to (evidence: `packages/oneclient_app/src/routes.rs`)
- App routes → Settings: routes to (evidence: `packages/oneclient_app/src/routes.rs`)
- Settings → Storage settings: contains view
- Storage settings → App state and actions: reads scan state (evidence: `packages/oneclient_app/src/view/app/settings/storage.rs`)
- App state and actions → Launcher services: obtains services
- Launcher services → Launcher database: opens database (evidence: `packages/oneclient_core/src/state.rs`)
- Launcher services → Account authentication: initializes auth
- Launcher services → Java discovery and install: initializes Java
- Launcher services → Cluster management: initializes clusters
- Launcher services → Bundles and packages: provides content context (evidence: `packages/oneclient_core/src/state.rs`)
- Launcher services → Game launch and sessions: owns game manager (evidence: `packages/oneclient_core/src/game/session.rs`)
- Storage settings → Launcher services: requests storage report
- Bundles and packages → Launcher database: reads bundle records (evidence: `packages/oneclient_content/src/bundles/manager.rs`)
- Player → Account authentication: chooses offline account (evidence: `README.md`)
- Player → Cluster management: creates cluster
- Player → Content browser: browses packages (evidence: `README.md`)
- Player → Game launch and sessions: launches cluster
- Game launch and sessions → Minecraft game: starts game (evidence: `README.md`)
- Player → Self-updater: receives updates (evidence: `README.md`)
- Self-updater → AethelONE release channel: checks releases (evidence: `README.md`)
- Game launch and sessions → Cosmetics proxy: configures proxy (evidence: `README.md`)
- Cosmetics proxy → Public cosmetics catalog: serves locker data (evidence: `README.md`)
