Skip to content

tokinanpa/StartRNR

Repository files navigation

StartRNR

StartRNR is an implementation of the cutting-edge player rating system known as Relative Network Rating (RNR) for competitive gaming. It uses start.gg's tournament data to generate and maintain a network of relative advantages between players.

Once the advantage network is generated, StartRNR can be used to predict the probability of a player winning a match, generate provably optimal seedings for tournaments, inspect the match history of two players, and create competitive rankings automatically.

All of these features work for any game, in any region, without restriction.

Warning

StartRNR is unstable and under active development. The design and user interface of this program is experimental and may be subject to change.

Currently, the power ranking and seeding features have not been implemented.

Installation

For more information, see the installation page.

Build and install StartRNR using cargo:

cargo install --git https://github.com/kiana-S/StartRNR

Alternatively, if you use Nix:

nix profile install github:kiana-S/StartRNR

You will need to provide a start.gg API token to access tournament data. Details can be found in INSTALL.md.

Usage

Once StartRNR is installed, run:

startrnr sync

The program will walk you through creating a dataset, then run its rating algorithm. This may take up to a few hours to finish running!

Once the rating data has been generated, these commands can be used to access it:

# Access a player's data
startrnr player info <player>

# Analyze matchup of two players
startrnr player matchup <player1> <player2>

A player can be specified by their tag or by their discriminator.

Details - The RNR System

For more information on RNR, see the details page.