How hamza-apps/osu-humanized-bot works
This is a Python osu! standard-mode gameplay automation bot. The documented workflow captures the game screen, detects hit objects, decides whether and when to hit, then moves and clicks the cursor; configuration controls behavior, while the bot tracks hit statistics. The source shows that the beatmap analyzer is initialized but not used in gameplay, and its analysis methods are placeholders. The README also describes broader timing and anti-detection capabilities, but sampled code does not establish additional subsystems or integrations.
Main entry points: osu_bot.py Gameplay loop · screen_capture.py Screen capture · hit_object_detector.py Hit-object detection · cursor_controller.py Cursor movement
Components 11
Gameplay orchestration
- Gameplay loop
src/osu_bot.py - Hit statistics
src/osu_bot.py
Screen perception
- Screen capture
src/screen_capture.py - Hit-object detection
src/hit_object_detector.py
Humanized action
- Cursor movement
src/cursor_controller.py
Settings and analysis
- Settings loader
config/settings.py - Bot settings
config/bot_settings.json - Beatmap analysis
src/beatmap_analyzer.py
Other components
- Bot operator
- Game display
- Mouse input
Connections 13
- Bot operator → Gameplay loop: starts
README.md - Gameplay loop → Settings loader: loads settings
src/osu_bot.py - Settings loader → Bot settings: reads or creates
config/settings.py - Gameplay loop → Screen capture: captures screen
src/osu_bot.py - Screen capture → Game display: captures pixels
src/screen_capture.py - Screen capture → Gameplay loop: returns screenshot
src/osu_bot.py - Gameplay loop → Hit-object detection: detects objects
src/osu_bot.py - Hit-object detection → Gameplay loop: returns detections
src/osu_bot.py - Gameplay loop → Cursor movement: moves cursor
src/osu_bot.py - Cursor movement → Mouse input: moves pointer
src/cursor_controller.py - Gameplay loop → Mouse input: clicks target
src/osu_bot.py - Gameplay loop → Hit statistics: updates hit count
src/osu_bot.py - Gameplay loop → Beatmap analysis: initializes
src/osu_bot.py