# weiss-ultimatesavior/tyranor-next architecture

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

- Interactive diagram: https://gitdiagram.com/weiss-ultimatesavior/tyranor-next
- Repository: https://github.com/weiss-ultimatesavior/tyranor-next

## Overview

Tyranor Next is an Android visual-novel game library and multi-engine launcher. Users scan or manually add games, review the detected library, configure engines, and launch a game through an integrated runtime or an external APK/emulator. The app also documents cover retrieval, save mirroring, online patches, archive tools, authentication, and background updates. The graph combines sampled source references with README-documented capabilities; several feature links use the README because their implementation files were not sampled.

Main entry points: [`app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt`](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt) (Launch orchestrator), [`app/src/main/java/com/tyranor/next/ui/game/GameScreen.kt`](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/game/GameScreen.kt) (Game library UI), [`app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt`](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt) (Game scanner), [`app/src/main/java/com/tyranor/next/core/engine/external/ExternalEngineModule.kt`](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/external/ExternalEngineModule.kt) (External APK modules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_library["Library workflow"]
  node_library_ui["Game library UI<br/>[GameScreen.kt]"]
  node_scan["Game scanner<br/>[EngineScanner.kt]"]
  node_game_model["Game records<br/>[ScanGame.kt]"]
  node_library_store[("Library storage")]
end

subgraph group_runtime["Launch and runtimes"]
  node_launcher["Launch orchestrator<br/>[EngineLauncher.kt]"]
  node_engine_catalog["Engine catalog<br/>[EngineType.kt]"]
  node_plugin_bootstrap["Native plugin setup"]
  node_external_modules["External APK modules"]
  node_external_emulators["External emulators"]
  node_built_in["Built-in runtimes"]
end

subgraph group_content["Game services"]
  node_covers["Cover retrieval"]
  node_saves["Save management<br/>[GameSaveManager.kt]"]
  node_patches["Online patches"]
  node_archives["Archive tools<br/>[ArchiveScanner.kt]"]
end

subgraph group_preferences["Settings and identity"]
  node_settings_ui["Settings UI<br/>[SettingsScreen.kt]"]
  node_settings_store[("Engine settings")]
  node_auth["Hikarinagi auth"]
end

subgraph group_platform["App platform"]
  node_updater["Background updater"]
  node_main_ui["App navigation<br/>[MainScreen.kt]"]
end

node_player(("Player"))
node_external_targets["APK and emulator apps"]
node_auth_service["OAuth service"]

node_player -->|"opens app"| node_main_ui
node_main_ui -.->|"navigates to"| node_library_ui
node_player -->|"manages games"| node_library_ui
node_library_ui -.->|"starts scan"| node_scan
node_scan -->|"creates records"| node_game_model
node_scan -->|"records results"| node_library_store
node_library_ui -.->|"requests launch"| node_launcher
node_launcher -->|"selects engine"| node_engine_catalog
node_launcher -->|"starts runtime"| node_built_in
node_launcher -->|"dispatches module"| node_external_modules
node_launcher -->|"dispatches emulator"| node_external_emulators
node_external_modules -->|"launches APK"| node_external_targets
node_external_emulators -->|"opens emulator"| node_external_targets
node_plugin_bootstrap -->|"installs plugins"| node_built_in
node_player -->|"configures engines"| node_settings_ui
node_settings_ui -->|"updates settings"| node_settings_store
node_player -->|"requests covers"| node_covers
node_covers -->|"uses authorization"| node_auth
node_auth -->|"performs OAuth"| node_auth_service
node_player -->|"manages saves"| node_saves
node_player -->|"applies patches"| node_patches
node_player -->|"unpacks archives"| node_archives
node_updater -.->|"downloads updates"| node_external_targets

click node_library_ui "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/game/GameScreen.kt"
click node_scan "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt"
click node_game_model "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/model/ScanGame.kt"
click node_library_store "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/storage/GameLibraryRepository.kt"
click node_launcher "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt"
click node_engine_catalog "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/EngineType.kt"
click node_plugin_bootstrap "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/plugin/EnginePluginBootstrap.kt"
click node_external_modules "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/external/ExternalEngineModule.kt"
click node_external_emulators "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/external/ExternalEmulatorLauncher.kt"
click node_built_in "https://github.com/weiss-ultimatesavior/tyranor-next/tree/main/engine/src/main/java/com/core"
click node_covers "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/cover/CoverScraperService.kt"
click node_saves "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/save/GameSaveManager.kt"
click node_patches "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/patch/KrkrOnlinePatchService.kt"
click node_archives "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/unpack/ArchiveScanner.kt"
click node_settings_ui "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/settings/SettingsScreen.kt"
click node_settings_store "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/settings/EngineSettingsStore.kt"
click node_auth "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/auth/HikarinagiAuthService.kt"
click node_updater "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/updater/BackgroundUpdateWorker.kt"
click node_main_ui "https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/main/MainScreen.kt"

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_library_ui,node_scan,node_game_model,node_library_store toneBlue
class node_launcher,node_engine_catalog,node_plugin_bootstrap,node_external_modules,node_external_emulators,node_built_in toneAmber
class node_covers,node_saves,node_patches,node_archives toneMint
class node_settings_ui,node_settings_store,node_auth toneRose
class node_updater,node_main_ui,node_player,node_external_targets,node_auth_service toneIndigo
```

## Components

### Library workflow

- [Game library UI](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/game/GameScreen.kt): `app/src/main/java/com/tyranor/next/ui/game/GameScreen.kt`
- [Game scanner](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt): `app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt`
- [Game records](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/model/ScanGame.kt): `app/src/main/java/com/tyranor/next/core/game/model/ScanGame.kt`
- [Library storage](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/storage/GameLibraryRepository.kt): `app/src/main/java/com/tyranor/next/core/game/storage/GameLibraryRepository.kt`

### Launch and runtimes

- [Launch orchestrator](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt): `app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt`
- [Engine catalog](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/EngineType.kt): `app/src/main/java/com/tyranor/next/core/engine/EngineType.kt`
- [Native plugin setup](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/plugin/EnginePluginBootstrap.kt): `app/src/main/java/com/tyranor/next/core/engine/plugin/EnginePluginBootstrap.kt`
- [External APK modules](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/external/ExternalEngineModule.kt): `app/src/main/java/com/tyranor/next/core/engine/external/ExternalEngineModule.kt`
- [External emulators](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/engine/external/ExternalEmulatorLauncher.kt): `app/src/main/java/com/tyranor/next/core/engine/external/ExternalEmulatorLauncher.kt`
- [Built-in runtimes](https://github.com/weiss-ultimatesavior/tyranor-next/tree/main/engine/src/main/java/com/core): `engine/src/main/java/com/core`

### Game services

- [Cover retrieval](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/cover/CoverScraperService.kt): `app/src/main/java/com/tyranor/next/core/cover/CoverScraperService.kt`
- [Save management](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/game/save/GameSaveManager.kt): `app/src/main/java/com/tyranor/next/core/game/save/GameSaveManager.kt`
- [Online patches](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/patch/KrkrOnlinePatchService.kt): `app/src/main/java/com/tyranor/next/core/patch/KrkrOnlinePatchService.kt`
- [Archive tools](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/unpack/ArchiveScanner.kt): `app/src/main/java/com/tyranor/next/core/unpack/ArchiveScanner.kt`

### Settings and identity

- [Settings UI](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/settings/SettingsScreen.kt): `app/src/main/java/com/tyranor/next/ui/settings/SettingsScreen.kt`
- [Engine settings](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/settings/EngineSettingsStore.kt): `app/src/main/java/com/tyranor/next/core/settings/EngineSettingsStore.kt`
- [Hikarinagi auth](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/auth/HikarinagiAuthService.kt): `app/src/main/java/com/tyranor/next/core/auth/HikarinagiAuthService.kt`

### App platform

- [Background updater](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/core/updater/BackgroundUpdateWorker.kt): `app/src/main/java/com/tyranor/next/core/updater/BackgroundUpdateWorker.kt`
- [App navigation](https://github.com/weiss-ultimatesavior/tyranor-next/blob/main/app/src/main/java/com/tyranor/next/ui/main/MainScreen.kt): `app/src/main/java/com/tyranor/next/ui/main/MainScreen.kt`

### Other components

- **Player**
- **APK and emulator apps**
- **OAuth service**

## Connections

- Player → App navigation: opens app
- App navigation → Game library UI: navigates to
- Player → Game library UI: manages games
- Game library UI → Game scanner: starts scan
- Game scanner → Game records: creates records (evidence: `app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt`)
- Game scanner → Library storage: records results (evidence: `app/src/main/java/com/tyranor/next/core/game/scan/EngineScanner.kt`)
- Game library UI → Launch orchestrator: requests launch
- Launch orchestrator → Engine catalog: selects engine (evidence: `app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt`)
- Launch orchestrator → Built-in runtimes: starts runtime (evidence: `app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt`)
- Launch orchestrator → External APK modules: dispatches module
- Launch orchestrator → External emulators: dispatches emulator (evidence: `app/src/main/java/com/tyranor/next/core/game/launch/EngineLauncher.kt`)
- External APK modules → APK and emulator apps: launches APK
- External emulators → APK and emulator apps: opens emulator
- Native plugin setup → Built-in runtimes: installs plugins (evidence: `app/src/main/java/com/tyranor/next/core/engine/plugin/EnginePluginBootstrap.kt`)
- Player → Settings UI: configures engines
- Settings UI → Engine settings: updates settings
- Player → Cover retrieval: requests covers
- Cover retrieval → Hikarinagi auth: uses authorization (evidence: `app/src/main/java/com/tyranor/next/core/cover/CoverScraperService.kt`)
- Hikarinagi auth → OAuth service: performs OAuth (evidence: `app/src/main/java/com/tyranor/next/core/auth/HikarinagiAuthService.kt`)
- Player → Save management: manages saves
- Player → Online patches: applies patches
- Player → Archive tools: unpacks archives
- Background updater → APK and emulator apps: downloads updates
