Game Statstrings

This document covers the game advertisement statstrings for the various Blizzard games and goes into detail on each one for each game.

STAR/SEXP/JSTR/SSHR/W2BN Statstrings are comma delimited, and most fields can be null as they have default values. Each field is in a different format, but they all stick to numeric integers, hexadecimal strings (in lowercase), or plaintext strings. The encoding Latin1 is recommended for correct viewing; map names may be in UTF-8 or anything else, but will still show up as Latin1 to the client.

STAR/SEXP

Saved Game
1. Null: This game is not saved.
2. Hex String: This is a saved game. The hex string is a UINT32, and is probably a checksum of the save file.
Map Size
1. Null: 128x128
2. Two Digit Number: Width and Height of the map, divided by 32. Ex: 43 = 4*32 x 3*32 = 128x96
Max Players
1. Null: 8 Player Map
2. Value: Number of players allowed on the map, plus 10. Ex: 16 = 6 players
Speed
- 0x00: Slowest
- 0x01: Slower
- 0x02: Slow
- 0x03: Normal
- 0x04/Null: Fast
- 0x05: Faster
- 0x06: Fastest
Approval
- 0x00: Not Approved
- 0x01: Blizzard Approved
- 0x02: Ladder Approved
- 0x03: PGL Approved
- 0x04: KBK Approved
- 0x05: CompUSA Approved
Game Type
- 0x02: Melee
- 0x03: Free For All
- 0x04: One vs One
- 0x05: Capture the Flag
- 0x06: Greed
- 0x07: Slaughter
- 0x08: Sudden Death
- 0x09: Ladder
- 0x0A: Use Map Settings
- 0x0B: Team Melee
- 0x0C: Team Free For All
- 0x0D: Team Capture the Flag
- 0x0F: Top vs Bottom
- 0x20: PGL
Unknown
1. This field has only been observed to be Null.
Game Parameter, based on game type
- This field is based on the Game Type
- Melee, Free for All, One vs One, Capture the Flag, Sudden Death, Use Map Settings, PGL
  - 0x01: None
- Greed
  - 0x01: 2500 Resources
  - 0x02: 5000 Resources
  - 0x03: 7500 Resources
  - 0x04: 10000 Resources
- Slaughter
  - 0x01: 15 Minutes
  - 0x02: 30 Minutes
  - 0x03: 45 Minutes
  - 0x04: 60 Minutes
- Ladder
  - 0x01: None
  - 0x02: Disconnect Counts as a Loss
- Team Melee, Team Free for All, Team Capture the Flag
  - 0x01: 2 Teams
  - 0x02: 3 Teams
  - 0x03: 4 Teams
- Top vs Bottom
  - Team Ratios, as gathered by the following equation: val[7] vs (val[2] - 10 - val[7])
  - Ex: if (val[2] = 16, val[7] = 2), then "2 vs 4"
CD-Key Checksum
1. This is a hex string UINT32 checksum of the creator's CD-Key as generated by call to #502 in Storm.dll (SStrHash).
Tileset
- 0x00/Null: Badlands
- 0x01: Space Platform
- 0x02: Installation
- 0x03: Ashworld
- 0x04: Jungle
- 0x05: Desert
- 0x06: Arctic
- 0x07: Twilight
Replay
- 0x00/Null: Not a Replay
- 0x01: Game Replay
Creator/Map
1. Format: Game's Creator + 0x0D + Map Name + 0x0D

JSTR

0 Saved Game (Unsure)

Null: This game is not saved.

Hex String: This is a saved game. The hex string is a UINT32, and is probably a checksum of the save file.

1 Map Size

Null: 128x128

Two Digit Number: Width and Height of the map, divided by 32.: Ex: 43 = 4*32 x 3*32 = 128x96

2 Max Players

Null: 8 Player Map

Value: Number of players allowed on the map, plus 10.: Ex: 16 = 6 players

3 Speed

0x00: Slowest

0x01: Slower

0x02: Slow

0x03: Normal

0x04/Null: Fast

0x05: Faster

0x06: Fastest

4 Approval

0x00: Not Approved

0x01: Blizzard Approved

0x02: Ladder Approved

0x03: PGL Approved

0x04: KBK Approved

0x05: CompUSA Approved

5 Game Type

0x02: Melee

0x03: Free for All

0x04: One vs One

0x05: Capture the Flag

0x06: Greed

