Match formats

Introduction

The match format is the rule you set on how a match is going to be played. It defines the number of match sets and score/result calculations to be used to determine a winner. A match format can be applied at any level of a tournament, and works with an inheritance system. If you want to learn more about the way match formats are applied, see our guide here.


Types

No games ("no_sets")

A match with no match sets or calculations involved.

Possible options:

  • none


Single game ("single_set")

A match with a single match set.

Possible options:

  • Calculation: (none | score | outcome)


Home & away ("home_and_away")

A match with two match sets, and match score tallied up from match sets scores.

Possible options:

  • Calculation: (none | score )


Best of ("best_of")

A match with any number of sets, where the winner is the participant with at least half of the set wins. The match may be interrupted when the winner is known (and the opponent may no longer contest the win).

Possible options:

  • Number of match sets
  • Interrupt
  • Calculation: (none | score | outcome )


Fixed games ("fixed_sets")

A match with any number of sets, with the winner being the participant with most sets won after they have all been played.

Possible options:

  • Number of match sets
  • Calculation: (none | score | outcome )


Fixed games (advanced) ("fixed_sets_advanced")

A match with any number of sets only available in FFA structures and matches. Several point systems are available, with points and calculators to build a custom rule. See the advanced guide on this specific match format.

Possible options:

  • Number of match sets
  • Match result
  • Match score
  • Match set result
  • Match set score


Options

Calculation "calculation" : "none" | “score” | “outcome”

Lets you declare the rule for the automated calculation of the match outcome based on match set score ( “score”) or match set outcome (“outcome”).


Number of match sets "nb_match_sets" int

Lets you declare how many match sets are to be played in the match.


Interrupt "interrupt" bool

Lets you stop the match when a winner is known, without playing the remaining match sets.


Match result "match_outcome_calculation" bool

Whether you want the match outcome to be automatically determined from the match score or not.


Match score "match_calculators" array

A list of possible calculators to be taken into account when calculating the match score.

Forfeit "match_set_result_forfeit_penalties" int

Whether to apply points (can be negative) to participants who forfeit in the match set.

{
    "options": {"forfeit": -1}
}
Match set score points "match_set_score_points" int

Whether to directly tally the match set scores into the match score or not.

Match set rank points "match_set_rank_points" scale

Whether to apply points (can be negative) to participants who forfeit in the match set.

{
    "options":
        "scale": {
            "1": "100",
            "2": "50",
            "3-5": "30"
        }
}

Match set score "match_set_calculators" array

A list of possible calculators to be taken into account when calculating the match set score.

Match set scale points "match_set_property_scale_points" int

Lets you declare a scale of points to be calculated in the participant’s score with an in-game rank.

{
    "options":
        "scale": {
            "1": "100",
            "2": "50",
            "3-5": "30"
        },
        "property": "ingame_rank"
}
Match set factor points "match_set_property_factor_points"

Lets you declare a number of points to be added for an in-game metric (i.e points for each kill).

{
    "options":
        "factor": 2,
        "property": "kills"
}