Rankings

Introduction

In certain stage types, a ranking is calculated. This ranking requires matches and a ranking configuration described in the stage settings. These settings are divided into two categories:

Calculators

Calculators describe how points are awarded to the competitors. When multiple calculators are configured, the sum of each calculator's points is awarded to the competitors. The order of the calculators does not change the outcome.

For more information on how calculators can be configured to awards points, please read the Points system documentation in the help center.

The calculators are configured in the stage settings with an array containing calculator configurations.

[
    { "name": "calculator name", "options": options },
    { "name": "calculator name", "options": options },
    ...
]

NameOptions
match_bye_points{"bye": integer}
match_result_points{"win": integer, "draw": integer, "loss": integer}
match_score_points{}
match_game_result_points{"win": integer, "draw": integer, "loss": integer}
Example
[
    {
        "name": "match_result_points",
        "options": {
            "win": 2,
            "draw": 1,
            "loss": 0
        }
    },
    {
        "name": "match_bye_points",
        "options": {
            "bye": 1
        }
    }
]

Tiebreakers

Tiebreakers describe how to handle ties between competitors that have the same number of points. The order of the tiebreakers is important because subsequent tiebreakers are only called when there are still ties between competitors.

For more information on how specific tiebreakers work, please read the Tiebreakers documentation in the help center.

The tiebreakers are configured in the stage settings with an array containing tiebreaker configurations. Some tiebreakers may not be available depending on the stage type because they would not provide any meaningful result due to the nature of the stage type.

[
    { "name": "tiebreaker name", "options": options },
    { "name": "tiebreaker name", "options": options },
    ...
]

NameOptions
buchholz{}
cumulative_opponents{}
cumulative{}
manual{}
match_result_head_to_head{}
match_result_overall{}
match_score_against_head_to_head{}
match_score_against_overall{}
match_score_difference_head_to_head{}
match_score_difference_overall{}
match_score_for_head_to_head{}
match_score_for_overall{}
median_buchholz{}
played_least{}
played_most{}
points_head_to_head{}
points_overall{}
random{}
Example
[
    {
        "name": "points_overall",
        "options": []
    },
    {
        "name": "match_result_head_to_head",
        "options": []
    }
]