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 CS2 Regional Standings model runs as a Node.js script. With a match data file and Node.js installed, you can generate regional standings tables for any snapshot in time.

Prerequisites

  • Node.js — any modern LTS version (v18 or later recommended)
  • Git — to clone the repository

Setup

1

Clone the repository

git clone https://github.com/ValveSoftware/counter-strike_regional_standings.git
cd counter-strike_regional_standings
2

Place match data

Copy your match data file to data/matchdata.json. If you don’t have live data yet, use the included sample file:
cp data/matchdata_sample_20230829.json data/matchdata.json
The sample file (data/matchdata_sample_20230829.json) contains a real historical snapshot and is safe to use for testing.
3

Run the model

Navigate to the model/ directory and run the script:
cd model
node main.js
4

Check the output

The model writes standings markdown files to live/<year>/. For example:
live/
└── 2024/
    ├── standings_global_2024_03_01.md
    ├── standings_europe_2024_03_01.md
    ├── standings_americas_2024_03_01.md
    ├── standings_asia_2024_03_01.md
    └── details/
        └── 2024_03_01/
            └── 0001--natus-vincere--...md
The script uses relative paths and must be run from the model/ directory. Running it from the repository root or any other directory will cause file-not-found errors when it tries to read match data and write output.

CLI arguments

The script accepts three optional positional arguments. All arguments have sensible defaults so you can run the model with no arguments at all.
PositionArgumentDefaultDescription
argv[2]Region indices[0,1,2]JSON array of region indices to include. 0 = Europe, 1 = Americas, 2 = Asia.
argv[3]Match data path../data/matchdata.jsonPath to the match data JSON file.
argv[4]Date overrideDate of most recent matchOverride the date string used in output filenames (YYYY-MM-DD format).

Command examples

# All regions, default data file
node main.js

# Europe only
node main.js '[0]'

# Americas only, custom data file
node main.js '[1]' '../data/my_matchdata.json'

# Asia only
node main.js '[2]'

# All regions, custom data file and date
node main.js '[0,1,2]' '../data/matchdata.json' '2024-03-01'

Next steps

Output format

Understand the generated file structure, naming conventions, and markdown table columns.

Model evaluation

Run the fit evaluation script to measure model accuracy against historical match data.

Build docs developers (and LLMs) love