# kauri-off/th08-rs architecture

> Architecture diagram of the GitHub repository kauri-off/th08-rs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kauri-off/th08-rs
- Repository: https://github.com/kauri-off/th08-rs

## Overview

This repository is an unofficial Rust reimplementation of Touhou 8, with desktop, Android, and browser front ends. The main user workflow is to select or import the player’s game files, configure the port, launch and play the game, then use its save, replay, and score features. The architecture separates platform/app orchestration from deterministic game logic, asset formats, rendering, and audio. The graph preserves documented capabilities and central indexed modules; some subsystem links are omitted or dashed because their implementation was not excerpted.

Main entry points: [`crates/th08-core/src/game.rs`](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/game.rs) (Game context and flow), [`src/launcher.rs`](https://github.com/kauri-off/th08-rs/blob/master/src/launcher.rs) (Launcher), [`src/sources.rs`](https://github.com/kauri-off/th08-rs/blob/master/src/sources.rs) (Game data sources), [`src/app.rs`](https://github.com/kauri-off/th08-rs/blob/master/src/app.rs) (App loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["App and launcher"]
  node_launcher["Launcher<br/>[launcher.rs]"]
  node_android_launcher["Android launcher"]
  node_app_loop["App loop<br/>[app.rs]"]
  node_settings["Settings<br/>[settings.rs]"]
  node_settings_store["Settings store<br/>[settings_store.rs]"]
  node_menu["Pause and settings menu<br/>[portmenu.rs]"]
  node_menu_model["Menu state<br/>[menu_model.rs]"]
  node_platform["Platform input and host<br/>[platform.rs]"]
  node_touch["Touch controls<br/>[touch.rs]"]
end

subgraph group_game["Game runtime"]
  node_game["Game context and flow<br/>[game.rs]"]
  node_enemies["Enemy simulation<br/>[enemy.rs]"]
  node_bullets["Bullet simulation<br/>[bullet.rs]"]
  node_ecl["ECL scripting<br/>[eclvm.rs]"]
  node_player_logic["Player simulation<br/>[player.rs]"]
  node_replay["Replay playback<br/>[replay.rs]"]
end

subgraph group_assets["Game data"]
  node_game_import["Game file import<br/>[gameimport.rs]"]
  node_sources["Game data sources<br/>[sources.rs]"]
  node_formats["Game file formats<br/>[archive.rs]"]
  node_repack["Translation pack building<br/>[import.rs]"]
end

subgraph group_presentation["Presentation"]
  node_drawlist["Draw command list<br/>[drawlist.rs]"]
  node_renderer["Graphics renderer<br/>[gfx.rs]"]
  node_audio["Audio playback<br/>[audio.rs]"]
end

subgraph group_records["Records and integrations"]
  node_records["Saves and replays<br/>[replays.rs]"]
  node_stats["Play statistics<br/>[stats.rs]"]
  node_translations["Translations UI<br/>[i18n.rs]"]
  node_updates["Update checks<br/>[update.rs]"]
end

node_player(("Player"))
node_game_files["Player-owned game files"]
node_storage[("Save storage")]
node_patch_center(("Touhou Patch Center"))

node_player -->|"chooses files"| node_launcher
node_launcher -->|"starts game"| node_app_loop
node_player -->|"imports files"| node_android_launcher
node_android_launcher -.->|"imports game data"| node_game_import
node_game_files -->|"supplies assets"| node_sources
node_game_import -.->|"converts for storage"| node_sources
node_app_loop -->|"uses launcher flow"| node_launcher
node_app_loop -.->|"uses host services"| node_platform
node_app_loop -.->|"loads and runs"| node_game
node_settings -.->|"selects data source"| node_sources
node_launcher -->|"configures"| node_settings
node_launcher -->|"reads and writes"| node_settings_store
node_launcher -->|"shows translations"| node_translations
node_launcher -->|"checks updates"| node_updates
node_player -->|"plays"| node_game
node_game -.->|"simulates"| node_enemies
node_game -.->|"updates player"| node_player_logic
node_enemies -->|"uses"| node_bullets
node_enemies -->|"runs scripts"| node_ecl
node_sources -.->|"reads game data"| node_formats
node_patch_center -->|"provides translation"| node_repack
node_repack -.->|"builds game pack"| node_sources
node_game -.->|"emits draw commands"| node_drawlist
node_drawlist -.->|"renders commands"| node_renderer
node_game -.->|"plays BGM"| node_audio
node_game -.->|"plays recorded inputs"| node_replay
node_player -->|"opens pause menu"| node_menu
node_menu -->|"updates menu state"| node_menu_model
node_menu -->|"edits settings"| node_settings
node_platform -->|"uses touch input"| node_touch
node_game -.->|"stores replays"| node_records
node_game -->|"saves scores"| node_storage
node_player -->|"browses replays"| node_records
node_game -.->|"records play statistics"| node_stats

click node_launcher "https://github.com/kauri-off/th08-rs/blob/master/src/launcher.rs"
click node_android_launcher "https://github.com/kauri-off/th08-rs/blob/master/android/app/src/main/java/org/th08/port/LauncherActivity.kt"
click node_app_loop "https://github.com/kauri-off/th08-rs/blob/master/src/app.rs"
click node_settings "https://github.com/kauri-off/th08-rs/blob/master/src/settings.rs"
click node_settings_store "https://github.com/kauri-off/th08-rs/blob/master/src/settings_store.rs"
click node_menu "https://github.com/kauri-off/th08-rs/blob/master/src/platform/portmenu.rs"
click node_menu_model "https://github.com/kauri-off/th08-rs/blob/master/src/menu_model.rs"
click node_platform "https://github.com/kauri-off/th08-rs/blob/master/src/platform.rs"
click node_touch "https://github.com/kauri-off/th08-rs/blob/master/src/platform/touch.rs"
click node_game_import "https://github.com/kauri-off/th08-rs/blob/master/src/gameimport.rs"
click node_sources "https://github.com/kauri-off/th08-rs/blob/master/src/sources.rs"
click node_formats "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-formats/src/archive.rs"
click node_repack "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-repack/src/import.rs"
click node_game "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/game.rs"
click node_enemies "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/enemy.rs"
click node_bullets "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/bullet.rs"
click node_ecl "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/eclvm.rs"
click node_player_logic "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/player.rs"
click node_replay "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/replay.rs"
click node_drawlist "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-out/src/drawlist.rs"
click node_renderer "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-render/src/gfx.rs"
click node_audio "https://github.com/kauri-off/th08-rs/blob/master/crates/th08-audio/src/audio.rs"
click node_records "https://github.com/kauri-off/th08-rs/blob/master/src/replays.rs"
click node_stats "https://github.com/kauri-off/th08-rs/blob/master/src/stats.rs"
click node_translations "https://github.com/kauri-off/th08-rs/blob/master/src/i18n.rs"
click node_updates "https://github.com/kauri-off/th08-rs/blob/master/src/update.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_launcher,node_android_launcher,node_app_loop,node_settings,node_settings_store,node_menu,node_menu_model,node_platform,node_touch toneBlue
class node_game,node_enemies,node_bullets,node_ecl,node_player_logic,node_replay,node_storage toneAmber
class node_game_import,node_sources,node_formats,node_repack toneMint
class node_drawlist,node_renderer,node_audio toneRose
class node_records,node_stats,node_translations,node_updates,node_player,node_game_files,node_patch_center toneIndigo
```

## Components

### App and launcher

- [Launcher](https://github.com/kauri-off/th08-rs/blob/master/src/launcher.rs): `src/launcher.rs`
- [Android launcher](https://github.com/kauri-off/th08-rs/blob/master/android/app/src/main/java/org/th08/port/LauncherActivity.kt): `android/app/src/main/java/org/th08/port/LauncherActivity.kt`
- [App loop](https://github.com/kauri-off/th08-rs/blob/master/src/app.rs): `src/app.rs`
- [Settings](https://github.com/kauri-off/th08-rs/blob/master/src/settings.rs): `src/settings.rs`
- [Settings store](https://github.com/kauri-off/th08-rs/blob/master/src/settings_store.rs): `src/settings_store.rs`
- [Pause and settings menu](https://github.com/kauri-off/th08-rs/blob/master/src/platform/portmenu.rs): `src/platform/portmenu.rs`
- [Menu state](https://github.com/kauri-off/th08-rs/blob/master/src/menu_model.rs): `src/menu_model.rs`
- [Platform input and host](https://github.com/kauri-off/th08-rs/blob/master/src/platform.rs): `src/platform.rs`
- [Touch controls](https://github.com/kauri-off/th08-rs/blob/master/src/platform/touch.rs): `src/platform/touch.rs`

### Game runtime

- [Game context and flow](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/game.rs): `crates/th08-core/src/game.rs`
- [Enemy simulation](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/enemy.rs): `crates/th08-core/src/enemy.rs`
- [Bullet simulation](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/bullet.rs): `crates/th08-core/src/bullet.rs`
- [ECL scripting](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/eclvm.rs): `crates/th08-core/src/eclvm.rs`
- [Player simulation](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/player.rs): `crates/th08-core/src/player.rs`
- [Replay playback](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-core/src/replay.rs): `crates/th08-core/src/replay.rs`

### Game data

- [Game file import](https://github.com/kauri-off/th08-rs/blob/master/src/gameimport.rs): `src/gameimport.rs`
- [Game data sources](https://github.com/kauri-off/th08-rs/blob/master/src/sources.rs): `src/sources.rs`
- [Game file formats](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-formats/src/archive.rs): `crates/th08-formats/src/archive.rs`
- [Translation pack building](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-repack/src/import.rs): `crates/th08-repack/src/import.rs`

### Presentation

- [Draw command list](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-out/src/drawlist.rs): `crates/th08-out/src/drawlist.rs`
- [Graphics renderer](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-render/src/gfx.rs): `crates/th08-render/src/gfx.rs`
- [Audio playback](https://github.com/kauri-off/th08-rs/blob/master/crates/th08-audio/src/audio.rs): `crates/th08-audio/src/audio.rs`

### Records and integrations

- [Saves and replays](https://github.com/kauri-off/th08-rs/blob/master/src/replays.rs): `src/replays.rs`
- [Play statistics](https://github.com/kauri-off/th08-rs/blob/master/src/stats.rs): `src/stats.rs`
- [Translations UI](https://github.com/kauri-off/th08-rs/blob/master/src/i18n.rs): `src/i18n.rs`
- [Update checks](https://github.com/kauri-off/th08-rs/blob/master/src/update.rs): `src/update.rs`

### Other components

- **Player**
- **Player-owned game files**
- **Save storage**
- **Touhou Patch Center**

## Connections

- Player → Launcher: chooses files (evidence: `README.md`)
- Launcher → App loop: starts game (evidence: `README.md`)
- Player → Android launcher: imports files (evidence: `README.md`)
- Android launcher → Game file import: imports game data
- Player-owned game files → Game data sources: supplies assets (evidence: `README.md`)
- Game file import → Game data sources: converts for storage
- App loop → Launcher: uses launcher flow (evidence: `src/app.rs`)
- App loop → Platform input and host: uses host services (evidence: `src/app.rs`)
- App loop → Game context and flow: loads and runs
- Settings → Game data sources: selects data source
- Launcher → Settings: configures (evidence: `src/launcher.rs`)
- Launcher → Settings store: reads and writes (evidence: `src/launcher.rs`)
- Launcher → Translations UI: shows translations (evidence: `src/launcher.rs`)
- Launcher → Update checks: checks updates (evidence: `src/launcher.rs`)
- Player → Game context and flow: plays (evidence: `README.md`)
- Game context and flow → Enemy simulation: simulates (evidence: `crates/th08-core/src/enemy.rs`)
- Game context and flow → Player simulation: updates player
- Enemy simulation → Bullet simulation: uses (evidence: `crates/th08-core/src/enemy.rs`)
- Enemy simulation → ECL scripting: runs scripts (evidence: `crates/th08-core/src/enemy.rs`)
- Game data sources → Game file formats: reads game data
- Touhou Patch Center → Translation pack building: provides translation (evidence: `README.md`)
- Translation pack building → Game data sources: builds game pack
- Game context and flow → Draw command list: emits draw commands
- Draw command list → Graphics renderer: renders commands
- Game context and flow → Audio playback: plays BGM
- Game context and flow → Replay playback: plays recorded inputs
- Player → Pause and settings menu: opens pause menu (evidence: `README.md`)
- Pause and settings menu → Menu state: updates menu state (evidence: `src/platform/portmenu.rs`)
- Pause and settings menu → Settings: edits settings (evidence: `src/platform/portmenu.rs`)
- Platform input and host → Touch controls: uses touch input (evidence: `src/platform.rs`)
- Game context and flow → Saves and replays: stores replays
- Game context and flow → Save storage: saves scores (evidence: `README.md`)
- Player → Saves and replays: browses replays (evidence: `README.md`)
- Game context and flow → Play statistics: records play statistics
