BNETDocs: Redux is no longer updated, this subdomain exists for archival purposes only. Visit the main site.


Generate Code: All packets

Packet Information

Message ID:0x1C
Direction:Client -> Server (Sent)
Used By:Starcraft Shareware, Starcraft Broodwar, Diablo Shareware, Diablo II, Warcraft II, Warcraft III: The Frozen Throne, Starcraft, Starcraft Japanese, Diablo, Diablo, Warcraft III
Format:(DWORD) Game State
(DWORD) Game Uptime in seconds
(WORD) Game Type
(WORD) Sub Game Type
(DWORD) Provider Version Constant (0xFF)
(DWORD) Ladder Type
(STRING) Game Name
(STRING) Game Password
(STRING) Game Statstring
Remarks:Used by clients to inform the server that a game has been created, or that the state of a created game has changed.
Bitwise flags for State:
0x01: Game is private
0x02: Game is full
0x04: Game contains players (other than creator)
0x08: Game is in progress
0x80: Game is a replay
Possible values for Game Type (Sub Game Type):
0x02: Melee
0x03: Free for All
0x04: 1 vs 1
0x05: Capture The Flag
0x06: Greed (Resources, 0x01: 2500, 0x02: 500, 0x03: 7500, 0x04: 10000)
0x07: Slaughter (Minutes, 0x01: 15, 0x02: 30, 0x03: 45, 0x04: 60)
0x08: Sudden Death
0x09: Ladder (Disconnects, 0x00: Not a loss, 0x01: Counts as a loss)
0x0A: Use Map Settings
0x0B: Team Melee (Number Of Teams, 0x01: 2 Teams, 0x02: 3 Teams, etc.)
0x0C: Team Free For All (Number Of Teams, 0x01: 2 Teams, 0x02: 3 Teams, etc.)
0x0D: Team Capture The Flag (Number Of Teams, 0x01: 2 Teams, 0x02: 3 Teams, etc.)
0x0F: Top vs. Bottom (Number Of Teams, 1-7 specifies the ratio of players belonging to both teams)
0x10: Iron Man Ladder (W2BN only)
0x20: PGL

Provider Version Constant: The Current version of the game (1.16.1) uses 0xFF, previous versions have used 0x1F, but this may vary depending on game version.

Possible values for Ladder:
0x00: Game is Normal (Non-Ladder)
0x01: Game is Ladder
0x03: Game is Iron Man Ladder (W2BN only)
It could be that the ladder is bitwise as well, and that 0x02 means Iron Man and 0x03 just means Iron Man + Ladder.

Sub Game Type appears to be 0x01 for all game types except Top vs Bottom, where it seems to depend on the size of each team. More research will be needed to confirm.
Related:[0x08] SID_STARTADVEX (C->S), [0x1A] SID_STARTADVEX2 (C->S), [0x1C] SID_STARTADVEX3 (S->C), Game Statstrings

User Comments

For detailed questions and discussion, visit the Research Forum

Nov 14, 2007
02:23 AM


For Values in the Statstring (PacketLog it for the format of it)

MapSize=Size of Map ex) 44

GameSpeed=The speed of game Format is a 1 digit number see below
0 = Slowest 1 = Slower 2 = Slow 3 = Normal 4 = Fast 5 = Faster 6 = Fastest

MapIcon=Icon of the map Format is 1 digit number see below
1 = Blizz icon , 2 = Ladder icon , 3 = Green GF icon , 4 = KBK icon

GameType=The type of game Format is a one digit charecter see below
2 = Melee , 3 = FFA , 4 = 1 on 1 , 9 = Ladder , a = UMS , f = Top vs Bottom

