# rus07tam/osu-cc architecture

> Architecture diagram of the GitHub repository rus07tam/osu-cc, 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/rus07tam/osu-cc
- Repository: https://github.com/rus07tam/osu-cc

## Overview

osu!cc is an optional add-on for osu!lazer, with a host that modifies the running game, manages plugins and exposes client services. Its main user workflow is to launch the game with osu!cc, use its settings and plugin-management UI, and experience enabled game enhancements. The repository also includes a desktop launcher, shared API client, cloud storage, themes and example plugins. Several edges below rely on explicit README description or indexed source references; unsampled integration details are not expanded.

Main entry points: [`osucc.Host/Plugin/PluginManager.cs`](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Plugin/PluginManager.cs) (Plugin manager), [`osucc.Host/Client/ClientConfig.cs`](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientConfig.cs) (Client settings), [`osucc.Shared/Api/OsuCcApiClient.cs`](https://github.com/rus07tam/osu-cc/blob/main/osucc.Shared/Api/OsuCcApiClient.cs) (API client), [`osucc.Host/Client/ClientProfileDownloads.cs`](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientProfileDownloads.cs) (Profile downloads)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game integration"]
  node_bootstrap["Host bootstrap"]
  node_patches["Game patches<br/>[Patches]"]
end

subgraph group_plugins["Plugin ecosystem"]
  node_pluginmanager["Plugin manager<br/>[PluginManager.cs]"]
  node_pluginloader["Plugin loading<br/>[PluginLoader.cs]"]
  node_pluginui["Plugin management UI<br/>[Plugins]"]
  node_pluginapi["Plugin API<br/>[OsuCcPlugin.cs]"]
  node_extensions["Bundled plugins"]
end

subgraph group_client["Client features"]
  node_config["Client settings<br/>[ClientConfig.cs]"]
  node_themes["Theme system"]
  node_clientfeatures["Client features<br/>[ClientMods.cs]"]
  node_downloads["Profile downloads"]
  node_celebrations["Score celebrations"]
end

subgraph group_services["Shared services"]
  node_api["API client<br/>[OsuCcApiClient.cs]"]
  node_cloudstorage["Cloud storage<br/>[CloudStorage.cs]"]
  node_localstorage[("Scoped storage<br/>[ScopedStorage.cs]")]
end

subgraph group_launcher["Desktop launcher"]
  node_launcherapp["Desktop launcher<br/>[Program.cs]"]
  node_launcher["Launcher UI<br/>[MainScreen.cs]"]
end

node_user(("Player"))
node_game["osu!lazer"]
node_api_service["osu!cc API"]

node_user -.->|"uses add-on"| node_game
node_game -.->|"hosts runtime"| node_bootstrap
node_bootstrap -->|"installs patches"| node_patches
node_pluginmanager -->|"loads plugins"| node_pluginloader
node_pluginmanager -.->|"serves management"| node_pluginui
node_pluginmanager -->|"hosts plugins"| node_pluginapi
node_extensions -.->|"implements contracts"| node_pluginapi
node_config -->|"selects theme"| node_themes
node_themes -->|"applies colours"| node_patches
node_clientfeatures -->|"reads settings"| node_config
node_downloads -->|"reads settings"| node_config
node_downloads -.->|"downloads profiles"| node_api
node_celebrations -->|"uses client API"| node_game
node_cloudstorage -->|"sends storage requests"| node_api
node_localstorage -.->|"uses game storage"| node_game
node_api -->|"sends HTTP requests"| node_api_service
node_user -.->|"starts launcher"| node_launcherapp
node_launcherapp -->|"opens interface"| node_launcher

click node_bootstrap "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Core/ClientBootstrapper.cs"
click node_patches "https://github.com/rus07tam/osu-cc/tree/main/osucc.Host/Patches"
click node_pluginmanager "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Plugin/PluginManager.cs"
click node_pluginloader "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Plugin/PluginLoader.cs"
click node_pluginui "https://github.com/rus07tam/osu-cc/tree/main/osucc.Host/UI/Plugins"
click node_pluginapi "https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Plugin/OsuCcPlugin.cs"
click node_extensions "https://github.com/rus07tam/osu-cc/tree/main/plugins"
click node_config "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientConfig.cs"
click node_themes "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Core/Theming/OsuCcThemeManager.cs"
click node_clientfeatures "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientMods.cs"
click node_downloads "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientProfileDownloads.cs"
click node_celebrations "https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Celebrations/ClientCelebrations.cs"
click node_api "https://github.com/rus07tam/osu-cc/blob/main/osucc.Shared/Api/OsuCcApiClient.cs"
click node_cloudstorage "https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Storage/CloudStorage.cs"
click node_localstorage "https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Storage/ScopedStorage.cs"
click node_launcherapp "https://github.com/rus07tam/osu-cc/blob/main/osucc.Launcher.Desktop/Program.cs"
click node_launcher "https://github.com/rus07tam/osu-cc/blob/main/osucc.Launcher/Screens/MainScreen.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_bootstrap,node_patches toneBlue
class node_pluginmanager,node_pluginloader,node_pluginui,node_pluginapi,node_extensions toneAmber
class node_config,node_themes,node_clientfeatures,node_downloads,node_celebrations,node_api_service toneMint
class node_api,node_cloudstorage,node_localstorage toneRose
class node_launcherapp,node_launcher,node_user,node_game toneIndigo
```

## Components

### Game integration

- [Host bootstrap](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Core/ClientBootstrapper.cs): `osucc.Host/Core/ClientBootstrapper.cs`
- [Game patches](https://github.com/rus07tam/osu-cc/tree/main/osucc.Host/Patches): `osucc.Host/Patches`

### Plugin ecosystem

- [Plugin manager](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Plugin/PluginManager.cs): `osucc.Host/Plugin/PluginManager.cs`
- [Plugin loading](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Plugin/PluginLoader.cs): `osucc.Host/Plugin/PluginLoader.cs`
- [Plugin management UI](https://github.com/rus07tam/osu-cc/tree/main/osucc.Host/UI/Plugins): `osucc.Host/UI/Plugins`
- [Plugin API](https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Plugin/OsuCcPlugin.cs): `osucc.Api/Plugin/OsuCcPlugin.cs`
- [Bundled plugins](https://github.com/rus07tam/osu-cc/tree/main/plugins): `plugins`

### Client features

- [Client settings](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientConfig.cs): `osucc.Host/Client/ClientConfig.cs`
- [Theme system](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Core/Theming/OsuCcThemeManager.cs): `osucc.Host/Core/Theming/OsuCcThemeManager.cs`
- [Client features](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientMods.cs): `osucc.Host/Client/ClientMods.cs`
- [Profile downloads](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Client/ClientProfileDownloads.cs): `osucc.Host/Client/ClientProfileDownloads.cs`
- [Score celebrations](https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Celebrations/ClientCelebrations.cs): `osucc.Api/Celebrations/ClientCelebrations.cs`

### Shared services

- [API client](https://github.com/rus07tam/osu-cc/blob/main/osucc.Shared/Api/OsuCcApiClient.cs): `osucc.Shared/Api/OsuCcApiClient.cs`
- [Cloud storage](https://github.com/rus07tam/osu-cc/blob/main/osucc.Api/Storage/CloudStorage.cs): `osucc.Api/Storage/CloudStorage.cs`
- [Scoped storage](https://github.com/rus07tam/osu-cc/blob/main/osucc.Host/Storage/ScopedStorage.cs): `osucc.Host/Storage/ScopedStorage.cs`

### Desktop launcher

- [Desktop launcher](https://github.com/rus07tam/osu-cc/blob/main/osucc.Launcher.Desktop/Program.cs): `osucc.Launcher.Desktop/Program.cs`
- [Launcher UI](https://github.com/rus07tam/osu-cc/blob/main/osucc.Launcher/Screens/MainScreen.cs): `osucc.Launcher/Screens/MainScreen.cs`

### Other components

- **Player**
- **osu!lazer**
- **osu!cc API**

## Connections

- Player → osu!lazer: uses add-on (evidence: `README.md`)
- osu!lazer → Host bootstrap: hosts runtime (evidence: `README.md`)
- Host bootstrap → Game patches: installs patches (evidence: `osucc.Host/Core/ClientBootstrapper.cs`)
- Plugin manager → Plugin loading: loads plugins (evidence: `osucc.Host/Plugin/PluginManager.cs`)
- Plugin manager → Plugin management UI: serves management
- Plugin manager → Plugin API: hosts plugins (evidence: `osucc.Host/Plugin/PluginManager.cs`)
- Bundled plugins → Plugin API: implements contracts
- Client settings → Theme system: selects theme (evidence: `osucc.Host/Client/ClientConfig.cs`)
- Theme system → Game patches: applies colours (evidence: `osucc.Host/Core/Theming/OsuCcThemeManager.cs`)
- Client features → Client settings: reads settings (evidence: `osucc.Host/Client/ClientMods.cs`)
- Profile downloads → Client settings: reads settings (evidence: `osucc.Host/Client/ClientProfileDownloads.cs`)
- Profile downloads → API client: downloads profiles
- Score celebrations → osu!lazer: uses client API (evidence: `osucc.Api/Celebrations/ClientCelebrations.cs`)
- Cloud storage → API client: sends storage requests (evidence: `osucc.Api/Storage/CloudStorage.cs`)
- Scoped storage → osu!lazer: uses game storage
- API client → osu!cc API: sends HTTP requests (evidence: `osucc.Shared/Api/OsuCcApiClient.cs`)
- Player → Desktop launcher: starts launcher
- Desktop launcher → Launcher UI: opens interface (evidence: `osucc.Launcher.Desktop/Program.cs`)
