# alban1911/rose architecture

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

- Interactive diagram: https://gitdiagram.com/alban1911/rose
- Repository: https://github.com/alban1911/rose

## Overview

Rose is a Windows League of Legends skin changer. Its main workflow detects a champion-select skin through League Client plugins, communicates the selection to the Python backend, then prepares and injects eligible skin assets when the game starts. The graph also preserves documented mod, chroma, party-sharing, client-customization, updater, and analytics capabilities. Several implementation details are unsampled, so documented links use the README and uncertain connections are omitted.

Main entry points: [`pengu/communication/message_handler.py`](https://github.com/alban1911/rose/blob/main/pengu/communication/message_handler.py) (Plugin Message Handler), [`injection/core/manager.py`](https://github.com/alban1911/rose/blob/main/injection/core/manager.py) (Injection Orchestrator), [`Pengu Loader/plugins/ROSE-SkinMonitor/index.js`](https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-SkinMonitor/index.js) (Skin Monitor), [`Pengu Loader/plugins/ROSE-PartyMode/index.js`](https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-PartyMode/index.js) (Party Mode UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["League Client"]
  node_league["League Client"]
  node_skin_monitor["Skin Monitor<br/>[index.js]"]
  node_rose_plugins["Skin UI Plugins"]
  node_party_plugin["Party Mode UI<br/>[index.js]"]
  node_jade["Jade Customization"]
end

subgraph group_backend["Backend Coordination"]
  node_python_bridge["Pengu Integration<br/>[pengu_loader.py]"]
  node_ws_server["WebSocket Server"]
  node_message_handler["Plugin Message Handler<br/>[message_handler.py]"]
  node_flow["Message Processing<br/>[flow_controller.py]"]
  node_lcu["LCU Client<br/>[client.py]"]
  node_game_monitor["Game Monitoring<br/>[game_monitor.py]"]
  node_phase_handlers["Phase Handling<br/>[phase_handler.py]"]
end

subgraph group_skins["Skin Management"]
  node_mod_storage[("Mod Storage<br/>[storage.py]")]
  node_mod_download["Skin Downloads<br/>[skin_downloader.py]"]
  node_mod_manager["Mod Management<br/>[mod_manager.py]"]
  node_inject_manager["Injection Orchestrator<br/>[manager.py]"]
  node_overlay["Overlay Injection<br/>[overlay_manager.py]"]
  node_patcher["LTK Patcher<br/>[patcher.py]"]
end

subgraph group_sharing["Party Sharing"]
  node_party_manager["Party Manager<br/>[party_manager.py]"]
  node_party_network["Relay Networking<br/>[ws_relay.py]"]
  node_cloud_relay["Cloudflare Relay<br/>[index.ts]"]
end

subgraph group_support["App Services"]
  node_chroma_ui["Chroma UI<br/>[panel.py]"]
  node_historic_random["Historic and Random"]
  node_updater["Auto Updater<br/>[update_sequence.py]"]
  node_analytics["Usage Analytics"]
end

node_user(("Player"))

node_user -->|"selects skin"| node_league
node_league -->|"hosts plugin"| node_skin_monitor
node_skin_monitor -->|"sends selection"| node_python_bridge
node_python_bridge -.->|"integrates loader"| node_ws_server
node_ws_server -.->|"dispatches messages"| node_message_handler
node_message_handler -.->|"processes messages"| node_flow
node_message_handler -->|"uses mod storage"| node_mod_storage
node_league -->|"uses skin features"| node_rose_plugins
node_league -->|"uses party controls"| node_party_plugin
node_league -->|"offers customization"| node_jade
node_phase_handlers -.->|"reads client state"| node_lcu
node_game_monitor -->|"signals game start"| node_inject_manager
node_inject_manager -->|"prepares mods"| node_mod_manager
node_inject_manager -.->|"starts injection"| node_overlay
node_overlay -->|"uses patcher tools"| node_patcher
node_mod_download -.->|"downloads assets"| node_mod_storage
node_party_plugin -->|"shares selections"| node_party_manager
node_party_manager -->|"connects rooms"| node_party_network
node_party_network -->|"uses WebSocket relay"| node_cloud_relay
node_user -->|"chooses chroma"| node_chroma_ui
node_chroma_ui -.->|"supports skin selection"| node_league
node_user -->|"uses skin options"| node_historic_random
node_user -->|"receives updates"| node_updater
node_analytics -->|"sends usage pings"| node_user

click node_skin_monitor "https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-SkinMonitor/index.js"
click node_rose_plugins "https://github.com/alban1911/rose/tree/main/Pengu%20Loader/plugins/ROSE-CustomSkinSelector"
click node_party_plugin "https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-PartyMode/index.js"
click node_jade "https://github.com/alban1911/rose/tree/main/Pengu%20Loader/plugins/ROSE-Jade/config/js/plugins"
click node_python_bridge "https://github.com/alban1911/rose/blob/main/utils/integration/pengu_loader.py"
click node_ws_server "https://github.com/alban1911/rose/blob/main/pengu/core/websocket_server.py"
click node_message_handler "https://github.com/alban1911/rose/blob/main/pengu/communication/message_handler.py"
click node_flow "https://github.com/alban1911/rose/blob/main/pengu/processing/flow_controller.py"
click node_lcu "https://github.com/alban1911/rose/blob/main/lcu/core/client.py"
click node_game_monitor "https://github.com/alban1911/rose/blob/main/injection/game/game_monitor.py"
click node_phase_handlers "https://github.com/alban1911/rose/blob/main/threads/handlers/phase_handler.py"
click node_mod_storage "https://github.com/alban1911/rose/blob/main/injection/mods/storage.py"
click node_mod_download "https://github.com/alban1911/rose/blob/main/utils/download/skin_downloader.py"
click node_mod_manager "https://github.com/alban1911/rose/blob/main/injection/mods/mod_manager.py"
click node_inject_manager "https://github.com/alban1911/rose/blob/main/injection/core/manager.py"
click node_overlay "https://github.com/alban1911/rose/blob/main/injection/overlay/overlay_manager.py"
click node_patcher "https://github.com/alban1911/rose/blob/main/injection/tools/patcher.py"
click node_party_manager "https://github.com/alban1911/rose/blob/main/party/core/party_manager.py"
click node_party_network "https://github.com/alban1911/rose/blob/main/party/network/ws_relay.py"
click node_cloud_relay "https://github.com/alban1911/rose/blob/main/relay-worker/src/index.ts"
click node_chroma_ui "https://github.com/alban1911/rose/blob/main/ui/chroma/panel.py"
click node_historic_random "https://github.com/alban1911/rose/blob/main/ui/handlers/randomization_handler.py"
click node_updater "https://github.com/alban1911/rose/blob/main/launcher/update/update_sequence.py"
click node_analytics "https://github.com/alban1911/rose/blob/main/analytics/core/analytics_client.py"

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_league,node_skin_monitor,node_rose_plugins,node_party_plugin,node_jade toneBlue
class node_python_bridge,node_ws_server,node_message_handler,node_flow,node_lcu,node_game_monitor,node_phase_handlers toneAmber
class node_mod_storage,node_mod_download,node_mod_manager,node_inject_manager,node_overlay,node_patcher toneMint
class node_party_manager,node_party_network,node_cloud_relay toneRose
class node_chroma_ui,node_historic_random,node_updater,node_analytics,node_user toneIndigo
```

## Components

### League Client

- **League Client**
- [Skin Monitor](https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-SkinMonitor/index.js): `Pengu Loader/plugins/ROSE-SkinMonitor/index.js`
- [Skin UI Plugins](https://github.com/alban1911/rose/tree/main/Pengu%20Loader/plugins/ROSE-CustomSkinSelector): `Pengu Loader/plugins/ROSE-CustomSkinSelector`
- [Party Mode UI](https://github.com/alban1911/rose/blob/main/Pengu%20Loader/plugins/ROSE-PartyMode/index.js): `Pengu Loader/plugins/ROSE-PartyMode/index.js`
- [Jade Customization](https://github.com/alban1911/rose/tree/main/Pengu%20Loader/plugins/ROSE-Jade/config/js/plugins): `Pengu Loader/plugins/ROSE-Jade/config/js/plugins`

### Backend Coordination

- [Pengu Integration](https://github.com/alban1911/rose/blob/main/utils/integration/pengu_loader.py): `utils/integration/pengu_loader.py`
- [WebSocket Server](https://github.com/alban1911/rose/blob/main/pengu/core/websocket_server.py): `pengu/core/websocket_server.py`
- [Plugin Message Handler](https://github.com/alban1911/rose/blob/main/pengu/communication/message_handler.py): `pengu/communication/message_handler.py`
- [Message Processing](https://github.com/alban1911/rose/blob/main/pengu/processing/flow_controller.py): `pengu/processing/flow_controller.py`
- [LCU Client](https://github.com/alban1911/rose/blob/main/lcu/core/client.py): `lcu/core/client.py`
- [Game Monitoring](https://github.com/alban1911/rose/blob/main/injection/game/game_monitor.py): `injection/game/game_monitor.py`
- [Phase Handling](https://github.com/alban1911/rose/blob/main/threads/handlers/phase_handler.py): `threads/handlers/phase_handler.py`

### Skin Management

- [Mod Storage](https://github.com/alban1911/rose/blob/main/injection/mods/storage.py): `injection/mods/storage.py`
- [Skin Downloads](https://github.com/alban1911/rose/blob/main/utils/download/skin_downloader.py): `utils/download/skin_downloader.py`
- [Mod Management](https://github.com/alban1911/rose/blob/main/injection/mods/mod_manager.py): `injection/mods/mod_manager.py`
- [Injection Orchestrator](https://github.com/alban1911/rose/blob/main/injection/core/manager.py): `injection/core/manager.py`
- [Overlay Injection](https://github.com/alban1911/rose/blob/main/injection/overlay/overlay_manager.py): `injection/overlay/overlay_manager.py`
- [LTK Patcher](https://github.com/alban1911/rose/blob/main/injection/tools/patcher.py): `injection/tools/patcher.py`

### Party Sharing

- [Party Manager](https://github.com/alban1911/rose/blob/main/party/core/party_manager.py): `party/core/party_manager.py`
- [Relay Networking](https://github.com/alban1911/rose/blob/main/party/network/ws_relay.py): `party/network/ws_relay.py`
- [Cloudflare Relay](https://github.com/alban1911/rose/blob/main/relay-worker/src/index.ts): `relay-worker/src/index.ts`

### App Services

- [Chroma UI](https://github.com/alban1911/rose/blob/main/ui/chroma/panel.py): `ui/chroma/panel.py`
- [Historic and Random](https://github.com/alban1911/rose/blob/main/ui/handlers/randomization_handler.py): `ui/handlers/randomization_handler.py`
- [Auto Updater](https://github.com/alban1911/rose/blob/main/launcher/update/update_sequence.py): `launcher/update/update_sequence.py`
- [Usage Analytics](https://github.com/alban1911/rose/blob/main/analytics/core/analytics_client.py): `analytics/core/analytics_client.py`

### Other components

- **Player**

## Connections

- Player → League Client: selects skin
- League Client → Skin Monitor: hosts plugin
- Skin Monitor → Pengu Integration: sends selection
- Pengu Integration → WebSocket Server: integrates loader
- WebSocket Server → Plugin Message Handler: dispatches messages
- Plugin Message Handler → Message Processing: processes messages
- Plugin Message Handler → Mod Storage: uses mod storage (evidence: `pengu/communication/message_handler.py`)
- League Client → Skin UI Plugins: uses skin features
- League Client → Party Mode UI: uses party controls
- League Client → Jade Customization: offers customization
- Phase Handling → LCU Client: reads client state
- Game Monitoring → Injection Orchestrator: signals game start (evidence: `injection/core/manager.py`)
- Injection Orchestrator → Mod Management: prepares mods (evidence: `injection/core/manager.py`)
- Injection Orchestrator → Overlay Injection: starts injection
- Overlay Injection → LTK Patcher: uses patcher tools (evidence: `injection/overlay/overlay_manager.py`)
- Skin Downloads → Mod Storage: downloads assets
- Party Mode UI → Party Manager: shares selections
- Party Manager → Relay Networking: connects rooms (evidence: `party/core/party_manager.py`)
- Relay Networking → Cloudflare Relay: uses WebSocket relay
- Player → Chroma UI: chooses chroma
- Chroma UI → League Client: supports skin selection
- Player → Historic and Random: uses skin options
- Player → Auto Updater: receives updates
- Usage Analytics → Player: sends usage pings
