Redis backed Round-Robin player turn control
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


NextPlayer is a tool for keeping track of whose turn it is, Round Robin style. Players can be added or removed at will. NextPlayer relies on Redis for tracking data. This is a very generic module, it can be used for anything which needs to track Round Robin data where entries can be dynamically added and removed. Operations are atomic, relying on Redis MULTI calls.

If there's an existing module which does the same thing please let me know!

Example Usage

var NextPlayer = require('./index.js');
var nextplayer = new NextPlayer();
var ns = "game-12345";

nextplayer.add(ns, ["Larry", "Curly", "Shemp", "Moe"], function(err, list) {
  console.log('ADD', list); // Larry, Curly, Shemp, Moe
  nextplayer.remove(ns, "Shemp", function(err, list) {
    console.log('REMOVE', list); // Larry, Curly, Moe
    nextplayer.step(ns, function(err, list) {
      console.log('STEP1', list); // Curly, Moe, Larry
      nextplayer.step(ns, function(err, list) {
        console.log('STEP2', list); // Moe, Larry, Curly
        nextplayer.list(ns, function(err, list) {
          console.log('LIST', list); // Moe, Larry, Curly
          nextplayer.destroy(ns, function(err) {


npm install nextplayer


Note: If you want to use a Promise-based API, consider using Bluebird's Promisfy All feature.


Creates a new instance of NextPlayer. An instance isn't tied to a particular game, think of it as a reusable service. Instead it's tied to a particular Redis key naming convention.


  • keyPrefix: A List key representing the list of all players
  • redis: (Optional) A fully configured and instantiated redis client
  • redisOptions: (Optional) A list of redis connection options, defaults to local
var nextplayer = new NextPlayer({
  keyPrefix: 'list-',
  redis: redis.createClient({host: 'localhost', port: 6370})

.add(namespace, identifiers, callback)

If an array is provided, inserts a list of players to go last. Otherwise, adds a single player.

nextplayer.add(namespace, "tod", callback);
nextplayer.add(namespace, ["bev", "jim"], callback);

function callback(err, newList) {}

.set(namespace, identifiers, callback)

Much like add(), except any players already in the list will be replaced with this entirely new list.

nextplayer.set(namespace, "tod", callback);
nextplayer.set(namespace, ["bev", "jim"], callback);

function callback(err, newList) {}

.remove(namespace, identifier, callback)

Removes a single player, by identifier, from the list.

nextplayer.remove(namespace, "ted", callback);

function callback(err, newList) {}

.step(namespace, callback)

Cycles through the players in the list, so the current player is now the last player, and the next becomes current.

nextplayer.step(namespace, callback);

function callback(err, newList) {}

.list(namespace, callback)

Gets an array of all players in the list, starting with the current player.

nextplayer.list(namespace, callback);

function callback(err, list) {}

.current(namespace, callback)

Returns just the current player from the list.

nextplayer.current(namespace, callback);

function callback(err, current) {}

.destroy(namespace, callback)

Destroys all keys associated with the provided namespace. Doesn't destroy the NextPlayer instance.

nextplayer.destroy(namespace, callback);

function callback(err) {}