How ptrchain/osu-echo works
osu-echo is a local osu! server: the game client connects to its Bancho-compatible server, submits scores and replays, and receives local profile, leaderboard, and bot responses. Score submission decodes replay data, stores plays, updates medals, and can notify Discord; PP and rank features also use online services. Separate web routes provide profiles and osu!direct-style beatmap access. The graph follows documented capabilities and indexed module references; several route and runtime details are unsampled, so uncertain dispatch links are omitted.
Main entry points: score_submit.rs Score submission · cho.rs Bancho protocol · banchobot.rs BanchoBot · db.rs SQLite data
Components 26
Server runtime
- Application startup
src/main.rs - HTTP server
src/server/mod.rs - Request routing
src/server/router.rs - Bancho protocol
src/handlers/cho.rs - Packet encoding
src/packets.rs
Scores and maps
- Score submission
src/handlers/score_submit.rs - Replay decoding
src/handlers/score_decode.rs - Score models
src/types/score.rs - Beatmap models
src/types/beatmap.rs - PP and map utilities
src/utils.rs
Profiles and bots
- Chat command dispatch
src/handlers/chat_commands.rs - BanchoBot
src/handlers/banchobot.rs - Tillerino
src/handlers/tillerino.rs - Medal awards
src/handlers/medals.rs
Web features
- API endpoints
src/handlers/api.rs - Profiles and leaderboards
src/handlers/website.rs - Web endpoints
src/handlers/web.rs - Avatar handling
src/handlers/avatar.rs - Discord notifications
src/handlers/webhook.rs
Shared services
- SQLite data
src/db.rs - Shared application state
src/state.rs - Configuration wizard
src/types/config.rs
Other components
- osu! client
- Discord
- osu! APIs
- Catboy map mirror
Connections 28
- osu! client → HTTP server: connects to
README.md - Application startup → HTTP server: starts
src/main.rs - HTTP server → Request routing: configures
src/server/mod.rs - Request routing → Bancho protocol: routes requests
- Bancho protocol → Chat command dispatch: dispatches chat
src/handlers/cho.rs - Bancho protocol → Packet encoding: encodes responses
src/handlers/cho.rs - Score submission → Replay decoding: decodes replay
src/handlers/score_submit.rs - Score submission → SQLite data: stores scores
src/handlers/score_submit.rs - Score submission → Medal awards: checks awards
src/handlers/score_submit.rs - Score submission → Discord notifications: notifies
src/handlers/score_submit.rs - Score submission → PP and map utilities: calculates PP
src/handlers/score_submit.rs - Replay decoding → Score models: builds score
src/handlers/score_decode.rs - Score submission → Score models: uses score
src/handlers/score_submit.rs - Score submission → Beatmap models: uses map data
src/handlers/score_submit.rs - Chat command dispatch → BanchoBot: dispatches commands
src/handlers/chat_commands.rs - Chat command dispatch → Tillerino: dispatches commands
src/handlers/chat_commands.rs - BanchoBot → SQLite data: reads and writes
src/handlers/banchobot.rs - BanchoBot → Tillerino: delegates to
src/handlers/banchobot.rs - BanchoBot → Medal awards: syncs medals
src/handlers/banchobot.rs - API endpoints → SQLite data: reads and writes
src/handlers/api.rs - Profiles and leaderboards → SQLite data: reads and writes
src/handlers/website.rs - Web endpoints → Score submission: uses submission
src/handlers/web.rs - Web endpoints → Replay decoding: uses decoder
src/handlers/web.rs - Discord notifications → Discord: posts plays
README.md - PP and map utilities → osu! APIs: fetches data
src/utils.rs - Web endpoints → Catboy map mirror: downloads maps
README.md - Score submission → Shared application state: uses shared state
src/handlers/score_submit.rs - Bancho protocol → Shared application state: uses shared state
src/handlers/cho.rs