Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/ValveSoftware/counter-strike_regional_standings/llms.txt

Use this file to discover all available pages before exploring further.

The model reads a single JSON file (matchdata.json) containing an array of matches and an array of events. This page documents the expected shape of that file and every field the model reads.

Top-level structure

The file has two top-level keys:
{
  "matches": [...],
  "events": [...]
}
The matches array contains individual match objects. The events array contains event metadata that matches reference by eventId. Event structure is documented separately in Event data JSON schema.

Match object fields

Each entry in the matches array represents a single match between two teams.
team1Name
string
required
Display name of team 1.
team2Name
string
required
Display name of team 2.
team1Players
array
required
Array of player objects representing team 1’s roster. Exactly 5 players are required; matches with any other count are discarded before ranking runs.
team2Players
array
required
Array of player objects representing team 2’s roster. Exactly 5 players are required; matches with any other count are discarded before ranking runs.
team1Id
string | number
required
Identifier for team 1. Used to look up prize distribution entries in the event’s prizeDistribution array. In practice this value is a numeric string (e.g., "11814").
team2Id
string | number
required
Identifier for team 2. Used to look up prize distribution entries in the event’s prizeDistribution array. In practice this value is a numeric string (e.g., "11555").
winningTeam
1 | 2
required
Indicates which team won: 1 for team 1, 2 for team 2.
matchStartTime
number
required
Unix timestamp in seconds when the match began. Used to apply the time-window filter and the scoring decay ramp.
eventId
number
required
Reference to the event this match belongs to. Must correspond to an eventId present in the top-level events array.
forfeited
boolean
When true, the match was a forfeit. The model still processes forfeited matches but treats the roster record as pending until a non-forfeited match is observed for the same players.
valveRanked
boolean
Whether this match counts toward the official CS2 Regional Standings. Required for all matches with a matchStartTime on or after 2025-01-01 (Unix timestamp 1735689600).
valveRanked is only required for matches played on or after January 1, 2025. Matches before that date are included regardless of whether this field is present.

Player object fields

Each entry in team1Players and team2Players represents a single player.
playerId
string | number
required
Unique identifier for the player. Used to determine roster identity — the model compares playerId values to detect shared players across lineups. In practice this value is a numeric string (e.g., "13290").
nick
string
required
The player’s in-game nickname or handle.
countryIso
string
required
Two-letter ISO country code for the player’s nationality, in lowercase (e.g., "us", "dk", "br"). Used when assigning teams to regions by plurality of player nationalities.

Example match object

{
  "matchStartTime": 1693330518,
  "team1Id": "11814",
  "team2Id": "11555",
  "team1Name": "Corinthians",
  "team2Name": "UNO MILLE",
  "team1Players": [
    {
      "playerId": "13290",
      "nick": "Demonos",
      "countryIso": "br"
    },
    {
      "playerId": "14011",
      "nick": "r4ul",
      "countryIso": "br"
    },
    {
      "playerId": "16775",
      "nick": "DANVIET",
      "countryIso": "br"
    },
    {
      "playerId": "19831",
      "nick": "proSHOW",
      "countryIso": "br"
    },
    {
      "playerId": "20885",
      "nick": "fREQ",
      "countryIso": "br"
    }
  ],
  "team2Players": [
    {
      "playerId": "2544",
      "nick": "remix",
      "countryIso": "br"
    },
    {
      "playerId": "11922",
      "nick": "ALLE",
      "countryIso": "br"
    },
    {
      "playerId": "16769",
      "nick": "realz1n",
      "countryIso": "br"
    },
    {
      "playerId": "16814",
      "nick": "danoco",
      "countryIso": "br"
    },
    {
      "playerId": "18875",
      "nick": "RICIOLI",
      "countryIso": "br"
    }
  ],
  "eventId": "7360",
  "winningTeam": 1,
  "forfeited": false,
  "valveRanked": true
}

Build docs developers (and LLMs) love