# wanghaoyang-wilson/negameluncher-offical-opensouse-py architecture

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

- Interactive diagram: https://gitdiagram.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py
- Repository: https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py

## Overview

NE Launcher is a Python desktop game launcher. Its runtime starts by preparing user configuration and loading drives, then opens a Qt interface whose web bridge exposes launcher actions such as game launch and version selection. Those actions publish events; the event core persists player-name changes. The repository also contains a drive/plugin API and a debug server. The README describes version verification, custom scripts, and community patching as capabilities, while warning that some documented features may not yet work; their implementations are not present in the supplied tree. Details of unsampled UI handlers and drive behavior are therefore limited.

Main entry points: [`Local/main.py`](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/main.py) (Application bootstrap), [`Local/UI.py`](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/UI.py) (Qt launcher UI), [`Local/config_mgr.py`](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/config_mgr.py) (Config manager), [`Local/event_bus.py`](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/event_bus.py) (Event bus)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Startup and state"]
  node_bootstrap["Application bootstrap<br/>[main.py]"]
  node_paths["User data paths<br/>[fileRW.py]"]
  node_config["Config manager<br/>[config_mgr.py]"]
  node_jsonstore[("JSON config files<br/>[jsonedit.py]")]
end

subgraph group_interface["Launcher interface"]
  node_launcherui["Qt launcher UI<br/>[UI.py]"]
  node_ui_layout["Qt UI layout<br/>[ui_local_ui.py]"]
  node_webui["Embedded launcher page<br/>[run.html]"]
end

subgraph group_events["Events and extensions"]
  node_eventbus["Event bus<br/>[event_bus.py]"]
  node_eventcore["Player event handler<br/>[event_core.py]"]
  node_drive_manager["Drive manager<br/>[drive_mgr.py]"]
  node_drive_loader["Drive loader and API<br/>[drive_loding.py]"]
  node_drive_plugin["Drive plugin"]
  node_drive_api["Drive API example<br/>[DriveApi.py]"]
end

subgraph group_operations["Operations"]
  node_debug_server["Debug server<br/>[app.py]"]
  node_documented_capabilities["Planned launcher capabilities<br/>[README.md]"]
end

node_user(("Launcher user"))
node_game["Game process"]

node_user -->|"starts"| node_bootstrap
node_bootstrap -->|"creates paths"| node_paths
node_bootstrap -->|"initializes"| node_config
node_config -->|"loads and writes"| node_jsonstore
node_bootstrap -->|"starts"| node_drive_manager
node_bootstrap -->|"opens"| node_launcherui
node_user -->|"uses"| node_launcherui
node_launcherui -->|"sets up"| node_ui_layout
node_launcherui -->|"loads"| node_webui
node_launcherui -->|"publishes actions"| node_eventbus
node_eventcore -->|"subscribes"| node_eventbus
node_eventcore -->|"persists name"| node_config
node_drive_manager -->|"initializes"| node_drive_loader
node_drive_loader -->|"loads drives"| node_drive_plugin
node_drive_api -.->|"uses"| node_eventbus
node_bootstrap -->|"optionally starts"| node_debug_server
node_launcherui -.->|"requests game actions"| node_game
node_user -->|"README describes"| node_documented_capabilities

click node_bootstrap "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/main.py"
click node_paths "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/fileRW.py"
click node_config "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/config_mgr.py"
click node_jsonstore "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/jsonedit.py"
click node_launcherui "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/UI.py"
click node_ui_layout "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/ui_local_ui.py"
click node_webui "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/run.html"
click node_eventbus "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/event_bus.py"
click node_eventcore "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/event_core.py"
click node_drive_manager "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive_mgr.py"
click node_drive_loader "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive_loding.py"
click node_drive_plugin "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/tree/main/Local/drive"
click node_drive_api "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive/DriveApi.py"
click node_debug_server "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/DebugSever/app.py"
click node_documented_capabilities "https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/README.md"

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_paths,node_config,node_jsonstore,node_user toneBlue
class node_launcherui,node_ui_layout,node_webui toneAmber
class node_eventbus,node_eventcore,node_drive_manager,node_drive_loader,node_drive_plugin,node_drive_api toneMint
class node_debug_server,node_documented_capabilities toneRose
class node_game toneIndigo
```

## Components

### Startup and state

- [Application bootstrap](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/main.py): `Local/main.py`
- [User data paths](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/fileRW.py): `Local/fileRW.py`
- [Config manager](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/config_mgr.py): `Local/config_mgr.py`
- [JSON config files](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/jsonedit.py): `Local/jsonedit.py`

### Launcher interface

- [Qt launcher UI](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/UI.py): `Local/UI.py`
- [Qt UI layout](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/ui_local_ui.py): `Local/ui_local_ui.py`
- [Embedded launcher page](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/run.html): `Local/run.html`

### Events and extensions

- [Event bus](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/event_bus.py): `Local/event_bus.py`
- [Player event handler](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/event_core.py): `Local/event_core.py`
- [Drive manager](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive_mgr.py): `Local/drive_mgr.py`
- [Drive loader and API](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive_loding.py): `Local/drive_loding.py`
- [Drive plugin](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/tree/main/Local/drive): `Local/drive`
- [Drive API example](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/drive/DriveApi.py): `Local/drive/DriveApi.py`

### Operations

- [Debug server](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/Local/DebugSever/app.py): `Local/DebugSever/app.py`
- [Planned launcher capabilities](https://github.com/wanghaoyang-wilson/negameluncher-offical-opensouse-py/blob/main/README.md): `README.md`

### Other components

- **Launcher user**
- **Game process**

## Connections

- Launcher user → Application bootstrap: starts
- Application bootstrap → User data paths: creates paths (evidence: `Local/main.py`)
- Application bootstrap → Config manager: initializes (evidence: `Local/main.py`)
- Config manager → JSON config files: loads and writes (evidence: `Local/config_mgr.py`)
- Application bootstrap → Drive manager: starts (evidence: `Local/main.py`)
- Application bootstrap → Qt launcher UI: opens (evidence: `Local/main.py`)
- Launcher user → Qt launcher UI: uses (evidence: `Local/UI.py`)
- Qt launcher UI → Qt UI layout: sets up (evidence: `Local/UI.py`)
- Qt launcher UI → Embedded launcher page: loads (evidence: `Local/UI.py`)
- Qt launcher UI → Event bus: publishes actions (evidence: `Local/UI.py`)
- Player event handler → Event bus: subscribes (evidence: `Local/event_core.py`)
- Player event handler → Config manager: persists name (evidence: `Local/event_core.py`)
- Drive manager → Drive loader and API: initializes (evidence: `Local/drive_mgr.py`)
- Drive loader and API → Drive plugin: loads drives (evidence: `Local/drive_loding.py`)
- Drive API example → Event bus: uses (evidence: `Local/drive/DriveApi.py`)
- Application bootstrap → Debug server: optionally starts (evidence: `Local/main.py`)
- Qt launcher UI → Game process: requests game actions
- Launcher user → Planned launcher capabilities: README describes (evidence: `README.md`)
