This document describes how to supply product information to Classic Battle.net™.

Usage

When connecting to the Classic Battle.net service and identifying with C>S 0x50 SID_AUTH_INFO (or the older C>S 0x06 SID_STARTVERSIONING/C>S 0x07 SID_REPORTVERSION system), the clients send their Platform, Product, Version (often called Version Byte or Verbyte), and Language values.

All four fields are UINT32 values, where all but Version are a four-character "UINT32-string", as described in notational conventions.

Products and Versions

Product and Version specify what version of what game being used. The Product value is seen again when users are seen in chat with their chat statstrings. The Version value may be used again during peer-to-peer and other game-related communication to ensure clients are on the same versions. The Latest Version value is the four-16-bit-integer Windows PRODUCTVERSION field for reference (also used during Check Revision).

Client	Product	Latest Version	Version Value
Telnet	`CHAT`		`0x01`
StarCraft Shareware	`SSHR`	1.12.0.0	`0xA5`
StarCraft Japanese	`JSTR`	1.12.0.0	`0xA9`
StarCraft	`STAR`	1.20.11.3277	?
StarCraft: Brood War	`SEXP`	1.20.11.3277	?
Diablo Shareware	`DSHR`	2001.5.11.1	`0x2A`
Diablo I Beta	`DIAB`
Diablo I Stress Test	`DTST`
Diablo Retail	`DRTL`	2001.5.11.1	`0x2A`
Diablo II Stress Test	`D2ST`
Diablo II	`D2DV`	1.14.3.71	`0x0E`
Diablo II: Lord of Destruction	`D2XP`	1.14.3.71	`0x0E`
WarCraft II: Battle.net Edition	`W2BN`	2.0.2.0	`0x4F`
WarCraft III Demo	`W3DM`		`0x01`
WarCraft III: Reign of Chaos	`WAR3`	1.30.0.9900	`0x1E`
WarCraft III: The Frozen Throne	`W3XP`	1.30.0.9900	`0x1E`

Italic listings no longer work on official Battle.net servers.

StarCraft products are all upgraded to the new StarCraft 1.18 and later releases on official servers. You can no longer log on with JSTR or SSHR, for they are also given an upgrade request.

The Battle.net Chat Service briefly supported non-tunneled StarCraft version "1.18.0.1345" with code 0xD6 but now bans you for using it, even though a newer version was the latest.

Programmatically obtaining the version byte

This is not a 100% guaranteed method, but you can scan the game's binary to find the version byte. Using a simple pattern matching.

For StarCraft, the pattern is:

C7 46 10 ** ** ** ** C7 46 18 ** ** ** ** C7 46

The version byte being the first set of wildcards.

C++ Code donated by DevCode

Java Code donated by Hdx

Platform

The Platform value identifies which of three possible platforms. This affects what files Battle.net gives you to work on your platform.

Operating System	Architecture	Platform Value
Windows	Intel x86	`IX86`
Mac OS	PowerPC	`PMAC`
OS X	Intel	`XMAC`

Language

The Language value identifies which language the product is using. You cannot specify this using the older C>S 0x06 SID_STARTVERSIONING/C>S 0x07 SID_REPORTVERSION system. This affects what language files Battle.net gives you as well as when the service sends you informative text in chat events among other places.

These are the values supported by Classic Battle.net's servers.

Language	Language Value
English (United States)	`enUS`
English (Great Britain)	`enGB`*
German (Germany)	`deDE`
French (France)	`frFR`
Italian (Italy)	`itIT`
Spanish (Spain)	`esES`
Korean (Korea)	`koKR`
Polish (Poland)	`plPL`
Russian (Russia)	`ruRU`
Chinese (Taiwan)	`zhTW`
Chinese (China)	`zhCN`**
Japanese (Japan)	`jaJA`**

Any other values (including (UINT32) 0) gives you 'enUS'.

* It is unknown whether 'enGB' or any other English varieties actually differ from 'enUS' and the server is just giving you that.

** These languages appear to be supported, but no official clients are available that use it. JSTR is no longer accessible.

Comments

