NextPlayer
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 = ;var nextplayer = ;var ns = "game-12345"; nextplayer;
Installation
npm install nextplayer
Methods
Note: If you want to use a Promise-based API, consider using Bluebird's Promisfy All feature.
Constructor
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.
Options
- 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 = keyPrefix: 'list-' redis: redis;
namespace
, identifiers
, callback
)
.add(If an array is provided, inserts a list of players to go last. Otherwise, adds a single player.
nextplayer;nextplayer; {}
namespace
, identifiers
, callback
)
.set(Much like add()
, except any players already in the list will be replaced with this entirely new list.
nextplayer;nextplayer; {}
namespace
, identifier
, callback
)
.remove(Removes a single player, by identifier, from the list.
nextplayer;nextplayer; {}
namespace
, callback
)
.step(Cycles through the players in the list, so the current player is now the last player, and the next becomes current.
nextplayer; {}
namespace
, callback
)
.list(Gets an array of all players in the list, starting with the current player.
nextplayer; {}
namespace
, callback
)
.current(Returns just the current player from the list.
nextplayercurrentnamespace callback; {}
namespace
, callback
)
.destroy(Destroys all keys associated with the provided namespace. Doesn't destroy the NextPlayer instance.
nextplayer; {}