# babalae/better-genshin-impact architecture

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

- Interactive diagram: https://gitdiagram.com/babalae/better-genshin-impact
- Repository: https://github.com/babalae/better-genshin-impact

## Overview

BetterGI is a Windows desktop assistant for Genshin Impact, automating gameplay through computer vision and simulated input. Its broad user workflow is to start the app, choose game capture, then run real-time helpers or standalone tasks that interpret the game screen and issue actions; other documented capabilities include scripted/pathing automation, macros, and plugins. The graph preserves these major branches and representative internal recognition, input, and task layers. Relationships are limited to README-described behavior or visible source references; unsampled task wiring is left unasserted.

Main entry points: [`BetterGenshinImpact/App.xaml.cs`](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/App.xaml.cs) (BetterGI App), [`BetterGenshinImpact/Core/Input/InputHub.cs`](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Input/InputHub.cs) (Input Simulation), [`BetterGenshinImpact/Core/Recognition/RecognitionObject.cs`](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/RecognitionObject.cs) (Image Recognition), [`BetterGenshinImpact/GameTask`](https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask) (Real-time Helpers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Desktop App"]
  node_app["BetterGI App<br/>[App.xaml.cs]"]
  node_config["Configuration<br/>[AllConfig.cs]"]
end

subgraph group_automation["Gameplay Automation"]
  node_realtime["Real-time Helpers"]
  node_standalone["Standalone Tasks"]
  node_one_dragon["Daily Routine"]
  node_pathing["Pathing Tasks"]
  node_recording["Input Recording"]
  node_quest_voice["Quest Voice<br/>[GptSovitsEngine.cs]"]
end

subgraph group_vision["Vision and Input"]
  node_capture["Game Capture"]
  node_recognition["Image Recognition"]
  node_inference["ONNX Runtime"]
  node_ocr["OCR<br/>[OcrFactory.cs]"]
  node_input["Input Simulation<br/>[InputHub.cs]"]
  node_mask["Overlay Mask"]
end

subgraph group_extensions["Scripts and Plugins"]
  node_script["Script Engine<br/>[ScriptExecution.cs]"]
  node_script_repos[("Script Repositories")]
  node_plugins["Plugin Hosting<br/>[PluginManager.cs]"]
end

subgraph group_services["App Services"]
  node_storage_ui["Storage Manager"]
  node_storage["Storage Service<br/>[StorageArea.cs]"]
  node_storage_provider["App Storage Areas"]
  node_map_state[("Map Mask State")]
end

node_user(("Player"))
node_tts_service["GPT-SoVITS"]

node_user -->|"starts"| node_app
node_app -->|"captures game"| node_capture
node_app -->|"loads settings"| node_config
node_user -->|"runs helpers"| node_realtime
node_user -->|"starts tasks"| node_standalone
node_user -->|"starts routine"| node_one_dragon
node_user -->|"runs routes"| node_pathing
node_user -->|"records input"| node_recording
node_capture -.->|"provides frames"| node_recognition
node_recognition -.->|"uses models"| node_inference
node_recognition -.->|"uses OCR"| node_ocr
node_realtime -->|"simulates actions"| node_input
node_standalone -->|"simulates actions"| node_input
node_pathing -.->|"simulates actions"| node_input
node_recording -.->|"records events"| node_input
node_app -->|"shows overlay"| node_mask
node_user -->|"runs scripts"| node_script
node_script -.->|"loads resources"| node_script_repos
node_app -->|"initializes plugins"| node_plugins
node_user -->|"manages storage"| node_storage_ui
node_storage_ui -->|"cleans areas"| node_storage
node_storage_provider -->|"registers areas"| node_storage
node_user -.->|"tracks map state"| node_map_state
node_quest_voice -->|"sends HTTP requests"| node_tts_service

click node_app "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/App.xaml.cs"
click node_config "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Config/AllConfig.cs"
click node_realtime "https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask"
click node_standalone "https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask"
click node_one_dragon "https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask"
click node_pathing "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/Dependence/AutoPathingScript.cs"
click node_recording "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recorder/KeyMouseRecorder.cs"
click node_capture "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/Fischless.GameCapture/Graphics/GraphicsCaptureV2.cs"
click node_recognition "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/RecognitionObject.cs"
click node_inference "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/ONNX/InferenceRuntimeService.cs"
click node_ocr "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/OCR/OcrFactory.cs"
click node_input "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Input/InputHub.cs"
click node_mask "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Mask/MaskWindowDrawingBoard.cs"
click node_script "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/ScriptExecution.cs"
click node_script_repos "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/Repositories/ScriptRepositoryStore.cs"
click node_plugins "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Plugins/Hosting/PluginManager.cs"
click node_storage_ui "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/ViewModel/Windows/StorageManagementViewModel.cs"
click node_storage "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Infrastructure/Storage/StorageArea.cs"
click node_storage_provider "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Service/AppStorageAreaProvider.cs"
click node_map_state "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/GameTask/MapMask/MapMaskStateStorage.cs"
click node_quest_voice "https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/GameTask/QuestVoice/Features/Tts/GptSovitsEngine.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_app,node_config toneBlue
class node_realtime,node_standalone,node_one_dragon,node_pathing,node_recording,node_quest_voice toneAmber
class node_capture,node_recognition,node_inference,node_ocr,node_input,node_mask toneMint
class node_script,node_script_repos,node_plugins toneRose
class node_storage_ui,node_storage,node_storage_provider,node_map_state,node_user,node_tts_service toneIndigo
```

## Components

### Desktop App

- [BetterGI App](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/App.xaml.cs): `BetterGenshinImpact/App.xaml.cs`
- [Configuration](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Config/AllConfig.cs): `BetterGenshinImpact/Core/Config/AllConfig.cs`

### Gameplay Automation

- [Real-time Helpers](https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask): `BetterGenshinImpact/GameTask`
- [Standalone Tasks](https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask): `BetterGenshinImpact/GameTask`
- [Daily Routine](https://github.com/babalae/better-genshin-impact/tree/refactor/20260930/BetterGenshinImpact/GameTask): `BetterGenshinImpact/GameTask`
- [Pathing Tasks](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/Dependence/AutoPathingScript.cs): `BetterGenshinImpact/Core/Script/Dependence/AutoPathingScript.cs`
- [Input Recording](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recorder/KeyMouseRecorder.cs): `BetterGenshinImpact/Core/Recorder/KeyMouseRecorder.cs`
- [Quest Voice](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/GameTask/QuestVoice/Features/Tts/GptSovitsEngine.cs): `BetterGenshinImpact/GameTask/QuestVoice/Features/Tts/GptSovitsEngine.cs`

### Vision and Input

- [Game Capture](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/Fischless.GameCapture/Graphics/GraphicsCaptureV2.cs): `Fischless.GameCapture/Graphics/GraphicsCaptureV2.cs`
- [Image Recognition](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/RecognitionObject.cs): `BetterGenshinImpact/Core/Recognition/RecognitionObject.cs`
- [ONNX Runtime](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/ONNX/InferenceRuntimeService.cs): `BetterGenshinImpact/Core/Recognition/ONNX/InferenceRuntimeService.cs`
- [OCR](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Recognition/OCR/OcrFactory.cs): `BetterGenshinImpact/Core/Recognition/OCR/OcrFactory.cs`
- [Input Simulation](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Input/InputHub.cs): `BetterGenshinImpact/Core/Input/InputHub.cs`
- [Overlay Mask](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Mask/MaskWindowDrawingBoard.cs): `BetterGenshinImpact/Core/Mask/MaskWindowDrawingBoard.cs`

### Scripts and Plugins

- [Script Engine](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/ScriptExecution.cs): `BetterGenshinImpact/Core/Script/ScriptExecution.cs`
- [Script Repositories](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Script/Repositories/ScriptRepositoryStore.cs): `BetterGenshinImpact/Core/Script/Repositories/ScriptRepositoryStore.cs`
- [Plugin Hosting](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Core/Plugins/Hosting/PluginManager.cs): `BetterGenshinImpact/Core/Plugins/Hosting/PluginManager.cs`

### App Services

- [Storage Manager](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/ViewModel/Windows/StorageManagementViewModel.cs): `BetterGenshinImpact/ViewModel/Windows/StorageManagementViewModel.cs`
- [Storage Service](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Infrastructure/Storage/StorageArea.cs): `BetterGenshinImpact/Infrastructure/Storage/StorageArea.cs`
- [App Storage Areas](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/Service/AppStorageAreaProvider.cs): `BetterGenshinImpact/Service/AppStorageAreaProvider.cs`
- [Map Mask State](https://github.com/babalae/better-genshin-impact/blob/refactor/20260930/BetterGenshinImpact/GameTask/MapMask/MapMaskStateStorage.cs): `BetterGenshinImpact/GameTask/MapMask/MapMaskStateStorage.cs`

### Other components

- **Player**
- **GPT-SoVITS**

## Connections

- Player → BetterGI App: starts (evidence: `README.md`)
- BetterGI App → Game Capture: captures game (evidence: `README.md`)
- BetterGI App → Configuration: loads settings (evidence: `BetterGenshinImpact/App.xaml.cs`)
- Player → Real-time Helpers: runs helpers (evidence: `README.md`)
- Player → Standalone Tasks: starts tasks (evidence: `README.md`)
- Player → Daily Routine: starts routine (evidence: `README.md`)
- Player → Pathing Tasks: runs routes (evidence: `README.md`)
- Player → Input Recording: records input (evidence: `README.md`)
- Game Capture → Image Recognition: provides frames
- Image Recognition → ONNX Runtime: uses models
- Image Recognition → OCR: uses OCR
- Real-time Helpers → Input Simulation: simulates actions (evidence: `README.md`)
- Standalone Tasks → Input Simulation: simulates actions (evidence: `README.md`)
- Pathing Tasks → Input Simulation: simulates actions
- Input Recording → Input Simulation: records events
- BetterGI App → Overlay Mask: shows overlay (evidence: `README.md`)
- Player → Script Engine: runs scripts (evidence: `README.md`)
- Script Engine → Script Repositories: loads resources
- BetterGI App → Plugin Hosting: initializes plugins (evidence: `BetterGenshinImpact/App.xaml.cs`)
- Player → Storage Manager: manages storage
- Storage Manager → Storage Service: cleans areas (evidence: `BetterGenshinImpact/ViewModel/Windows/StorageManagementViewModel.cs`)
- App Storage Areas → Storage Service: registers areas (evidence: `BetterGenshinImpact/Service/AppStorageAreaProvider.cs`)
- Player → Map Mask State: tracks map state
- Quest Voice → GPT-SoVITS: sends HTTP requests (evidence: `BetterGenshinImpact/GameTask/QuestVoice/Features/Tts/GptSovitsEngine.cs`)
