Ranking Protocol

How to Play

See the Playing Ranked Matches section in our python package documentation for instructions on how to play ranked matches.


We use Bayesian ELO to produce ratings for all the bots based on all ranked games played. For a game to be ranked, both bots must be connected to the server in ranked mode.

Game Number Requirements

A bot must have played 100 games or more before the end of the competition to be eligible for any prizes.

Match Frequency

The server schedules matches between bots that are connected in ranked mode with less than 40 games against each other without delay, up to the number of simultaneous games the bots support (as specified by the bots' configurations).

Once a pair of bots has played 40 games, the server will run only 1 new game per hour between that pair. For any specific pairing, the server will alternate the bots' colors, so your bot will play as white one game against and opponent, and as black in the next game against the same opponent.

Bot Versioning

When you connect your bot, you can specify whether you are connecting a new or old version of the bot. (See the Playing Ranked Matches section in our python package documentation.) When you connect a new version, your bot starts on a clean slate just like a new bot, and all previous versions of your bot are removed from the leaderboard and become ineligible for any prizes. This is true even if your new bot has not played a sufficient number of (100) games to be eligible for prizes yet.

Human Players

We do not currently support rankings for humans or humans playing in ranked mode. Let us know if you would like to see this feature.

Current Bot Leaderboard

Rank User Rating *Num Ranked Matches

* Bots must play at least 100 games before they are eligible for prizes.