package ipc

Get desktop application:
View/edit binary Protocol Buffers messages

• string id = 1

• repeated ActiveGamePlayer player = 2

• int64 ttl = 3

  time to live, in seconds

Used in: ActiveGameEntry

• string username = 1

• string user_id = 2

• string game_id = 1

Used in: GameDocument

• bytes tiles = 1

Sent when the annotation state of games within a broadcast changes (e.g. a game is claimed or unclaimed). Clients invalidate GetBroadcastGames only.

• string slug = 1

Sent when a live broadcast's feed data has been updated (scores, new round, etc.) Clients listening on channel-broadcast-{slug} re-fetch broadcast games on receipt.

• string slug = 1

• int32 current_round = 2

Used in: GameDocument, LeagueSettings, OMGWordsChallengeResultEvent, omgwords_service.CreateAnnotatedGameRequest, omgwords_service.ImportGCGRequest

• ChallengeRule_VOID = 0

• ChallengeRule_SINGLE = 1

• ChallengeRule_DOUBLE = 2

• ChallengeRule_FIVE_POINT = 3

• ChallengeRule_TEN_POINT = 4

• ChallengeRule_TRIPLE = 5

Used in: ChatMessages

• string username = 1

• string channel = 2

• string message = 3

• int64 timestamp = 4

  timestamp is in milliseconds!

• string user_id = 5

• string id = 6

• string country_code = 7

  these are only loaded by specific endpoints.

• string avatar_url = 8

• string channel = 1

• string id = 2

Used as response type in: user_service.SocializeService.GetChatsForChannel

• repeated ChatMessage messages = 1

• CHILD = 0

• NOT_CHILD = 1

• UNKNOWN = 2

Used in: omgwords_service.AnnotatedGameEvent, puzzle_service.SubmissionRequest

• ClientGameplayEvent.EventType type = 1

• string game_id = 2

• string position_coords = 3

  position coordinates, like H8 or G10. Only matters for TILE_PLACEMENT.

• string tiles = 4

  tiles that are being played (or exchanged). The `.` character is used for thru, and lowercase characters are used for blanks.

• bytes machine_letters = 5

  machine_letters is tiles, but in binary.

• repeated uint32 challenged_word_indices = 6

  For CHALLENGE_PLAY events, specifies which word indices to challenge. Indices correspond to the wordsFormed array from the last play. If empty or not set, challenges all words (default/backward compatible).

Used in: ClientGameplayEvent

• TILE_PLACEMENT = 0

• PASS = 1

• EXCHANGE = 2

• CHALLENGE_PLAY = 3

• RESIGN = 4

When a Receiver declines a Seeker:

• string request_id = 1

Used in: Season, league_service.AllDivisionStandingsResponse, league_service.DivisionStandingsResponse

• string uuid = 1

• string season_id = 2

• int32 division_number = 3

• string division_name = 4

• repeated PlayerRegistration players = 5

• repeated string game_ids = 6

• repeated LeaguePlayerStanding standings = 7

• bool is_complete = 8

Used as request type in: tournament_service.TournamentService.SetDivisionControls

Used as field type in: DivisionControlsResponse, TournamentDivisionDataResponse

• string id = 1

• string division = 2

• optional GameRequest game_request = 3

• TournamentGameResult suspended_result = 4

• int32 suspended_spread = 5

• bool auto_start = 6

• uint32 spread_cap = 7

• bool gibsonize = 8

• int32 gibson_spread = 9

• int32 minimum_placement = 10

• int32 maximum_bye_placement = 11

• string id = 1

• string division = 2

• optional DivisionControls division_controls = 3

• map<int32, RoundStandings> division_standings = 4

• string id = 1

• string division = 2

• int32 round = 3

• string id = 1

• string division = 2

• repeated Pairing division_pairings = 3

• map<int32, RoundStandings> division_standings = 4

Used as request type in: tournament_service.TournamentService.SetRoundControls

• string id = 1

• string division = 2

• repeated RoundControl round_controls = 3

• repeated Pairing division_pairings = 4

• map<int32, RoundStandings> division_standings = 5

• string message = 1

Used in: RoundControl

• MANUAL_FIRST = 0

• RANDOM_FIRST = 1

• AUTOMATIC_FIRST = 2

Used as response type in: tournament_service.TournamentService.GetTournament

• map<string, TournamentDivisionDataResponse> divisions = 1

• bool started = 2

Used in: GameDocument

• int32 num_rows = 1

• int32 num_cols = 2

• bytes tiles = 3

  tiles are laid out in row-major form

• bool is_empty = 4

  repeated int32 h_cross_scores = 4; repeated int32 v_cross_scores = 5;

• string id = 1

A GameDocument encodes the entire state of a game. It includes a history of events, as well as information about the current state of the bag, timers, etc. It should be possible to recreate an entire omgwords game from a GameDocument state at any given time.

Used as response type in: omgwords_service.GameEventService.GetGameDocument

Used as field type in: game_service.GameDocumentResponse, GameDocumentEvent, omgwords_service.PatchDocumentRequest, omgwords_service.ReplaceDocumentRequest

• repeated GameDocument.MinimalPlayerInfo players = 1

  players are in order of who went first.

• repeated GameEvent events = 2

• uint32 version = 3

• string lexicon = 4

• string uid = 5

• string description = 6

• repeated bytes racks = 7

• ChallengeRule challenge_rule = 8

• PlayState play_state = 9

• repeated int32 current_scores = 10

• string variant = 11

• int32 winner = 12

  The index of the player who won, or -1 if it was a tie.

• string board_layout = 13

  The board layout is just the name for the layout of the board. It should have a sensible default, if blank.

• string letter_distribution = 14

  The letter distribution is the name of the distribution of tiles used for this game. If blank, should default to "english".

• GameType type = 15

• bool timers_started = 16

• GameEndReason end_reason = 17

• optional MetaEventData meta_event_data = 18

• optional google.protobuf.Timestamp created_at = 19

• optional GameBoard board = 20

  gameplay-specific structures: board is the current state of the board

• optional Bag bag = 21

  bag is the current tiles in the bag.

• uint32 scoreless_turns = 22

• uint32 player_on_turn = 23

  The index of the player on turn

• optional Timers timers = 24

Used in: GameDocument

• string nickname = 1

• string real_name = 2

• string user_id = 3

  user_id is an internal, unchangeable user ID, whereas the other two user identifiers might possibly be mutable.

• bool quit = 4

A GameDocumentEvent should eventually replace the GameHistoryRefresher. For now, it will be used for annotated games.

