StartRNR/README.md

38 lines
1.6 KiB
Markdown
Raw Normal View History

2023-08-25 22:12:47 -04:00
# StartGGElo
StartGGElo is a tool for using [start.gg](https://www.start.gg/)'s video game tournament data to
generate and maintain [Elo ratings](https://wikipedia.org/wiki/Elo_rating_system) for each competitive player.
Once Elo ratings are generated, StartGGElo can be used to generate ranking lists, predict the
probability of a player winning a match, generate seedings for future tournaments, and more.
2023-08-25 23:13:33 -04:00
2023-08-25 23:14:59 -04:00
> **Note**
2023-08-25 23:16:28 -04:00
> StartGGElo is still under development; currently, it only supports generating player ratings.
2023-08-25 22:12:47 -04:00
## Installation
TODO
## Configuration
StartGGElo stores its rating database in its config directory, which is located at:
- Windows: `%APPDATA%\Roaming\ggelo`
- Mac/Linux: `~/.config/ggelo` or `~/.ggelo`
This directory also contains StartGGElo's config file, which defines how it calculates its ratings.
2023-08-25 23:16:28 -04:00
This file does not need to be edited directly, but it can be if you want to transfer your ratings between
computers.
2023-08-25 22:12:47 -04:00
## Elo system basics
*For more information on StartGGElo's rating system, see the [details page](DETAILS.md).*
As the name implies, StartGGElo uses the Elo system for its ratings. In the Elo system, all newcomers to the
game are assigned an **initial rating**, and this rating is adjusted whenever a player loses or wins matches.
The initial rating for StartGGElo is 1500, but this is configurable.
Whenever a player enters a tournament, StartGGElo will use start.gg's API to determine how many sets
that player won within that tournament. This number is the player's **score** for that tournament. If the score
the player earned is larger than their Elo rating would predict, then their rating is increased.