Error Messages

Errors can only occur when the client sends a message that the server rejects.
Error codes are five digits integers; the first two digits indicate the error category, and the three last digits indicate the error type.

Example: error code 10102

• first two digits: 10: communication error
• three last digits: 102: incorrect password

General Errors

Error category: 99

General description

These generic communication errors are not dependant on any state of the client or the server

Error code Error parameter Error name Error description 99000 Bad message format The message sent is in an unknown format. 99001 Empty message The message sent by client contains no data. 99002 command Unknown command The 'command' sent is unknown to the server. 99003 Bad identification The client or player identification misses (this error will no more be used in v0.5.5). 99004 Excess flood The client sent too much data in a small time, it has been kicked from the server because it was flooding. 99005 Idle disconnection The client was idle for a too long time, it has been disconnected from the server. 99006 Admin kick The client has been kicked from the server by the server administrator. 99999 error description Unknown error An unknown error occured when processing client message.

Client Connection Errors

Error category: 10

General description

These are the errors that can occur during the connection (handshaking) to the server.

Errors on client identification - Client Type message

Error code Error parameter Error name Error description 10000 Bad client type format The Client Type message sent is in an unknown format. This error occur when one or more required fields to identify the client are missing. 10001 Client already connected This client is already connected to server. This error happens when a client sends its Client Type when already connected. 10002 No client name given The name of the client used to connect to the server is missing. 10003 Illegal characters Client name contains illegal character(s) The name of the client used to connect to the server contains character(s) that are not allowed by the server. 10004 No client version given The version of the client used to connect to the server is missing. 10005 Illegal characters Client version contains illegal character(s) The client version identificator contains character(s) that are not allowed on the server. 10006 No protocol version given The communication protocol version used by the client is missing. 10007 Illegal characters Protocol version contains illegal character(s) The protocol version identificator contains character(s) that are not allowed on the server. 10008 protocol version Unsupported protocol The communication protocol version used by the client isn't supported by the server.

Errors on player identification - Player Name message

Error code Error parameter Error name Error description 10100 Bad player identification format The Player Name message sent is in an unknown format. 10101 Player already connected There is already a player with the same name on the server. This error can occur when a player tries to change his/her name when already connected. 10102 No player name given The player's name is missing. 10103 Illegal characters Player name contains illegal character(s) The name of the player contains character(s) that are not allowed on the server. 10104 player name Name already in use There is already a player connected to the server with the same player name submitted. 10105 Incorrect password Player name or password submitted is incorrect. (not yet implemented)

Chat Errors

Error category: 20

General description

These are the errors that can occur when a player chats or whispers.

Errors when chatting - Chat message

Error code Error name Error description 20000 Bad chat message format The chat message sent sent is in an unknown format. 20001 Empty chat message The chat message sent is empty.

Errors when whispering - Whisper message

Error code Error parameter Error name Error description 20100 Bad whisper message format The whisper message sent is in an unknown format. 20101 No whispered user given The whispered player name is missing. 20102 whispered player No such user The player to which the message is sent to does not exist or is not currently connected. 20103 Empty whisper text The whisper text sent is empty.

Errors when performing a chat action - Chat Action message

Error code Error name Error description 20200 Bad chat action message format The chat action message sent sent is in an unknown format. 20201 Empty action text The action text sent is empty.

Game Creation Errors

Error category: 30

General description

These are the errors that can occur when attempting to create a game.

General errors - Creating A Game message

Error code Error parameter Error name Error description 30000 Bad game creation format The game creation message sent is in an unknown format. 30001 Creator is already in a game The player wanting to create a game is already in a game. Players can't play multiple games simultaneously. Games must be created from the hall. 30002 error description Error during game creation An unknown error occured during the game creation. The game has not been created.

Errors on game settings - Creating A Game message