• optional GameDocument doc = 1

Used in: GameDocument, GameEndedEvent, GameInfoResponse, TournamentGame, TournamentGameEndedEvent, league_service.PlayerSeasonGame, tournament_service.TournamentResultOverrideRequest

• NONE = 0

  NONE: the game has not yet ended!

• TIME = 1

  TIME: one person timed out (and lost)

• STANDARD = 2

  WENT_OUT: game ended regularly, with one person having zero tiles on their rack.

• CONSECUTIVE_ZEROES = 3

  6 consecutive zeroes ends the game.

• RESIGNED = 4

• ABORTED = 5

  Aborted games are aborted by mutual agreement.

• TRIPLE_CHALLENGE = 6

• CANCELLED = 7

  CANCELLED means the game never started. Game start signal was not sent.

• FORCE_FORFEIT = 8

  FORCE_FORFEIT is a way to force an opponent to take a loss if they left a game early without resigning.

• ADJUDICATED = 9

  ADJUDICATED means the game ended by external ruling (e.g., league deadline) based on the current score. Unlike FORCE_FORFEIT, this is neutral and can result in a win, loss, or tie for either player.

GameEndedEvent is always sent from the server to both clients.

• map<string, int32> scores = 1

• map<string, int32> new_ratings = 2

• GameEndReason end_reason = 3

• string winner = 4

  The winner is not always the highest scoring player; one player can time out. The end_reason should make it clear what happened.

• string loser = 5

• bool tie = 6

  If it was a tie, the winner and loser above can be interchanged.

• int64 time = 7

  Time that the game ended

• map<string, int32> rating_deltas = 8

• optional macondo.GameHistory history = 9

  Send the full game history again. This will have rack information in it.

GameEvent is an internal game event, saved in the GameDocument.

Used in: GameDocument, ServerOMGWordsEvent

• string note = 2

• bytes rack = 3

• GameEvent.Type type = 4

• int32 cumulative = 5

• int32 row = 6

• int32 column = 7

• GameEvent.Direction direction = 8

• string position = 9

• bytes played_tiles = 10

• bytes exchanged = 11

  An event will not have all of these; it depends on the type of the event.

• int32 score = 12

• int32 bonus = 13

• int32 end_rack_points = 14

• int32 lost_score = 15

• bool is_bingo = 16

• repeated bytes words_formed = 17

  words_formed is a list of all words made by this play

• int32 millis_remaining = 18

• uint32 player_index = 19

  The player who played this move is encoded in player_index. This should be the index in GameDocument.players.

• repeated string words_formed_friendly = 20

• repeated uint32 challenged_word_indices = 21

  For CHALLENGE events, indices of words that were challenged. Empty = challenged all words (backward compatible with existing games).

Used in: GameEvent

• HORIZONTAL = 0

• VERTICAL = 1

Used in: GameEvent

• TILE_PLACEMENT_MOVE = 0

• PHONY_TILES_RETURNED = 1

• PASS = 2

• CHALLENGE_BONUS = 3

• EXCHANGE = 4

• END_RACK_PTS = 5

• TIME_PENALTY = 6

• END_RACK_PENALTY = 7

  Only for international rules (or after 6 zeroes)

• UNSUCCESSFUL_CHALLENGE_TURN_LOSS = 8

  Lose a turn for challenging a word incorrectly (only for double challenge)

• CHALLENGE = 9

  Issue a challenge

• TIMED_OUT = 10

• RESIGNED = 11

A GameHistoryRefresher is sent to both players when the game starts, and any observers at the time that they begin observing. It can also be sent to a player who reconnects in the middle of a game.

• optional macondo.GameHistory history = 1

  The history contains all the moves, points, as well as the last known racks of each player. It also implicitly contains whose turn it is at the moment, by the events / turns in the history. The front-end is responsible for showing all this information in a nice format. Note: the racks of each player should not be sent to both players, only to observers. The back-end will have to be smart enough to overwrite this information with a blank string before sending it. It might not even be that great of a big deal, as I'm sure people can devise other ways to cheat, but shrug.

• int32 time_player1 = 2

  These represent how much time each player has remaining on their clock as of the "refresher", in milliseconds. player1 is the player who is listed first in the game history, regardless of whether they went first.

• int32 time_player2 = 3

• int32 max_overtime_minutes = 4

• optional GameMetaEvent outstanding_event = 5

  outstanding_event refers to any possible outstanding game meta event that has not yet been responded to or expired.

• int32 time_bank_player1 = 6

  Time bank remaining for each player in correspondence games, in milliseconds

• int32 time_bank_player2 = 7

• int32 initial_time_bank_minutes = 8

  Initial time bank for correspondence games, in minutes (similar to max_overtime_minutes)

Used as response type in: game_service.GameMetadataService.GetMetadata

Used as field type in: GameInfoResponses

• repeated PlayerInfo players = 1

• string time_control_name = 4

• string tournament_id = 6

• GameEndReason game_end_reason = 11

  done - is game done? bool done = 9;

• repeated int32 scores = 13

• int32 winner = 14

• optional google.protobuf.Timestamp created_at = 15

• string game_id = 16

• optional google.protobuf.Timestamp last_update = 18

• optional GameRequest game_request = 19

• string tournament_division = 20

• int32 tournament_round = 21

• int32 tournament_game_index = 22

  a game index within a round.

• GameType type = 23

• optional uint32 player_on_turn = 24

  Index of the player whose turn it is (0 or 1). Optional for backwards compatibility.

• string league_id = 25

  League information

• string league_slug = 26

• repeated int64 time_bank = 27

  time_bank is the current remaining time bank per player, in milliseconds. Populated for active correspondence/league games so clients can compute the real time until expiry (per-turn allowance + bank), not just the per-turn proxy. Empty for games without a time bank or for finished games.

Used as response type in: game_service.GameMetadataService.GetActiveCorrespondenceGames, game_service.GameMetadataService.GetRecentCorrespondenceGames, game_service.GameMetadataService.GetRecentGames

• repeated GameInfoResponse game_info = 1

GameMetaEvent defines how we serialize meta events to the database.

Used in: GameHistoryRefresher, MetaEventData

• string orig_event_id = 1

• optional google.protobuf.Timestamp timestamp = 2

• GameMetaEvent.EventType type = 3

• string player_id = 4

  the player that performed the event.

• string game_id = 5

• int32 expiry = 6

  how long should this event remain active, in milliseconds?

Used in: GameMetaEvent

• REQUEST_ABORT = 0

  These are "original events"

