package league_service
Get desktop application:
View/edit binary Protocol Buffers messages
message
league_service.proto:302string season_id = 1
Required: UUID of the season
string user_id = 2
UUID of player (required unless scope is ALL_PLAYERS)
int32 additional_minutes = 3
Minutes to add to time bank
TimeBankScope scope = 4
Which games/players to affect
message
league_service.proto:309bool success = 1
int32 games_updated = 2
Number of games modified
string message = 3
Season management
message
league_service.proto:110string league_id = 1
optional start_date = 2
optional end_date = 3
ipc.SeasonStatus status = 4
Explicit status (SCHEDULED, ACTIVE)
message
league_service.proto:315string season_id = 1
string user_id = 2
UUID of the cheater to penalize
message
league_service.proto:320bool success = 1
int32 games_forfeited = 2
Ongoing games that were force-forfeited
int32 games_penalized = 3
Completed games with scores modified
string message = 4
rpc CreateLeague (, )
league_service.proto:12League management
message
league_service.proto:67string name = 1
string description = 2
string slug = 3
optional settings = 4
message
league_service.proto:126repeated divisions = 1
rpc GetAllLeagues (, )
league_service.proto:14message
league_service.proto:78bool active_only = 1
message
league_service.proto:80repeated leagues = 1
rpc GetAllSeasons (, )
league_service.proto:25message
league_service.proto:101repeated seasons = 1
Division and standings
message
league_service.proto:122string division_id = 1
message
league_service.proto:124optional division = 1
rpc GetLeague (, )
league_service.proto:13Roster: all players across all seasons, with division and standings
message
league_service.proto:173repeated players = 1
All players who have ever played in this league.
repeated int32 season_numbers = 2
Season numbers present in the league, ascending.
Statistics (Phase 8)
message
league_service.proto:198repeated stats = 1
Phase 8 implementation
message
league_service.proto:99repeated seasons = 1
Head-to-head records for a player across all league seasons
message
league_service.proto:327string user_id = 1
UUID of player
string league_id = 2
UUID or slug of league
message
league_service.proto:332repeated records = 1
message
league_service.proto:158string user_id = 1
string league_id = 2
Optional: filter by specific league
message
league_service.proto:163repeated seasons = 1
message
league_service.proto:212string user_id = 1
string season_id = 2
message
league_service.proto:217repeated games = 1
message
league_service.proto:103string league_id = 1
UUID or slug
int32 limit = 2
Number of most recent seasons to return (by season_number desc)
message
league_service.proto:108repeated seasons = 1
rpc GetSeason (, )
league_service.proto:22message
league_service.proto:268repeated players = 1
message
league_service.proto:146repeated registrations = 1
message
league_service.proto:254repeated games = 1
Admin operations
message
league_service.proto:242string user_id = 1
UUID of player to move
string season_id = 2
UUID of season
string from_division_id = 3
UUID of current division
string to_division_id = 4
UUID of target division
message
league_service.proto:249bool success = 1
string message = 2
message
league_service.proto:117string league_id = 1
UUID or slug (for context, not used)
string season_id = 2
Required: UUID of season to open registration for
message
league_service.proto:289bool success = 1
int32 divisions_processed = 2
string message = 3
Player management
message
league_service.proto:128string league_id = 1
string user_id = 2
string season_id = 3
message
league_service.proto:134bool success = 1
string season_id = 2
message
league_service.proto:139string season_id = 1
string user_id = 2
message
league_service.proto:144bool success = 1
message
league_service.proto:89string league_id = 1
string name = 2
string description = 3
message
league_service.proto:84string league_id = 1
optional settings = 2
message
league_service.proto:278string season_id = 1
optional start_date = 2
optional end_date = 3
message
league_service.proto:284string season_id = 1
ipc.PromotionFormula promotion_formula = 2
message
league_service.proto:336Used in:
string opponent_user_id = 1
string opponent_username = 2
int32 wins = 3
int32 losses = 4
int32 draws = 5
int32 spread = 6
repeated season_games = 7
Per-season game details (empty until backend is deployed with this field)
message
league_service.proto:347Used in:
int32 season_number = 1
bool won = 2
bool draw = 3
int32 player_score = 4
int32 opponent_score = 5
int32 game_end_reason = 6
message
league_service.proto:233Used as request type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
string user_id = 1
UUID of user to invite
message
league_service.proto:237Used as response type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
bool success = 1
string message = 2
message
league_service.proto:74Used as request type in: LeagueService.GetAllSeasons, LeagueService.GetCurrentSeason, LeagueService.GetLeague, LeagueService.GetLeagueRoster, LeagueService.GetLeagueStatistics, LeagueService.GetPastSeasons
string league_id = 1
UUID or slug
message
league_service.proto:82Used as response type in: LeagueService.CreateLeague, LeagueService.GetLeague, LeagueService.UpdateLeagueMetadata, LeagueService.UpdateLeagueSettings
optional league = 1
message
league_service.proto:180Used in:
string user_id = 1
string username = 2
repeated seasons = 3
One entry per season the player participated in.
message
league_service.proto:187Used in:
int32 season_number = 1
int32 division_number = 2
int32 rank = 3
Final rank in division (0 if season incomplete)
int32 wins = 4
int32 losses = 5
int32 draws = 6
int32 spread = 7
ipc.StandingResult result = 8
Promoted, relegated, stayed, champion
message
league_service.proto:203Used in:
string stat_type = 1
string user_id = 2
string username = 3
int32 value = 4
string game_id = 5
int32 division_number = 6
message
league_service.proto:221Used in:
string game_id = 1
string opponent_user_id = 2
string opponent_username = 3
int32 player_score = 4
int32 opponent_score = 5
string result = 6
"win", "loss", "draw", "turn", "in_progress"
optional game_date = 7
int32 round = 8
Optional round number
ipc.GameEndReason game_end_reason = 9
message
league_service.proto:272Used in:
string user_id = 1
string username = 2
int32 unstarted_game_count = 3
message
league_service.proto:150Used in:
string user_id = 1
string username = 2
string season_id = 3
string division_id = 4
Empty if not assigned to division yet
int32 division_number = 5
0 if not assigned to division yet
message
league_service.proto:95Used as request type in: LeagueService.GetAllDivisionStandings, LeagueService.GetSeason, LeagueService.GetSeasonPlayersWithUnstartedGames, LeagueService.GetSeasonRegistrations, LeagueService.GetSeasonZeroMoveGames, LeagueService.RecalculateSeasonExtendedStats
string season_id = 1
message
league_service.proto:97Used as response type in: LeagueService.BootstrapSeason, LeagueService.GetCurrentSeason, LeagueService.GetSeason, LeagueService.OpenRegistration, LeagueService.UpdateSeasonDates, LeagueService.UpdateSeasonPromotionFormula
optional season = 1
message
league_service.proto:165Used in:
string season_id = 1
int32 season_number = 2
string league_name = 3
int32 division_number = 4
optional standing = 5
Scope for time bank additions
Used in:
TIMEBANK_SCOPE_SINGLE_PLAYER = 0
Only the specified player's side in their games
TIMEBANK_SCOPE_PLAYER_AND_OPPONENT = 1
Both sides of the player's games
TIMEBANK_SCOPE_ALL_PLAYERS = 2
All in-progress games in the season
message
league_service.proto:258Used in:
string game_id = 1
optional created_at = 2
string player0_id = 3
string player0_username = 4
string player1_id = 5
string player1_username = 6
string division_id = 7