brackets-manager.js

A simple library to manage tournament brackets (round-robin, single elimination, double elimination).

It contains all the logic needed to manage tournaments.

Features

• BYE supported: only during creation (for seeding and balancing).
• Forfeit supported: only during updates.
• Match supported (locked, waiting, ready, running, completed, archived).

Round-robin

• Each participant plays each opponent once.
• No limitation nor restriction in numbers.

Single elimination

• Number of participants : 8, 16, 32, etc. (powers of two)
• Optional Consolation Final : matches semi-final losers.
• Handles up to 4 first places.

Double elimination

• Twice the number of matches.
• Contains a Winner Bracket (WB), and a Loser Bracket (LB).
• Number of participants : 8, 16, 32, etc. (powers of two)
• Optional Grand Final : matches the WB winner against the LB winner.
  • Can be simple or double.
• Handles up to 3 first places.

Interface

• This library doesn't come with a GUI to create and update tournaments.
• You can use brackets-viewer.js to display the current state of a stage.
• It is designed to be used with any storage.
• An example of JSON storage is given to run tests. You can use it out of the box.
• It uses asynchronous calls to a storage interface to be able to handle asynchronous SQL requests (for example).

Credits

This library has been created to be used by the Nantarena.

It has been inspired by:

• Toornament (configuration, API and data format)
• Challonge's bracket generator
• jQuery Bracket (feature examples)