• REQUEST_ADJUDICATION = 1

  Adjudication is just seen as a "nudge" on the front end.

• REQUEST_UNDO = 2

• REQUEST_ADJOURN = 3

  Are we going to implement this someday?

• ABORT_ACCEPTED = 4

  And these are responses: A user can accept an abort, or the client will auto-accept when time expires:

• ABORT_DENIED = 5

• ADJUDICATION_ACCEPTED = 6

  A user would not accept an adjudication. The client auto-accepts this when time expires

• ADJUDICATION_DENIED = 7

  An adjudication is denied when the receiver responds positively to a nudge.

• UNDO_ACCEPTED = 8

• UNDO_DENIED = 9

• ADD_TIME = 10

  More:

  add X seconds at a time (30?) to opponent's clock

• TIMER_EXPIRED = 11

  Some meta events have a timer associated with them. Send this with the original event id after time has expired.

Used in: GameRequest

• REAL_TIME = 0

• CORRESPONDENCE = 1

Used in: DivisionControls, GameInfoResponse, InstantiateGame, SeekRequest, tournament_service.TournamentDivisionSummary, tournament_service.TournamentMetadata

• string lexicon = 1

• optional GameRules rules = 2

• int32 initial_time_seconds = 3

• int32 increment_seconds = 4

• macondo.ChallengeRule challenge_rule = 5

• GameMode game_mode = 6

• RatingMode rating_mode = 7

• string request_id = 8

• int32 max_overtime_minutes = 9

• bool player_vs_bot = 10

• string original_request_id = 11

• macondo.BotRequest.BotCode bot_type = 12

• int32 time_bank_minutes = 13

  time_bank_minutes is the number of minutes of time bank for correspondence games. When a player exceeds their per-turn time (increment_seconds), the deficit is deducted from their time bank. Player times out only when time bank is exhausted.

A GameRules is just the name of a board layout + the name of a letter distribution. These must exist in a database or file somewhere.

Used in: GameRequest, omgwords_service.CreateAnnotatedGameRequest, omgwords_service.ImportGCGRequest

• string board_layout_name = 1

  The supported board layout names are CrosswordGame and SuperCrosswordGame

• string letter_distribution_name = 2

  The supported letter distributions are english, french, norwegian, german, catalan, spanish. There are more to come!

• string variant_name = 3

  Use "classic" for our classic game, otherwise it could be some other game (a is worth 100, dogworms, etc.)

Used in: GameDocument, GameInfoResponse

• NATIVE = 0

  A NATIVE game is the default OMGWords game (or its variants) created on the woogles site, between two players or between a player and a bot.

• ANNOTATED = 1

  An ANNOTATED game does not feature Woogles players, but is instead created by a broadcaster/annotator to represent a real-life game. It is created using the liwords "editor" mode or by importing a GCG.

• BOT_VS_BOT = 2

Used as request type in: league_service.LeagueService.GetDivisionTimeBankWarnings

• string division_id = 1

• int32 threshold_hours = 2

  Time bank threshold in hours (e.g., 24 for 1 day)

Used as response type in: league_service.LeagueService.GetDivisionTimeBankWarnings

• repeated TimeBankWarning warnings = 1

Request for getting followers of a user

• string user_id = 1

Response containing list of follower user IDs

• repeated string follower_user_ids = 1

Request for getting users that a user follows

• string user_id = 1

Response containing list of user IDs that the user follows

• repeated string follow_user_ids = 1

InitRealmInfo is a request for the API server to send back information about that realm back to the user. For example, for the lobby realm, we would like lists of active games, chats, etc; for game realms, we would like the game history.

• string user_id = 2

• repeated string realms = 3

InstantiateGame is an internal message passed to gamesvc in order to instantiate a game.

• repeated string user_ids = 1

• optional GameRequest game_request = 2

• int32 assigned_first = 3

  assigned_first is -1 if random, or the player index in user_ids otherwise

• optional TournamentDataForGame tournament_data = 4

When we go to a new path in our SPA, we send a JoinPath. When we leave the path, we send an Unjoin realm. d

• string path = 1

• int32 lag_ms = 1

Used in: league_service.GetAllLeaguesResponse, league_service.LeagueResponse

• string uuid = 1

• string name = 2

• string description = 3

• string slug = 4

• optional LeagueSettings settings = 5

• string current_season_id = 6

• bool is_active = 7

Used in: Division, league_service.SeasonSummary

• string user_id = 1

• string username = 2

• int32 rank = 3

• int32 wins = 4

• int32 losses = 5

• int32 draws = 6

• int32 spread = 7

• int32 games_played = 8

• int32 games_remaining = 9

• StandingResult result = 10

• int32 total_score = 11

  Extended stats for richer leaderboard display

  Sum of scores (for ScAV = total_score / games_played)

• int32 total_opponent_score = 12

  Sum of opponent scores (for OScAV)

• int32 total_bingos = 13

  Sum of bingos (for BAV = total_bingos / games_played)

• int32 total_opponent_bingos = 14

  Sum of opponent bingos (for OBAV)

