How teio980/umamusumeass works
UmamusumeAss is a Windows desktop assistant that connects to an Android emulator and automates configurable Umamusume workflows. The main path runs from user-configured tasks through connection setup and visual automation to game actions and execution logs. The README documents task-queue management, Career and independent training, races, reward collection, shop workflows, and developer editing tools. Sampled source supports the Hachimi runner’s visual-runtime calls and Career engine structure; other task-family links reflect documented capabilities and tree paths, not inspected implementations.
Main entry points: AdbVisualPipelineRuntime.cs Visual runtime · Tasks Task modules · SettingsViewModel.cs Connection settings · App.xaml.cs WPF application
Components 23
Desktop interface
- WPF application
src/UmamusumeWpfGui/App.xaml.cs - Task workspace
src/UmamusumeWpfGui/ViewModels/GrassViewModel.cs - Task settings
src/UmamusumeWpfGui/ViewModels/Tasks - Workflow editor
src/UmamusumeWpfGui/ViewModels/DeveloperToolsViewModel.cs - Execution logs
src/UmamusumeWpfGui/ViewModels/HachimiTaskLogViewModel.cs
Emulator connection
- Connection settings
src/UmamusumeWpfGui/ViewModels/SettingsViewModel.cs - Device discovery
src/UmamusumeWpfGui/Helper/EmulatorProfileCatalog.cs - ADB session
src/UmamusumeWpfGui/Services/AdbConnectionSessionFactory.cs - Connection health
src/UmamusumeWpfGui/Services/ConnectionHealthMonitor.cs
Workflow execution
- Task modules
src/UmamusumeWpfGui/Services/Tasks - Career engine
src/UmamusumeWpfGui/Services/Training/Runtime/CareerTrainingEngine.cs - Independent training
src/UmamusumeWpfGui/Services/Training/AdbIndependentTrainingPipeline.cs - JSON workflow runner
src/UmamusumeWpfGui/Services/Tasks/HachimiJsonPipelineRunner.cs - Workflow definitions
src/UmamusumeWpfGui/Models/HachimiPipelineModels.cs
Visual interaction
- Visual runtime
src/UmamusumeWpfGui/Services/Tasks/AdbVisualPipelineRuntime.cs - Offline OCR
src/UmamusumeWpfGui/Services/Tasks/WindowsOcrTextRecognizer.cs - Template matching
src/UmamusumeWpfGui/Services/Tasks/TemplateMatcher.cs
Settings and data
- Local settings
src/UmamusumeWpfGui/Services/JsonSettingsService.cs - Uma database
src/UmamusumeWpfGui/Services/UmaDatabaseService.cs - Localization
src/UmamusumeWpfGui/Services/LocalizationService.cs
Other components
- Trainer
- ADB
- Android emulator
Connections 26
- Trainer → WPF application: uses
- WPF application → Task workspace: presents
- Task workspace → Task settings: configures
- Task workspace → Task modules: starts tasks
- Trainer → Connection settings: configures
- Connection settings → Local settings: persists
- Connection settings → Device discovery: requests discovery
- Device discovery → ADB: queries devices
- Connection settings → ADB session: opens session
- ADB session → ADB: runs commands
- ADB → Android emulator: controls
- ADB session → Connection health: monitors
- Task modules → Career engine: runs Career
- Task modules → Independent training: runs training
- Task modules → JSON workflow runner: runs workflows
- Workflow editor → Workflow definitions: edits
- JSON workflow runner → Workflow definitions: loads
- Career engine → Visual runtime: observes and acts
- Independent training → Visual runtime: captures and acts
- JSON workflow runner → Visual runtime: requests interactions
- Visual runtime → ADB: captures and inputs
- Visual runtime → Offline OCR: recognizes text
- Visual runtime → Template matching: matches images
- Task modules → Execution logs: reports results
- WPF application → Localization: displays language
- Career engine → Uma database: reads game data