0x07: Slaughter

0x08: Sudden Death

0x09: Ladder

0x0A: Use Map Settings

0x0B: Team Melee

0x0C: Team Free For All

0x0D: Team Capture the Flag

0x0F: Top vs Bottom

0x20: PGL

6 Game Parameter

This field is based on the Game Type:

Melee, Free for All, One vs One, Capture the Flag, Sudden Death, Use Map Settings, PGL

0x01: None

Greed

0x01: 2500 Resources

0x02: 5000 Resources

0x03: 7500 Resources

0x04: 10000 Resources

Slaughter

0x01: 15 Minutes

0x02: 30 Minutes

0x03: 45 Minutes

0x04: 60 Minutes

Ladder

0x01: None

0x02: Disconnect Counts as a Loss

Team Melee, Team Free for All, Team Capture the Flag

0x01: 2 Teams

0x02: 3 Teams

0x03: 4 Teams

Top vs Bottom

Team Ratios, as gathered by the following Equation:

val[7] vs (val[2] - 10 - val[7]): Ex: if (val[2] = 16, val[7] = 2), then "2 vs 4"

7 CD-Key Checksum

This is a hex string UINT32 checksum of the creator's CDKey as generated by call #502 of Storm.dll (SStrHash).

8 Tileset

0x00/Null: Badlands

0x01: Space Platform

0x02: Installation

0x03: Ashworld

0x04: Jungle

0x05: Desert

0x06: Arctic

0x07: Twilight

9 Creator/Map

Game's Creator [0x0D] Map Name [0x0D]

SSHR: ,1,2,3,4,5,6,7,8,9

1 Map Size

Null: 128x128

Two Digit Number: Width and Height of the map, divided by 32.: Ex: 43 = 4*32 x 3*32 = 128x96

2 Max Players

Null: 2 Player Map

Value: Number of players allowed on the map, plus 10.: Ex: 16 = 6 players

3 Speed

0x00: Slowest

0x01: Slower

0x02: Slow

0x03: Normal

0x04/Null: Fast

0x05: Faster

0x06: Fastest

4 Approval

0x00: Not Approved

0x01: Blizzard Approved

0x02: Ladder Approved

0x03: PGL Approved

0x04: KBK Approved

0x05: CompUSA Approved

5 Game Type

0x02: Melee

6 Game Parameter

0x01: None

7 Checksum

This is a hex string UINT32 checksum that seems to always be 2ac374b3, probably because SSHR has no CDKey and only one map.

8 Tileset

0x00/Null: Badlands

9 Creator/Map

Game's Creator [0x0D] Map Name [0x0D]

W2BN: 0,1,2,3,4,5,6,7,8,9

0 Saved Game

Null: This game is not saved.

Hex String: This is a saved game. The hex string is a UINT16, and is probably a checksum of the save file.

1 Map Size

Null: 128x128

Two Digit Number: Width and Height of the map, divided by 32.: Ex: 43 = 4*32 x 3*32 = 128x96

2 Max Players

Null: 8 Player Map

Value: Number of players allowed on the map, plus 10.: Ex: 16 = 6 players

3 Speed

0x00: Slowest

0x01: Even Slower

0x02: Slower

0x03: Slow

0x04: Normal

0x05/Null: Fast

0x06: Faster

0x07: Even Faster

0x08: Fastest

4 Approval

0x00: Not Approved

0x01: Blizzard Approved

0x02: Ladder Approved

0x03: PGL Approved

0x04: KBK Approved

0x05: CompUSA Approved

5 Game Type

0x02: Melee

0x03: Free for All

0x04: One vs One

0x09: Ladder

0x0A: Use Map Settings

0x0F: Top vs Bottom

0x10: Iron Man Ladder

6 Game Parameter

This field is based on the Game Type:

Melee, Free for All, One vs One, Use Map Settings, Iron Man Ladder

0x01: None

Ladder

0x01: None

0x02: Disconnect Counts as a Loss

Top vs Bottom

Team Ratios, as gathered by the following Equation:

val[7] vs (val[2] - 10 - val[6]): Ex: if (val[2] = 16, val[6] = 2), then "2 vs 4"

7 CD-Key Checksum

This is a hex string UINT32 checksum of the creator's CDKey as generated by call #502 of Storm.dll (SStrHash).

8 Game Settings

This field is a bitwise-based hex string, containing specific game settings.

