package league_service
Get desktop application:
View/edit binary Protocol Buffers messages
message
league_service.proto:343string 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:350bool success = 1
int32 games_updated = 2
Number of games modified
string message = 3
Season management
message
league_service.proto:112string league_id = 1
optional start_date = 2
optional end_date = 3
ipc.SeasonStatus status = 4
Explicit status (SCHEDULED, ACTIVE)
message
league_service.proto:356string season_id = 1
string user_id = 2
UUID of the cheater to penalize
message
league_service.proto:361bool success = 1
int32 games_forfeited = 2
Ongoing games that were force-forfeited
int32 games_penalized = 3
Completed games with scores modified
string message = 4
message
league_service.proto:272string season_id = 1
UUID of season
int32 division_number = 2
Division number to create; existing divisions numbered >= this are shifted up by one
string division_name = 3
Optional; defaults to "Division {division_number}"
message
league_service.proto:278bool success = 1
string message = 2
string division_id = 3
UUID of the newly created division
rpc CreateLeague (, )
league_service.proto:12League management
message
league_service.proto:69string name = 1
string description = 2
string slug = 3
optional settings = 4
message
league_service.proto:284string season_id = 1
UUID of season
string division_id = 2
UUID of division to delete; must have no players registered to it
message
league_service.proto:289bool success = 1
string message = 2
int32 divisions_renumbered = 3
Remaining divisions with a higher number that were shifted down to close the gap
message
league_service.proto:128repeated divisions = 1
rpc GetAllLeagues (, )
league_service.proto:14message
league_service.proto:80bool active_only = 1
message
league_service.proto:82repeated leagues = 1
rpc GetAllSeasons (, )
league_service.proto:25message
league_service.proto:103repeated seasons = 1
Division and standings
message
league_service.proto:124string division_id = 1
message
league_service.proto:126optional division = 1
rpc GetLeague (, )
league_service.proto:13Roster: all players across all seasons, with division and standings
message
league_service.proto:175repeated 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:200repeated stats = 1
Phase 8 implementation
message
league_service.proto:101repeated seasons = 1
Head-to-head records for a player across all league seasons
message
league_service.proto:368string user_id = 1
UUID of player
string league_id = 2
UUID or slug of league
message
league_service.proto:373repeated records = 1
message
league_service.proto:160string user_id = 1
string league_id = 2
Optional: filter by specific league
message
league_service.proto:165repeated seasons = 1
message
league_service.proto:214string user_id = 1
string season_id = 2
message
league_service.proto:219repeated games = 1
message
league_service.proto:105string league_id = 1
UUID or slug
int32 limit = 2
Number of most recent seasons to return (by season_number desc)
message
league_service.proto:110repeated seasons = 1
rpc GetSeason (, )
league_service.proto:22message
league_service.proto:309repeated players = 1
message
league_service.proto:148repeated registrations = 1
message
league_service.proto:295repeated games = 1
Admin operations
message
league_service.proto:260string 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:267bool success = 1
string message = 2
message
league_service.proto:119string 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:330bool success = 1
int32 divisions_processed = 2
string message = 3
Player management
message
league_service.proto:130string league_id = 1
string user_id = 2
string season_id = 3
message
league_service.proto:136bool success = 1
string season_id = 2
message
league_service.proto:141string season_id = 1
string user_id = 2
message
league_service.proto:146bool success = 1
message
league_service.proto:91string league_id = 1
string name = 2
string description = 3
message
league_service.proto:86string league_id = 1
optional settings = 2
message
league_service.proto:319string season_id = 1
optional start_date = 2
optional end_date = 3
message
league_service.proto:325string season_id = 1
ipc.PromotionFormula promotion_formula = 2
message
league_service.proto:377Used 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:388Used 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:251Used as request type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
string user_id = 1
UUID of user to invite
message
league_service.proto:255Used as response type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
bool success = 1
string message = 2
message
league_service.proto:76Used 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:84Used as response type in: LeagueService.CreateLeague, LeagueService.GetLeague, LeagueService.UpdateLeagueMetadata, LeagueService.UpdateLeagueSettings
optional league = 1
message
league_service.proto:182Used in:
string user_id = 1
string username = 2
repeated seasons = 3
One entry per season the player participated in.
message
league_service.proto:189Used 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:205Used 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:223Used 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
optional last_update = 10
Live clock anchor, populated only for in-progress correspondence/league games (zero/unset for finished games), so a client can tick the on-turn player's deadline. last_update is the time of the last move; increment_secs is the per-turn allowance; on_turn_time_bank_ms is the on-turn player's remaining time bank in milliseconds. Whose turn it is is read from result ("turn" = this player, "in_progress" = the opponent).
int32 increment_secs = 11
int64 on_turn_time_bank_ms = 12
optional double mistake_index = 13
mistake_index is this player's "mistake score" for the game from BestBot analysis (lower is better; 0 is a perfect game). It is only present once the game has completed analysis; when absent the client should show a placeholder rather than 0, since 0 is itself a meaningful (perfect) value.
message
league_service.proto:313Used in:
string user_id = 1
string username = 2
int32 unstarted_game_count = 3
message
league_service.proto:152Used 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:97Used as request type in: LeagueService.GetAllDivisionStandings, LeagueService.GetSeason, LeagueService.GetSeasonPlayersWithUnstartedGames, LeagueService.GetSeasonRegistrations, LeagueService.GetSeasonZeroMoveGames, LeagueService.RecalculateSeasonExtendedStats
string season_id = 1
message
league_service.proto:99Used as response type in: LeagueService.BootstrapSeason, LeagueService.GetCurrentSeason, LeagueService.GetSeason, LeagueService.OpenRegistration, LeagueService.UpdateSeasonDates, LeagueService.UpdateSeasonPromotionFormula
optional season = 1
message
league_service.proto:167Used 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:299Used 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