package league_service
Get desktop application:
View/edit binary Protocol Buffers messages
message
league_service.proto:374string 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:381bool success = 1
int32 games_updated = 2
Number of games modified
string message = 3
Season management
message
league_service.proto:114string league_id = 1
optional start_date = 2
optional end_date = 3
ipc.SeasonStatus status = 4
Explicit status (SCHEDULED, ACTIVE)
message
league_service.proto:387string season_id = 1
string user_id = 2
UUID of the cheater to penalize
message
league_service.proto:392bool 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:303string 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:309bool 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:71string name = 1
string description = 2
string slug = 3
optional settings = 4
message
league_service.proto:315string 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:320bool 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:148repeated divisions = 1
rpc GetAllLeagues (, )
league_service.proto:14message
league_service.proto:82bool active_only = 1
message
league_service.proto:84repeated leagues = 1
rpc GetAllSeasons (, )
league_service.proto:25message
league_service.proto:105repeated seasons = 1
message
league_service.proto:146repeated games = 1
Division and standings
message
league_service.proto:128optional division = 1
rpc GetLeague (, )
league_service.proto:13Roster: all players across all seasons, with division and standings
message
league_service.proto:195repeated 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:222repeated stats = 1
Phase 8 implementation
message
league_service.proto:103repeated seasons = 1
Head-to-head records for a player across all league seasons
message
league_service.proto:399string user_id = 1
UUID of player
string league_id = 2
UUID or slug of league
message
league_service.proto:404repeated records = 1
message
league_service.proto:180string user_id = 1
string league_id = 2
Optional: filter by specific league
message
league_service.proto:185repeated seasons = 1
message
league_service.proto:236string user_id = 1
string season_id = 2
message
league_service.proto:241repeated games = 1
message
league_service.proto:107string league_id = 1
UUID or slug
int32 limit = 2
Number of most recent seasons to return (by season_number desc)
message
league_service.proto:112repeated seasons = 1
rpc GetSeason (, )
league_service.proto:22message
league_service.proto:340repeated players = 1
message
league_service.proto:168repeated registrations = 1
message
league_service.proto:326repeated games = 1
Admin operations
message
league_service.proto:291string 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:298bool success = 1
string message = 2
message
league_service.proto:121string 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:361bool success = 1
int32 divisions_processed = 2
string message = 3
Player management
message
league_service.proto:150string league_id = 1
string user_id = 2
string season_id = 3
message
league_service.proto:156bool success = 1
string season_id = 2
message
league_service.proto:161string season_id = 1
string user_id = 2
message
league_service.proto:166bool success = 1
message
league_service.proto:93string league_id = 1
string name = 2
string description = 3
message
league_service.proto:88string league_id = 1
optional settings = 2
message
league_service.proto:350string season_id = 1
optional start_date = 2
optional end_date = 3
message
league_service.proto:356string season_id = 1
ipc.PromotionFormula promotion_formula = 2
message
league_service.proto:132One game of a division, for the cross-table. Scores are final once the game has ended, and the running scores while it is in progress.
Used in:
string game_id = 1
string player0_user_id = 2
string player1_user_id = 3
int32 player0_score = 4
int32 player1_score = 5
ipc.GameEndReason game_end_reason = 6
NONE while the game is in progress.
int32 winner_index = 7
0 or 1 for a finished game's winner; -1 for a draw or a game in progress.
int32 player_on_turn = 8
The player on turn in a game in progress; -1 otherwise.
message
league_service.proto:126Used as request type in: LeagueService.GetDivisionCrosstable, LeagueService.GetDivisionStandings
string division_id = 1
message
league_service.proto:408Used 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:419Used 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:282Used as request type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
string user_id = 1
UUID of user to invite
message
league_service.proto:286Used as response type in: LeagueService.InviteUserToLeagues, LeagueService.RevokeUserFromLeagues
bool success = 1
string message = 2
message
league_service.proto:78Used 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:86Used as response type in: LeagueService.CreateLeague, LeagueService.GetLeague, LeagueService.UpdateLeagueMetadata, LeagueService.UpdateLeagueSettings
optional league = 1
message
league_service.proto:202Used in:
string user_id = 1
string username = 2
repeated seasons = 3
One entry per season the player participated in.
message
league_service.proto:209Used 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
optional int32 timeouts = 9
Games lost on time that season; unset from a server that predates it.
message
league_service.proto:227Used 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:245Used 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.
optional double opponent_mistake_index = 14
opponent_mistake_index is the opponent's, under the same rules.
int32 player_tiles_played = 15
Tile progress, populated only for in-progress games: the tiles each player has on the board, and the tiles not yet played (bag and both racks). A game's tiles are the sum of the three.
int32 opponent_tiles_played = 16
int32 tiles_unplayed = 17
message
league_service.proto:344Used in:
string user_id = 1
string username = 2
int32 unstarted_game_count = 3
message
league_service.proto:172Used 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:99Used as request type in: LeagueService.GetAllDivisionStandings, LeagueService.GetSeason, LeagueService.GetSeasonPlayersWithUnstartedGames, LeagueService.GetSeasonRegistrations, LeagueService.GetSeasonZeroMoveGames, LeagueService.RecalculateSeasonExtendedStats
string season_id = 1
message
league_service.proto:101Used as response type in: LeagueService.BootstrapSeason, LeagueService.GetCurrentSeason, LeagueService.GetSeason, LeagueService.OpenRegistration, LeagueService.UpdateSeasonDates, LeagueService.UpdateSeasonPromotionFormula
optional season = 1
message
league_service.proto:187Used 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:330Used 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