What is SS-IMS?
The SS Integrated Management Server (SS-IMS) is an automated tournament management system designed by SSConexión for the Spanish Showdown tournament series. It provides comprehensive automation for osu! tournament operations, from qualifier lobbies to elimination matches, with complete database-driven control over all tournament data.The problem
Modern osu! tournaments have relied heavily on Google Sheets for data management, but this approach has critical scalability issues:- Data integrity problems when multiple staff members edit simultaneously
- Limited automation capabilities requiring manual updates
- Performance degradation with large datasets
- No version control or reliable audit trails
- Complex formulas that break easily
Key features
Zero-Sheet dependency
All tournament data (players, teams, matches, maps) stored in PostgreSQL with complete control over data flows
Qualifiers automation
Fully autonomous lobby management including room creation, map cycling, and timer management
Elimination automation
State-machine based logic handling pick/ban phases, best-of logic, tiebreaker enforcement, and win conditions
Panic protocol
Built-in fail-safe mechanisms allowing referees to instantly override automation during disputes
Discord integration
Bi-directional communication for match control, live logs, and player notifications via Discord threads
Redundant score importing
Multiple parsing methods including CSV imports and native osu! API integration
Dynamic match management
Complete bracket management through Discord commands and database admin tools
Comprehensive testing
Extensive test suite verifying all tournament match flows and automation logic
How it works
SS-IMS bridges the gap between Discord (for coordination and logging) and Bancho IRC (for osu! lobby management):- Discord serves as the entry point where tournament staff initialize matches, manage schedules, and monitor automation
- BanchoSharp handles IRC communication with osu! servers to control multiplayer lobbies
- PostgreSQL provides the central source of truth for all tournament data
- State machines drive the automation logic for both qualifier and elimination matches
Get started
Quickstart
Get from zero to your first automated match in minutes
Installation
Detailed setup instructions for deploying SS-IMS
Discord commands
Complete reference for all Discord slash commands
Automation concepts
Understand how the automation systems work
System architecture
The system consists of several core components:- Discord Manager: Handles all Discord bot functionality, slash commands, and thread management
- AutoRef Qualifiers: State machine for autonomous qualifier lobby automation
- AutoRef Elimination: State machine for head-to-head match automation with pick/ban phases
- Database Layer: Entity Framework Core with PostgreSQL for all data persistence
- IRC Bridge: BanchoSharp integration for osu! Bancho communication
Use cases
SS-IMS is ideal for:- Large-scale osu! tournaments requiring reliable automation
- Tournament series needing consistent data management across multiple events
- Organizers who want to eliminate Google Sheets dependency
- Teams requiring comprehensive audit trails and match logs
- Tournaments with complex scheduling needs and player availability coordination