Error code Error parameter Error name Error description 30101 No game name given The game name is missing. 30102 game name Game already on server There is already a game with that name on server. 30103 illegal character Game name contains illegal character(s) The game name contains character(s) that are not allowed on the server. 30104 No time per turn given The time allowed to play a turn is missing. 30105 time per turn Non integer time per turn The time allowed to play a turn must be an integer. 30106 time per turn Time per turn too short The time allowed to play a turn is too short (depending on the server's configuration). 30107 No predefined game code given The code for the predefined game setting to be used is missing. 30108 code Unknown predefined game code The code for the predefined game setting given does not exist on the server. 30109 No maximum players given The maximum number of players that can play simultaneously in this game is missing. 30110 max players Non integer maximum players The maximum number of players that can play simultaneously in this game must be an integer. 30111 max players Number of maximum players too small The maximum number of players that can play simultaneously in the game is too small (depending on the server's configuration). It has to be at least 1. 30112 illegal character Game description contains illegal character(s) The game description contains character(s) that are not allowed on server.

Join Game Errors

Error category: 35

General description

These are the errors that can occur when joining a game.

General errors - Joining A Game message

Error code Error parameter Error name Error description 35000 Bad game joining format The game joining request format is invalid (eg. some required fields are invalid/missing). 35001 Player is already in a game The player wanting to join a game is already playing a game. Player cannot play multiple games simultaneously. 35002 No game name to join given The name of the game to join is missing. 35003 game name No such game The game to join does not exist on server.

Errors on game state - Joining A Game message

Error code Error name Error description 35101 All player slots are full The maximum number of simultaneous players in this game has already been reached. 35102 Player is banned form game This player cannot join this game because s/he is banned from it (not implemented yet).

Operator Action Errors

Error category: 40

General description

These are the errors that can occur when using messages reserved to game operators.

Errors when starting a game - Starting A Game message

Error code Error name Error description 40001 Not operator The player is not the game creator or a game operator. 40002 Game already started The game is already running. It cannot be restarted before it's over.

Errors on kicking players - Kicking A Player message

Error code Error parameter Error name Error description 40100 Bad kick message format The kick message sent is in an unknown format. 40101 Not operator The player is not the game creator or a game operator. 40102 kicked player No such user in game Player to kick is not in this game.

Errors On Game Action

Error category: 50

General description

These are the errors that can occur when asking for game data or doing actions that need the player to be in a game.

Errors on requesting game data Game Informations, Players Scores Request, Glyphs Request, Current Hand Request, Current Board Request, Board Type Request Leaving The Game Player's Moves

Error code Error name Error description 50001 Not connected to a game The player is not connected to any game, so s/he cannot ask for game data.

Errors When Playing

Error category: 60

General description

These are the errors that can occur when a player submits his or her moves.

General errors - Player's Moves

Error code Error name Error description 60000 Bad moves format The moves message sent is in an unknown format. 60001 Already played The player already played this turn. 60002 Not your turn The player cannot play because it's not his/her turn (e.g. in scrabble games). 60003 No moves sent The player didn't submit any moves. 60004 Game didn't start The player cannot play because the game didn't start yet. 60005 Game is over The player cannot play because the game is over.

Errors on moves content - Player's Moves

Error code Error parameter Error name Error description 60101 Unaligned moves The moves submitted were not aligned. 60102 illegal character Illegal or unavailable glyph(s) A letter that was not in the hand was used in the moves. 60103 overlapped letter Overlapping glyph(s) A letter was played over an existing letter on the board. 60104 Moves not continuous The moves submitted were not continuous. 60105 First moves too short The first moves submitted has to be at least 2 letters wide. 60106 First moves not through center The first moves submitted didn't pass through the center of the board. 60107 Isolated moves The moves submitted didn't touch at least one of letter(s) already present on the board. This error does not apply to the first turn. 60108 word Incorrect word(s) At least one of the word engendered was incorrect. 60109 Same tile used twice A tile was used twice in the same Moves (Boggle). 60110 Moves not contiguous At least one tile is not neighbouring (horizontally, veritcally or diagonally) another tile. 60111 minimum length req. Moves too short The Moves played is not long enough (does not contain enough Move elements)

Errors when trading letters - Change Own Hand

Error code Error parameter Error name Error description 60200 Bad trade letters format The trade letters message sent is in an unknown format 60201 letter Tile(s) not in hand The player tried to change a letter that was not in his hand. 60202 Trading impossible The player cannot change his hand in the type of game he's connected to. 60203 Error when trading letters An unknown error occured when trading.