UPDATE

Name

UPDATE --  Notification that the list of players or the list of tables in a room has changed, or the list of rooms or game types on a server.

Synopsis

<UPDATE TYPE="type" ACTION="action" ROOM="room">
DataTypeExample
TYPEstringplayer
ACTIONstringadd
ROOMint1

Description

Notification from the server that the list of players in the current room has been modified since the last update, or that a table has been added, removed or changed its state, or that a room or game type has been added or removed.

Message Data

TYPE

Update type. Can be 'player' or 'table' for room updates, or 'room' or 'game' for server updates.

ACTION

Action to do. Can be either 'add' or 'delete' for players, and 'join' or 'status' for tables. For 'room' and 'game' updates, 'add' and 'delete' are possible.

ROOM

Room to which the update applies. Only used for types 'player' and 'table'.


Usage

An UPDATE tag is sent from the server to the client if the list of players or tables in the current room has changed since the last update. It is not sent upon initial entry to a room. To obtain a player or table list upon entering a room, the client must send a LIST of type 'player' or 'table'. The UPDATE tag contains one or more tags of type PLAYER or TABLE, respectively. The two other types, updates of type ROOM or GAME, no client request exists; instead, a reconfiguration of the server leads to such updates.