@socialgorithm/game-server

JavaScript Game Server

Creates a socket server (default port 5433) that serves games. To use this server, you provide functions that will be called on game or player actions, and call functions to communicate with players or to broadcast game state to spectators.

If you have no idea what any of this means, start at our homepage or tournament documentation

Integrating

Install the dependency:

npm install @socialgorithm/game-server

Start the game server and supply a new match function:

  new GameServer({ name: "My Game Name" }, newMatchFunction, { port: 5433 });

The new match function:

• Must return an implementation of the Match interface (i.e. must implement callback to listen for player communication).
• May accept MatchOptions
• May accept an output channel on which to monitor/communicate with players/spectators.

  newMatchFunction(createMatchMessage: Messages.CreateMatchMessage, outputChannel: MatchOutputChannel) {
    debug("Started new match");
    return new MyMatch(createMatchMessage.options, createMatchMessage.players, outputChannel);
  }

In your game, you can then use MatchOutputChannel to communicate with players or spectators (e.g. the Tournament Server).

Example

See tic-tac-toe-game-server for an example of integration.

Contributing

The rest of this guide is for contributors.

Publishing to NPM

To publish to NPM, make sure you've incremented the version number (e.g. npm version patch) and run:

npm publish