• int32 total_turns = 15

  Sum of turns (for #TAV = total_turns / games_played)

• int32 high_turn = 16

  Highest single turn score (HT)

• int32 high_game = 17

  Highest game score (HG)

• int32 timeouts = 18

  Number of timeout losses (#TO)

• int32 blanks_played = 19

  Number of blanks played (for ?AV = blanks_played / games_played)

• int32 total_tiles_played = 20

  Sum of tiles played (for TAV = total_tiles_played / games_played)

• int32 total_opponent_tiles_played = 21

  Sum of opponent tiles played (for OTAV)

• PlacementStatus placement_status = 22

  How player was placed in this division (NEW, PROMOTED, etc.)

• double avg_mistake_index = 23

  Average mistake index from BestBot analysis (0 if no analysis)

• int32 games_analyzed = 24

  Number of games with completed BestBot analysis

• int32 best_rank = 25

  Best possible finishing rank (computed from remaining pairings)

• int32 worst_rank = 26

  Worst possible finishing rank (computed from remaining pairings)

Used in: League, league_service.CreateLeagueRequest, league_service.UpdateLeagueSettingsRequest

• int32 season_length_days = 1

• optional TimeControl time_control = 3

• string lexicon = 4

• string variant = 5

• int32 ideal_division_size = 6

• ChallengeRule challenge_rule = 9

A MatchUser requests or receives a match via a seek or a match request.

Used in: SeekRequest

• string user_id = 1

  user_id is the database, or anonymous, ID of the user.

• string relevant_rating = 2

  relevant_rating is the rating of the user, for the relevant seek mode.

• bool is_anonymous = 3

  if is_anonymous, backend won't bother to look up the user in the DB.

• string display_name = 4

  display_name is the display username of the user (could be real name too)

In order to make socket messages as small and simple as possible, we should include the message type with the socket message. Whenever we add a new client <-> server socket message type, add it to this list.

• SEEK_REQUEST = 0

• MATCH_REQUEST = 1

• SOUGHT_GAME_PROCESS_EVENT = 2

• CLIENT_GAMEPLAY_EVENT = 3

• SERVER_GAMEPLAY_EVENT = 4

  deprecate soon

• GAME_ENDED_EVENT = 5

• GAME_HISTORY_REFRESHER = 6

• ERROR_MESSAGE = 7

• NEW_GAME_EVENT = 8

• SERVER_CHALLENGE_RESULT_EVENT = 9

• SEEK_REQUESTS = 10

• ONGOING_GAME_EVENT = 12

• TIMED_OUT = 13

• ONGOING_GAMES = 14

• READY_FOR_TOURNAMENT_GAME = 15

• TOURNAMENT_ROUND_STARTED = 16

• GAME_DELETION = 17

• MATCH_REQUESTS = 18

• DECLINE_SEEK_REQUEST = 19

• CHAT_MESSAGE = 20

• CHAT_MESSAGE_DELETED = 21

• USER_PRESENCE = 22

• USER_PRESENCES = 23

• SERVER_MESSAGE = 24

• READY_FOR_GAME = 25

• LAG_MEASUREMENT = 26

• TOURNAMENT_GAME_ENDED_EVENT = 27

• TOURNAMENT_MESSAGE = 28

  used for TournamentDataResponse (metadata)

• REMATCH_STARTED = 29

• TOURNAMENT_DIVISION_MESSAGE = 30

• TOURNAMENT_DIVISION_DELETED_MESSAGE = 31

• TOURNAMENT_FULL_DIVISIONS_MESSAGE = 32

• TOURNAMENT_DIVISION_ROUND_CONTROLS_MESSAGE = 34

• TOURNAMENT_DIVISION_PAIRINGS_MESSAGE = 35

• TOURNAMENT_DIVISION_CONTROLS_MESSAGE = 36

• TOURNAMENT_DIVISION_PLAYER_CHANGE_MESSAGE = 37

• TOURNAMENT_FINISHED_MESSAGE = 38

• TOURNAMENT_DIVISION_PAIRINGS_DELETED_MESSAGE = 39

• PRESENCE_ENTRY = 40

• ACTIVE_GAME_ENTRY = 41

• GAME_META_EVENT = 42

• PROFILE_UPDATE_EVENT = 43

• OMGWORDS_GAMEPLAY_EVENT = 44

  Add more events here. The total number of events should fit in a byte. We should definitely not be using anywhere close to 255 events, and in order to enforce that I'll be forcing the event type header to just be a byte long.

• OMGWORDS_GAMEDOCUMENT = 45

• TOURNAMENT_PLAYER_CHECKIN = 46

• OUR_CORRESPONDENCE_GAMES = 47

• OUR_CORRESPONDENCE_SEEKS = 48

• MONITORING_STREAM_STATUS_UPDATE = 49

• OUR_LEAGUE_CORRESPONDENCE_GAMES = 50

• ANALYSIS_COMPLETE = 51

• BROADCAST_UPDATED = 52

• BROADCAST_GAMES_UPDATED = 53

Used in: GameDocument

• repeated GameMetaEvent events = 1

Monitoring/Invigilation data for tournament participants

Used in: MonitoringStreamStatusUpdate, TournamentMonitoringUpdate, tournament_service.GetTournamentMonitoringResponse

• string user_id = 1

• string username = 2

• string camera_key = 3

  camera_key and screenshot_key are only sent to directors and the user themselves

• string screenshot_key = 4

• StreamStatus camera_status = 5

  Camera stream status and timestamp

• optional google.protobuf.Timestamp camera_timestamp = 6

• StreamStatus screenshot_status = 7

  Screenshot stream status and timestamp

• optional google.protobuf.Timestamp screenshot_timestamp = 8

Single user monitoring stream status update (sent via WebSocket to individual user)

• optional MonitoringData monitoring_data = 1

A NewGameEvent gets sent from the server to the involved clients when a new game is about to begin. It should follow a SoughtGameProcessEvent.

• string game_id = 1

• string requester_cid = 2

  These are the connection IDs of the requesting and accepting users.

• string accepter_cid = 3

• bool valid = 1

• string challenger = 2

• ChallengeRule challenge_rule = 3

• bytes returned_tiles = 4

Used in: PairResponse

• SUCCESS = 0

• PLAYER_COUNT_INSUFFICIENT = 1

• ROUND_COUNT_INSUFFICIENT = 2

• PLAYER_COUNT_TOO_LARGE = 3

• PLAYER_NAME_COUNT_INSUFFICIENT = 4

• PLAYER_NAME_EMPTY = 5

• MORE_PAIRINGS_THAN_ROUNDS = 6

• ALL_ROUNDS_PAIRED = 7

• INVALID_ROUND_PAIRINGS_COUNT = 8

• PLAYER_INDEX_OUT_OF_BOUNDS = 9

• UNPAIRED_PLAYER = 10

• INVALID_PAIRING = 11

• MORE_RESULTS_THAN_ROUNDS = 12

• MORE_RESULTS_THAN_PAIRINGS = 13

• INVALID_ROUND_RESULTS_COUNT = 14

• INVALID_PLAYER_CLASS_COUNT = 15

• INVALID_PLAYER_CLASS = 16

• INVALID_CLASS_PRIZE = 17

• INVALID_GIBSON_SPREAD = 18

• INVALID_CONTROL_LOSS_THRESHOLD = 19

• INVALID_HOPEFULNESS_THRESHOLD = 20

• INVALID_DIVISION_SIMS = 21

• INVALID_CONTROL_LOSS_SIMS = 22

• INVALID_CONTROL_LOSS_ACTIVATION_ROUND = 23

• INVALID_PLACE_PRIZES = 24

• INVALID_REMOVED_PLAYER = 25

• INVALID_VALID_PLAYER_COUNT = 26

• MIN_WEIGHT_MATCHING = 27

• INVALID_PAIRINGS_LENGTH = 28

• OVERCONSTRAINED = 29

• REQUEST_TO_JSON_FAILED = 30

• TIMEOUT = 31

• UNSUPPORTED_PAIR_METHOD = 32

• SIMPLE_PAIRING_FAILED = 33

Used in: PairRequest

• COP = 0

• PAIR_RANDOM = 1

• PAIR_ROUND_ROBIN = 2

• PAIR_KING_OF_THE_HILL = 3

• PAIR_FACTOR = 4

• PAIR_INITIAL_FONTES = 5

• PAIR_SWISS = 6

• PAIR_TEAM_ROUND_ROBIN = 7

• PAIR_INTERLEAVED_ROUND_ROBIN = 8

• PAIR_AUTO = 9

Used as request type in: pair_service.PairService.HandlePairRequest

• PairMethod pair_method = 1

• repeated string player_names = 2

• repeated int32 player_classes = 3

• repeated RoundPairings division_pairings = 4

• repeated RoundResults division_results = 5

• repeated int32 class_prizes = 6

• int32 gibson_spread = 7

• double control_loss_threshold = 8

• double hopefulness_threshold = 9

• int32 all_players = 10

• int32 valid_players = 11

• int32 rounds = 12

• int32 place_prizes = 13

• int32 division_sims = 14

• int32 control_loss_sims = 15

• int32 control_loss_activation_round = 16

• bool allow_repeat_byes = 17

• repeated int32 removed_players = 18

• int64 seed = 19

• bool top_down_byes = 20

• int32 factor = 21

• int32 initial_nonperf_rounds = 22

Used as response type in: pair_service.PairService.HandlePairRequest, tournament_service.TournamentService.RunCOP

• PairError error_code = 1

• string error_message = 2

• string log = 3

• repeated int32 pairings = 4

• repeated bool gibsonized_players = 5

• repeated int32 multiround_pairings = 6

Used in: DivisionPairingsResponse, DivisionRoundControls, PlayersAddedOrRemovedResponse, TournamentDivisionDataResponse

• repeated int32 players = 1

• int32 round = 2

• repeated TournamentGame games = 3

  can be a list, for elimination tourneys

• repeated TournamentGameResult outcomes = 4

• repeated string ready_states = 5

Used in: RoundControl

• RANDOM = 0

• ROUND_ROBIN = 1

• KING_OF_THE_HILL = 2

• ELIMINATION = 3

• FACTOR = 4

• INITIAL_FONTES = 5

• SWISS = 6

• QUICKPAIR = 7

• MANUAL = 8

• TEAM_ROUND_ROBIN = 9

• INTERLEAVED_ROUND_ROBIN = 10

• PAIRING_METHOD_COP = 11

• AUSTRALIAN_DRAW = 12

PlacementStatus indicates a player's status for next season placement

Used in: LeaguePlayerStanding

• PLACEMENT_NONE = 0

• PLACEMENT_NEW = 1

  Brand new player

• PLACEMENT_PROMOTED = 3

  Promoted from lower division

• PLACEMENT_RELEGATED = 4

  Relegated from higher division

• PLACEMENT_STAYED = 5

  Stayed in same division

• PLACEMENT_SHORT_HIATUS_RETURNING = 6

  Returning after 1-3 seasons

• PLACEMENT_LONG_HIATUS_RETURNING = 7

  Returning after 4+ seasons

Used in: GameDocument, ServerOMGWordsEvent

• PLAYING = 0

• WAITING_FOR_FINAL_PASS = 1

• GAME_OVER = 2

• UNSTARTED = 3

• string id = 1

• string division = 2

• optional TournamentPerson player = 3

Meta information about the player of a particular game.

Used in: GameInfoResponse, omgwords_service.AnnotatedGamesResponse.AnnotatedGame, omgwords_service.CreateAnnotatedGameRequest

• string user_id = 1

• string nickname = 2

• string full_name = 3

• string country_code = 4

• string rating = 5

  Rating for the particular mode of the game. String because it could be provisional or some other strings.

• string title = 6

• bool is_bot = 8

  string avatar_url = 7; // the UserService now offers Avatar info

• bool first = 9

  first is true if the player went first. This is deprecated because it is assumed the player listed first went first.

Used in: Division

• string user_id = 1

• string username = 2

• string division_id = 3

• optional google.protobuf.Timestamp registration_date = 4

• int32 firsts_count = 5

• string status = 6

Used in: RoundStandings

• string player_id = 1

• int32 wins = 2

• int32 losses = 3

• int32 draws = 4

• int32 spread = 5

• bool gibsonized = 6

• string id = 1

• string division = 2

• optional TournamentPersons players = 3

• repeated Pairing division_pairings = 4

• map<int32, RoundStandings> division_standings = 5

• string ips = 1

Only authenticated connections.

• string username = 1

• string user_id = 2

• repeated string channel = 3

• string user_id = 1

• map<string, ProfileUpdate.Rating> ratings = 2

  map of variant name to rating

Used in: ProfileUpdate

• double rating = 1

• double deviation = 2

PromotionFormula defines how many players are promoted/relegated per division

Used in: Season, league_service.UpdateSeasonPromotionFormulaRequest

• PROMO_N_DIV_6 = 0

  ceil(N/6) - default, e.g. 15 players = 3 promoted/relegated

• PROMO_N_PLUS_1_DIV_5 = 1

  ceil((N+1)/5), e.g. 15 players = 4 promoted/relegated

• PROMO_N_DIV_5 = 2

  ceil(N/5), e.g. 15 players = 3 promoted/relegated

• PROMO_N_DIV_3 = 3

  ceil(N/3), e.g. 15 players = 5 promoted/relegated

Used in: GameRequest

• RATED = 0

• CASUAL = 1

• string game_id = 1

This can be sent from the user to the tournament or vice-versa.

• string tournament_id = 1

• string division = 2

• int32 round = 3

• string player_id = 4

• int32 game_index = 5

  within a matchplay type tournament where several

• bool unready = 6

  games share a round.

  if true, this is a NOT-ready message.

• string path = 1

• string user_id = 2

• repeated string realms = 2

  realm should be made obsolete. RegisterRealmResponse should always return a list of realms.

RematchStartedEvent gets sent to a game for which there is a rematch. It notifies that observers of the game that a rematch has started.

• string rematch_game_id = 1

  rematch_game_id is the new game ID.

Used in: DivisionRoundControls, TournamentDivisionDataResponse, tournament_service.SingleRoundControlsRequest, tournament_service.TournamentDivisionSummary

• PairingMethod pairing_method = 1

• FirstMethod first_method = 2

• int32 games_per_round = 3

• int32 round = 4

• int32 factor = 5

• int32 initial_fontes = 6

• int32 max_repeats = 7

• bool allow_over_max_repeats = 8

• int32 repeat_relative_weight = 9

• int32 win_difference_relative_weight = 10

• optional uint32 spread_cap_override = 12

  Optional is needed to represent: - `nil` for no override at all - `0` overriding the default to disable the spread cap Without an optional, these two cases would be indistinguishable.

• repeated int32 gibson_spreads = 13

  COP-specific fields (only used when pairing_method == COP) These arrays should have one value per round in the round range. gibson_spreads are ordered from last round to first (reverse chronological).

• repeated double hopefulness_thresholds = 14

  hopefulness_thresholds are ordered from last round to first (reverse chronological).

• double control_loss_threshold = 15

• int32 division_sims = 16

• int32 control_loss_sims = 17

• int32 control_loss_activation_round = 18

  control_loss_activation_round is 0-indexed relative to the start of this COP round range.

• int32 place_prizes = 19

• uint32 reset_round = 20

  reset_round is the Australian Draw repeat-reset point, stored as a 1-based round number (valid >= 1). A meeting in 1-based round r is avoided as a repeat iff r >= reset_round, so meetings in earlier rounds are allowed to recur. This emulates a day-based reset (e.g. set 9 so rounds 1-8 are forgiven when pairing round 9 onward). 0/unset is treated as 1 (reset from round 1 = avoid all prior meetings, the default no-repeat behavior); do not rely on the proto3 zero-default as a meaningful sentinel -- the reader clamps it explicitly. reset_round at or past the current round forgives every prior meeting (King-of-the-Hill). When even a strict pairing is impossible the reset point is relaxed upward one round at a time.

Used in: PairRequest

• repeated int32 pairings = 1

Used in: PairRequest

• repeated int32 results = 1

Used in: DivisionControlsResponse, DivisionPairingsResponse, DivisionRoundControls, PlayersAddedOrRemovedResponse, TournamentDivisionDataResponse

• repeated PlayerStanding standings = 1

Used in: league_service.AllSeasonsResponse, league_service.PastSeasonsResponse, league_service.RecentSeasonsResponse, league_service.SeasonResponse

• string uuid = 1

• string league_id = 2

• int32 season_number = 3

• optional google.protobuf.Timestamp start_date = 4

• optional google.protobuf.Timestamp end_date = 5

• optional google.protobuf.Timestamp actual_end_date = 6

• SeasonStatus status = 7

• repeated Division divisions = 8

• PromotionFormula promotion_formula = 9

  How to calculate promotion/relegation counts

Used in: Season, league_service.BootstrapSeasonRequest

• SEASON_SCHEDULED = 0

• SEASON_ACTIVE = 1

• SEASON_COMPLETED = 2

• SEASON_CANCELLED = 3

• SEASON_REGISTRATION_OPEN = 4

Used in: SeekRequests

• optional GameRequest game_request = 1

• optional MatchUser user = 2

• int32 minimum_rating_range = 3

• int32 maximum_rating_range = 4

• string seeker_connection_id = 5

  connection_id is the websocket ID via which this game was requested.

• optional MatchUser receiving_user = 6

• SeekState user_state = 7

• SeekState receiver_state = 8

• string receiver_connection_id = 9

• repeated string booted_receivers = 10

• string rematch_for = 11

  rematch_for is the game ID that this Match Request is a rematch for (empty if it isn't a rematch)

• string tournament_id = 12

  If this match request is part of a tournament, it is treated in a special way. We are moving towards server-only matching during tournaments, so the following will only be used in "clubhouse mode" / more free-form clubs.

• bool receiver_is_permanent = 13

• string rating_key = 14

• bool require_established_rating = 15

• bool only_followed_players = 16

SeekRequests sends all open seek requests.

• repeated SeekRequest requests = 1

Used in: SeekRequest

• ABSENT = 0

• PRESENT = 1

• READY = 2

The server will send back a challenge result event only in the case of a challenge. In all other cases, the server will send back a ServerGameplayEvent. A ServerChallengeResultEvent is sent back along with a list of ServerGameplayEvents, instead of trying to reconstruct and send the right incremental events. The reason is that the logic is complex and has many special cases, and is already fully implemented in Macondo. We don't wish to re-implement it both in this repo's backend and frontend. XXX: This message type is obsolete, and will be replaced by OMGWordsChallengeResultEvent

• bool valid = 1

• string challenger = 2

• macondo.ChallengeRule challenge_rule = 3

• string returned_tiles = 4

The server will send back a ServerGameplayEvent to a ClientGameplayEvent. The server will also send these asynchronously for opponent gameplay events. XXX: This message type is obsolete and will be replaced by ServerOMGWordsEvent

• optional macondo.GameEvent event = 1

  XXX: move to ipc.GameEvent

• string game_id = 2

• string new_rack = 3

• int32 time_remaining = 4

• macondo.PlayState playing = 5

  XXX: move to ipc.PlayState

• string user_id = 6

  the event has the nickname, but not the userid.

• int32 time_bank = 7

  time bank remaining for the player who just moved, in milliseconds

• string opponent_rack = 8

  opponent_rack is populated for annotated games to keep frontend state in sync when rack inference borrows tiles from opponent

• string message = 1

ServerOMGWordsEvent is a new event type.

• optional GameEvent event = 1

• string game_id = 2

• bytes new_rack = 3

• int32 time_remaining = 4

• PlayState playing = 5

• string user_id = 6

• bytes opponent_rack = 7

  opponent_rack is populated for annotated games to keep frontend state in sync when rack inference borrows tiles from opponent

A SoughtGameProcessEvent gets sent when a match request (or seek request) get accepted (from client to server), or canceled -- when sent from server to client.

• string request_id = 1

Used in: LeaguePlayerStanding, league_service.LeagueRosterSeason

• RESULT_NONE = 0

• RESULT_PROMOTED = 1

• RESULT_RELEGATED = 2

• RESULT_STAYED = 3

• RESULT_CHAMPION = 4

Stream status for monitoring

Used in: MonitoringData

• NOT_STARTED = 0

• PENDING = 1

• ACTIVE = 2

• STOPPED = 3

Used in: GetDivisionTimeBankWarningsResponse

• string user_id = 1

• string username = 2

• int32 low_timebank_game_count = 3

  Number of games with time bank below threshold

Used in: LeagueSettings

• int32 increment_seconds = 1

• int32 time_bank_minutes = 2

• string game_id = 1

• string user_id = 2

Used in: GameDocument

• int64 time_of_last_update = 1

  time_of_last_update is the timestamp of the last update, in milliseconds If no update has been made, this defaults to timeStarted.

• int64 time_started = 2

  time_started is a unix timestamp, in milliseconds.

• repeated int64 time_remaining = 3

  time_remaining is an array of remaining time per player, in milliseconds

• int32 max_overtime = 4

  max_overtime is the number of minutes that the game is allowed to go overtime

• int32 increment_seconds = 5

  increment_seconds is the amount of seconds that is added to the timer after every move

• bool reset_to_increment_after_turn = 6

  reset_to_increment_after_turn sets the timer for the player to increment_seconds. this can be used for correspondence games; for example, time_remaining and increment_seconds can be set to the same number of seconds (let's say 5 days) at the beginning, and this flag can be set to on. Then we should always have 5 days to make any move.

• bool untimed = 7

  If untimed is true, then Timers are not updated at all.

• repeated int64 time_bank = 8

  time_bank is an array of time bank per player, in milliseconds. Used for correspondence/league games. Once time_remaining reaches 0, time is deducted from time_bank. Player only loses when both are exhausted.

Used in: InstantiateGame

• string tid = 1

  The ID of the tournament

• string division = 2

• int32 round = 3

• int32 game_index = 4

• string id = 1

• string name = 2

• string description = 3

• optional TournamentPersons directors = 5

• bool is_started = 6

• optional google.protobuf.Timestamp start_time = 7

  Note: this field seems totally unused

• optional google.protobuf.Timestamp scheduled_start_time = 8

• optional google.protobuf.Timestamp scheduled_end_time = 9

• bool checkins_open = 10

• bool registration_open = 11

Used in: FullTournamentDivisions

• string id = 1

• string division = 2

• optional TournamentPersons players = 3

• map<int32, RoundStandings> standings = 4

• map<string, Pairing> pairing_map = 5

• optional DivisionControls controls = 6

• repeated RoundControl round_controls = 7

• int32 current_round = 8

• string id = 1

• string division = 2

• string id = 1

Used in: Pairing

• repeated int32 scores = 1

• repeated TournamentGameResult results = 2

• GameEndReason game_end_reason = 3

• string id = 4

New tournaments will use full tournament messages (specifically, TournamentDivisionDataResponse et al). This event is also used in the tournament_service's RecentGamesResponse, which can be used to fetch information for the last games played in a tournament.

Used in: tournament_service.RecentGamesResponse

• string game_id = 1

• repeated TournamentGameEndedEvent.Player players = 2

• GameEndReason end_reason = 3

• int64 time = 4

  Time that the game ended

• int32 round = 5

• string division = 6

• int32 game_index = 7

Used in: TournamentGameEndedEvent

• string username = 1

• int32 score = 2

• TournamentGameResult result = 3

Used in: DivisionControls, Pairing, TournamentGame, TournamentGameEndedEvent.Player, tournament_service.TournamentPairingRequest, tournament_service.TournamentResultOverrideRequest

• NO_RESULT = 0

  NO_RESULT: the game is not over

• WIN = 1

• LOSS = 2

• DRAW = 3

• BYE = 4

• FORFEIT_WIN = 5

• FORFEIT_LOSS = 6

• ELIMINATED = 7

  ELIMINATED: player is eliminated in a bracket tournament

• VOID = 8

  VOID: player never played this round and should neither be assigned a win nor a loss. Useful for club-type games.

Broadcast message for monitoring updates

• string tournament_id = 1

• repeated MonitoringData participants = 2

Used in: PlayerCheckinResponse, TournamentPersons

• string id = 1

• int32 rating = 2

• bool suspended = 3

• bool checked_in = 4

Used as request type in: tournament_service.TournamentService.AddDirectors, tournament_service.TournamentService.AddPlayers, tournament_service.TournamentService.RemoveDirectors, tournament_service.TournamentService.RemovePlayers

Used as field type in: PlayersAddedOrRemovedResponse, TournamentDataResponse, TournamentDivisionDataResponse

• string id = 1

• string division = 2

• repeated TournamentPerson persons = 3

This message makes the "Status Bar" show up and also tells the players that the backend is now accepting "ready" messages for this round.

• string tournament_id = 1

• string division = 2

• int32 round = 3

• int32 game_index = 4

  for matchplay type rounds etc.

• optional google.protobuf.Timestamp deadline = 5

(message has no fields)

Used in: UserPresences

• string username = 1

• string user_id = 2

• string channel = 3

• bool is_anonymous = 4

• bool deleting = 5

• repeated UserPresence presences = 1

• DEFAULT = 0

• TOURNAMENT_NEGATIVE_MAX_BYE_PLACEMENT = 1001

• TOURNAMENT_NEGATIVE_MIN_PLACEMENT = 1002

• TOURNAMENT_NEGATIVE_GIBSON_SPREAD = 1003

• TOURNAMENT_EMPTY_ROUND_CONTROLS = 1004

• TOURNAMENT_SET_ROUND_CONTROLS_AFTER_START = 1005

• TOURNAMENT_ELIMINATION_PAIRINGS_MIX = 1006

• TOURNAMENT_DISCONTINUOUS_INITIAL_FONTES = 1007

• TOURNAMENT_INVALID_INITIAL_FONTES_ROUNDS = 1008

• TOURNAMENT_INVALID_ELIMINATION_PLAYERS = 1009

• TOURNAMENT_ROUND_NUMBER_OUT_OF_RANGE = 1010

• TOURNAMENT_NONEXISTENT_PLAYER = 1011

• TOURNAMENT_NONAMENDMENT_PAST_RESULT = 1012

• TOURNAMENT_FUTURE_NONBYE_RESULT = 1013

• TOURNAMENT_NIL_PLAYER_PAIRING = 1014

• TOURNAMENT_NONOPPONENTS = 1015

• TOURNAMENT_MIXED_VOID_AND_NONVOID_RESULTS = 1016

• TOURNAMENT_NONEXISTENT_PAIRING = 1017

• TOURNAMENT_UNINITIALIZED_GAMES = 1018

• TOURNAMENT_TIEBREAK_INVALID_GAME_INDEX = 1019

• TOURNAMENT_GAME_INDEX_OUT_OF_RANGE = 1020

• TOURNAMENT_RESULT_ALREADY_SUBMITTED = 1021

• TOURNAMENT_NONEXISTENT_RESULT_AMENDMENT = 1022

• TOURNAMENT_GIBSON_CAN_CATCH = 1023

• TOURNAMENT_CANNOT_ASSIGN_BYE = 1024

• TOURNAMENT_INTERNAL_BYE_ASSIGNMENT = 1025

• TOURNAMENT_INCORRECT_PAIRINGS_LENGTH = 1026

• TOURNAMENT_PAIRINGS_ASSIGNED_BYE = 1027

• TOURNAMENT_SUSPENDED_PLAYER_UNREMOVED = 1028

• TOURNAMENT_PAIRING_INDEX_OUT_OF_RANGE = 1029

• TOURNAMENT_SUSPENDED_PLAYER_PAIRED = 1030

• TOURNAMENT_PLAYER_NOT_PAIRED = 1031

• TOURNAMENT_PLAYER_ALREADY_EXISTS = 1032

• TOURNAMENT_ADD_PLAYERS_LAST_ROUND = 1033

• TOURNAMENT_PLAYER_INDEX_OUT_OF_RANGE = 1034

• TOURNAMENT_PLAYER_ALREADY_REMOVED = 1035

• TOURNAMENT_REMOVAL_CREATES_EMPTY_DIVISION = 1036

• TOURNAMENT_NEGATIVE_GIBSON_ROUND = 1037

• TOURNAMENT_ROUND_NOT_COMPLETE = 1038

• TOURNAMENT_FINISHED = 1039

• TOURNAMENT_NOT_STARTABLE = 1040

• TOURNAMENT_ROUND_NOT_READY = 1041

• TOURNAMENT_SET_GAME_ROUND_NUMBER = 1042

• TOURNAMENT_ALREADY_READY = 1043

• TOURNAMENT_SET_READY_MULTIPLE_IDS = 1044

• TOURNAMENT_SET_READY_PLAYER_NOT_FOUND = 1045

• TOURNAMENT_NO_LOSER = 1046

• TOURNAMENT_NO_WINNER = 1047

• TOURNAMENT_UNPAIRED_PLAYER = 1048

• TOURNAMENT_INVALID_PAIRING = 1049

• TOURNAMENT_INVALID_SWISS = 1050

• TOURNAMENT_ZERO_GAMES_PER_ROUND = 1051

• TOURNAMENT_EMPTY_NAME = 1052

• TOURNAMENT_NOT_STARTED = 1053

• TOURNAMENT_NONEXISTENT_DIVISION = 1054

• TOURNAMENT_NIL_DIVISION_MANAGER = 1055

• TOURNAMENT_SET_NON_FUTURE_ROUND_CONTROLS = 1056

• TOURNAMENT_ADD_DIVISION_AFTER_START = 1057

• TOURNAMENT_INVALID_DIVISION_NAME = 1058

• TOURNAMENT_DIVISION_ALREADY_EXISTS = 1059

• TOURNAMENT_DIVISION_REMOVAL_AFTER_START = 1060

• TOURNAMENT_DIVISION_REMOVAL_EXISTING_PLAYERS = 1061

• TOURNAMENT_PLAYER_ID_CONSTRUCTION = 1062

• TOURNAMENT_EXECUTIVE_DIRECTOR_EXISTS = 1063

• TOURNAMENT_DIRECTOR_EXISTS = 1064

• TOURNAMENT_NO_DIVISIONS = 1065

• TOURNAMENT_GAME_CONTROLS_NOT_SET = 1066

• TOURNAMENT_INCORRECT_START_ROUND = 1067

• TOURNAMENT_PAIR_NON_FUTURE_ROUND = 1068

• TOURNAMENT_DELETE_NON_FUTURE_ROUND = 1069

• TOURNAMENT_DIVISION_NOT_FINISHED = 1070

• TOURNAMENT_NOT_EXACTLY_ONE_EXECUTIVE_DIRECTOR = 1071

• TOURNAMENT_EXECUTIVE_DIRECTOR_REMOVAL = 1072

• TOURNAMENT_INVALID_FUTURE_RESULT = 1073

• TOURNAMENT_SCHEDULED_START_AFTER_END = 1090

• TOURNAMENT_NOT_FINISHED = 1091

• TOURNAMENT_OPENCHECKINS_AFTER_START = 1092

• TOURNAMENT_CHECKINS_CLOSED = 1093

• TOURNAMENT_NOT_REGISTERED = 1094

• TOURNAMENT_REGISTRATIONS_CLOSED = 1095

• TOURNAMENT_ALREADY_STARTED = 1096

• TOURNAMENT_OPENREGISTRATIONS_AFTER_START = 1097

• TOURNAMENT_CANNOT_START_CHECKINS_OR_REGISTRATIONS_OPEN = 1098

• TOURNAMENT_CANNOT_REMOVE_UNCHECKED_IN_IF_CHECKINS_OPEN = 1099

• TOURNAMENT_COP_IN_FIRST_HALF = 1100

• TOURNAMENT_COP_INVALID_SIMULATIONS = 1101

• TOURNAMENT_COP_INVALID_PLACE_PRIZES = 1102

• TOURNAMENT_COP_INVALID_PARAMETERS = 1103

• TOURNAMENT_NON_COP_AFTER_COP = 1104

• PUZZLE_VOTE_INVALID = 1074

• PUZZLE_GET_RANDOM_PUZZLE_ID_NOT_FOUND = 1075

• PUZZLE_GET_RANDOM_PUZZLE_NOT_FOUND = 1076

• PUZZLE_GET_PUZZLE_UUID_NOT_FOUND = 1077

• PUZZLE_GET_PREVIOUS_PUZZLE_NO_ATTEMPTS = 1078

• PUZZLE_GET_PREVIOUS_PUZZLE_ATTEMPT_NOT_FOUND = 1079

• PUZZLE_GET_ANSWER_PUZZLE_UUID_NOT_FOUND = 1080

• PUZZLE_SUBMIT_ANSWER_PUZZLE_ID_NOT_FOUND = 1081

• PUZZLE_SUBMIT_ANSWER_SET_CORRECT = 1082

• PUZZLE_SUBMIT_ANSWER_SET_ATTEMPTS = 1083

• PUZZLE_SET_PUZZLE_VOTE_ID_NOT_FOUND = 1084

• PUZZLE_SUBMIT_ANSWER_PUZZLE_ATTEMPT_NOT_FOUND = 1085

• PUZZLE_GET_PUZZLE_UPDATE_ATTEMPT = 1086

• PUZZLE_GET_ANSWER_NOT_YET_RATED = 1087

• USER_UPDATE_NOT_FOUND = 1088

• GAME_NO_LONGER_AVAILABLE = 1089