How futurelesswindchan/kazefactor works
KazeFactor is an Android assistant for managing Soul Knight challenge-factor recipes and automatically refreshing the game until a target appears. The main workflow is recipe configuration and rule/probability feedback, followed by accessibility-service capture, calibration and slot recognition, safe refresh decisions, and overlay feedback. Separate capabilities include offline recipe-code sharing and manual position setup. The graph follows documented workflows and sampled wiring; several subsystem links are documented in the README rather than verified from their unsampled implementations.
Main entry points: RefreshEngine.kt Refresh state machine · KazeAccessibilityService.kt Accessibility service · RecipeRepository.kt Recipe repository · MainActivity.kt App navigation
Components 28
App experience
- App navigation
app/src/main/java/io/github/futurelesswindchan/kazefactor/MainActivity.kt - Recipe screens
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/ui/screen - Recipe view models
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/viewmodel - Recipe code UI
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/ui/screen/RecipeCodeScreen.kt - Permission guide
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/ui/screen/PermissionGuideScreen.kt - Control overlay
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/overlay
Recipe domain
- Recipe and factors
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/model/Recipe.kt - Factor database
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/model/FactorDatabase.kt - Rules and probability
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/rule - Recipe code codec
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/codec
Screen vision
- Frame recognition
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/FrameAnalyzer.kt - Auto calibration
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Calibrator.kt - Profile verification
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/ProfileVerifier.kt - Manual edge snapping
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Snapper.kt - Coordinate calibration
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Calibration.kt - Profile model
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/CalibrationProfile.kt - Image operations
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/image/ImageOps.kt
Refresh automation
- Accessibility service
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/KazeAccessibilityService.kt - Screen capture
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/A11yScreenCapturer.kt - Gesture tapper
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/GestureTapper.kt - Refresh state machine
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Candidate decisions
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/Decision.kt - Engine state
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/EngineState.kt
Persistence
- Recipe repository
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/repository/RecipeRepository.kt - Recipe storage
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/datastore/RecipeDataStore.kt - Engine settings
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/datastore/EngineSettingsDataStore.kt - Calibration profiles
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/datastore/CalibrationProfileDataStore.kt
Other components
- Player
Connections 31
- Player → App navigation: opens
README.md - App navigation → Recipe screens: routes to
app/src/main/java/io/github/futurelesswindchan/kazefactor/MainActivity.kt - App navigation → Recipe view models: creates
app/src/main/java/io/github/futurelesswindchan/kazefactor/MainActivity.kt - Recipe screens → Recipe view models: uses
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/ui/screen/RecipeListScreen.kt - Recipe view models → Recipe repository: queries
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/viewmodel/RecipeListViewModel.kt - Recipe repository → Recipe storage: reads and writes
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/repository/RecipeRepository.kt - Recipe repository → Rules and probability: validates
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/repository/RecipeRepository.kt - Recipe repository → Factor database: uses
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/repository/RecipeRepository.kt - Rules and probability → Recipe and factors: checks
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/rule/RuleEngine.kt - Rules and probability → Factor database: consults
core-domain/src/main/kotlin/io/github/futurelesswindchan/kazefactor/domain/rule/RuleEngine.kt - Recipe code UI → Recipe code codec: encodes codes
- Player → Permission guide: sets up service
README.md - Player → Control overlay: controls refresh
README.md - Accessibility service → Screen capture: creates
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/KazeAccessibilityService.kt - Accessibility service → Gesture tapper: creates
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/KazeAccessibilityService.kt - Accessibility service → Refresh state machine: assembles
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/KazeAccessibilityService.kt - Accessibility service → Control overlay: connects
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/service/KazeAccessibilityService.kt - Refresh state machine → Screen capture: captures frames
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Gesture tapper: sends taps
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Frame recognition: analyzes frames
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Candidate decisions: evaluates candidates
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Auto calibration: calibrates frames
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Profile verification: verifies profile
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/RefreshEngine.kt - Refresh state machine → Engine state: publishes state
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/loop/EngineState.kt - Candidate decisions → Recipe and factors: matches recipe
README.md - Auto calibration → Frame recognition: validates slots
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Calibrator.kt - Auto calibration → Image operations: processes pixels
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Calibrator.kt - Manual edge snapping → Coordinate calibration: fits coordinates
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/Snapper.kt - Profile verification → Profile model: checks profile
core-engine/src/main/kotlin/io/github/futurelesswindchan/kazefactor/engine/vision/CalibrationProfile.kt - Calibration profiles → Profile model: persists profile
app/src/main/kotlin/io/github/futurelesswindchan/kazefactor/data/datastore/CalibrationProfileDataStore.kt - Engine settings → Refresh state machine: provides settings