[After GameType you would see something like , ",,1" & ",34eab02f,"
1 is believed to be no game penalty on disc and 0 would then be game penalty on disc and the alphanumeric thing after seems to be a timestamp maybe..

MapType=Type of map weather sc or bw 4 = SC 5 = BW

Username=Username of the host of the game (Can be spoofed)

MapName=The name of the map itself ( i.e The Hunters)

Nov 14, 2007
08:51 PM

still waiting for someone to bring over the old bnetdocs's page on game statstrings
i might do it today after i get some stuff done

Nov 18, 2007
03:38 AM

Brought it over.

Game Statstrings

Nov 18, 2007
04:16 AM

yeh I thought that alphanumeric was sometype of map checksum; someone know how it is derived?

Nov 18, 2007
05:34 AM

i've tested it with various different checksum functions (almost all the CRC's i could find) me and don found out that the check sum is actually different from computer to computer and product to product.... so im not quite sure how it's derived but seems to depend on some client side element also...

Nov 18, 2007
05:43 AM

Are you both even sure it's the map checksum?

Nov 18, 2007
11:00 PM

so it still could be a timestamp? w/e it is, people can still join the game even if you use the same value for all ur maps

Nov 18, 2007
11:34 PM

Yea, a timestamp makes more sense.

Nov 19, 2007
12:33 PM

that's a very large time stamp... timestamp doesn't make since because it doesn't change based on filetime, we proved that when we tested it with kyro's map (same exact one as mine)..

both me and kyro had the same exact map with the same exact filetime and all together got 2 different values... which is what leads me to believe its a hash of the map and some other element of the computer either username or ip or something hmm i haven't tested this using a different username

May 22, 2008
02:23 PM

It would be cool to make Ripple Chat Bot enter a game... but the Packet Builder it has restricts that in a way that's not cool.

Oct 03, 2008
02:17 PM

I did some packet analyzing and I found that when you host a replay game, the value 0x81 is used for the game state. And when you close all the available slots the value is 0x06.

Also, 0x04 does not mean the game contains players necisary, it could also mean that the game contains slots that are filled, either by a computer or a closed slot. So, if you close all available slots, and open one... it refreshes the game, because starcraft will update on the status.

Also, the Unknown DWORD I always get the value FF.

Sep 03, 2010
07:29 PM

Parameter is more like SubType.

Values for GameType/SubType
2 Melee
3 Free For All
4 One on One
5 Capture The Flag
6 Greed
-- SubType: Resources (1 = 2500; 2 = 5000; 3 = 7500; 4 = 10000)
7 Slaughter
-- SubType: Minutes (1 = 15; 2 = 30; 3 = 45; 4 = 60)
8 Sudden Death
9 Ladder
-- SubType: Disconnects (Specifies if a disconnect is counted as a loss or not)
10 Use Map Settings
11 Team Melee
-- SubType: Number Of Teams (1 = 2; 2 = 3; 3 = 4)
12 Team Free For All
-- SubType: Number Of Teams (1 = 2; 2 = 3; 3 = 4)
13 Team Capture The Flag
-- SubType: Number Of Teams (1 = 2; 2 = 3; 3 = 4)
15 Top Vs. Bottom
-- SubType: Teams (1-7 specifies the ratio of players belonging to both teams)
16 Iron Man Ladder
32 PGL

Those values apply to Starcraft and W2BN

Oct 03, 2010
10:53 PM

Updated according to Herinermann's documentation and Frost's documentation.

Thank you for your contributions.

Oct 06, 2010
09:04 PM

Missing 0x80 state bitwise flag. It means a replay game.

Also, the provider version constant (Gotten from storm network provider information structure +0x28) may not be 0xFF in all games and all version. It is 0xFF in the current version of Starcraft: Broodwar, however.

Oct 07, 2010
10:38 PM

Added the missing flag and stuck a note in there about the provider version constant.

We recommend you use Firefox to view this site. This site has been optimized for Firefox.

Get Firefox
BNLS Server Status

= Online       = Offline Server Status v1 v2




= Online       = Offline


Site scripts and design copyrights reserved to Don Cullen.
Contents copyrighted to Blizzard and their parent corporation, Vivendi.
Main credits for contents goes to Arta. View the rest of credits.
Demented Minds copyrights reserved to Don Cullen 2003-present.
Copyright infringements will be prosecuted to the fullest extent allowable by law.
Please view our legal disclaimer and terms of service.