What is Game State Integration, and why stream tools use it
Game State Integration (GSI) is a feature Valve built into Counter-Strike 2 and Dota 2 that sends live match data, such as your health, kills and the round score, to a program on your own PC. Stream overlays, RGB lighting and AI commentators use it because it is fast, official and doesn't touch game memory.
How it works
You place a small text file in the game's config folder. The file names a local address (something like http://127.0.0.1:3000) and lists which kinds of data you want. When the game starts, it reads the file, and from then on it posts an update to that address whenever the listed data changes.
The program listening at that address compares each update with the last one. Kills went from 3 to 4: that's a kill. The round phase changed to "over" and your team's score went up: round won. That comparison is how a tool turns a stream of state into moments.
What the game sends
In Counter-Strike 2, a player's own feed covers health, armour, the weapon in hand, kills, deaths, headshots, the round phase, the score and the map. In Dota 2 it covers your hero, kills, deaths, streaks, gold and the match result. You choose the sections in the config file, and the game sends nothing you didn't ask for.
What it can't do
- It can't read game memory or change anything in the game. Data only flows out.
- While you are playing, it doesn't reveal other players' positions or health. That data goes to spectators only.
- It doesn't describe everything. There is no "clutch" or "flank" event; a tool has to infer those or let you call them.
Why stream tools prefer it to watching the screen
The other way to know what happened in a game is to watch the picture and recognise it, which costs GPU time and can misread a busy frame. GSI is exact and arrives within moments of the event. For commentary that matters: a line about a kill has to start while the kill is still on screen.
Colorcast uses GSI for both games. A kill reaches the commentator as data, and the first word is usually out about a second later. Moments the feed doesn't cover are triggered by hotkey, Stream Deck or mic.
Dota 2 needs one extra step
Dota 2 only sends game state when it is launched with -gamestateintegration in its Steam launch options, and its config files live in their own gamestate_integration folder. CS2 needs no launch option.
Set it up
- AI commentary for a CS2 stream, step by step
- Dota 2 setup
- League of Legends setup (Riot's Live Client Data, a similar idea)