Each Setting section has a bitwise mask, which should be applied to read the setting. Bitwise fields may be combined, Specific fields can only have one option.

Options - 0xF00 Mask - Bitwise: 0x200: One Peon; 0x400: Fixed Order
Resources - 0x23000 Mask - Specific: 0x00/Null: Default; 0x1000: Low; 0x2000: Medium; 0x3000: High; 0x20000: Random
Tileset - 0x1C000 Mask - Specific: 0x00/Null: Default; 0x4000: Forest; 0x8000: Winter; 0xC000: Wasteland; 0x14000: Random; 0x1C000: Orc Swamp

9 Creator/Map

Game's Creator [0x0D] Map Name [0x0D]

DRTL/DSHR: Diablo Statstrings are instead [0x0D] delimited and use the following pattern:

0 Difficulty: 0x00: Normal; 0x01: Nightmare; 0x02: Hell
1 Creator: The name of the game's creator
2 Creator Statstring: The statstring of the game's creator. See Chat Statstrings for the format of this field.

D2DV/D2XP:

Open Battle.net: '4' + Game Description
Closed Battle.net: (UINT8) 0x00 (0x01 and 0x02 have previously been seen)

WAR3/W3XP: Warcraft III games use a completely different format for SID_GETADVLISTEX, and do not contain a "Statstring" in the classic sense.

Comments

Caaaaarrrrlll Thu Mar 27, 2008 3:30pm UTC	If the map name has a 0x0D or a 0x0A, then others will not be able to join. They will receive a "Unable to join game." message from Battle.net and the information screen will be blank. (Tested on Starcraft Broodwar) Im going to play safe and assume that this is because Starcraft cannot parse the invalid statstring.
ansichart Fri Oct 3, 2008 2:29pm UTC	I have done some packet analyzing and I found out the first unknown value. It is the number of players allowed on the map. If the value is blank, then it is an 8 player map, values 12-17 are 2 player maps - 7 player maps. And #7 does not seem to be the checksum of the map, since it seems to be the same value for me no matter what map I pick. The other unknown value is set to 1 for a replay game, and set to blank if not. Also, there is a parameter that lies before the map size... before the first comma and after the game password. The field contains a DWORD in it only when you host a saved game. I am not sure what this data means.
Caaaaarrrrlll Sun Aug 23, 2009 11:51am UTC	The statstring format for Starcraft needs to be updated... I made my bot send the SID_STARTADVEX3 following these specifications and it had the blank info come up. Now, that is not saying I do not have a working statstring, because I do. I may find time later on to update this with my working statstring, and ansichart's findings.
RealityRipple Fri Apr 9, 2010 9:24pm UTC	Got this info regarding Starcraft Shareware games. Will be doing the rest of them soon as well: Game Statstring: ,33,12,6,,2,1,2ac374b3,,RealityRipple(0x0D)Byways(0x0D) Map Size: 33 332,332 96x96 Players: 12 2 players Game Speed: 6 Fastest Approval: - Not Implemented/No Approval/Unknown Game Type: 2 Melee Parameter: 1 See above Parameter Checksum: 2ac374b3 Tileset: blank Badlands Creator: RealityRipple MapName: Byways As for the checksum, http://forum.valhallalegends.com/index.php?topic=17702.msg182264#msg182264 will explain how it is created.
Caaaaarrrrlll Wed Jun 30, 2010 6:07am UTC	That looks about right.
Sixen Thu Sep 2, 2010 10:11pm UTC	Going to check back on these, it's from old research of mine. DRTL: Status: 0 Game Type: 7 Language ID: 67698688 Address Family: 0 Port: 2 Host IP: -1290215401 ???: 0 ???2: 0 Game Status: 0 Time Elapsed: 101580800 Game Name: asdf Game Pass: Game Statstring: 0 Host: UssRustolium16 LTRD 19 0 0 101 16 79 105 19312 0
MysT_DooM Thu Sep 30, 2010 8:36pm UTC	7: the Hex Dword is actually a CDKey Hash hashed by SStrHash()
Sixen Thu Sep 30, 2010 9:16pm UTC	Mhmm. Talking to Frost now.
Caaaaarrrrlll Sun Oct 3, 2010 11:24pm UTC	Updated.
Heinermann Fri Feb 25, 2011 4:46am UTC	Just want you to know that the hash is easily broken on older games and updating to an installation with a Digital Key is highly recommended.