Skip to main content

Match Custom Data Keys

A match custom data (aka MCD) key is an object describing a single match parameter (a map, a weather condition, the duration of the match, etc). The keys can be managed in the Game Modes > Match Custom Data section of the Game Studio and are defined by:

  • a name, label and description
  • a type for the value it will eventually hold (string, number, boolean, etc, or a list thereof)
  • a set of flags defining whether the key:
    • is mandatory (i.e. will be present in all game modes and cannot be omitted)
    • allows an empty value (i.e. can be left unset)
    • is an advanced setting (controls whether the key is grouped in an “advanced settings” pane on the competition configuration page on faceit.com)
    • is shown to players in the competition overview page
  • an optional set of allowed values for the key
  • an optional default value which will end up in the match configuration unless overridden at competition creation time

MCD