idiat Sat Mar 22, 2008 10:05pm UTC	W3XP verbyte is 0x15
Kyro Sun Mar 23, 2008 1:33am UTC	Confirmed by RealityRipple. Updated W3XP verbyte to 0x15. Thanks for the heads up, idiat.
FrostWraith Sat Jun 21, 2008 1:28am UTC	D2DV Verbyte = 0x0C D2XP Verbyte = 0x0C
Kyro Sun Jun 22, 2008 4:06am UTC	Updated, thanks.
Alendar Sun Jul 6, 2008 5:20am UTC	WAR3 VerByte = 0x16 W3XP VerByte = 0x16
Ozzapoo Thu Nov 13, 2008 12:00am UTC	The current Wc3 Verbyte for both RoC and TFT is 0x16
Sixen Sun Jan 18, 2009 7:57pm UTC	SC/BW are now 0xD3
Alendar Sat Apr 4, 2009 7:59pm UTC	WarCraft VerBytes are now 0x17
Kyro Fri Apr 10, 2009 12:20pm UTC	@Alendar, Ozzapoo, Sixen-- updated. Thanks.
Heinermann Wed Feb 3, 2010 5:57am UTC	I found a product code called DTST. You can find it in Starcraft.exe(1.16.1)@0x004497A4. From what I can tell its the same as DRTL?
Kyro Mon Jul 19, 2010 11:52pm UTC	Probably has something to do with Diablo 3?
Caaaaarrrrlll Tue Jul 20, 2010 12:27am UTC	Updated D2DV/D2XP verbyte to 0x0D. @Heinermann: That product is indeed there. Further testing would have to be done to see what product it really is. I would take an educated guess that DTST stands for Diablo Test (Client).
Caaaaarrrrlll Tue Jul 20, 2010 12:30am UTC	Diablo 3 will not be seen on Classic Battle.net. In other words, the product id for Diablo 3 and StarCraft II will not be seen in any icons.bni, or in any classic game. They will only be seen in newer games that are compatible with Battle.net v2. If it really is Diablo 3, Blizzard has something to surprise the community with and hasn't announced it yet.
Heinermann Sun Aug 8, 2010 2:15am UTC	It was there long before Diablo 3 even began so I highly doubt it. It probably was as you said (Diablo TeST)
Caaaaarrrrlll Tue Aug 10, 2010 3:47am UTC	Interesting enough, I sent DTST in a SID_AUTH_INFO and got disconnected, but not IP banned... I could instantly reconnect after it disconnected me. It did not give me any error codes or anything, it just simply disconnected me for sending DTST as the product, nothing else followed. On a side note, you can send DRTL and DSHR in SID_AUTH_INFO and you will receive SID_AUTH_INFO from Battle.net. The packet you receive will tell you to use BSHA-1 and you will receive something like lockdown-IX86-1.mpq as your CheckRevision file. I have been told that when you use DRTL, DSHR, SSHR, or any game that does not use CD-Keys, you send SID_AUTH_CHECK without any CD-Keys appended to the packet (everything EXCEPT the CD-Key part of the packet), and Battle.net will treat that as proper communication and will not disconnect you, surprisingly enough. I will be testing this soon with my own bot later, and I will hopefully add (incorrect?) documentation for it here on BnetDocs later.
Sixen Wed Sep 1, 2010 2:32pm UTC	Warcraft III: Demo: W3DM 0x01 As far as D3 goes, these games will still need to support viewing users on SC2/D3/WoW since these will all be ported to Bnet2.0 soon(tm). EDIT: Perhaps DTST needs to login through a specific server similar to W3DM?
Kyro Wed Sep 1, 2010 6:56pm UTC	Do we have a range of known battle.net server IP addresses to put that theory to the test?
Heinermann Thu Sep 2, 2010 5:59am UTC	I looked into the code in Starcraft where DTST is referenced. It grabs the icon from glueattle.neticons.pcx from patch_rt.mpq according to the product (this function is probably no longer used). DRTL, DSHR, and DTST all have the Diablo icon according to that piece of code. Getting a hold of the Diablo Battle.net Beta might give us the answers.
Heinermann Fri Sep 3, 2010 4:18am UTC	I checked and the Alpha/Pre-release has nothing Battle.net related.
Sixen Fri Sep 3, 2010 4:34am UTC	@Kyro: Well, the W3DM server is demo.war3.battle.net. Perhaps we should keep a list of servers... EDIT: Got a document up with a list. @Heinermann: Hrmm... Supposedly, this is a copy of D1 Alpha. I have not checked it out myself yet. http://www.megaupload.com/?d=HK7F9E4L According to the Diablo Evolution website, that is the correct size (and the owner of the site put that link up). I can try and contact the guys from Diablo Evolution and see if he can upload the D1 Beta. Apparently he has a copy of it.
Sixen Fri Sep 3, 2010 7:40am UTC	Awesome, I got in contact with Mystery, the guy who ran Diablo Evolution. He told me he'll re-upload the Diablo Beta tomorrow, :). Few other things... Do you have copies of the other game betas? D2, SC1, War2, War3? Could potentially be more information there... In addition, the D2 Beta on Battle.net had product code D2ST, this could potentially be that; not the D1 Beta. It's more than possible the D2ST could have the same icon as DRTL... That beta is located here: http://www.megaupload.com/?d=UENTRDTJ This Beta Archives site seems to have all of them if we need any (aside from DRTL Beta which Mystery will upload for us tomorrow).
Sixen Sat Sep 4, 2010 3:32am UTC	Been talking to Heinermann a lot lately, we found out the Diablo 2 Stress Test: D2ST verbyte is 0xCA and uses the same login sequence as DRTL/DSHR. -- I just need the D2 LoD Beta if anyone has access to this.
Heinermann Sat Sep 4, 2010 10:48pm UTC	It might be safe to assume that DTST is a Diablo Stress Test
Heinermann Tue Sep 7, 2010 1:54pm UTC	Diablo Battle.net Beta: DIAB
Caaaaarrrrlll Mon Sep 27, 2010 12:02am UTC	I updated Hdx's Java-code donation so that it is hosted here at BnetDocs instead of pastebin. It'd be nice if it could be displayed as neatly as the CPP version by DevCode.
Caaaaarrrrlll Mon Apr 4, 2011 6:21am UTC	Updated WAR3/W3XP verbytes to 0x1A.
Caaaaarrrrlll Mon Jul 11, 2016 2:03am UTC	I have added the sample code as attachments to this document.
Caaaaarrrrlll Sun Apr 23, 2017 9:09pm UTC	Version bytes have been updated for WAR3/W3XP to `0x1C` and STAR/SEXP to `0xD6`.
Caaaaarrrrlll Wed Apr 11, 2018 12:02am UTC	Updated WAR3/W3XP to version 1.29.0.9055 (`0x1D`).
Caaaaarrrrlll Wed Aug 8, 2018 8:57pm UTC	Updated WAR3/W3XP to version 1.30.0.9900 (`0x1E`).