git.cworth.org Git - lmno-server/blob - game.js

   1 const no_team = { name: "" };
   2
   3 /* A single player can have multiple connections, (think, multiple
   4  * browser windows with a common session cookie). */
   5 class Player {
   6   constructor(id, session_id, name, connection) {
   7     this.id = id;
   8     this.session_id = session_id;
   9     this.name = name;
  10     this.connections = [connection];
  11     this.team = no_team;
  12   }
  13
  14   add_connection(connection) {
  15     /* Don't add a duplicate connection if this player already has it. */
  16     for (let c of this.connections) {
  17       if (c === connection)
  18         return;
  19     }
  20
  21     this.connections.push(connection);
  22   }
  23
  24   /* Returns the number of remaining connections after this one is removed. */
  25   remove_connection(connection) {
  26     this.connections.filter(c => c !== connection);
  27     return this.connections.length;
  28   }
  29
  30   /* Send a string to all connections for this player. */
  31   send(data) {
  32     this.connections.forEach(connection => connection.write(data));
  33   }
  34
  35   info_json() {
  36     return JSON.stringify({
  37       id: this.id,
  38       name: this.name,
  39       team: this.team.name
  40     });
  41   }
  42 }
  43
  44 /* Base class providing common code for game engine implementations. */
  45 class Game {
  46   constructor(id) {
  47     this.id = id;
  48     this.players = [];
  49     this.players_by_session = {};
  50     this.next_player_id = 1;
  51     this.teams = [];
  52     this.state = {
  53       team_to_play: no_team
  54     };
  55     this.first_move = true;
  56
  57     /* Send a comment to every connected client every 15 seconds. */
  58     setInterval(() => {this.broadcast_string(":");}, 15000);
  59   }
  60
  61   /* Suport for game meta-data.
  62    *
  63    * What we want here is an effectively static field that is
  64    * accessible through either the class name (SomeGame.meta) or an
  65    * instance (some_game.meta). To pull this off we do keep two copies
  66    * of the data. But the game classes can just set SomeGame.meta once
  67    * and then reference it either way.
  68    */
  69   static set meta(data) {
  70     /* This allows class access (SomeGame.meta) via the get method below. */
  71     this._meta = data;
  72
  73     /* While this allows access via an instance (some_game.meta). */
  74     this.prototype.meta = data;
  75   }
  76
  77   static get meta() {
  78     return this._meta;
  79   }
  80
  81   /* Just performs some checks for whether a move is definitely not
  82    * legal (such as not the player's turn). A child class is expected
  83    * to override this (and call super.add_move early!) to implement
  84    * the actual logic for a move. */
  85   add_move(player, move) {
  86
  87     /* The checks here don't apply on the first move. */
  88     if (! this.first_move) {
  89
  90       /* Discard any move asserting to be the first move if it's no
  91        * longer the first move. This resolves the race condition if
  92        * multiple players attempt to make the first move. */
  93       if (move.assert_first_move) {
  94         return { legal: false,
  95                  message: "Your opponent beat you to the first move" };
  96       }
  97
  98       /* Cannot move if you are not on a team. */
  99       if (player.team === no_team)
 100       {
 101         return { legal: false,
 102                  message: "You must be on a team to take a turn" };
 103       }
 104
 105       /* Cannot move if it's not this player's team's turn. */
 106       if (player.team !== this.state.team_to_play)
 107       {
 108         return { legal: false,
 109                  message: "It's not your turn to move" };
 110       }
 111     }
 112
 113     return { legal: true };
 114   }
 115
 116   /* Assign team only if player is unassigned.
 117    * Return true if assignment made, false otherwise. */
 118   assign_player_to_team_perhaps(player, team)
 119   {
 120     if (player.team !== no_team)
 121       return false;
 122
 123     player.team = team;
 124     this.broadcast_event("player-update", player.info_json());
 125
 126     return true;
 127   }
 128
 129   /* This function is called after the child add_move has returned
 130    * 'result' so that any generic processing can happen.
 131    *
 132    * In particular, we assign teams for a two-player game where a
 133    * player assumed a team by making the first move. */
 134   post_move(player, result)
 135   {
 136     if (this.first_move && result.legal) {
 137       this.first_move = false;
 138
 139       this.assign_player_to_team_perhaps(player, this.teams[0]);
 140
 141       /* Yes, start at 1 to skip teams[0] which we just assigned. */
 142       for (let i = 1; i < this.teams.length; i++) {
 143         const other = this.players.find(p => (p !== player) && (p.team === no_team));
 144         if (!other)
 145           return;
 146         this.assign_player_to_team_perhaps(other, this.teams[i]);
 147       }
 148     }
 149   }
 150
 151   add_player(session, connection) {
 152     /* First see if we already have a player object for this session. */
 153     const existing = this.players_by_session[session.id];
 154     if (existing) {
 155       existing.add_connection(connection);
 156       return existing;
 157     }
 158
 159     /* No existing player. Add a new one. */
 160     const id = this.next_player_id;
 161     const player = new Player(id, session.id, session.nickname, connection);
 162
 163     /* Broadcast before adding player to list (to avoid announcing the
 164      * new player to itself). */
 165     const player_data = JSON.stringify({ id: player.id, name: player.name });
 166     this.broadcast_event("player-enter", player_data);
 167
 168     this.players.push(player);
 169     this.players_by_session[session.id] = player;
 170     this.next_player_id++;
 171
 172     return player;
 173   }
 174
 175   /* Drop a connection object from a player, and if it's the last one,
 176    * then drop that player from the game's list of players. */
 177   remove_player_connection(player, connection) {
 178     const remaining = player.remove_connection(connection);
 179     if (remaining === 0) {
 180       const player_data = JSON.stringify({ id: player.id });
 181       this.players.filter(p => p !== player);
 182       delete this.players_by_session[player.session_id];
 183       this.broadcast_event("player-exit", player_data);
 184     }
 185   }
 186
 187   /* Send a string to all players */
 188   broadcast_string(str) {
 189     this.players.forEach(player => player.send(str + '\n'));
 190   }
 191
 192   /* Send an event to all players.
 193    *
 194    * An event has both a declared type and a separate data block.
 195    * It also ends with two newlines (to mark the end of the event).
 196    */
 197   broadcast_event(type, data) {
 198     this.broadcast_string(`event: ${type}\ndata: ${data}\n`);
 199   }
 200
 201   handle_events(request, response) {
 202     /* These headers will keep the connection open so we can stream events. */
 203     const headers = {
 204       "Content-type": "text/event-stream",
 205       "Connection": "keep-alive",
 206       "Cache-Control": "no-cache"
 207     };
 208     response.writeHead(200, headers);
 209
 210     /* Add this new player. */
 211     const player = this.add_player(request.session, response);
 212
 213     /* And queue up cleanup to be triggered on client close. */
 214     request.on('close', () => {
 215       this.remove_player_connection(player, response);
 216     });
 217
 218     /* Give the client the game-info event. */
 219     const game_info_json = JSON.stringify({
 220       id: this.id,
 221       url: `${request.protocol}://${request.hostname}/${this.id}`
 222     });
 223     response.write(`event: game-info\ndata: ${game_info_json}\n\n`);
 224
 225     /* And the player-info event. */
 226     response.write(`event: player-info\ndata: ${player.info_json()}\n\n`);
 227
 228     /* As well as player-enter events for all existing players. */
 229     this.players.filter(p => p !== player).forEach(p => {
 230       response.write(`event: player-enter\ndata: ${p.info_json()}\n\n`);
 231     });
 232
 233     /* Finally, if this game class has a "state" property, stream that
 234      * current state to the client. */
 235     if (this.state) {
 236       const state_json = JSON.stringify(this.state);
 237       response.write(`event: game-state\ndata: ${state_json}\n\n`);
 238     }
 239   }
 240
 241   handle_player(request, response) {
 242     const player = this.players_by_session[request.session.id];
 243     const name = request.body.name;
 244     const team_name = request.body.team;
 245     var updated = false;
 246     if (! player) {
 247       response.sendStatus(404);
 248       return;
 249     }
 250
 251     if (name && (player.name !== name)) {
 252       player.name = name;
 253
 254       /* In addition to setting the name within this game's player
 255        * object, also set the name in the session. */
 256       request.session.nickname = name;
 257       request.session.save();
 258
 259       updated = true;
 260     }
 261
 262     if (team_name !== null && (player.team.name !== team_name))
 263     {
 264       if (team_name === "") {
 265         player.team = no_team;
 266         updated = true;
 267       } else {
 268         const index = this.teams.findIndex(t => t.name === team_name);
 269         if (index >= 0) {
 270           player.team = this.teams[index];
 271           updated = true;
 272         }
 273       }
 274     }
 275
 276     if (updated)
 277       this.broadcast_event("player-update", player.info_json());
 278
 279     response.send("");
 280   }
 281
 282   broadcast_move(move) {
 283     this.broadcast_event("move", move);
 284   }
 285
 286 }
 287
 288 module.exports = Game;